Ebullient开发文档之OTA升级(从TF中升级简洁明了)

news2024/12/26 15:21:13

一. 简介

这一篇将给大家介绍如何进行OTA升级(esp32s3), 为了简单方便，可操作性强，这次是从TF中读取固件来进行跟新，本来想看看网上有没有参考的，有是有，但绝大多数都是基于官方的例程，甚至贴出来的源码和官方基本一样，很难有操作性，还需要自己去分析，从中得到在代码中是如何操作的，没有啥参考性，还不如直接去研究官方例程(ಥ_ಥ) 。

本次先简单介绍一下OTA升级流程，然后在代码中一目了然实现OTA升级(其实官方给我们做了很好的封装，需要自己写的代码量非常少)。

二. OTA升级原理

原理简单概括就是: 在flash开辟两个app区域和一块ota数据区域，bootloader根据ota区域中的数据来决定执行那块区域中的app；当app需要更新的时候，app会将接送到的固件下载到另外一块app区域，和修改ota数据，最后重启，就可以了。这只是其中一种方案，其它方案原理是一样，只是方法上有略微的区别。

原理就是这样非常简单，下面就来看看在esp32中如何操作。

三. ESP32-IDF实现OTA升级

(1). 修改分区表

将nvs区域的大小由0x6000减小为0x4000,将多出来的0x2000大小的区域分配给otadata，(官方文档解释)OTA 数据分区的容量是 2 个 flash 扇区的大小（0x2000 字节），防止写入时电源故障引发问题。两个扇区单独擦除、写入匹配数据，若存在不一致，则用计数器字段判定哪个扇区为最新数据。

(2). 添加app区域

将factory区域去掉(不去掉也可以，如果flash只够大的话)，添加两个app区域，大小由自己决定，我的flash大小为16M，所以我这里每个app的大小分配的5M，再大就放不下啦。

请添加图片描述

我们通过idf下载程序的时候，默认会下载到app0区域中，启动也是默认从app0启动的。如果带有factory区域的话，那么默认会下载到factory区域，启动的时候，会先检测app0/1是不是设置为了启动区域，不是的话就从factory区域驱动，否则就从对应的app区域中启动

(3). 代码实现

在CmakeList下的idf_component_register中添加app_update组件，这样才能调用OTA相关的库和函数
#include“esp_ota_ops.h”
编写代码

//从tfcard中更新固件
void firmware_update_from_tfcard(char *filename){
    esp_ota_handle_t update_handle = 0 ;
    esp_partition_t *update_partition = esp_ota_get_next_update_partition(NULL);
    assert(update_partition != NULL);
    ESP_LOGI("ota", "Writing to partition subtype %d at offset 0x%"PRIx32,
            update_partition->subtype, update_partition->address);
    char file[255];
    snprintf(file, 255, "/sdcard/firmware/%s", filename);
    FILE *fp = TFCard_Open(file,"rb");
    esp_ota_begin(update_partition, OTA_WITH_SEQUENTIAL_WRITES, &update_handle);
    while(1){
        uint16_t size = 0;
        uint8_t buf[1024];
        size = TFCard_Read(fp,buf,1024);
        esp_ota_write( update_handle, (const void *)buf, size);
        if( size < 1024)
            break;
        ota_update.ota_update_curr_size += 1024;
        vTaskDelay(10);
    }
    esp_ota_end(update_handle);
    esp_ota_set_boot_partition(update_partition);
    esp_restart();
}