ESP32S3 物理按键精灵

通过网盘分享的文件:
链接: https://pan.baidu.com/s/1ntt7e5DUn_Z3j9JVTPr44Q?pwd=f4at 提取码: f4at 

 

功能

  • 4 条可独立计时的序列,每条最多 32 个动作。
  • 支持按键、组合键(修饰键组合)和单独等待。
  • 支持字母、数字、方向键、常用按键、F1–F24 和符号键。
  • 可无限循环,或循环 1–100,000 次。
  • 每条序列可单独启用、保存、启动和停止;还有全部启动和全部停止控制。
  • 设置保存在 NVS Flash 存储中,断电后不丢失。
  • BOOT 按键可快速启动 / 停止。上电、USB 重新连接或主机休眠后,所有序列都会保持暂停状态。
  • 英文界面和固件提示,无外部脚本,不依赖互联网。

硬件

现有硬件使用 ESP32-S3 N16R8 开发板,16 MB Flash,两个 USB-C 接口。天线朝上、接口朝下时,左侧的 USB/OTG 口接目标电脑;右侧的 USB 转串口口用于烧录和查看日志。请核对你手上板子的丝印:不同厂家的接口位置可能不一样。BOOT 接在 GPIO 0 上。

快速上手

  1. 按下面的说明烧录固件。
  2. 用一根支持数据传输的线,把原生 USB/OTG 口接到目标电脑上。
  3. 在手机上连接 Wi-Fi key-agent,密码 71581234。
  4. 打开 **http://192.168.4.1**。如果手机提示无互联网连接,保持连接即可。
  5. 选择一条序列,编辑它的动作,启用后点击 Save and apply(保存并应用)。
  6. 点击 Start sequence(启动序列)或 Start all(全部启动)。在电脑上打开一个文本编辑器,就能看到输出效果。

任意序列运行时按 BOOT,会停止所有序列。全部暂停时按 BOOT,会按已保存的设置启动所有已启用的序列。上电或复位开发板时不要按住 BOOT,否则会进入下载模式。

默认序列会依次输入 1、2、3,每个按键按住 40 ms,松开后等待 500 ms。4 条序列默认都是启用的,但会保持暂停,直到你手动启动。

计时与行为

设置 范围
按键按住时间 20–10,000 ms
松开后等待 0–86,400,000 ms
单独等待 1–86,400,000 ms
重复次数 0 表示无限循环;否则为 1–100,000

1 秒 = 1,000 ms;1 小时 = 3,600,000 ms。每条序列有各自的计时器,但 USB 按键是串行发送的。就绪的序列按优先级依次执行:1、2、3,然后是 4。一个按键被按住时,会先松开,再把控制权交给另一条序列。等待时间是最小延迟,不是保证的精确时长;高优先级序列的活动可能会延迟低优先级序列。

保存时只会停止选中的那条序列、松开它的按键,并保存它的配置,其他序列会继续运行。启动一条序列时,会从它的第一个动作开始执行。全部启动时,已经在运行的序列会继续,不会重新开始。被禁用的序列会保留自己的动作。如果没有启用任何序列,就什么都不会启动。

切换标签页会保留未保存的草稿;刷新页面会丢弃草稿。只要有未保存的草稿,全部启动就是不可用的。BOOT 始终使用已保存的设置。关闭页面或断开手机连接,不会停止播放。

按键标签采用美式键盘布局。实际输入的字符取决于主机键盘布局和输入法。在 macOS 上,Cmd/Win 对应 Command 键。

网络访问

热点使用 main/main.c 中定义的固定默认密码。任何连上热点的人都可以通过设备 API 控制键盘。如果需要不同的密码,请在构建前修改 AP_PASSWORD。配置通过本地 HTTP 提供;设备不会加入外部 Wi-Fi 网络。

致谢

USB 描述符设置基于 Espressif 的 CC0/Unlicense tusb_hid 示例。ESP-IDF 和托管组件保留各自的许可证;组件管理器会在配置期间获取它们。

请登录后发表评论

    没有回复内容