资产监测设备中关于OPL1200 芯片OTA升级的API说明

Posted 2021-10-19 瑞奇Ricky

近期笔者的研发团队正在研究如何优化资产监测设备的功能，主要从软件和硬件两个方面进行，本期着重于软件方面的升级。但软件升级后，有些提供给客户的API有所改动，作为研发团队需要提供新的API说明，供客户参考。借此机会分享给对资产监测技术感兴趣的用户。

资产监测设备简介：
资产监测监测设备是基于物联网技术的延伸发展，主要应用于智慧物流方向，帮助用户实现运输中的资产实时监测。资产监测技术的工作原理，简单来说是用传感技术与全球定位技术进行数据采集，再通过芯片进行数据计算，最后通信模块与网络将信息传递至云端后台，供用户随时随地查看。

资产监测设备的功能：
资产监测设备的主要功能是提供运输中的资产实时定位、帮助用户了解货物运输的具体情况。同时根据运输轨迹，用户可以监测运输路线与运输速度。对于运输过程中，货物出现丢失、暴力扔件等情况，该系统会自动报警，提醒用户及时采取相关措施，避免资产受损。

资产监测设备中OPL1200芯片OTA升级的API说明：
/*
*获取OPL1200当前工程ID、芯片ID和固件版本号
*/
uint8_t ota_get_version(uint16_t *project_id, uint16_t *chip_id, uint16_t *firmware_id)
{
uint8_t state = MW_OTA_OK;
state = MwOta_VersionGet(project_id, chip_id, firmware_id);
return state;

}
/*
*从OTA文件中获取OPL1200待升级固件的工程ID、芯片ID和固件版本号，根据此确定固件烧录位置，进行升级前的准备工作
*/
uint8_t ota_prepare(uint16_t project_id, uint16_t chip_id, uint16_t firmware_id, uint32_t img_size, uint32_t img_sum)
{
uint8_t state = MW_OTA_OK;
state = MwOta_Prepare(project_id, chip_id, firmware_id, img_size, img_sum);
return state;

}
/*
*OAT文件的写入，ota_prepare之后，直接利用该函数进行写入即可
*/
uint8_t ota_data_write(uint8_t *pubAddr, uint32_t ulSize)
{
uint8_t state = MW_OTA_OK;
state = MwOta_DataIn(pubAddr, ulSize);
return state;

}
/*
*OAT升级完成
*/
uint8_t ota_data_finish(void)
{
uint8_t state = MW_OTA_OK;
state = MwOta_DataFinish();
return state;

}
/*
*放弃OAT升级
*/
uint8_t ota_abort(void)
{
uint8_t state = MW_OTA_OK;
state = MwOta_DataGiveUp();
return state;
}

正在使用该设备或对此感兴趣的用户，可查看以上文档
​