告别C语言：利用CH9329与Lua脚本轻松打造USB自动化控制工具
1. 为什么选择CH9329+Lua方案？
如果你曾经想用硬件控制电脑的键盘鼠标操作，大概率会被传统开发方式劝退。单片机编程、USB协议栈、HID描述符...这些名词光是听着就让人头大。我最初尝试用Arduino开发这类工具时，光是搞明白HID报告描述符就花了整整两周，最后代码还经常不稳定。
CH9329芯片的出现彻底改变了这个局面。这颗国产芯片内置了完整的USB HID协议栈，只需要通过串口发送简单指令，就能模拟键盘鼠标的所有操作。更妙的是配合Lua脚本语言，你甚至不需要编译烧录，直接修改脚本文件就能实时看到效果。实测从开箱到实现第一个自动化操作，最快只要15分钟。
相比传统方案，这个组合有三大杀手锏：
- 零协议知识要求：芯片已经处理好所有USB底层通信，你只需要关心"按下A键"这样的高层逻辑
- 脚本化开发：Lua代码比C语言简单10倍，没有指针、内存管理等复杂概念
- 即时反馈：省去编译-下载-调试的繁琐循环，保存脚本立即生效
2. 硬件准备与初始配置
2.1 硬件采购指南
CH9329模块在某宝上价格约15-30元，选购时注意确认是支持串口通信的版本。推荐带USB Type-C接口的模块，比如下图这种：
[CH9329模块实物图描述：板载CH9329芯片、Type-C接口、4Pin排针（VCC/GND/TX/RX）]同时你需要：
- USB数据线（Type-A to Type-C）
- 杜邦线若干（建议选用母对母）
- 可选：面包板方便临时接线
2.2 五分钟快速接线
模块引脚定义通常如下：
- VCC：接5V电源（可直接用USB供电）
- GND：接地
- TX：接开发板的RX引脚
- RX：接开发板的TX引脚
以常见的ESP32开发板为例，接线示意图：
CH9329 ESP32 VCC ---- 5V GND ---- GND TX ---- GPIO16(RX2) RX ---- GPIO17(TX2)注意：不同开发板的串口引脚号可能不同，需要查阅具体手册
3. Lua脚本编程实战
3.1 开发环境搭建
推荐使用VS Code + Lua插件组合：
- 安装Lua语言支持插件
- 创建新文件保存为
hid_tool.lua - 下载FlexLua提供的CH9329库文件放入项目目录
基础模板代码：
-- 初始化CH9329（使用UART0，屏幕分辨率1920x1080） LIB_CH9329Config("UART0", 1920, 1080) -- 主循环 while true do -- 你的自动化代码写在这里 LIB_DelayMs(100) -- 防止CPU占用过高 end3.2 鼠标控制三要素
通过LIB_CH9329_MoveMouse()函数可以实现所有鼠标操作，其核心参数：
-- 模式：ABSOLUTE(绝对坐标)/RELATIVE(相对移动) -- x,y：目标坐标（绝对模式时是像素值，相对模式时是偏移量） -- 按键：LEFT/RIGHT/MIDDLE -- 动作：SINGLE(单击)/DOUBLE(双击)/PRESS(按下)/RELEASE(弹起) -- 示例：在(500,300)处左键双击 LIB_CH9329_MoveMouse("ABSOLUTE", 500, 300, "LEFT", "DOUBLE")实际案例：自动绘制Windows画图的正方形
function drawSquare(x, y, size) -- 移动至起点 LIB_CH9329_MoveMouse("ABSOLUTE", x, y, "LEFT", "PRESS") -- 绘制四条边 LIB_CH9329_MoveMouse("ABSOLUTE", x+size, y, "LEFT", "NONE") LIB_CH9329_MoveMouse("ABSOLUTE", x+size, y+size, "LEFT", "NONE") LIB_CH9329_MoveMouse("ABSOLUTE", x, y+size, "LEFT", "NONE") LIB_CH9329_MoveMouse("ABSOLUTE", x, y, "LEFT", "RELEASE") end3.3 键盘高级技巧
LIB_CH9329KbdSend()函数支持发送任意键值，特殊键值表如下：
| 键名 | 键值 | 说明 |
|---|---|---|
| KEY_CTRL | 0x01 | 控制键 |
| KEY_SHIFT | 0x02 | 切换键 |
| KEY_ALT | 0x04 | 替代键 |
| KEY_WIN | 0x08 | Windows键 |
组合键示例：实现Ctrl+Alt+Delete
tab = {0x01|0x04, 0x63, 0x00, 0x00, 0x00, 0x00, 0x00} LIB_CH9329KbdSend(tab)4. 典型应用场景剖析
4.1 自动化测试工具
在软件QA测试中，经常需要重复执行固定操作流程。传统方式需要人工值守，现在可以用脚本实现：
-- 测试Chrome浏览器启动-搜索-关闭流程 function testChrome() -- Win+R打开运行对话框 sendHotkey(0x08, 0x15) -- WIN+R -- 输入chrome并回车 typeString("chrome") sendKey(0x58) -- ENTER LIB_DelayMs(3000) -- 在地址栏输入百度网址 sendHotkey(0x01, 0x3E) -- CTRL+L typeString("https://www.baidu.com") sendKey(0x58) -- ENTER LIB_DelayMs(2000) -- 关闭浏览器 sendHotkey(0x01, 0x3F) -- CTRL+W end4.2 智能家居中控台
配合物联网开发板，可以打造物理智能家居控制面板：
-- 绑定GPIO按钮控制智能灯具 function onButtonPress() -- 模拟按下手机APP的快捷键 sendHotkey(0x08, 0x10) -- WIN+1 LIB_DelayMs(1000) -- 用方向键选择灯具 sendKey(0x52) -- UP LIB_DelayMs(500) sendKey(0x58) -- ENTER end5. 避坑指南与性能优化
5.1 常见问题排查
现象1：电脑无法识别设备
- 检查USB数据线是否支持数据传输（有些充电线只有电源线）
- 确认模块供电正常（LED指示灯是否亮起）
现象2：按键响应延迟高
- 减少串口通信间隔（但不要小于20ms）
- 避免在循环中使用长时间延迟
5.2 脚本优化技巧
- 变量复用：将常用键值定义为全局变量
KEY_ENTER = 0x58 KEY_SPACE = 0x2C- 函数封装：把重复操作抽象成函数
function typeString(str) for i = 1, #str do local c = string.byte(str, i) -- 转换字符到键值码（需实现映射表） local keycode = charToKeycode(c) LIB_CH9329KbdSend({0x00, keycode, 0x00, 0x00, 0x00, 0x00, 0x00}) LIB_DelayMs(50) end end- 异步处理：使用状态机避免阻塞
state = "IDLE" function loop() if state == "IDLE" then startTask() state = "RUNNING" elseif state == "RUNNING" then -- 执行任务步骤 end end