这个页面的 最新开发版本 可能比这个发布的 2.1.0rc1 版本新。

Bluetooth: Peripheral hids keyboard

概述

本实例演示了 BLE 键盘功能,你可以使用支持 BLE HID 功能的设备(比如智能手机,PC)连接,BLE 键盘的默认名称为: WM-KEYBOARD. 该示例同时展示了 LE Secure Connectino 功能,默认的 IO 能力为仅仅支持显示。连接建立后,配对码会显示在控制台,在对端设备输入该配对码已完成配对流程。 该示例支持 cli 指令用于模拟键盘的输入功能,具体指令集请参考示例代码。

输入指令 (cli commands)

in:
  • 模拟在键盘输入一个字符(仅支持单字符输入), 比如输入 in a, 相当于在键盘输入 a 键. 提示: in capslock 指令用于模拟在键盘按下 CapsLock 键

sc:
  • 模拟在键盘输入系统控制按键,比如 sc powerdown 类似于在智能手机的长按 power 键,sc sleep 类似于短按 power 键。

cc:
  • 模拟在键盘输入用户控制指令,比如 cc home 模拟智能手机的 home 按键,cc volup/voldown 模拟增加/降低音量按键。

环境要求

  • 支持 BLE 功能的开发板

编译和烧录

示例位置:

examples/bluetooth/peripheral_hids_keyboard

编译、烧录等操作请参考:[快速入门](https://doc.winnermicro.net/w800/zh_CN/2.1.0rc1/get_started/index.html)

运行结果

[I] (2) main: ver: 2.0.1dev build at Sep 25 2024 10:32:07

W800: [I] (24) bt: LE SC enabled
[I] (24) bt: No ID address. App must call settings_load()
[I] (24) sc_hid: Bluetooth initialized
[I] (26) bt: Identity: 28:6D:CE:11:22:33 (public)
[I] (26) bt: HCI: version 4.2 (0x08) revision 0x0709, manufacturer 0x070c
[I] (26) bt: LMP: version 4.2 (0x08) subver 0x0709
[I] (34) sc_hid: Advertising successfully started
[I] (31836) sc_hid: Connected 4C:28:16:4D:51:3F (random)

[I] (32018) sc_hid: Passkey for 4C:28:16:4D:51:3F (random): 366039

[W] (42364) bt: chan 0x200040dc conn 0x20003c70 handle 0 encrypt 0x01 hci status 0x00
[I] (42366) sc_hid: Security changed: 4C:28:16:4D:51:3F (random) level 4

[W] (42444) bt: Set privacy mode command is not supported