ESP32接入腾讯云物联网开发平台

文章目录

前言
1 资料参考
2 对接总体思路
3 代码移植
- 3.1 component qcloud_iot
- 3.2 项目顶层处理
- 3.3 component main
4 移植问题备忘
- CMakeLists.txt 的定义语法
- mbedtls_ssl_conf_psk 编译错误
5 腾讯云物联网开发平台操作
- 5.1 腾讯云物联网开发平台创建WiFi产品
- 5.2 代码中修改设备三元组信息
- 5.3 配置添加 WiFi SSID 和密码
- 5.4 ESP32 编译、烧写、monitor
6 最终结果
END

前言

这篇笔记记录采用 ESP32 接入腾讯云物联网开发平台的流程，同时给出了我的移植示例，方便其他想接入腾讯云物联网的朋友。

毕竟腾讯云IoT现在是免费的，而且还有腾讯连连小程序加持，真香是肯定的。

先说下哈，问过腾讯云的朋友，ESP32接入腾讯云物联网开发平台的例程正在处理，预计后面会发布到 github 上。所以我这篇笔记只是小能手的试水，因为最近正在玩 ESP_Moonlight 开发板，想要做个小玩具玩玩，因此着急着先摸索出来了。后续当然建议是以腾讯云官方文档为主。

如果你还没看到官方文档，又急着玩，不妨看看我这篇笔记，也能加深下对ESP32开发的了解。

小能手在时隔4年后，再次玩起了乐鑫芯片，这次是带语音识别功能的ESP32。目前基于 ESP-Moonlight 开发板记录一系列笔记，详情请点击。

1 资料参考

目力所及的资料有两个，一个是腾讯云的，一个是乐鑫的，两家在19年有过合作。

首先是腾讯云的资料，Wi-Fi 智能灯接入指引，虽然demo是使用AT命令的模组，不过追进去，还是发现了非模组的版本：
https://github.com/tencentyun/qcloud-iot-esp-wifi/tree/master/qcloud-iot-esp8266-demo

名称	说明
qcloud-iot-at-esp8266	腾讯云IoT AT指令ESP8266定制固件、说明及使用
qcloud-iot-esp8266-demo	腾讯云IoT C-SDK 在ESP8266 RTOS SDK上的移植及demo和配网代码

乐鑫也根据腾讯云的CSDK，写了一个对接的工程，不过目前有点旧了，移植的CSDK也是老的版本：https://github.com/espressif/esp-qcloud，另外看了代码只支持 cert 方式，比较有局限性。

2 对接总体思路

所以我的对接思路是以腾讯云的 ESP SDK 为主，应该更容易对接到腾讯云。

对接的主要困难是在编译系统这块，腾讯云的 qcloud-iot-esp8266-demo 仍采用 GNU Make，而我手头的 ESP-Moonlight 都是基于 ESP-IDF V4.0 了，编译系统采用的是 CMake。这块一些文件需要自己处理下。

目前总体代码也已上传：https://github.com/twowinter/esp-moonlight/

3 代码移植

3.1 component qcloud_iot

复制 component 目录

将腾讯云SDK中的 component 复制至本项目的 component 目录，具体见 esp-moonlight/components/qcloud_iot

CMakeLists.txt

参考了乐鑫的文档，这里头有CMake的参考，https://github.com/espressif/esp-qcloud/blob/master/CMakeLists.txt

set(COMPONENT_ADD_INCLUDEDIRS "qcloud_iot_c_sdk/include""qcloud_iot_c_sdk/include/exports""qcloud_iot_c_sdk/sdk_src/internal_inc")# Edit following two lines to set component requirements (see docs)
set(COMPONENT_REQUIRES "mbedtls")
set(COMPONENT_PRIV_REQUIRES )set(COMPONENT_SRCS"qcloud_iot_c_sdk/sdk_src""qcloud_iot_c_sdk/platform")register_component()

3.2 项目顶层处理

项目顶层目录位于 esp-moonlight/examples/qcloud_sr，主要是修改 CMake 文件和配置文件。

CMakeLists.txt
里面记得增加新加的 component qcloud_iot。

set(EXTRA_COMPONENT_DIRS ${CMAKE_CURRENT_SOURCE_DIR}/../../components/moonlight_board${CMAKE_CURRENT_SOURCE_DIR}/../../components/led_rgb${CMAKE_CURRENT_SOURCE_DIR}/../../components/speech_recognition${CMAKE_CURRENT_SOURCE_DIR}/../../components/button${CMAKE_CURRENT_SOURCE_DIR}/../../components/qcloud_iot)

复制项目配置

#
# QCloud IoT demo Configuration
#
CONFIG_QCLOUD_IOT_EXPLORER_ENABLED=y
CONFIG_SMART_LIGHT_ENABLED=y
CONFIG_GATEWAY_ENABLED=
CONFIG_OTA_ENABLED=
CONFIG_RAW_DATA_ENABLED=
CONFIG_MQTT_ENABLED=
CONFIG_DEMO_EXAMPLE_SELECT=0
CONFIG_WIFI_CONFIG_ENABLED=y
CONFIG_DEMO_WIFI_SSID="Your_WiFi"
CONFIG_DEMO_WIFI_PASSWORD="12345678"

3.3 component main

component main 组件的调整也是两个文件，CMake 文件和配置文件。

CMakeLists.txt

idf_component_register(SRC_DIRS "./" "samples/data_template_light"INCLUDE_DIRS "./" "include")

配置菜单修改

qcloud-iot-esp-wifi/qcloud-iot-esp8266-demo/main/Kconfig.projbuild

里头涉及对腾讯云DEMO 的参数配置菜单，需要移植过来。

4 移植问题备忘

移植过程中有两个典型问题，我这边做个记录。

CMakeLists.txt 的定义语法

对编译系统不熟，导致两次掉入这个坑里。

在指定原文件的时候，之前我采用 SRCS，应该是看某些文件里既可以指定文件，也可以指定目录，给我造成了误导。反正最新的CMake编译系统，原文件仅使用 SRCS，而如果是目录的话，就得使用 SRC_DIRS。

In the legacy Make-based build system, it is required to also set COMPONENT_SRCDIRS if COMPONENT_SRCS is set. In CMake, the equivalent is not necessary i.e. specifying SRC_DIRS to idf_component_register if SRCS is also specified (in fact, SRCS is ignored if SRC_DIRS is specified).

而且这里要注意，如果使用 SRC_DIRS 那么 SRCS 就会被忽略。

component qcloud_iot 处理：

set(src_dirs "qcloud_iot_c_sdk/sdk_src""qcloud_iot_c_sdk/platform")set(include_dirs "qcloud_iot_c_sdk/include""qcloud_iot_c_sdk/include/exports""qcloud_iot_c_sdk/sdk_src/internal_inc")idf_component_register(SRC_DIRS "${src_dirs}"INCLUDE_DIRS "${include_dirs}"REQUIRES mbedtls)

component main 处理：

idf_component_register(SRC_DIRS "./" "samples/data_template_light"INCLUDE_DIRS "./" "include")

mbedtls_ssl_conf_psk 编译错误

/Users/tt/esp/esp-moonlight/components/qcloud_iot/qcloud_iot_c_sdk/platform/HAL_TLS_mbedtls.c: In function '_mbedtls_client_init':
/Users/tt/esp/esp-moonlight/components/qcloud_iot/qcloud_iot_c_sdk/platform/HAL_TLS_mbedtls.c:153:15: error: implicit declaration of function 'mbedtls_ssl_conf_psk'; did you mean 'mbedtls_ssl_conf_sni'? [-Werror=implicit-function-declaration]ret = mbedtls_ssl_conf_psk(&(pDataParams->ssl_conf), (unsigned char *)pConnectParams->psk, pConnectParams->psk_length,^~~~~~~~~~~~~~~~~~~~mbedtls_ssl_conf_sni
cc1: some warnings being treated as errors

通过代码发现是相关的配置项需要启用。

#if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
int mbedtls_ssl_conf_psk( mbedtls_ssl_config *conf,const unsigned char *psk, size_t psk_len,const unsigned char *psk_identity, size_t psk_identity_len )

/* Key exchanges using a PSK */
#if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)           || \defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)       || \defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)       || \defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
#define MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED
#endif

这是最终在项目配置中需要使能的参数。
CONFIG_MBEDTLS_PSK_MODES=y

5 腾讯云物联网开发平台操作

一旦SDK搞定，剩下的事情就好解决了。

5.1 腾讯云物联网开发平台创建WiFi产品

具体见 Wi-Fi 智能灯接入指引。

5.2 代码中修改设备三元组信息

到 components/qcloud_iot/qcloud_iot_c_sdk/platform/HAL_Device_freertos.c 里面修改在腾讯云物联网平台注册的设备信息（目前仅支持密钥设备）：

/* Product Id */
static char sg_product_id[MAX_SIZE_OF_PRODUCT_ID + 1]    = "PRODUCT_ID";
/* Device Name */
static char sg_device_name[MAX_SIZE_OF_DEVICE_NAME + 1]  = "YOUR_DEV_NAME";
/* Device Secret */
static char sg_device_secret[MAX_SIZE_OF_DEVICE_SECRET + 1] = "YOUR_IOT_PSK";

5.3 配置添加 WiFi SSID 和密码

图省事，先不折腾配网了，直接 idf.py menuconfig 来配置。

5.4 ESP32 编译、烧写、monitor

常规操作，忽略不表。

6 最终结果

最终可以在腾讯云 IoT Explorer 上看到设备的属性更新。

看代码描述，这个示例应该是每10秒上传一次亮度。

/*example for cycle report, you can delete this for your needs*/
static void cycle_report(Timer *reportTimer)
{int i;if (expired(reportTimer)) {for (i = 0; i < TOTAL_PROPERTY_COUNT; i++) {DeviceProperty *pReportData = &(sg_DataTemplate[i].data_property);/* simulate brightness changes */if (0 == strcmp(pReportData->key, "brightness")) {int *brightness = (int *)pReportData->data;*brightness += 5;if (*brightness > 100)*brightness = 0;set_propery_state(pReportData->data, eCHANGED);} else {set_propery_state(&(sg_DataTemplate[i].data_property.data), eCHANGED);}countdown_ms(reportTimer, 10000);}}
}

END

That’s all

IoT小能手的其他精彩文章：

行业围观
深度报道第1个从太空发回的LoRa信号(含视频)
从工信部发文解读政府对LoRa产业的态度
技术分享
LoRaWAN介绍 - LoRa从业者读这篇就够了
干货 | LoRaWAN 协议中文版，你要的pdf来了
无线节点的空中唤醒技术解析
玩玩硬件
自制一个 LoRa PM2.5 监测器
语音控制智能家居的抽风小仓鼠
一些有关电子的好玩东西
心得分享
文档啊，最重要的还是层次感
技术管理入门课_先做个不讨厌的人
你没中过勒索病毒，不知道备份有多重要