BLE pair示例

源码路径：example/ble/pair

支持的平台

全平台

本例程演示了本平台如何做GAP peripheral进行配对。

本例程为 BLE Peripheral 角色，开机后自动广播并支持配对。可通过手机 BLE APP 完成配对与 GATT 读写验证。

cmd_diss set_sec 0 2

参数解释：0 是连接索引 conn_idx（当前连接一般是 0）。 2 是安全等级（对应 LE_SECURITY_LEVEL_NO_MITM_BOND，即不要求 MITM、但进行绑定）。

IO Cap 能力说明（配对方式与此相关）：

io_cap 值	枚举	行为说明	典型表现
0	GAP_IO_CAP_DISPLAY_ONLY	设备仅显示数字	手机输入 PIN；设备端打印 `SHOW PIN`
1	GAP_IO_CAP_DISPLAY_YES_NO	设备显示数字并确认	手机数字确认；设备端打印 `SHOW NC`
2	GAP_IO_CAP_KB_ONLY	设备可输入数字但不显示	手机显示 PIN；设备端用 `diss set_key` 输入
3	GAP_IO_CAP_NO_INPUT_NO_OUTPUT	无输入输出	Just Works，一般无需输入/确认
4	GAP_IO_CAP_KB_DISPLAY	既能显示也能输入	手机根据对端策略选择 PIN/确认

发送命令后手机端会弹出配对请求

点击配对后会要求输入PIN码，将日志输出的PIN码填入即可完成配对

运行该例程前，需要准备：

使能蓝牙(BLUETOOTH)：
- 路径：Sifli middleware → Bluetooth
- 开启：Enable bluetooth
  - 宏开关：CONFIG_BLUETOOTH
  - 作用：使能蓝牙功能
使能GAP, GATT Client, BLE connection manager：
- 路径：Sifli middleware → Bluetooth → Bluetooth service → BLE service
- 开启：Enable BLE GAP central role
  - 宏开关：CONFIG_BLE_GAP_CENTRAL
  - 作用：作为BLE CENTRAL（中心设备）的开关，打开后，提供扫描和主动发起与外设（Peripheral）的连接功能。
- 开启：Enable BLE GATT client
  - 宏开关：CONFIG_BLE_GATT_CLIENT
  - 作用：GATT CLIENT的开关，打开后，可以主动搜索发现服务，读/写数据，接收通知。
- 开启：Enable BLE connection manager
  - 宏开关：CONFIG_BSP_BLE_CONNECTION_MANAGER
  - 作用：提供BLE连接控制管理，包括多连接管理，BLE配对，链路连接参数更新等内容。
使能NVDS：
- 路径：Sifli middleware → Bluetooth → Bluetooth service → Common service
- 开启：Enable NVDS synchronous
  - 宏开关：CONFIG_BSP_BLE_NVDS_SYNC
  - 作用：蓝牙NVDS同步。当蓝牙被配置到HCPU时，BLE NVDS可以同步访问，打开该选项；蓝牙被配置到LCPU时，需要关闭该选项。

切换到例程project目录，运行scons命令执行编译：

> scons --board=eh-lb525 -j32

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

$ ./uart_download.bat

     Uart Download

please input the serial port num:5

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