# 1 操作场景

使用BLE蓝牙模拟一款智能灯，配合“腾讯连连”小程序实现设备接入，物联网开发平台可以远程控制灯的亮度、颜色、开关，并实时获取智能灯上报到开发平台的数据。

本文档主要指导您如何使用NRF52832模组在物联网开发平台创建智能灯产品并通过手机接入。


# 2 前提条件

为了通过下面的步骤快速理解该业务流程，需要做好以下准备工作：
- 申请物联网开发平台服务。
- 准备一块NRF52832开发板。
- 下载最新版本代码。
- 安装python、JLink驱动程序。


# 3 操作步骤

## 3.1 控制台操作

### 3.1.1 新建项目
1. 登录 [物联网开发平台控制台](https://console.cloud.tencent.com/iotexplorer)，选择【新建项目】。
2. 在新建项目页面，填写项目基本信息，完成后点击保存。
   - 项目名称：输入“智能灯演示”或其他名称。
   - 项目描述：按照实际需求填写项目描述。  
   ![](image/BLE/new_project.png)


### 3.1.2 新建产品
1. 进入该项目的产品列表页面，单击【新建产品】。
2. 在新建产品页面，填写产品基本信息，完成后点击保存。
  - 产品名称：输入“蓝牙智能灯”或其他产品名称。
  - 产品类型：选择“智慧生活—电工照明—灯”。 
  - 设备类型：选择“设备”。
  - 认证方式：选择“密钥认证”。
  - 通信方式：选择“BLE”。
  - 其他选项保持默认。  
  ![](image/BLE/new_product.png)


### 3.1.3 创建数据模板
1. 打开刚刚创建的【蓝牙智能灯】产品。  
![](image/BLE/ble_product.png)

2. 选择【数据模板】，点击【导入JSON】。  
![](image/BLE/data_template.png)

1. 打开代码中的`examples\nimble_llsync\date_templatenrf52832.json`，如果出现乱码请将您的编辑器修改为utf8编码，将文件中的代码粘贴进来，点击【导入】。  
![](image/BLE/import_json.png)


### 3.1.4 交互开发配置
配置产品在小程序端的控制面板、配网引导、快捷入口，若不配置则使用系统默认配置。  
![](image/BLE/llsync_gui.png)


### 3.1.5 新建设备
在设备调试页面中，单击【新建设备】，输入设备名“ble_device_01”或其他设备名称，点击【保存】。  
![](image/BLE/new_device.png)



## 3.2 设备端操作

### 3.2.1 硬件简介与连接
开发板实物如下：  
![](image/BLE/nrf52832_board.jpg)

指示灯作用如下
- LED1: 开关
- LED2: action
- LED3: replay
- LED4: 未使用

1. 使用USB线连接开发板左上角串口。
2. 使用JLink连接开发板右下角下载线接口。
3. 打开左上角电源开关。
4. 打开设备管理器，确保串口和JLink能够正常识别，若不能识别请重新安装驱动。  
   ![](image/BLE/jlink_driver.png)

### 3.2.2 准备软件环境
1. 新买到的nrf52832开发板可能已经烧写了 NORDIC 官方蓝牙协议栈，需要进行擦除，否则会导致下载失败、程序异常或其他问题
2. 启动 JFlash.exe，选择 File -> New project  
   ![](image/BLE/jflash1.png)
3. 点击省略号添加设备  
   ![](image/BLE/jflash2.png)
4. 在“Device”中输入nrf52832，选择具体芯片型号，例程中使用的为nRF52832_xxAA  
   ![](image/BLE/jflash3.png)
5. 选择 Target -> Manual Programming -> Erase Chip 擦除芯片  
   ![](image/BLE/jflash4.png)
6. 擦除完成后即可继续进行之后的开发

### 3.2.3 代码修改与烧录
1. 打开工程`board\Nordic_NRF52832\KEIL\llsync\TencentOS_tiny.uvprojx`。
2. 打开文件`ble_qiot_import.c`，找到以下三个宏并修改为你自己的设备信息。  
   ![](image/BLE/edit_device_info.png)
3. 在【设备调试】页面中选择【设备信息】子页面，将【设备名称】、【设备密钥】、【产品ID】分别填入`DEVICE_NAME`,`SECRET_KEY`,`PRODUCT_ID`。  
   ![](image/BLE/device_info.png)
4. 在`ble_qiot_ret_status_t ble_qiot_explorer_init(void)`中或其他合适的地方修改日志等级`ble_qiot_set_log_level(BLE_QIOT_LOG_LEVEL_DEBUG);`，以便开发调试。
5. 编译下载并运行。

## 3.3 腾讯连连小程序调试
1. 微信主页面下拉并搜索【腾讯连连】小程序。  
   ![](image/BLE/llsync1.jpg)
2. 点击下方的【加号】添加设备。  
   ![](image/BLE/llsync2.jpg)
   ![](image/BLE/llsync3.jpg)
3. 待扫描到蓝牙设备后点击右侧的【连接】。  
   ![](image/BLE/llsync4.jpg)
4. 在【我的设备】中打开刚刚添加的蓝牙设备。  
   ![](image/BLE/llsync5.jpg)
5. 点击右侧的【立即连接】连接设备，如连接失败。  
   ![](image/BLE/llsync6.jpg)
6. 连接成功后点击【电灯开关】，可以看到开发版上【LED1】随之变化。  
   ![](image/BLE/llsync7.jpg)
7. 点击【亮度】或【颜色】按钮进行设置  
8. 查看串口打印，可以看到亮度、颜色设置成功  
   ![](image/BLE/com_debug.png)

# 4 Q&A
Q: 实际产品中如何处理设备信息？  
A: 例程中 `DEVICE_NAME`, `SECRET_KEY`, `PRODUCT_ID` 直接写在代码中，产品中应保存在Flash中，同时修改`ble_qiot_import.c`中`ble_get_product_id()`,`ble_get_device_name()`,`ble_get_psk()`三个函数。  

Q: LLSync SDK 需要多大的 Flash 来保存配置信息？  
A: 目前只需要不到32字节。  

Q: 如果开发其他 BLE 芯片，有什么注意事项？  
A: `components\connectivity\qcloud_iot_explorer_ble\inc\ble_qiot_import.h` 为用户需要移植适配的接口，与蓝牙协议栈相关的接口在`ble_qiot_import.c`中已经完成了适配，用户仅需根据实际产品要开发`ble_write_flash()`,`ble_read_flash()`等接口。  

# 5 参考资料
[LLSync SDK](https://github.com/tencentyun/qcloud-iot-explorer-BLE-sdk-embedded) 内相关文档  
[LLSync SDK 接入指引](https://cloud.tencent.com/document/product/1081/48398)  
[LLSync SDK 使用参考](https://cloud.tencent.com/document/product/1081/48399)