鸿蒙群控鸿蒙蓝牙HIDHarmonyOS

鸿蒙群控除了插线还能走蓝牙?ESP32 板子从买到能用

鸿蒙群控的蓝牙 HID 方案怎么落地:ESP32-C3 和 S3 怎么选、焊接与不焊固件的区别、刷固件与绑定 BLE 的步骤、测试通路、串口与 WiFi 两种通信方式,以及点击偏移和连不上的常见原因。

约 5 分钟

为什么鸿蒙要留一条蓝牙通道

在鸿蒙 Next(HarmonyOS Next)上,鸿蒙群控的默认做法是插数据线,一根线对应一台设备,稳定、延迟低。但设备多起来之后,问题就来了:USB 口不够、线材堆成一团、机柜里的走线越来越难维护。

鸿蒙蓝牙 HID 就是给这种场景准备的。它的思路是把手机当成一个 HID Host,也就是外接键盘鼠标的角色:电脑或中控通过串口或 WiFi 连一块 ESP32 开发板,板子再对手机发蓝牙 HID 指令。对手机来说,它感觉不到这是个程序,只当接了一个键盘。

这条路和鸿蒙自动化脚本服务、鸿蒙投屏、USB HID 都不冲突,可以单独用,也可以组合用。比如截图找图走自动化通道,点击走蓝牙板,两条通道各干各的。这也是蓝牙群控方案最实用的地方:把控制通道单独拎出来,不占自动化通道。

先搞清楚要买什么

板子要自己买,淘宝、拼多多、1688 都有,固件是免费的。买之前有三个选择要确定,选错了就得重刷:

芯片型号,ESP32-C3 或 ESP32-S3 都支持,固件分别对应。

板型,分焊接引脚和不焊引脚两种,固件也是分开的。

功能版本,务必选含键盘的那一版。HOME 键、按键、快捷键这些都依赖键盘 HID,缺了这一版,系统键和快捷键就用不了。

用于鸿蒙群控蓝牙 HID 的 ESP32 开发板实物

固件在网盘的产品资源里找,路径是鸿蒙资源文件夹下的 USB 版本、再进蓝牙固件。这里有个坑:别刷 iOS USB 专用的蓝牙固件,那是给 iOS 平台的板子用的。刷写步骤本身和安卓一致。

刷完固件先绑定

刷好之后给板子重新上电,然后在鸿蒙中控里绑定。中控选中一台已连接的设备,右键进蓝牙 HID 设置,点绑定蓝牙 BLE。

鸿蒙中控里蓝牙 HID 设置中绑定蓝牙 BLE 并选择串口

弹出的对话框里选串口。如果列表是空的,先取消只显示未绑定这类筛选再点强制刷新;还是找不到,直接在 MAC 输入框里填蓝牙 MAC 的后 8 位也能绑上。

蓝牙 MAC 从哪来?开发板的蓝牙名称一般就是 MAC 的后 8 位,中控在绑定串口时也会自动读出来。建议买回来就在板子上贴个标签写好这 8 位,手机侧也可以贴一张对应的,多机管理时省时间。

绑定成功后,中控设备列表里的蓝牙 MAC 一栏会显示出刚绑的硬件地址。这里的对应关系是 UDID 对 bleMac,一个手机绑一块板。

测试通路再往下走

绑完别急着写脚本,先测通路。

在手机的设置、蓝牙里搜索并配对这块开发板,名称就是 MAC 后 8 位,图标可能显示成键盘或者鼠标。

然后回中控右键进蓝牙 HID 设置,点测试蓝牙 BLE,选通信方式(默认串口),点触控长按或者 HOME 按键。手机有反应,说明整条通路是通的。

鸿蒙中控蓝牙 HID 设置里的测试面板发送触控长按与按键

没反应的话,按这个顺序试:手机上忽略该设备后重新配对,开发板按 RST 重启,然后再测一次。

串口还是 WiFi

板和电脑之间的通信有两种方式,脚本里用不同的参数切换:串口模式适合开发板直接接在电脑上,不用额外配网;网络模式需要先往开发板里写入 WiFi 账号密码,之后走网络通信。

中控里对应的入口是蓝牙 HID 设置下的设置 WiFi 信息。配完重启开发板,中控会扫描开发板 IP,成功后设备列表里的硬件 IP 一栏就能看到。

一般不需要手工干预,中控启动且绑定关系正确时会自动扫描。选哪种取决于你的机柜形态:板子集中在电脑附近就用串口,板子分散到设备旁边就用 WiFi。

点击偏移和连不上

蓝牙方案有它自己的一类问题,跟插线那套不一样。

点击偏移通常有三个原因。最常见的是脚本里没调用设置屏幕尺寸的接口——蓝牙点击走的是绝对像素坐标,不先告诉它屏幕宽高,坐标就对不上,横竖屏切换之后还要重新设一次。第二个是通信方式选错,比如串口被占用、或者板子没配网却选了网络模式。第三个是绑定的 MAC 和当前串口不是同一块板。

蓝牙连不上的处理也有固定套路:按住开发板上的 RST 约 5 秒再松开,手机上忽略该设备后重新搜索。要记住一块板同时只连一台手机,连接成功后蓝牙名称可能会隐藏;换绑前先在手机上断开并忽略,再按 RST。

开发板的灯语能帮上忙:配对成功常亮约三秒后熄灭,蓝牙断开慢闪约十次,查找蓝牙快闪约十五次。看灯就能判断板子处在什么状态。

还有一条容易漏的:手机侧要在蓝牙设置里完成配对并保持蓝牙开启,配对后如果系统弹出键盘、鼠标或输入设备的权限确认,要点允许。开发者选项里的 USB 调试是给自动化和截图用的,和 BLE 配对不能互相替代。


关于 EasyClick:手机自动化 AI 智能体平台,覆盖安卓免 root、iOS 免越狱、鸿蒙 Next 三大生态,提供脚本开发、苹果群控、本地中控投屏与云控系统。→ 了解全部产品

想要真实跑起来?

本文介绍的方案均可在 EasyClick 手机自动化平台落地。官网提供完整文档、开发工具与群控云控产品,免费体验。

访问 EasyClick 官网 →