图文手把手教程--ESP32 OTA空中升级(阿里云物联网平台)

本文内容

1）使用ota_example_mqtt例程，通过阿里云物联网平台，进行OTA升级。

2）将例程编译成两个版本，版本1.0.0下载至ESP32开发板，版本2.0.0上传至阿里云物联网平台。

一、首先完成在阿里云生活物联网平台创建自有品牌项目：

图文手把手教程--ESP32 MQTT连接阿里云生活物联网平台

二、创建ota_example_mqtt例程。

1）创建示例项目ota_example_mqtt：VSCODE中->"查看"->”命令面板“->输入：Show Examples projects->选择Use current ESP-IDF(E:\ESP32-IDF\esp\esp-idf)->弹出示例ESP-IDF Examples，选择aliyun->ota->ota_example_mqtt->Create project using ota_example_mqtt->选择示例保存的路径。

例如：E:\ESP32-IDF\project-example，因ESP-IDF框架与示例是分离的，所以示例保存的路径可以随意，但需要注意：路径不能有中文和空格，否则报错。

2）创建完成，如下图所示。

 打开后，如果右下角提示是否允许Makefile Tools配置，则选择不允许。

如果不小心选择了允许，则会出现：头文件报警告“在 browse.path 中未找到包含文件”，即头文件有波浪线，无法跳转。原因：本地没有安装cmake。

解决办法：在.vscode->c_cpp_properties.json中删除"configurationProvider": "ms-vscode.cmake-tools"即可。

三、修改例程的配置和代码，编译、下载到ESP32开发板。

3.1 将四元组生成bin文件进行烧录，适合量产。

smart_light例程，详见博客：图文手把手教程--ESP32 MQTT连接阿里云生活物联网平台

1）打开例程smart_light，复制single_mfg_config.csv到ota_example_mqtt项目下。

 

 2）打开single_mfg_config.csv，可以看到四元组已填写好了。

 3）四元组生成bin文件以及烧录四元组bin文件，详见以下的博客：

 图文手把手教程--ESP32 MQTT连接阿里云生活物联网平台

3.2 配置flash大小和分区表。

打开SDK可视化配置，设定flash大小和设定“partition table”分区表。

3.3 配置wifi帐号和密码。

3.4 配置版本号为1.0.0。

3.5 修改app_main()代码。

void app_main()
{
    conn_mgr_init();
    conn_mgr_register_wifi_event(wifi_event_handle);
	conn_mgr_set_wifi_config_ext((const uint8_t *)EXAMPLE_WIFI_SSID, strlen(EXAMPLE_WIFI_SSID), (const uint8_t *)EXAMPLE_WIFI_PASS, strlen(EXAMPLE_WIFI_PASS));

    IOT_SetLogLevel(IOT_LOG_DEBUG);//设置日志水平为5，高于5的日志被屏蔽，例如：LOG_FLOW_LEVEL被屏蔽不打印。

    conn_mgr_start();

    while (1)
    {
        printf("firmware_version=%s\n", CONFIG_LINKKIT_FIRMWARE_VERSION);//打印版本号
        vTaskDelay(1000 / portTICK_PERIOD_MS);
    }
}

3.6 修改ota_solo.c中170行的代码。

//if (0 != IOT_OTA_ReportVersion(h_ota, "iotx_ver_1.0.0")) {
    if (0 != IOT_OTA_ReportVersion(h_ota, CONFIG_LINKKIT_FIRMWARE_VERSION)) {
        rc = -1;
        EXAMPLE_TRACE("report OTA version failed");
        goto do_exit;
    }

3.7 编译、下载到ESP32开发板。

打开串口监控，显示信息如下图所示。

四、在阿里云物联网平台，进行OTA批量升级。

4.1 配置版本号为2.0.0，保存后重新进行编译。

4.2 将生成的bin文件，复制到桌面，并重命名为ota_example_mqtt_v2.0.0。

 

 4.3 在阿里云物联网平台，添加升级包并发起批量升级。

1）登陆进入阿里云物联网平台，进入公共实例。

2）监控运维->OTA升级->添加升级包。

 

3）添加升级包完成，如下图所示。

 4）ESP32下载的程序版本是1.0.0，在VSCODE中先打开串口监控，以便观察升级的过程。

5）点击批量升级。

 6）选择静态升级，定向升级，选择要升级的设备，然后点击下一步。

 

7）点击完成后，在VSCODE串口监控中可以看到，收到平台发送的升级指令。

正在下载固件中...

8）最后可以看到MD5验证失败，原因是从平台得到的origin为空，但升级却显示成功了。

 

从打印的版本号，确实是升级成功了。

五、解决固件校验失败，平台显示升级失败的问题。

1）修改以下代码。

case IOT_OTAG_CHECK_FIRMWARE:
            if ((4 != buf_len) || (0 != ((unsigned long)buf & 0x3))) {
                OTA_LOG_ERROR("Invalid parameter");
                h_ota->err = IOT_OTAE_INVALID_PARAM;
                return -1;
            } else if (h_ota->state != IOT_OTAS_FETCHED) {
                h_ota->err = IOT_OTAE_INVALID_STATE;
                OTA_LOG_ERROR("Firmware can be checked in IOT_OTAS_FETCHED state only");
                return -1;
            } else {
                char md5_str[33];
                otalib_MD5Finalize(h_ota->md5, md5_str);
                //OTA_LOG_DEBUG("origin=%s, now=%s", h_ota->md5sum, md5_str);//删除
                OTA_LOG_DEBUG("origin=%s, now=%s", h_ota->sign, md5_str);    //增加
                //if (0 == strcmp(h_ota->md5sum, md5_str)) {                 //删除
                if (0 == strcmp(h_ota->sign, md5_str)) {                     //增加
                    *((uint32_t *)buf) = 1;
                } else {
                    *((uint32_t *)buf) = 0;
                    IOT_OTA_ReportProgress(h_ota, IOT_OTAP_CHECK_FALIED, NULL);
                    OTA_LOG_ERROR("image checksum compare failed");
                }
                return 0;
            }

造成此原因，是因为从平台得到的升级包签名，是保存在h_ota->sign变量中，而不是h_ota->md5sum，所以这里存在BUG，需要修改。

 2）修改完毕后，重新编译、下载程序到ESP32开发板中，打开串口监控。

 平台中显示升级成功。

六、修改版本号涉及的几个地方。

1）宏定义所在的文件--工程->sdkconfig。 

2） 上报版本号所在的文件--工程->ota_solo.c。

3） 获取固件版本号所在的文件--ESP32-IDF\esp\esp-idf\components\esp-aliyun\wrappers。

 4）调试用，增加的版本号打印。

至此，ESP32 OTA空中升级(阿里云物联网平台)已全部完成，愉快的玩耍吧！

完整的例程代码下载：https://download.csdn.net/download/felix_tao/86469362

使用例程，报错怎么办，解决办法如下：

1）打开VSCODE报错，c_cpp_properties.json无法找到E:\\ESP32-IDF...

解决办法：点击.vscode->c_cpp_properties.json，修改盘符即可，例如将E盘改为D盘。

2）编译工程报错：

[0/1] Re-running CMake...
FAILED: build.ninja 
CreateProcess failed: The system cannot find the file specified.
ninja: error: rebuilding 'build.ninja': subcommand failed

解决方法：清除编译产生的所有文件，左下角->点击垃圾桶图标(ESP-IDF Full Clean)->清除后，接着重新编译即OK。

本文参考的文档：

设备OTA开发 - 设备接入Link SDK - 阿里云