链接: 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 上。
快速上手
- 按下面的说明烧录固件。
- 用一根支持数据传输的线,把原生 USB/OTG 口接到目标电脑上。
- 在手机上连接 Wi-Fi key-agent,密码 71581234。
- 打开 **http://192.168.4.1**。如果手机提示无互联网连接,保持连接即可。
- 选择一条序列,编辑它的动作,启用后点击 Save and apply(保存并应用)。
- 点击 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 和托管组件保留各自的许可证;组件管理器会在配置期间获取它们。



没有回复内容