当前文档版本为v0.3.0,您可以访问 开发中 的文档以获取最近可能的更新。

Bluetooth: Peripheral HIDs

1 功能概述

此项目演示了蓝牙从机的功能,该工程演示了 HID over GATT 服务,模拟一个通用鼠标设备。

2 环境要求

  • board: 支持蓝牙的设备

  • uart: 用来显示配对码,日志等

  • 测试设备: 手机、平板等

3 编译和烧录

项目位置:zephyr\samples_panchip\bluetooth\peripheral_hids

统一的配置、编译、下载工具正在开发中,当前可以使用脚本进行编译和下载。

脚本位置:quick_build_samples\bluetooth\peripheral_hids.bat

打开脚本后默认会编译项目,编译完成时,可输入字符进行后续下载等操作:

Input the keyword to continue:
  'b' build                         编译项目
  'r' make clean and rebuild        重新编译项目
  'f' flash download                下载
  'e' erase chip                    擦除芯片
  'o' open project by VS Code       打开 `VS Code`,可查看源码,执行编译下载等
  others exit                       退出
wait input:

4 演示说明

  1. 烧录完成后,设备自动启动蓝牙广播,可以在手机或抓包工具上获取如下信息:

    • Service UUID: 0x1812, 0x180A, 0x180F

    • Device Name: Test HoG mouse

  2. 当手机或其它主设备与其建立连接后,串口log 会显示连接信息,如下:

    Connected
    
  3. 该示例主要演示 HID over GATT 服务:

    image

5 其他说明

修改CONFIG_BT_MAX_PAIRED 可以调整保存的配对信息个数,如下修改将支持保存两组配对信息。

CONFIG_BT_MAX_PAIRED=2

当需要与多个设备配对时,可以修改CONFIG_BT_KEYS_OVERWRITE_OLDEST 来支持覆盖旧设备的配对信息。

否则配对信息存储达到上限时,将无法与新设备进行配对。

CONFIG_BT_KEYS_OVERWRITE_OLDEST=y