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

前言

这篇笔记记录采用 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 监测器
  语音控制智能家居的抽风小仓鼠
  一些有关电子的好玩东西

• 心得分享
  文档啊，最重要的还是层次感
  技术管理入门课_先做个不讨厌的人
  你没中过勒索病毒，不知道备份有多重要