BLE hid示例

源码路径:example/ble/hid

支持的平台

全平台

概述

  1. 本例程演示了本平台如何实现BLE HID。

  2. 例程中实现了两类HID type,分把是HID_KEYBOARD和HID_CONSUMER。

    1. main.c默认定义了HID_CONSUMER,可以通过undefine HID_CONSUMER再define HID_KEYBOARD方式来切换编译后支持的type。 、 HID_TYPE_CHOOSE

例程的使用

  1. 本例程开机会开启广播,广播名字以SIFLI_APP-xx-xx-xx-xx-xx-xx, 其中xx代表本设备的蓝牙地址。可以通过手机的BLE APP进行连接

  2. 手机连上本设备后,通过finsh命令”test_hids [key] [p|r]”向手机发起控制命令。其中p|r代表press|release, 需要配对使用;key根据HID type是keyboard还是consumer有不同值:

    1. Keyboard type的key取值范围:
      keyboard_value

    2. Consumer type的key取值范围:
      consumer_value

    3. 比如再consume type下输入”test_hids 0 p”就代表输入key值对应PLAY的press操作。

硬件需求

运行该例程前,需要准备:

编译和烧录

切换到例程project/common目录,运行scons命令执行编译:

> scons --board=eh-lb525 -j32

切换到例程project/common/build_xx目录,运行uart_download.bat,按提示选择端口即可进行下载:

$ ./uart_download.bat

     Uart Download

please input the serial port num:5

关于编译、下载的详细步骤,请参考快速入门的相关介绍。

例程的预期结果

例程启动后:

  1. 可以被手机的BLE APP搜到并连上。

  2. 通过finsh命令可以对手机进行控制。

异常诊断

参考文档

更新记录

版本

日期

发布说明

0.0.1

01/2025

初始版本