FireBeetle 帮你把手机变成键盘鼠标

2022-04-081.6万
精华项目
AI 快速预览详细 收起
该项目介绍了如何使用FireBeetle和CH9329芯片,通过BLE蓝牙将手机变为控制电脑的键盘和鼠标。硬件选择包括基于ESP32的FireBeetle开发板和WCH出品的CH9329芯片。CH9329芯片支持多种工作模式和串口通信模式,可以灵活配置。手机端程序设计采用了点灯科技Blinker库,提供了便捷的物联网解决方案。通过绑定按键和处理函数,以及数据处理函数,实现了对输入框、摇杆和按钮事件的处理。最终,用户可以通过手机应用程序远程控制电脑,实现键盘和鼠标的全部功能。


这次做的项目能够帮你把手上的手机变成能够控制电脑的键盘和鼠标。
基本原理上是:用户通过手机应用程序经由BLE蓝牙和FireBeetle进行通讯,FireBeetle收到之后再通过USB接口将数据发送到电脑上。从原理上看整体分作三部分:硬件的选择和设计,Arduino代码的编写和手机端程序设计。
首先介绍硬件的选择和设计。FireBeetle是DFRobot出品的基于 ESP32 的开发板,它能够支持蓝牙和 WIFI 的通讯,它带有USB转串口芯片但是无法将自身模拟为USB键盘鼠标设备,为了实现这个功能,还需要设计一个USB键盘鼠标Shield。经过研究,最终选择了 WCH 出品的CH9329芯片进行实现。CH9329是一款串口转标准USB HID 设备(键盘、鼠标、自定义 HID)芯片,根据不同的工作模式,在电脑上可被识别为标准的USB 键盘设备、 USB 鼠标设备或自定义 HID 类设备。该芯片接收客户端发送过来的串口数据,并按照HID 类设备规范,将数据先进行打包再通过 USB 口上传给计算机。这款芯片基本特性如下:
●支持 12Mbps 全速USB 传输,兼容 USB V2.0,内置晶振。
●
默认串口通信波特率为 9600bps,支持各种常见波特率。
●
支持 5V 电源电压和3.3V 电源电压。
●
多种芯片工作模式, 适应不同应用需求。
●
多种串口通信模式,灵活切换。
●
支持普通键盘和多媒体键盘功能,支持全键盘功能。
●
支持相对鼠标和绝对鼠标功能。
●
支持自定义 HID 类设备功能,可用于单纯数据传输。
●
支持 ASCII 码字符输入和区位码汉字输入。
●
支持远程唤醒电脑功能。
●
支持串口或 USB 口配置芯片参数。
●
可自行配置芯片的 VID、PID,以及芯片各种字符串描述符。
●
可自行配置芯片的默认波特率。
●
可自行配置芯片通信地址,实现同一个串口下挂载多个芯片。
●
可自行配置回车字符。
●
可自行配置过滤字符串,以便进行无效字符过滤。
●
符合 USB 相关规范,符合HID 类设备相关规范。
●
采用小体积的 SOP-16 无铅封装,兼容RoHS。
对于这次的设计来说,通过串口就能实现USB键盘鼠标,非常方便。确定了芯片之后,接下来即可着手Shield设计了。电路设计如下:
FireBeetle 帮你把手机变成键盘鼠标图3
左侧和中间是 FireBeetle的接口,右侧是USB 公头,右下是CH9329芯片。
下面是CH9329的最小系统电路,芯片内置了晶振,外部只需要一个0.1uf(C1)的电容即可正常工作。
FireBeetle 帮你把手机变成键盘鼠标图1
图中的 Pin1 是用来标志芯片配置完成的引脚(#ACT),Pin2、3、4、5是用来配置芯片功能的引脚,通过组合可以在上电的时候实现芯片的功能选择。
  
工作模式
  
MODE1电平
MODE0 电平
功能说明
模式0
1
1
模拟标准USB键盘+USB鼠标设备+USB自定义HID类设备(默认)
  该模式下CH9329芯片在电脑上识别为USB键盘、USB鼠标和自定义HID类设备的多功能复合设备,USB键盘包含普通键和多媒体键,  USB鼠标包含相对鼠标和绝对鼠标。
  该模式功能最全,可以实现USB键盘和USB鼠标的全部功能。
  
MODE0引脚和MODE1引脚内置了上拉电阻,当这两个引脚悬空时,芯片处于本模式。
模式1
1
0
模拟标准USB键盘设备
  该模式下CH9329芯片在电脑上识别为单一USB键盘设备, USB键盘只包含普通键,不包含多媒体键,支持全键盘模式,适用于部分不支持复合设备的系统。
模式2
0
1
模拟标准USB键盘+USB鼠标设备
  该模式下CH9329芯片在电脑上识别为USB键盘和USB鼠标的多功能复合设备, USB键盘包含普通键和多媒体键, USB鼠标包含相对鼠标和绝对鼠标。
  注: Linux/Android/苹果等操作系统下, 出于兼容性考虑,建议使用该模式。
  
模式3
0
0
模拟标准USB自定义HID类设备
  
该模式下CH9329芯片在电脑上识别为单一USB自定义HID类设备,具有上传和下传2个通道,可以实现串口和HID数据透传功能。CH9329芯片如果接收到串口数据,则打包通过USB上传,如果接收到USB下传数据,则通过串口进行发送。
  
这个模式可以方便用户实现串口转HID。
  
  
串口通信模式
  
CFG1电平
CFG0电平
功能
模式0
1
1
协议传输模式(默认)
  该模式一般适用于既需要使用USB键盘功能,又
  需要使用USB鼠标功能的应用。如果需要使用全
  键盘功能,也建议采用该模式。
  
CFG0引脚和CFG1引脚内置了上拉电阻,当这两个引脚悬空时,芯片处于本模式。
模式1
1
0
ASCII模式
  该模式下客户串口设备向CH9329芯片发送串口
  数据时,可以发送ASCII码字符数据,也可以发
  送区位码汉字数据。
  该模式适用于只需要使用USB键盘中可见ASCII
  字符的应用。
模式2
0
1
透传模式
  该模式下客户串口设备向CH9329芯片发送串口
  数据时,可以是任意16进制数据。
  该模式适用于CH9329芯片处于芯片工作模式3的
  应用。
  
PCB 设计如下:
FireBeetle 帮你把手机变成键盘鼠标图2
3D预览:
FireBeetle 帮你把手机变成键盘鼠标图4

接下来开始手机端程序的设计。经过考察,选择了点灯科技出品的 Blinker,这是一套专业且易用物联网解决方案,提供了服务器、应用、设备端SDK支持。简单便捷的应用配合多设备支持的SDK,可以让开发者在3分钟内实现设备的接入。 点灯服务有三个版本,社区版开源且免费,让大家可以体验到点灯方案的特点和优势;云服务版提供更多增值服务与功能,且有效降低客户的项目实施成本,让客户更快的进行物联网升级;商业版可进行独立部署,可以满足客户更多样的需求。这次我们使用它提供的ESP32 支持通过蓝牙连接FireBeetle 开发板。首先,安装 Arduino 的库,在https://diandeng.tech/dev 页面下载 Arduino 库。之后解压放到 Arduino 的 Library目录下。
FireBeetle 帮你把手机变成键盘鼠标图12
之后,烧写示例文件:
\blinker-library\examples\Blinker_Widgets\Blinker_Button\Button_BLE\Button_BLE.ino
打开手机上的“点灯 Blinker”程序之后开始创建控制设备的应用:
1.创建一个新设备:
FireBeetle 帮你把手机变成键盘鼠标图5
2.添加一个独立设备
FireBeetle 帮你把手机变成键盘鼠标图6
3.选择蓝牙接入
FireBeetle 帮你把手机变成键盘鼠标图7
4.这时手机会执行一个搜索蓝牙设备的动作,这也是为什么要提前刷上一个示例代码的原因
FireBeetle 帮你把手机变成键盘鼠标图8
5.在界面上放置一个输入框(当作键盘用于输入字符),一个摇杆组件(用于控制鼠标)和六个按钮(分别用于实现鼠标左键单击,左键双击,中键单击,右键单击,以及输入键盘回车键)
FireBeetle 帮你把手机变成键盘鼠标图9
6.每个组件可以进行属性的调整,包括显示的文字和名称。
FireBeetle 帮你把手机变成键盘鼠标图10
设置好了之后,在界面上操作数据可以在Arduino 的串口监视器中看到当有事件信息,其中有摇杆的动作、按钮事件和文本框的输入内容。
FireBeetle 帮你把手机变成键盘鼠标图11
接下来就可以进行 Arduino 代码的编写了, 关键代码有:
1.      代码首部加入#define BLINKER_BLE这个定义后, Blinker 库能够帮助用户完成大部分的蓝牙操作,使用者只需要专注于“收到数据如何处理”而不必关心“如何收到数据”。
2.      Setup函数中通过Button1.attach(button1_callback); 绑定按键和处理函数,当按键发生后会自动调用 button1_callback() 函数来处理;
3.       Setup函数中通过Blinker.attachData(dataRead);绑定数据处理函数, dataRead() 函数能够收到输入框和摇杆的数据;

4.      收到的输入框数据是 ASCII 码,通过Asc2Scancode() 函数转化为HID Scancode 再发送给 CH9329 芯片;

  1. #define BLINKER_PRINT Serial
  2. #define BLINKER_BLE
  3. #include <Blinker.h>
  4. //键盘数据
  5. char keypress[]  = {0x57, 0xAB, 0x00, 0x02, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10};
  6. //鼠标数据
  7. char mousemove[] = {0x57, 0xAB, 0x00, 0x05, 0x05, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00};
  8. // 左键单击
  9. BlinkerButton Button1("btn-l1");
  10. // 左键双击
  11. BlinkerButton Button2("btn-l2");
  12. // 右键单击
  13. BlinkerButton Button3("btn-r1");
  14. // 中键单击
  15. BlinkerButton Button4("btn-m1");
  16. // 回车
  17. BlinkerButton Button5("btn-rtn");
  18. // 左键单击
  19. void button1_callback(const String & state) {
  20.   BLINKER_LOG("Left Click ", state);
  21.   // 触发鼠标左键
  22.   mousemove[6] = 0x01;
  23.   SendData((byte*)mousemove, sizeof(mousemove));
  24.   delay(10);
  25.   // 鼠标左键抬起
  26.   mousemove[6] = 0x00;
  27.   SendData((byte*)mousemove, sizeof(mousemove));
  28.   delay(10);
  29. }
  30. // 左键双击
  31. void button2_callback(const String & state) {
  32.   BLINKER_LOG("Left Double Click ", state);
  33.   // 触发鼠标左键
  34.   mousemove[6] = 0x01;
  35.   SendData((byte*)mousemove, sizeof(mousemove));
  36.   delay(10);
  37.   // 鼠标左键抬起
  38.   mousemove[6] = 0x00;
  39.   SendData((byte*)mousemove, sizeof(mousemove));
  40.   delay(20);
  41.   // 再来一次
  42.   mousemove[6] = 0x01;
  43.   SendData((byte*)mousemove, sizeof(mousemove));
  44.   delay(10);
  45.   mousemove[6] = 0x00;
  46.   SendData((byte*)mousemove, sizeof(mousemove));
  47.   delay(20);
  48. }
  49. // 右键单击
  50. void button3_callback(const String & state) {
  51.   BLINKER_LOG("Right Click ", state);
  52.   // 触发鼠标右键
  53.   mousemove[6] = 0x02;
  54.   SendData((byte*)mousemove, sizeof(mousemove));
  55.   delay(10);
  56.   mousemove[6] = 0x00;
  57.   SendData((byte*)mousemove, sizeof(mousemove));
  58.   delay(10);
  59. }
  60. // 中键双击
  61. void button4_callback(const String & state) {
  62.   BLINKER_LOG("Middle Click ", state);
  63.   // 触发鼠标中键
  64.   mousemove[6] = 0x04;
  65.   SendData((byte*)mousemove, sizeof(mousemove));
  66.   delay(10);
  67.   mousemove[6] = 0x00;
  68.   SendData((byte*)mousemove, sizeof(mousemove));
  69.   delay(10);
  70. }
  71. // 回车
  72. void button5_callback(const String & state) {
  73.   BLINKER_LOG("Enter ", state);
  74.   // 键盘回车
  75.   keypress[7] = 0x28;
  76.   SendData((byte*)keypress, sizeof(keypress));
  77.   delay(10);
  78.   keypress[7] = 0;
  79.   SendData((byte*)keypress, sizeof(keypress));
  80.   delay(10);
  81. }
  82. // 将 Buffer 指向的内容,size 长度,计算 checksum 之后发送到Serial2
  83. void SendData(byte *Buffer, byte size) {
  84.   byte sum = 0;
  85.   for (int i = 0; i < size - 1; i++) {
  86.     Serial2.write(*Buffer);
  87.     sum = sum + *Buffer;
  88.     Buffer++;
  89.   }
  90.   *Buffer = sum;
  91.   Serial2.write(sum);
  92. }
  93. // 将ASCII 字符转化为 HID Scancode值
  94. byte Asc2Scancode(byte Asc, boolean *shift) {
  95.   if ((Asc >= 'a') && (Asc <= 'z')) {
  96.     *shift = false;
  97.     return (Asc - 'a' + 0x04);
  98.   }
  99.   if ((Asc >= 'A') && (Asc <= 'Z')) {
  100.     *shift = true;
  101.     return (Asc - 'A' + 0x04);
  102.   }
  103.   if ((Asc >= '1') && (Asc <= '0')) {
  104.     *shift = false;
  105.     return (Asc - '0' + 0x1E);
  106.   }
  107.   if (Asc == '>') {
  108.     *shift = true;
  109.     return (0x37);
  110.   }
  111.   if (Asc == '.') {
  112.     *shift = false;
  113.     return (0x37);
  114.   }
  115.   if (Asc == '_') {
  116.     *shift = true;
  117.     return (0x2D);
  118.   }   
  119.   if (Asc == '-') {
  120.     *shift = false;
  121.     return (0x2D);
  122.   }   
  123.   return 0;
  124. }
  125. // 如果未绑定的组件被触发,则会执行其中内容
  126. // 这里的游戏摇杆和输入框都会在这里处理
  127. void dataRead(const String & data)
  128. {
  129.   BLINKER_LOG("Blinker readString: ", data);
  130.   // 判断是否为游戏摇杆
  131.   if (data.indexOf("joy") != -1) {
  132.     BLINKER_LOG("Joy Move");
  133.     String StrX, StrY;
  134.     // 将摇杆坐标从输入中分离出来
  135.     StrX = data.substring(data.indexOf("[") + 1, data.indexOf(","));
  136.     StrY = data.substring(data.indexOf(",") + 1, data.indexOf("]"));
  137.     BLINKER_LOG("", StrX); BLINKER_LOG("", StrY);
  138.     // 摇杆数据按照鼠标发送出去
  139.     mousemove[7] = map(StrX.toInt(), 0, 255, -127, 127);
  140.     mousemove[8] = map(StrY.toInt(), 0, 255, -127, 127);
  141.     SendData((byte*)mousemove, sizeof(mousemove));
  142.     delay(10);
  143.     mousemove[7] = 0;
  144.     mousemove[8] = 0;
  145.   } else {
  146.     boolean shift;
  147.     byte scanCode;
  148.     for (int i = 0; i < data.length(); i++) {
  149.       BLINKER_LOG("Key In", data.charAt(1));
  150.       // 将收到的 ASCII 转为 ScanCode
  151.       scanCode = Asc2Scancode(data.charAt(i), &shift);
  152.       // 一些按键当有 Shift 按下时会发生转义
  153.       if (scanCode != 0) {
  154.         if (shift == true) {
  155.           keypress[5] = 0x02;
  156.         }
  157.         BLINKER_LOG("Scancode", scanCode);
  158.         // 填写要发送的 ScanCode
  159.         keypress[7] = scanCode;
  160.         SendData((byte*)keypress, sizeof(keypress));
  161.         delay(10);
  162.         keypress[5] = 0x00; keypress[7] = 0;
  163.         SendData((byte*)keypress, sizeof(keypress));
  164.         delay(10);
  165.       }
  166.     }
  167.   }
  168. }
  169. void setup() {
  170.   // 初始化调试串口
  171.   Serial.begin(115200);
  172.   // 初始 CH9329 串口
  173.   Serial2.begin(9600);
  174. #if defined(BLINKER_PRINT)
  175.   BLINKER_DEBUG.stream(BLINKER_PRINT);
  176. #endif
  177.   // 初始化blinker
  178.   Blinker.begin();
  179.   Blinker.attachData(dataRead);
  180.   Button1.attach(button1_callback);
  181.   Button2.attach(button2_callback);
  182.   Button3.attach(button3_callback);
  183.   Button4.attach(button4_callback);
  184.   Button5.attach(button5_callback);
  185. }
  186. void loop() {
  187.   Blinker.run();
  188. }
复制代码

本文提到的 PCB 和电路图下载附件Ch9329 FireBeetle.zip


image008.png (125.5 KB, 下载次数: 5608)

FireBeetle · 手机变键盘鼠标 | DF创客社区_image_3.webp

创作许可协议

本项目采用 None(不开放任何权利,保留所有权利) 进行许可。

评论(12)
派大星ym
派大星ym
,,,,
俺是胡胡
俺是胡胡
点个赞顶顶顶顶顶顶顶
zoologist
zoologist
作者
FireBeetle ESP32 代码

诩
诩
视频建议可以做精一点
可以放在文章开头镇帖
作品很好
那么问题来了:
这个作品在生活中是否能给我们带来什么帮助吗?求回复,
谢谢
诩
诩回复zoologist
嗯嗯
zoologist
zoologist
作者
回复诩
差不多吧,可以同时实现键盘和鼠标的功能
共5条回复,已加载2条,点击查看更多共5条回复,已加载全部
三春牛-创客
三春牛-创客
很实用!!
三春牛-创客
三春牛-创客
好好好好好
三春牛-创客
三春牛-创客
赞赞赞赞赞
三春牛-创客
三春牛-创客
呵呵呵呵
三春牛-创客
三春牛-创客
哈哈哈哈
三春牛-创客
三春牛-创客
厉害厉害
三春牛-创客
三春牛-创客
666666666666
zoologist
zoologist
作者
工作的视频在
[media=x,500,375]https://www.bilibili.com/video/BV1f34y1s7ij/[/media]
- 没有更多了 -