Air780EP模塊AT開發(fā)FOTA遠(yuǎn)程升級指南
簡介
AT版本的遠(yuǎn)程升級主要是對AT固件進(jìn)行升級,實(shí)際方式為通過合宙官方IOT平臺升級或者使用自己搭建的服務(wù)器進(jìn)行升級服務(wù)。
關(guān)聯(lián)文檔和使用工具:
AT固件獲取
生成差分包工具網(wǎng)址
合宙IOT平臺配置
此為合宙IOT平臺對應(yīng)鏈接。
升級日志 —— 如何查看
升級日志 —— 響應(yīng)碼列表
響應(yīng)碼 | 響應(yīng)信息 | 問題以及解決辦法 | 云平臺日志結(jié)果 |
---|---|---|---|
3 | 無效的設(shè)備 | 檢查請求鍵名(imei小寫)正確性 | 無 |
17 | 無權(quán)限 | 設(shè)備會上報imei、固件名、項(xiàng)目key。 服務(wù)器會以此查出設(shè)備、固件、項(xiàng)目三 條記錄, 如果 這三者不在同一個用戶名下,就會認(rèn)為無權(quán)限。 設(shè)備不在項(xiàng)目key對應(yīng)的賬戶下, 可尋找合宙技術(shù)支持查詢該設(shè)備在哪個賬戶下, 核實(shí)情況后可修改設(shè)備歸屬 | 無權(quán)限 |
21 | 21 | 不允許從1.0.2升到1.0.3 | 21 |
25 | 無效的項(xiàng)目 | productkey不一致,檢查是否存在拼寫錯誤, 檢查模塊是否在本人賬戶下,若不在本人賬戶下,請聯(lián)系合宙工作人員處理 | 未找到項(xiàng)目 |
26 | 無效的固件 | 固件名稱錯誤,項(xiàng)目中沒有對應(yīng)的固件。用戶自己修改了固件名稱,可對照升級日志中設(shè)備當(dāng)前固件名與升級配置中固件名是否相同(固件名稱,固件功能要完全一致,只是版本號不同)。 | 找不到固件 |
27 | 已是最新版本 | 1、設(shè)備固件版本高于云平臺 2、固件版本設(shè)備腳本版本高于云平臺版本 3、用戶項(xiàng)目升級配置中未添加該設(shè)備 4、云平臺升級配置中,是否升級配置為否 | 已是最新版本 設(shè)備不在配置的升級設(shè)備列表中 |
40 | 循環(huán)升級 | 云平臺進(jìn)入設(shè)備列表搜索被禁止的imei,解除禁止升級就好了。 云平臺防止模塊在升級失敗后,反復(fù)請求升級導(dǎo)致流量耗盡, 在模塊一天請求升級六次后會禁止模塊升級??稍谄脚_解除。 | 檢測到循環(huán)升級 (已禁止升級,請到設(shè)備列表解除) |
43 | 請等待 | 云平臺生成差分升級包需要等待, 一到三分鐘后云平臺生成完成差分包便可以請求成功。 | 正在生成版本,請等待 |
44 | 基礎(chǔ)版本缺失 | 平臺未收錄設(shè)備固件(多為定制固件, 可尋找合宙技術(shù)支持人員添加,需提供定制固件郵件) | 基礎(chǔ)CORE版本缺失 |
使用默認(rèn)項(xiàng)目名配置
客戶在向合宙采購4G模塊時,如果采購人員沒有告知這批模塊應(yīng)該放在IOT平臺的哪個產(chǎn)品下,合宙則會以采購人的手機(jī)號為賬號,默認(rèn)密碼888888,需要創(chuàng)建一個"Air7XXF標(biāo)準(zhǔn)模塊"的項(xiàng)目。
注意:以**"Air7XXF標(biāo)準(zhǔn)模塊"**命名的項(xiàng)目,為780EP模塊AT版本默認(rèn)FOTA請求升級的IOT項(xiàng)目。并將此次所采購的所有模塊都放在這個項(xiàng)目下,如果模塊沒在該項(xiàng)目下或者需要更換項(xiàng)目請聯(lián)系合宙工作人員。
配置流程
以780EP為例,獲取AT固件版本,下載到本地后解壓并將dfota.bin文件上傳到dfota中。
- 在IOT平臺-我的項(xiàng)目頁面點(diǎn)擊固件列表
2.創(chuàng)建固件,上傳對應(yīng)文件
3.上傳好文件之后會自動生成固件名稱,不需要修改
4.如果配置“升級全部設(shè)備”選項(xiàng)為“是”,則無需配置IMEI,按照上述內(nèi)容配置即可。如果選擇“否”,還需添加IMEI,如下圖所示。
AT指令觸發(fā)升級
手動觸發(fā)升級
如下模塊從V1006升級到V1007的流程
自動升級(默認(rèn)24小時內(nèi)自動觸發(fā))
自動升級是模塊定期向后臺發(fā)送升級請求,來獲取新固件進(jìn)行更新的,大致流程如下
可以通過AT+UPGRADE="PERIOD",60設(shè)置自動升級時間,這里設(shè)置為60s來作為演示
使用自建項(xiàng)目名配置
客戶從合宙采購?fù)昴K之后,注冊登錄合宙IOT平臺,在IOT平臺我的項(xiàng)目頁面新建一個項(xiàng)目,并要求合宙工作人員將這批模塊放入新建的項(xiàng)目中(客戶本身無權(quán)限進(jìn)行操作)。本示例就以“遠(yuǎn)程升級模塊”為項(xiàng)目名進(jìn)行遠(yuǎn)程升級。
該項(xiàng)目下的模塊可通過設(shè)備列表查看
配置流程
- 參考[使用默認(rèn)項(xiàng)目名配置](# 使用默認(rèn)項(xiàng)目名配置)下的配置流程
- 注意此時的項(xiàng)目為“遠(yuǎn)程升級模塊”
AT指令觸發(fā)升級
手動觸發(fā)升級
- 通過下方圖示操作,找到對應(yīng)項(xiàng)目的項(xiàng)目Key。
復(fù)制項(xiàng)目Key,用AT+UPGRADE="KEY",ProductKey進(jìn)行配置,其中ProductKey為對應(yīng)項(xiàng)目Key
要注意的是該命令參數(shù)會寫入nv,掉電保存
然后再發(fā)送AT+UPGRADE進(jìn)行遠(yuǎn)程升級
自動升級(默認(rèn)24小時內(nèi)自動觸發(fā))
自動升級是模塊定期向后臺發(fā)送升級請求,來獲取新固件進(jìn)行更新的,大致流程如下
可以通過AT+UPGRADE="PERIOD",60設(shè)置自動升級時間,這里設(shè)置為60s來作為演示
自定義服務(wù)器升級
- 使用自己的服務(wù)器來升級模塊和使用iot平臺升級最重要的區(qū)別是下載固件的來源不同。
- 其實(shí)FOTA的過程是新老版本生成差分包再進(jìn)行升級的過程,那么這個差分的過程在哪里呢?使用合宙iot平臺升級,差分的過程在iot服務(wù)器后臺,那使用自己的服務(wù)器該怎么辦呢?答案當(dāng)然是自己來完成差分的過程,放在服務(wù)器等待模塊來下載。
差分包生成工具
? 手動生成差分包的過程使用doc平臺工具中的差分工具 差分工具
? 注意:升級文件為 xxxx.dfota.bin 文件
下載生成的差分文件
- 本次我們從V1006升級到V1007需要準(zhǔn)備各自的bin遠(yuǎn)程升級文件,上傳完成后等待差分完成,下載得到的差分文件,這里將名字改為dfota_final_AirM2M_AirM2M_V1007.bin。
配置流程
- 把生成的固件放到服務(wù)器上,然后通過**AT+UPGRADE="URL",""**指令設(shè)置對應(yīng)的URL鏈接。
- 配置完差分包URL地址成功后,**AT+UPGRADE **主動觸發(fā)升級。
- 升級流程如下,這里選擇了USB的另外一個端口,可以上報模塊的升級過程:
恭喜你成功從V1006版本通過自定義服務(wù)器搭建FOTA服務(wù)的方式升級到了更新的V1007版本
-
IOT
+關(guān)注
關(guān)注
187文章
4213瀏覽量
196850 -
FOTA
+關(guān)注
關(guān)注
0文章
23瀏覽量
7708 -
合宙通信
+關(guān)注
關(guān)注
0文章
147瀏覽量
1751
發(fā)布評論請先 登錄
相關(guān)推薦
評論