手摸手教你使用 Ai-WB2（BL602）做一个自动刷抖音工具

[bzhou830]

本文把一块 Ai-WB2（BL602）伪装成"蓝牙触摸屏"，让它替你的手指在屏幕上划一下 —— 于是抖音就翻到下一个视频了。

适合谁看：玩过 WB2 / BL602、点过灯、跑过 FreeRTOS，但从没碰过蓝牙 HID 的朋友。
本文会先把"刷抖音"这件事的原理掰开揉碎，再一行一行把代码写出来。

你会得到什么：一个能连上安卓手机、按一下板子上的键（或者完全不用按）就自动刷抖音的小玩意儿，
外加对 BLE HID 设备开发的完整认知 —— 键盘、鼠标、触摸屏三条路的区别你都会搞明白。

---

目录

• 〇、先讲个故事：一个关于腱鞘炎的严肃技术问题
• 一、原理篇：刷抖音这个动作，到底发生了什么
• 二、开工前的准备
• 三、搭工程
• 四、核心关卡：HID Report Map 怎么写
• 五、把描述符挂到 GATT 上
• 六、滑动手势：从"点一下"到"划一下"
• 七、按键与自动刷
• 八、编译
• 九、烧录
• 十、效果展示与验证
• 十一、踩坑大全
• 十二、进阶玩法
• 十三、小结

---

〇、一个关于腱鞘炎的严肃技术问题

事情是这样的。

某天你躺在床上刷抖音，刷了三个小时，大拇指从"灵活"刷到了"半身不遂"。你盯着天花板，产生了一个朴素的想法：

能不能让机器替我划？

你打开某宝，搜"刷视频神器"，出来一堆几十块钱的小玩意儿：一个小夹子，夹在手机上，伸出一根"机械手指"，啪嗒啪嗒地在屏幕上点。或者一个蓝牙小遥控器，按一下切一个视频。

前一种是物理外挂（笨重、吵、还挑手机壳），后一种是蓝牙 HID 设备——也就是我们今天要自己焊（其实不用焊）的那个。

而且自制有个巨大优势：淘宝货你不知道它在干嘛，自己写的你知道每一个字节。

好，那问题来了：一个蓝牙小盒子，凭什么能让抖音翻页？

---

一、原理篇：刷抖音这个动作，到底发生了什么

这一章是全文最重要的部分。搞懂了它，后面写代码就是体力活；跳过了它，你会写出一个"能连上但就是不动"的玩意儿，然后怀疑人生。

1.1 你的手指，其实一直在"骗"手机

我们来做个思想实验：你的手指在屏幕上从下往上一抹，抖音就换了个视频。

这一抹，手机内部经历了什么？

1. 手指（导体）靠近屏幕，改变了那一块区域的电容；
2. 触摸屏控制器扫描到电容变化，算出"有个东西在坐标 (540, 1800) 这儿"；
3. 驱动把它包装成内核输入事件，往上报；
4. Android 的 InputReader 收到一堆原始事件，认出这是"一个手指先按下、再移动、再抬起"；
5. 于是生成一串 MotionEvent 送给前台 App：
   • ACTION_DOWN —— 手指按下
   • ACTION_MOVE × N —— 手指移动（N 通常十几个到几十个）
   • ACTION_UP —— 手指抬起
6. 抖音收到这一串事件，一算速度："哦，往上划的，够快"，于是切下一个视频。

关键点：抖音认的不是"某个按键"，而是一串有速度、有方向的连续触摸事件。

这就决定了我们的技术路线 —— 我们得想办法伪造出这么一串事件。

1.2 Android 的输入流水线

简单画一下：

手指 / 触摸屏 / 蓝牙 HID 设备
              │
              ▼
   ┌──────────────────────┐
   │  内核 input 子系统    │  ← 不管是真屏幕还是蓝牙设备，都在这儿汇合
   │  (evdev / hid)       │
   └──────────────────────┘
              │
              ▼
   ┌──────────────────────┐
   │  InputReader/InputFlinger │  ← 判断"这是点击还是滑动"
   └──────────────────────┘
              │
              ▼
   ┌──────────────────────┐
   │  MotionEvent → App   │  ← 抖音在这儿等你
   └──────────────────────┘

> 上面这张图把"WB2 伪装的蓝牙触摸屏"和"你那根肉手指"在系统里的地位画了出来： > 它们在**内核 input 子系统**这一层就汇合了，后面的识别逻辑完全共用 —— 这是整件事能成立的地基。

这张图里藏着一个天大的好消息：

真触摸屏和蓝牙 HID 设备，在"内核 input 子系统"这一层就汇合了。
往上走的路一模一样。

换句话说，只要我们的蓝牙设备能上报"标准的触摸屏数据"，Android 根本分不清这到底是你那根肉手指，还是一块 WB2 开发板。它俩在系统眼里是平等的。

这就是整件事的理论基础。

1.3 蓝牙 HID 的三张脸

BLE HID（准确叫 HOGP，HID over GATT）允许一个设备把自己伪装成好几种输入设备。常见的有三张脸：

脸	用途	能刷抖音吗
键盘	发按键码（A、回车、方向键…）	❌ 抖音手机版不认方向键（那套 Z/X/C/↑↓ 快捷键是网页版的）
鼠标	发相对位移 + 按键	❌ 见下节，这是最大的坑
触摸屏	发绝对坐标 + 触摸状态	✅ 正解

1.4 一个 bit 的差距：Rel 和 Abs

很多人（包括我第一次做的时候）会想："鼠标也能移动光标，我让光标从屏幕底下移到上面不就完了？"

不行。 原因在一个 bit 上。

在 HID 报告描述符里，Input 这一项的最后一个字节决定了坐标是"相对"还是"绝对"：

0x81, 0x06,   /* Input (Data,Var,Rel)  ← Rel = Relative，相对位移，鼠标 */
0x81, 0x02,   /* Input (Data,Var,Abs)  ← Abs = Absolute，绝对坐标，触摸屏 */

区别在哪？

• 相对（Rel）：报文里的数字是"位移量"。发 X=+20, Y=-30 意思是"往右下挪 20 和 30"，不是"移动到 (20, 30)"。Android 收到后，就在屏幕上画一个小箭头，然后平移一小段。它没有"按住-拖动"的概念，所以刷不动信息流。
• 绝对（Abs）：报文里的数字是"坐标值"。发 X=500, Y=780 就是"手指在 (500, 780) 这个位置"。Android 收到一串坐标 + 按下标志，就能拼出完整的滑动手势。

就这一个 bit，决定了你的设备是"能刷抖音"还是"只能画个光标"。

💡 顺便说一句，Android 上你连蓝牙鼠标时看到的那个小箭头，就是相对坐标的产物。它能点、能滚轮，但没法"按住拖"，也就没法刷信息流。

1.5 灵魂拷问：我哪知道你手机分辨率多少？

既然要发绝对坐标，那坐标范围怎么定？

手机分辨率千奇百怪：1080×2400、1080×2340、1440×3200、还有一加那种异形屏……难道我要在固件里内置一张分辨率表？

不用。 这里有个省事到有点狡猾的技巧：

在报告描述符里，我们自己声明坐标范围：

0x15, 0x00,        /* Logical Minimum (0)     */
0x26, 0xE8, 0x03,  /* Logical Maximum (1000)  ← 就写 1000，爱谁谁 */

Android 读到 Logical Maximum = 1000 之后，会把 0~1000 线性映射到屏幕真实像素。

于是：

• 我们发 Y = 780 → 在任何手机上都是"屏幕高度 78% 的位置"
• 我们发 Y = 260 → 在任何手机上都是"屏幕高度 26% 的位置"

固件完全不需要知道手机分辨率。 1080×2400 也好、4K 折叠屏也好，通用。

这个技巧叫"归一化坐标"，是整个方案能落地的关键之一。

1.6 野路子：音量键翻页

在查资料的过程中，我发现抖音其实留了个后门：设置 → 通用设置 → 音量键翻页，打开之后，按手机音量键就能切视频。

那思路就简单多了：把 WB2 伪装成多媒体键盘（Consumer Control），发一个"音量+"就完事。

	触摸屏方案	音量键方案
代码量	中等（要说清楚描述符）	极小（3 行）
要不要动手机设置	不用	要去抖音里开"音量键翻页"
通用性	所有 App 通吃（快手、B站、小红书…）	只在这个 App 里有效
会不会改变系统音量	不会	会（顺带把媒体音量也调了）
逼格	⭐⭐⭐⭐⭐	⭐⭐

结论：音量键方案简单，但要看 App 脸色，还会顺手改你音量。

所以本文以触摸屏方案为主（默认配置），同时把音量键方案也做进固件里（一个宏切换），你可以两个都试试，体会一下区别。

1.7 最终方案

┌─────────────────────────────────────────────┐
│              WB2 (BL602)                     │
│                                              │
│  GPIO12 按键 ──→ swipe_up()                  │
│                     │                        │
│                     ▼                        │
│              touch_send() × 18 帧            │
│                     │                        │
│                     ▼                        │
│         BLE GATT Notification                │
└─────────────────┬───────────────────────────┘
                  │
                  ▼
┌─────────────────────────────────────────────┐
│              Android 手机                    │
│                                              │
│   HIDS 0x1812 (Report ID 1 = 触摸屏)         │
│   BAS  0x180F (电量)                         │
│                                              │
│   → MotionEvent: DOWN → MOVE×16 → UP         │
│                     │                        │
│                     ▼                        │
│              抖音：下一个视频 ✨               │
└─────────────────────────────────────────────┘

---

二、开工前的准备

2.1 硬件清单

东西	说明	备注
Ai-WB2 开发板	主控 BL602，RISC-V，Wi-Fi 4 + BLE 5.0	本文用 bl602dk
USB 数据线	供电 + 烧录 + 串口日志	注意要能传数据的，别拿充电线
安卓手机	Android 6.0+（本文方案对蓝牙 HID 触摸屏的支持很稳）	iOS 对第三方 HID 限制多，不保证
按键	接 GPIO12，或直接用板载按键	内部上拉，按下接地即可

接线？不用接线。 GPIO12 内部已经开了上拉，你拿个杜邦线一头接 GPIO12、一头碰一下 GND，就算"按下"了。想优雅点就焊个轻触开关。

2.1.1 接线详解（其实超简单）

如果你懒得焊，拿一根杜邦线一头怼 GPIO12、另一头碰一下 GND，就等于"按了一次键"。想正经一点，焊个轻触开关：

要点：GPIO12 用内部上拉，按键把引脚拉到 GND 即触发（下降沿检测，见 main.c:599）。

信号	接法	说明
GPIO12	轻触开关一端	片上已开内部上拉（见 main.c:694 的 GPIO_PULLUP）
GND	轻触开关另一端	按下时 GPIO12 被拉低 → 下降沿触发
3.3V	不接	上拉由芯片内部完成，无需外挂电阻

没有轻触开关？开发板上的 BOOT / RST 之类别乱碰。就用杜邦线碰 GND 最稳。
想换别的 GPIO？改 main.c:50 的 SWIPE_BTN_PIN 即可（注意引脚要支持 GPIO 输入模式）。

2.2 软件环境

项目	路径 / 版本	用途
bouffalo_sdk	D:/bouffalo_sdk	博流官方 SDK
RISC-V 工具链	D:/toolchain_gcc_t-head_windows/bin	T-Head riscv64-unknown-elf-gcc
make	D:/bouffalo_sdk/tools/make/make	Windows 原生 make
串口工具	任意（115200 波特率）	看日志、烧录

⚠️ 路径按你本机的实际情况改。下面所有命令假设你用的就是这两个路径。

2.3 先验证环境能用

# 在 Git Bash 里执行
export PATH="/d/toolchain_gcc_t-head_windows/bin:$PATH"
riscv64-unknown-elf-gcc --version

能看到版本号就说明工具链没问题。

---

三、搭工程

3.1 目录结构

ble_douyin_swiper/
├── main.c              # 全部实现：触摸屏 HID、广播、按键任务、电量
├── CMakeLists.txt      # 工程名 + 主文件
├── Makefile            # 复用 bouffalo_sdk 的 project.build
├── defconfig           # 关闭 SHELL/BREDR/MESH，开启 BLUETOOTH/RF/BT_SETTINGS
├── flash_prog_cfg.ini  # 烧录分区表
├── FreeRTOSConfig.h    # FreeRTOS 配置
├── Kconfig             # 工程 Kconfig
└── build/              # 编译产物

3.2 创建工程

如果你已经有一个能编译的 BL602 BLE 工程（比如上一节的 ble_keyboard_down），直接把它的配置骨架复制过来最快：

mkdir ble_douyin_swiper
cd ble_douyin_swiper
cp ../ble_keyboard_down/{CMakeLists.txt,FreeRTOSConfig.h,Kconfig,defconfig,Makefile,.gitignore,flash_prog_cfg.ini} .

然后改两个地方，把工程名换掉：

CMakeLists.txt：

project(ble_douyin_swiper)     # ← 原来是别的名字

flash_prog_cfg.ini：

[FW]
filedir = ./build/build_out/ble_douyin_swiper*_$(CHIPNAME)*.bin
address = @partition

⚠️ flash_prog_cfg.ini 里的文件名模板必须和 CMakeLists.txt 里的 project() 对上，
否则烧录时会报"找不到固件文件"。

3.3 defconfig 关键点

这几个开关决定了 BLE 栈能不能起来：

CONFIG_BLUETOOTH =y
CONFIG_RF =y
CONFIG_BT_SMP =y          # 配对加密，手机连 HID 设备一般要求
CONFIG_BT_SETTINGS =y     # 保存配对信息，不然每次重连都要重新配对
CONFIG_BT_STACK_CLI =n    # 关掉，否则会去 include cli.h 然后报找不到
CONFIG_BT_MESH =n

---

四、核心关卡：HID Report Map 怎么写

4.1 描述符是个啥（一句话版）

报告描述符（Report Map）就是一份"自我说明书"：设备告诉主机"我接下来发的这串字节，第几个字节到第几个字节是什么意思"。

它不是给人看的，是给主机的 HID 解析器看的。你写错了，主机就理解错 —— 或者干脆不理你。

一个描述符由很多"条目（Item）"组成，每个条目 1~3 字节：

[前缀字节] [数据字节...]

常用的前缀：

前缀	含义	例子
0x05	Usage Page（用途页）	0x05, 0x0D = Digitizer（数字化仪/触摸）
0x09	Usage（用途）	0x09, 0x04 = Touch Screen
0xA1	Collection（集合开始）	0xA1, 0x01 = Application
0xC0	End Collection（集合结束）
0x85	Report ID	0x85, 0x01 = 这是 1 号报告
0x15	Logical Minimum	值域下限
0x25/0x26	Logical Maximum	值域上限（1 字节 / 2 字节）
0x75	Report Size（每个字段多少 bit）	0x75, 0x10 = 16 bit
0x95	Report Count（几个这样的字段）	0x95, 0x02 = 2 个
0x81	Input（输入字段）	0x81, 0x02 = 绝对坐标

4.2 触摸屏描述符逐行解剖

这是本工程的灵魂（main.c:121）。我们一段一段来看：

0x05, 0x0D,        /* Usage Page (Digitizer)              */
0x09, 0x04,        /* Usage (Touch Screen)                */
0xA1, 0x01,        /* Collection (Application)            */

"你好主机，我是一块触摸屏。" —— 0x0D 是 Digitizer 用途页，0x04 是 Touch Screen。

0x85, 0x01,        /*   Report ID (1)                     */

"我下面这些数据，编号是 1 号报告。"

0x09, 0x22,        /*   Usage (Finger)                    */
0xA1, 0x02,        /*   Collection (Logical)              */

"我要描述的是'一根手指'。" —— 一个描述符里可以有多个 Finger 集合（多点触控），我们只需要一根。

0x09, 0x42,        /*     Usage (Tip Switch)              */ ← 笔尖/手指是否接触
0x09, 0x32,        /*     Usage (In Range)                */ ← 是否在感应范围内
0x15, 0x00,        /*     Logical Minimum (0)             */
0x25, 0x01,        /*     Logical Maximum (1)             */
0x75, 0x01,        /*     Report Size (1)                 */
0x95, 0x02,        /*     Report Count (2)                */
0x81, 0x02,        /*     Input (Data,Var,Abs)            */

"开头 2 个 bit：第 0 位是'手指按下了吗'，第 1 位是'手指在感应范围内吗'。0 或 1。"

• Tip Switch = 1 表示"手指按在屏幕上"
• In Range = 1 表示"手指悬在能感应到的范围内"
• 手势期间这俩都置 1，抬手时都清 0

0x75, 0x01,        /*     Report Size (1)                 */
0x95, 0x06,        /*     Report Count (6)                */
0x81, 0x01,        /*     Input (Const) 填充 6 bit        */

"再来 6 个 bit 的填充，凑满 1 个字节。" —— 0x81, 0x01 的 Const 表示"这是常量，别管"。

HID 是按字节对齐的，前面只用了 2 bit，得补齐 8 bit 才能开始下一个字段。

0x05, 0x01,        /*     Usage Page (Generic Desktop)    */
0x09, 0x30,        /*     Usage (X)                       */
0x09, 0x31,        /*     Usage (Y)                       */
0x15, 0x00,        /*     Logical Minimum (0)             */
0x26, 0xE8, 0x03,  /*     Logical Maximum (1000)          */
0x35, 0x00,        /*     Physical Minimum (0)            */
0x45, 0x00,        /*     Physical Maximum (0)            */
0x55, 0x00,        /*     Unit Exponent (0)               */
0x65, 0x00,        /*     Unit (None)                     */
0x75, 0x10,        /*     Report Size (16)                */
0x95, 0x02,        /*     Report Count (2)                */
0x81, 0x02,        /*     Input (Data,Var,Abs) X,Y        */

"然后是 X 和 Y，各 16 bit（小端），范围 0~1000。注意是绝对的。" ← 就是这里！

0x26, 0xE8, 0x03 = 0x03E8 = 1000（小端：低字节在前）。

最后的 0x81, 0x02 里的 0x02 就是 Absolute。改成 0x06 你就得到一个鼠标了 —— 然后发现刷不动抖音。 别问我怎么知道的。

0xC0,              /*   End Collection (Logical)          */
0xC0,              /* End Collection (Application)        */

"描述完毕。"

4.3 所以 5 字节报文长这样

字节	内容
byte0	bit0 = Tip Switch，bit1 = In Range，bit2~7 = 0
byte1	X 低 8 位
byte2	X 高 8 位
byte3	Y 低 8 位
byte4	Y 高 8 位

举例：手指按在 (500, 780)：

0x03, 0xF4, 0x01, 0x0C, 0x03
  │     └─────┬──┘  └─────┬──┘
  │          X=500       Y=780
  └─ bit0=1(Tip) bit1=1(InRange)

（500 = 0x01F4，小端就是 F4 01；780 = 0x030C，小端是 0C 03。）

4.4 Consumer 描述符：为什么必须是"位图"

第二路报告（Report ID 2）是多媒体键，用于音量键方案。它有个坑，值得单独讲：

0x75, 0x01,        /*   Report Size (1)                   */
0x95, 0x08,        /*   Report Count (8)                  */
0x05, 0x0C,        /*   Usage Page (Consumer)             */
0x09, 0xE9,        /*   Usage (Volume Increment)   bit0   */
0x09, 0xEA,        /*   Usage (Volume Decrement)   bit1   */
...
0x81, 0x02,        /*   Input (Data,Var,Abs)              */

每个功能占 1 个 bit，8 个功能正好 1 字节。全 0 = 全部松开。

为什么不能用 Report Size=16 / Count=1 配 6 个 usage？

因为那样是畸形描述符 —— 字段数（1 个 16 位字段）和 usage 数（6 个）对不上。后果很阴间：主机解析时会认为"全 0 的帧不合法"，直接丢弃。

于是你发"按下音量+"能生效，但发"松开"（全 0）被丢了 —— 键就永远卡在按下状态。在 Windows 上的表现是：音量一路飙到最大，停不下来。

这个坑是真实踩过的（参考工程 ble_hid_selfie 的 cccbd17 那次提交修的就是它）。
记住：bit 位图，Report Size=1，Count 等于 usage 数量。

4.5 完整描述符

main.c:121 的完整内容（已验证可用）：

static const u8_t report_map[] = {
    /* ===== Report ID 1: Touch Screen (Digitizer) ===== */
    0x05, 0x0D,        /* Usage Page (Digitizer)              */
    0x09, 0x04,        /* Usage (Touch Screen)                */
    0xA1, 0x01,        /* Collection (Application)            */
    0x85, 0x01,        /*   Report ID (1)                     */
    0x09, 0x22,        /*   Usage (Finger)                    */
    0xA1, 0x02,        /*   Collection (Logical)              */
    0x09, 0x42,        /*     Usage (Tip Switch)              */
    0x09, 0x32,        /*     Usage (In Range)                */
    0x15, 0x00,        /*     Logical Minimum (0)             */
    0x25, 0x01,        /*     Logical Maximum (1)             */
    0x75, 0x01,        /*     Report Size (1)                 */
    0x95, 0x02,        /*     Report Count (2)                */
    0x81, 0x02,        /*     Input (Data,Var,Abs)            */
    0x75, 0x01,        /*     Report Size (1)                 */
    0x95, 0x06,        /*     Report Count (6)                */
    0x81, 0x01,        /*     Input (Const) 填充 6 bit        */
    0x05, 0x01,        /*     Usage Page (Generic Desktop)    */
    0x09, 0x30,        /*     Usage (X)                       */
    0x09, 0x31,        /*     Usage (Y)                       */
    0x15, 0x00,        /*     Logical Minimum (0)             */
    0x26, 0xE8, 0x03,  /*     Logical Maximum (1000)          */
    0x35, 0x00,        /*     Physical Minimum (0)            */
    0x45, 0x00,        /*     Physical Maximum (0)            */
    0x55, 0x00,        /*     Unit Exponent (0)               */
    0x65, 0x00,        /*     Unit (None)                     */
    0x75, 0x10,        /*     Report Size (16)                */
    0x95, 0x02,        /*     Report Count (2)                */
    0x81, 0x02,        /*     Input (Data,Var,Abs) X,Y        */
    0xC0,              /*   End Collection (Logical)          */
    0xC0,              /* End Collection (Application)        */

    /* ===== Report ID 2: Consumer Control（1 字节位图）===== */
    0x05, 0x0C,        /* Usage Page (Consumer)               */
    0x09, 0x01,        /* Usage (Consumer Control)            */
    0xA1, 0x01,        /* Collection (Application)            */
    0x85, 0x02,        /*   Report ID (2)                     */
    0x15, 0x00,        /*   Logical Minimum (0)               */
    0x25, 0x01,        /*   Logical Maximum (1)               */
    0x75, 0x01,        /*   Report Size (1)                   */
    0x95, 0x08,        /*   Report Count (8)                  */
    0x05, 0x0C,        /*   Usage Page (Consumer)             */
    0x09, 0xE9,        /*   Usage (Volume Increment)   bit0   */
    0x09, 0xEA,        /*   Usage (Volume Decrement)   bit1   */
    0x09, 0xE2,        /*   Usage (Mute)               bit2   */
    0x09, 0xCD,        /*   Usage (Play/Pause)         bit3   */
    0x09, 0xB5,        /*   Usage (Scan Next Track)    bit4   */
    0x09, 0xB6,        /*   Usage (Scan Prev Track)    bit5   */
    0x09, 0xB7,        /*   Usage (Stop)               bit6   */
    0x09, 0xB1,        /*   Usage (Pause)              bit7   */
    0x81, 0x02,        /*   Input (Data,Var,Abs)              */
    0xC0               /* End Collection                      */
};

---

五、把描述符挂到 GATT 上

5.1 HIDS 属性表

描述符写好了，得通过 GATT 暴露给手机。HIDS（0x1812）服务的属性表长这样（main.c:322 起）：

索引	特征 / 描述符	UUID	属性
0	HID Service	0x1812	Primary
1-2	Protocol Mode	0x2A4E	Read + WriteWithoutResp
3-4	Report Map	0x2A4B	Read
5-6	HID Information	0x2A4A	Read
7-8	HID Control Point	0x2A4C	WriteWithoutResp
9-10	Touch Input Report	0x2A4D	Read + Write + Notify
11	├ CCC	0x2902	Read + Write
12	└ Report Reference	0x2908	Read（id=1, type=Input）
13-14	Consumer Input Report	0x2A4D	Read + Write + Notify
15	├ CCC	0x2902	Read + Write
16	└ Report Reference	0x2908	Read（id=2, type=Input）

对应代码：

/* ---- Input Report 1: Touch Screen (Report ID 1) ---- */
BT_GATT_CHARACTERISTIC(BT_UUID_HIDS_REPORT,
                       BT_GATT_CHRC_READ | BT_GATT_CHRC_WRITE | BT_GATT_CHRC_NOTIFY,
                       BT_GATT_PERM_READ | BT_GATT_PERM_WRITE,
                       read_report, write_report, &touch_report),
BT_GATT_CCC(touch_ccc_changed, BT_GATT_PERM_READ | BT_GATT_PERM_WRITE),
BT_GATT_DESCRIPTOR(BT_UUID_HIDS_REPORT_REF,
                   BT_GATT_PERM_READ,
                   read_report_ref, NULL, (void *)&touch_report_ref),

5.2 Report Reference：主机怎么知道"这条特征 = 那个 Report ID"

注意上面那个 BT_UUID_HIDS_REPORT_REF（0x2908）描述符。它的值是：

static const struct hids_report_ref touch_report_ref = {
    .id = 0x01, .type = 0x01,      /* Report ID 1, Input Report */
};

这就是告诉主机："这条 GATT 特征承载的是 1 号报告，类型是 Input。"

有它之后，空中报文里就不需要带 Report ID 前缀了 —— 主机靠这个描述符就能把特征和 Report ID 对上。

另一种做法是报文首字节带 Report ID（比如发 01 03 F4 01 0C 03）。两种都合法，
但不能混用：描述符里声明了 Report ID、报文却不带前缀、同时又没有 Report Reference 描述符，
主机会直接把报文丢掉。

本文用的是"Report Reference + 不带前缀"的接法。

5.3 索引怎么数：记住 +4 规律

bt_gatt_notify() 需要你告诉它"往哪个特征发"，用的是属性数组下标：

bt_gatt_notify(conn, &hids.attrs[TOUCH_INPUT_REPORT_VAL_IDX], buf, sizeof(buf));

下标怎么算？每路 Report 占 4 个属性（声明 + 值 + CCC + Report Reference）。

• 前面固定部分（服务声明 + Protocol Mode + Report Map + HID Info + Control Point）= 9 个
• 第 1 路 Report 的值属性 = 9 + 1 = 10
• 第 2 路 Report 的值属性 = 10 + 4 = 14
• 第 3 路（如果还有）= 18

#define TOUCH_INPUT_REPORT_VAL_IDX     10
#define CONSUMER_INPUT_REPORT_VAL_IDX  14

🔢 规律：第 N 路 Input Report 的值索引 = 10 + (N-1) × 4

5.4 READ|WRITE|NOTIFY 一个都不能少

这一条值得单独加粗：

BT_GATT_CHRC_READ | BT_GATT_CHRC_WRITE | BT_GATT_CHRC_NOTIFY

千万别为了"简化"把它改成 NOTIFY only。

Windows 的 HID 驱动在枚举设备时会先 Read 一次 Input Report 取初始状态。不可读 → 初始化失败 → 后面收多少 Notification 都不理你。

现象极具迷惑性：设备能连上、能配对、串口日志显示报文发出去了，但按键死活没反应。

（这条是踩坑换来的，详见项目里的另一篇教程。）

5.5 电量服务（BAS）

顺手把标准电量服务也挂上，手机设置里能显示电量，显得很专业：

static struct bt_gatt_attr battery_attrs[] = {
    BT_GATT_PRIMARY_SERVICE(BT_UUID_BAS),
    BT_GATT_CHARACTERISTIC(BT_UUID_BAS_BATTERY_LEVEL,
                           BT_GATT_CHRC_READ | BT_GATT_CHRC_NOTIFY,
                           BT_GATT_PERM_READ,
                           read_u8, NULL, &battery_level),
    BT_GATT_CCC(battery_ccc_changed, BT_GATT_PERM_READ | BT_GATT_PERM_WRITE),
};

电量值来自一个弱函数，默认返回 100：

__attribute__((weak)) u8_t read_battery_level(void)
{
    return 100;
}

想接真实电量？在你自己的 .c 里重写它，用 ADC 读 VBAT 分压，映射到 0~100 就行。

---

六、滑动手势：从"点一下"到"划一下"

6.1 上报一帧触摸（main.c:494）

/* tip: 1 = 手指按着, 0 = 抬手
 * x/y: 归一化坐标 0..1000 */
static void touch_send(u8_t tip, u16_t x, u16_t y)
{
    struct bt_conn *conn = default_conn;
    u8_t buf[5];

    if (!conn || !touch_notify) {
        return;
    }

    /* byte0: bit0 = Tip Switch, bit1 = In Range */
    buf[0] = tip ? 0x03 : 0x00;
    buf[1] = (u8_t)(x & 0xFF);        /* X 低 8 位 */
    buf[2] = (u8_t)(x >> 8);          /* X 高 8 位 */
    buf[3] = (u8_t)(y & 0xFF);        /* Y 低 8 位 */
    buf[4] = (u8_t)(y >> 8);          /* Y 高 8 位 */

    memcpy(touch_report.buf, buf, sizeof(buf));

    printf("[TOUCH] %s X=%u Y=%u  (%02X %02X %02X %02X %02X)\r\n",
           tip ? "DOWN/MOVE" : "UP      ",
           (unsigned)x, (unsigned)y,
           buf[0], buf[1], buf[2], buf[3], buf[4]);

    bt_gatt_notify(conn, &hids.attrs[TOUCH_INPUT_REPORT_VAL_IDX],
                   buf, sizeof(buf));
}

那个 printf 建议保留 —— 调试时看着一串 DOWN/MOVE ... UP 滚过去，非常有安全感。

6.2 一次完整上滑（main.c:522）

static void swipe_up(void)
{
    if (!default_conn || !touch_notify) {
        return;
    }

    printf("[SWIPE] up  Y: %d -> %d\r\n", TOUCH_Y_START, TOUCH_Y_END);

    /* 1) 按下 */
    touch_send(1, TOUCH_X, TOUCH_Y_START);
    vTaskDelay(pdMS_TO_TICKS(SWIPE_STEP_MS));

    /* 2) 中间移动帧 */
    for (int i = 1; i <= SWIPE_STEPS; i++) {
        int y = TOUCH_Y_START +
                ((TOUCH_Y_END - TOUCH_Y_START) * i) / SWIPE_STEPS;
        touch_send(1, TOUCH_X, (u16_t)y);
        vTaskDelay(pdMS_TO_TICKS(SWIPE_STEP_MS));
    }

    /* 3) 抬手 */
    touch_send(0, TOUCH_X, TOUCH_Y_END);
}

三步，对应 ACTION_DOWN → ACTION_MOVE × N → ACTION_UP。

6.3 参数怎么调（main.c:67）

#define TOUCH_X         500    /* 水平中点 */
#define TOUCH_Y_START   780    /* 起点：屏幕 78% 高度 */
#define TOUCH_Y_END     260    /* 终点：屏幕 26% 高度 */
#define SWIPE_STEPS     16     /* 中间插值帧数 */
#define SWIPE_STEP_MS   10     /* 每帧间隔 */

调参指南：

参数	调大会怎样	建议
TOUCH_X	X 越大越靠右	保持 500（居中）。贴边容易触发系统的侧边返回手势
TOUCH_Y_START	起点越靠下	700~850。太靠底会碰到导航栏
TOUCH_Y_END	终点越靠下	200~350。划得太短抖音可能不认
SWIPE_STEPS	越顺滑，但越慢	12~20。太少会变成"跳变"
SWIPE_STEP_MS	总时长越长	8~15。总时长 = STEPS × STEP_MS

当前配置的总时长 = 16 × 10 = 160 ms，划过屏幕高度的 52%。这个速度接近真人快速上滑，抖音识别率很高。

⚠️ 只发首尾两帧为什么不行？
如果你只发 DOWN(500,780) 和 UP(500,260) 两帧，Android 会认为这是"手指瞬移"，
速度和距离都算不出来，抖音多半不认。必须用一串 MOVE 帧把轨迹补出来。

6.4 音量键路径（main.c:561）

如果你想试试备胎方案：

typedef enum {
    CONSUMER_KEY_VOLUME_UP   = (1u << 0),   /* 0xE9 音量+ */
    CONSUMER_KEY_VOLUME_DOWN = (1u << 1),   /* 0xEA 音量- */
    ...
} consumer_key_t;

static void send_consumer(consumer_key_t key)
{
    u8_t press[1]   = { (u8_t)key };
    u8_t release[1] = { 0x00 };

    bt_gatt_notify(conn, &hids.attrs[CONSUMER_INPUT_REPORT_VAL_IDX], press, 1);
    vTaskDelay(pdMS_TO_TICKS(120));      /* 按住 > 1 个连接间隔 */
    bt_gatt_notify(conn, &hids.attrs[CONSUMER_INPUT_REPORT_VAL_IDX], release, 1);
}

那个 120 ms 的延时不能省：按下去立刻松开，主机可能来不及处理，或者把它当成一次无效抖动。

---

七、按键与自动刷

7.1 按键触发（main.c:599）

static void swipe_task(void *arg)
{
    int last = 1;          /* 空闲 = 高电平（上拉） */

    for (;;) {
        int cur = bflb_gpio_read(gpio_dev, SWIPE_BTN_PIN) ? 1 : 0;

        if (last == 1 && cur == 0) {              /* 下降沿 = 按下 */
            vTaskDelay(pdMS_TO_TICKS(DEBOUNCE_MS));
            if (bflb_gpio_read(gpio_dev, SWIPE_BTN_PIN) == 0) {
                bool ready = (SWIPE_METHOD == 1) ? touch_notify : consumer_notify;

                if (ready) {
                    do_swipe();
                } else {
                    printf("Button pressed, but host not subscribed (notify=0)\r\n");
                }
            }
        }
        last = cur;
        vTaskDelay(pdMS_TO_TICKS(20));
    }
}

标准套路：下降沿检测 + 消抖延时 + 二次确认。40 ms 消抖对机械按键够用。

7.2 切换刷法

改 main.c:55 一行：

#define SWIPE_METHOD    1     /* 1 = 触摸屏上滑（默认） */
                              /* 2 = 音量+（需在抖音里开"音量键翻页"） */

7.3 彻底解放双手：自动刷

改 main.c:58：

#define AUTO_SWIPE_EN   1     /* 1 = 自动定时刷 */
#define AUTO_SWIPE_MS   5000  /* 每 5 秒划一下 */

打开后固件会多起一个任务，每隔 AUTO_SWIPE_MS 毫秒自己划一次。连按键都省了。

💡 想更像真人？把间隔改成随机值（比如 3000~8000 ms 之间浮动）。
完全固定间隔的机器行为比较容易被识别，虽然刷抖音这种场景一般没人管你。

---

八、编译

必须在 Git Bash / 原生 bash 里执行（不是 CMD），
路径用 Windows 盘符风格（D:/...，不能用 MSYS 的 /d/...）。

cd ble_douyin_swiper
export PATH="/d/toolchain_gcc_t-head_windows/bin:$PATH"
BL_SDK_BASE=D:/bouffalo_sdk D:/bouffalo_sdk/tools/make/make CHIP=bl602 BOARD=bl602dk

成功的话，最后几行长这样：

Memory region         Used Size  Region Size  %age Used
fw_header_memory:         176 B         4 KB      4.30%
      xip_memory:      269528 B         1 MB     25.70%
     itcm_memory:        4064 B        16 KB     24.80%
     dtcm_memory:        1028 B        48 KB      2.09%
      ram_memory:       11748 B       176 KB      6.52%
Generate .../build/build_out/ble_douyin_swiper_bl602.bin
[100%] Built target ble_douyin_swiper_bl602.elf

产物在 build/build_out/ble_douyin_swiper_bl602.bin。

8.1 常见编译错误

报错	原因	解决
find_package(bouffalo_sdk) 失败	BL_SDK_BASE 没设或写成 /d/...	用 BL_SDK_BASE=D:/bouffalo_sdk
找不到 riscv64-unknown-elf-gcc	工具链不在 PATH	export PATH="/d/toolchain_gcc_t-head_windows/bin:$PATH"
链接报找不到 ble_controller_init	误用了 BL616 的 API	BL602 用 ble_lib_api.h + ble_controller_init()
GPIO_FUNC_GPIO 未定义	那是 BL616 的宏	BL602 用 bflb_gpio_init(..., GPIO_INPUT|GPIO_PULLUP...)
cli.h: No such file	开了 CONFIG_BT_STACK_CLI	defconfig 里设为 n
send_consumer defined but not used	见下方说明	用运行期 if 分支，别用 #if 硬裁

最后那个告警：因为 SWIPE_METHOD=1 时 send_consumer() 没被调用。本工程用运行期 if (SWIPE_METHOD == 1) 而不是 #if，让两个函数都保持被引用，GCC 会自动折叠常量裁掉另一支 —— 两个配置都是 0 error / 0 warning。

---

九、烧录

cd ble_douyin_swiper
export PATH="/d/toolchain_gcc_t-head_windows/bin:$PATH"
BL_SDK_BASE=D:/bouffalo_sdk COMX=COM6 BAUDRATE=921600 \
  D:/bouffalo_sdk/tools/make/make CHIP=bl602 BOARD=bl602dk flash

• COMX=COM6 换成你实际的串口号（设备管理器里看）
• BAUDRATE 叫这个名，不是 b=
• make flash 会先编译再烧录

9.1 烧录失败怎么办

1. 先关掉串口监视器，不然串口被占用会报 PermissionError。
2. 如果卡在 Start handshake 或报 LOAD HELP BIN FAIL：
   • 按住板子 BOOT 键（GPIO8 拉低）
   • 按一下 RESET
   • 松开 RESET，再松开 BOOT
   • 看到 Handshake succeeded / The ack data is b'4f4b' 就成了

成功标志：

Flash writing succeeded
All programming completed successfully

---

十、效果展示与验证

10.1 串口日志

烧录后复位，串口（115200）应该看到：

BLE ready, registering HID touch screen service
Advertising started - connect to 'WB2 Swiper'

手机连上后：

BLE connected

按一下 GPIO12，你会看到一串触摸帧滚过去：

[SWIPE] up  Y: 780 -> 260
[TOUCH] DOWN/MOVE X=500 Y=780  (03 F4 01 0C 03)
[TOUCH] DOWN/MOVE X=500 Y=747  (03 F4 01 EB 02)
[TOUCH] DOWN/MOVE X=500 Y=715  (03 F4 01 CB 02)
...（中间 14 帧）
[TOUCH] DOWN/MOVE X=500 Y=260  (03 F4 01 04 01)
[TOUCH] UP      X=500 Y=260  (00 F4 01 04 01)

Y 从 780 一路减小到 260，最后一帧 00 开头表示抬手 —— 一次标准的上滑手势。

10.2 🔥 调试神技：开发者选项的"指针位置"

这一招能让你"看见"手势，强烈推荐先用它验证，再打开抖音。

1. 手机 → 设置 → 关于手机 → 连点"版本号" 7 次，打开开发者选项
2. 设置 → 系统 → 开发者选项 → 往下滑，找到 "指针位置"（Pointer location），打开
3. 屏幕顶部会显示一条状态栏，你触摸屏幕时会实时显示坐标和轨迹

打开它之后，按一下板子的键，你会看到：

• 屏幕上凭空出现一条从下往上的白色轨迹线
• 顶部状态栏显示坐标在跳动

如果轨迹出来了，说明 HID 部分已经完全成功 —— 剩下就是抖音认不认的问题了。

如果轨迹出不来，问题一定在 HID 描述符或 GATT 层；
如果轨迹出来了但抖音不翻页，那是手势参数（距离/速度）的问题。
这个二分法能省你两小时。

10.3 实测效果

项目	结果
手势总时长	160 ms（16 帧 × 10 ms）
划过距离	屏幕高度的 52%
单帧报文	5 字节
一次手势总数据量	18 帧 × 5 字节 = 90 字节
从按下到翻页的延迟	< 200 ms（肉眼无感）
固件大小	约 270 KB（xip_memory 269528 B）

10.4 如果抖音不翻页

按这个顺序排查：

1. 打开"指针位置"看轨迹 —— 没轨迹 → 回到第 4、5 章检查描述符和 GATT
2. 轨迹有了但不翻页 → 手势力度不够：
   • 把 TOUCH_Y_START 调大到 850、TOUCH_Y_END 调小到 200（划得更长）
   • 把 SWIPE_STEP_MS 调小到 8（划得更快）
3. 确认抖音在前台 —— 后台 App 收不到触摸事件
4. 确认手机没开"手势导航"冲突 —— 从屏幕底部边缘上滑可能触发系统手势，所以 TOUCH_Y_START 别超过 850

---

十一、踩坑大全

Q1：能连上，但几秒就断（HCI 0x22 / 0x13）？
A：99% 是 32.768 kHz 时钟源不对。确认 main() 里有 HBN_32K_Sel(HBN_32K_RC);。
如果板子上有外部晶振，改成 HBN_32K_XTAL。

Q2：手机搜不到设备？
A：确认广播数据里的 UUID16 列表包含 HIDS：
BT_DATA_BYTES(BT_DATA_UUID16_ALL, 0x12, 0x18, 0x0F, 0x18)。
（0x1812 小端是 12 18。）

Q3：连上了，按按键串口只有 host not subscribed？
A：手机没对 Input Report 的 CCC 写 0x0001。正常配对时系统会自动做；
如果没做，检查一下 BT_GATT_CCC 的权限是不是 READ|WRITE。

Q4：Windows 上鼠标不动？
A：这是正常的。 触摸屏设备本来就不会移动鼠标光标。想验证请用安卓手机 + "指针位置"。

Q5：划一次翻了两三个视频？
A：手速太快、距离太长，抖音判断为"快速连续滑动"。
把 SWIPE_STEPS 调大到 20、SWIPE_STEP_MS 调大到 15（划得慢一点）。

Q6：电量一直显示 100%？
A：默认实现就是返回 100。重写 read_battery_level() 接真实 ADC。

Q7：想刷快手 / B站 / 小红书？
A：直接就能用，不用改代码。因为我们的方案是在系统层模拟真实触摸，
跟 App 无关 —— 这正是它比"音量键方案"高明的地方。

Q8：能不能加个"双击点赞"？
A：能。发两次快速的"按下-抬起"（间隔 < 100 ms）就是双击。见第十二章。

---

十二、进阶玩法

搞定基础款之后，可以玩点花的：

12.1 双击点赞

/* 双击 = 两次快速的"按下-抬起"，间隔要短 */
static void double_tap(u16_t x, u16_t y)
{
    for (int i = 0; i < 2; i++) {
        touch_send(1, x, y);
        vTaskDelay(pdMS_TO_TICKS(30));      /* 按住 30ms */
        touch_send(0, x, y);
        vTaskDelay(pdMS_TO_TICKS(60));      /* 两次点击间隔 60ms */
    }
}

抖音里在屏幕中间双击就是点赞。把它绑到另一个 GPIO，你就有了"刷 + 赞"二合一遥控器。

12.2 随机间隔（更像真人）

static void auto_task(void *arg)
{
    for (;;) {
        /* 3~8 秒随机间隔，别像个机器人 */
        u32_t wait = 3000 + (rand() % 5000);
        vTaskDelay(pdMS_TO_TICKS(wait));
        if (default_conn) {
            do_swipe();
        }
    }
}

12.3 手势参数做成可配置

把 TOUCH_Y_START / TOUCH_Y_END / SWIPE_STEPS 存到 Flash，
再加一个厂商自定义 GATT 服务（参考 ble_hid_selfie 的 0xFF10），
就能用手机 App 实时调手势 —— 不用每次改代码重新烧录。

12.4 外壳

拿个 3D 打印的小盒子，或者直接用热熔胶把板子粘在手机壳背面。
接个小锂电池，贴个轻触开关。恭喜你做出了淘宝上卖 39 块的东西 —— 但你的能改代码。

---

十三、小结

回过头看，我们其实只做了三件事：

1. 搞懂了原理：刷抖音 = 注入一串有方向的触摸事件（DOWN → MOVE × N → UP）
2. 选对了 HID 形态：用触摸屏（绝对坐标）而不是鼠标（相对坐标）—— 差别只有一个 bit
3. 用归一化坐标绕开了分辨率问题：Logical Maximum = 1000，让 Android 自己去做映射

然后代码就水到渠成了：写描述符 → 挂 GATT → 循环发 18 帧报文。

最关键的那个认知是：真触摸屏和蓝牙 HID 设备，在 Android 内核的 input 子系统那一层就汇合了。
往上走的路完全一样。所以只要你的报文格式标准，系统根本分不清那是手指还是一块 WB2。

最后提醒一句：这玩意儿做好了，别在上班时间用。
以及 —— 用它刷到腱鞘炎的概率，比用手刷要低得多。这才是本文的真正意义。🙂

参考

• Bluetooth SIG：HID over GATT Profile (HOGP)、HID Service (HIDS 0x1812)
• USB-IF：HID Usage Tables（Digitizer Page 0x0D / Consumer Page 0x0C）
• Android AOSP：触控设备与触控笔的 HID 描述符规范
• Ai-Thinker Ai-WB2 模组资料

[bzhou830]

ble_douyin_swiper.zip

[Yaqing-Zheng]

不愧是你~

[yffbit]

不如autojs