OTA移植API

更新时间：2018-10-19 11:29:34

移植指南

1 背景

OTA升级作为物联网设备的一项基础功能，可以快速修复软件漏洞，更新系统,对于快速迭代的物联网产品是刚性需求；目前IOT设备种类繁多，但并未提供统一的OTA升级方案，针对日益发展的IOT设备，开发者迫切需要一套云端一体化的OTA升级方案来满足快速迭代的产品开发周期，同时降低产品开发和部署的成本。

2 目标

对于接入AliOS Things的物联网设备，阿里巴巴云端和设备端OTA组件为用户提供云端一体化的OTA升级服务; 对于使用OTA升级服务的用户只需按照此文档实现移植层接口后就可以轻松使用阿里巴巴物联网OTA升级服务。

3 使用对象

使用AliOS Things 的开发者或用户，代码路径:https://github.com/alibaba/AliOS-Things.git 分支:rel_2.0.0

4 移植使用说明

AliOS Things OTA设备端软件架构如下图所示，OTA核心组件为通用组件，设备端OTA整体功能移植到不同的平台和操作系统，需分别实现如图标注为粉色的底层平台接口移植层和操作系统接口移植层，AliOS Things操作系统移植接口已完成对接，因此使用时无需移植，新芯片或者模组导入只需简单实现底层平台移植层接口(5个回调函数接口)就可以正常使用AliOS Things云端一体化的OTA服务。差分升级需要配合boot移植差分还原模块，目前只在平台8266和3080平台上面支持。

5 移植接口详细说明

5.1 启动服务接口

在设备连接上阿里云之后，可以通过调用ota_service_init(NULL)接口启动OTA服务,默认接口参数为空，将使用系统默认烧录的四元组，也可以手动传入四元组等参数启动，默认传输协议支持MQTT，固件下载协议支持HTTPs。

typedef struct {
    int   inited;  /*If is inted*/
    char  pk[PRODUCT_KEY_MAXLEN + 1];/*Product Key*/
    char  ps[PRODUCT_SECRET_MAXLEN + 1];/*Product secret*/
    char  dn[DEVICE_NAME_MAXLEN + 1];/*Device name*/
    char  ds[DEVICE_SECRET_MAXLEN + 1];/*Device secret*/
    char  uuid[64];
    int   trans_protcol;  /*default:0--> MQTT 1-->COAP*/
    int   dl_protcol;     /*default:3--> HTTPS 1-->COAP 2-->HTTP*/
    int   sign_type;      /*default:0--> sha256 1--> md5 2-->RSA*/
    int   firm_size;
    char* dl_url;         /*Dowdload URL*/
    void* h_coap;
} ota_service_manager;

int ota_service_init(ota_service_manager* context);

5.2 底层平台移植层接口

OTA回调函数的实现代码位于platform/mcu/xxx/hal/ota_port.c,init实现初始化OTA分区及分区固件大小检查擦除，ota_write实现对下载数据解释后分段写入OTA分区中，ota_read完成从flash读出数据，ota_set_boot用于升级成功时告诉boot下次启动到新升级的分区, ota_rollback用于乒乓升级升级时与bootloader共同完成回滚到老的分区，在平台初始化的时候会调用hal_ota_register_module(&ota_hal_module)注册上述回调接口。

struct hal_ota_module_s {
    hal_module_base_t base;

    /* Link to HW */
    int (*init)(hal_ota_module_t *m, void *something);
    int (*ota_write)(hal_ota_module_t *m, volatile uint32_t *off_set,
                     uint8_t *in_buf , uint32_t in_buf_len);
    int (*ota_read)(hal_ota_module_t *m,  volatile uint32_t *off_set,
                    uint8_t *out_buf , uint32_t out_buf_len);
    int (*ota_set_boot)(hal_ota_module_t *m, void *something);
    int (*ota_rollback)(hal_ota_module_t *m, void *something);
};

init

入参

返回值

ota_write

入参

返回值

ota_read

入参

返回值

ota_set_boot

入参

升级完成参数

typedef struct  {
    OTA_ENUM_UPDATE_TYPE update_type;
    OTA_ENUM_RESULT_TYPE result_type;
    OTA_ENUM_FIRMWARE_TYPE  firmware_type;
    uint32_t splict_size;
    uint8_t diff_version;
    uint8_t rollback;
} ota_finish_param_t;

详细说明：

返回值

ota_rollback

入参