文章目录
- 前言
- 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);
}
}
}