腾讯云例程qcloud_led_light

# Smart Light `Smart Light` 使用 `ESP32、ESP32S2` 配合 `腾讯连连小程序` 演示了一个智能灯控制方案。 功能： - 通过腾讯连连小程序配网、控制 - 支持 `OTA` 升级功能、版本回滚 # 详细说明 ## 0. 一些准备工作 - 拥有搭载 `ESP32、ESP32S2` 芯片的硬件平台 - 拥有 `ESP-IDF release/v4.2` 的环境，你可参考该 [文档](../../README.md) 完成搭建 - 正常使用的微信号 ## 1. 云平台设置 1. **新建产品** 你需要在 [腾讯物联网开发平台 (IoT Explorer)](https://console.cloud.tencent.com/iotexplorer) 新建项目，随后即可新建产品。 <div align="center"> <img src="./_static/qcloud_01.png" width = "500" height = "463" alt="云平台_新建产品" align=center > </div> 2. **数据模板** 通过 `标准功能-导入 JSON ` 添加标准属性，[点击查看 light 的 json 文件](./data_template_light.json) 。 <div align="center"> <img src="./_static/qcloud_02.png" width = "600" height = "407" alt="云平台_导入json" align=center > </div> 3. **设备开发** 此处可不进行选择。 4. **交互开发** 此处可配置设备的首选、次选配网方案。当前例程支持乐鑫方案下的 `Soft Ap`、 `Smart Config`、 `AirKiss`。 <div align="center"> <img src="./_static/qcloud_03.png" width = "600" height = "336" alt="云平台_交互开发" align=center > </div> 5. **设备调试** 此处新建一个设备，随后可点击该设备查看 `产品 ID (PRODUCT_ID)`、`设备名称 (DEVICE_NAME)`、 `设备密钥 (DEVICE_SECRET)`。 <div align="center"> <img src="./_static/qcloud_04.png" width = "600" height = "356" alt="云平台_设备调试" align=center > </div> 6. **批量生产** 此处可以查看 `配网二维码`。 <div align="center"> <img src="./_static/qcloud_05.png" width = "600" height = "331" alt="云平台_配网二维码" align=center > </div> >该二维码与随后设备端生成的二维码功能相同。 ## 2. 设备设置 1. **设置 `light` 接口** 1. **进入 `menuconfig` 配置界面** ```shell idf.py menuconfig ``` 2. **在 `ESP QCloud Example Configuration -> Light development board selection -> light hardware type` 中选择 `Custom`** ```shell ( ) ESP32 moonlight ( ) ESP32-MeshKit Light (X) Custom ``` 3. **根据 `light` 种类填写对应 `GPIO` 号** 若是 `单色 LED`，可随意接入任意 `RGB` 脚，`单色 LED` 只能完成开关功能，无法调色。若是 `RGB`、`RGB + 色温色调`，请按实际 `GPIO` 接入。 ```shell (25) Light red pin GPIO number (26) Light green pin GPIO number (27) Light blue pin GPIO number (4) Light cold color pin GPIO number (16) Light warm color pin GPIO number (500) The time from the current color to the next color (3000) Period of blinking lights ``` 在配网时，`light` 会进入呼吸灯模式，用以提示状态。 - `The time from the current color to the next color`，可配置颜色切换的时间。 - `Period of blinking lights`，可配置呼吸灯循环的周期。 2. **烧录认证信息** 认证信息通常为 `PRODUCT_ID`、 `DEVICE_NAME`、 `DEVICE_SECRET`，当成功获取到认证信息时，可以选择下述任意一种方式完成信息烧录。 - **通过 `menuconfig` 配置界面** 1. **进入 `menuconfig` 配置界面** ```shell idf.py menuconfig ``` 2. **选择 `ESP QCloud Config` 选项** ```shell [ ] ESP Qcloud Mass Manufacture (PRODUCT_ID) Product ID (DEVICE_NAME) Device Name (DEVICE_SECRET) Device Secret ESP QCloud OTA Config ---> Qcloud utils ---> ESP QCloud Log Config ---> UART for console input (UART0) ---> ``` - **不**开启 `ESP Qcloud Mass Manufacture` 选项。 3. **填入你的信息** 填写你的 `产品 ID (PRODUCT_ID)`、 `设备名称 (DEVICE_NAME)`、 `设备密钥 (DEVICE_SECRET)`。 - **通过量产工具配置** 请参考量产工具目录下的 [文档](./../../config/mass_mfg/README.md)，另外需要 <b>开启</b> `ESP Qcloud Mass Manufacture` 选项。 3. **构建&运行工程** 通过下述命令，可快速构建、下载工程并打开监视器。 ```shell idf.py flash monitor ``` 4. **设备配网** 如果一切顺利，`shell` 窗口将打印一个二维码，并打印热点配网使用的 `SSID`，使用 `微信` 扫码，按提示完成后续操作，设备默认启动 `Soft Ap` 配网。 >该二维码与云端生成的二维码功能相同。 <div align="center"> <img src="./_static/device_shell_01.png" width = "440" height = "191" alt="设备端_配网提示_shell" align=center > </div> 1. **立即绑定** 如果一切正常，扫描二维码后将看到下述界面。 <div align="center"> <img src="./_static/app_01.jpg" width = "200" height = "425" alt="小程序_立即绑定" align=center > </div> 2. **开始配网** - **一键配网** 一键配网使用的是乐鑫 `esp-touch v1` 协议。 <div align="center"> <img src="./_static/app_smartconfig_01.jpg" width = "200" height = "425" alt="小程序_一键配网_01" align=center > </div> - **微信配网** 微信一键配网使用的是腾讯 `AirKiss` 协议。 <div align="center"> <img src="./_static/app_smartconfig_02.jpg" width = "200" height = "425" alt="小程序_一键配网_02" align=center > </div> - **热点配网( SoftAp 配网)** 热点配网需要填入设备的 `SSID` 信息，可从监视器中查看。 <div align="center"> <img src="./_static/app_softap_01.jpg" width = "200" height = "425" alt="小程序_热点配网_01" align=center > </div> <div align="center"> <img src="./_static/app_softap_02.jpg" width = "200" height = "425" alt="小程序_热点配网_02" align=center > </div> - **蓝牙辅助配网( BLE 配网)** 蓝牙辅助配网的 `local name` 默认为 `QCloud`。 <div align="center"> <img src="./_static/app_ble_01.jpg" width = "200" height = "425" alt="小程序_蓝牙配网_01" align=center > </div> <div align="center"> <img src="./_static/app_ble_02.jpg" width = "200" height = "425" alt="小程序_蓝牙配网_02" align=center > </div> 3. **等待配网结果** 成功后可在主页查看设备信息。 <div align="center"> <img src="./_static/app_02.jpg" width = "200" height = "425" alt="小程序_配网成功" align=center > </div> 配网成功后，小程序与你的设备将形成绑定关系，同时会记录 `Wi-Fi` 的相关信息。如果想清除配网信息，可使用下述两种方法。 - **使用 `esptools` 工具擦除** 若通过量产工具烧录认证信息，执行此命令后，需要再次完成烧录认证信息。 ```shell idf.py erase_flash ``` - **使用快速复位按键** 在乐鑫提供的开发板中，可快速重复按下 `RST` 按键 5 次。若使用芯片，快速上电、掉电 5 次也可完成此操作。当前例程可修改复位次数及时间，方法如下： 1. **进入 `menuconfig` 配置界面** ```shell idf.py menuconfig ``` 2. **选择 `ESP QCloud Example Configuration`** ```shell Light development board selection ---> (5) More than this number of conti