日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

AI 助理
備案控制臺
文檔
有獎?wù){(diào)研
輸入文檔關(guān)鍵字查找
首頁 物聯(lián)網(wǎng)平臺 操作指南 監(jiān)控運(yùn)維 OTA升級 OTA升級概述

OTA升級概述

更新時(shí)間：
產(chǎn)品詳情
相關(guān)技術(shù)圈
我的收藏

OTA（Over-the-Air Technology）即空中下載技術(shù)，基于無線網(wǎng)絡(luò)對設(shè)備固件、軟件或驅(qū)動進(jìn)行更新。通過OTA升級，可以對物聯(lián)網(wǎng)設(shè)備更新功能、修復(fù)漏洞、優(yōu)化性能。本文介紹如何為接入物聯(lián)網(wǎng)平臺的設(shè)備進(jìn)行OTA升級。

使用限制

使用OTA功能的設(shè)備必須使用MQTT協(xié)議接入物聯(lián)網(wǎng)平臺，設(shè)備可以選擇MQTT協(xié)議或HTTPS協(xié)議下載升級包。

  • 單個(gè)阿里云賬號最多有500個(gè)升級包，賬號下所有RAM用戶共享配額。

  • 升級包的數(shù)量、大小、格式和地域限制。

    • HTTPS協(xié)議下載：可以包括一個(gè)或多個(gè)文件，單個(gè)文件最大為1,000 MB。僅支持.bin、.dav、.tar、.gz、.zip、.gzip、.apk、.tar.gz、.tar.xz、.pack格式的文件。

    • MQTT協(xié)議下載：僅包含一個(gè)文件，且文件大小不超過16 MB。目前僅支持中國華東2（上海）、華北2（北京）和華南1（深圳）地域。推薦使用物聯(lián)網(wǎng)平臺提供的C語言Link SDK，開發(fā)MQTT下載文件的能力。詳細(xì)內(nèi)容，請參見示例代碼說明。

工作原理

image
說明

  • 公共實(shí)例的轉(zhuǎn)移設(shè)備僅支持發(fā)起升級方式為靜態(tài)升級的批量升級任務(wù)。

    • 轉(zhuǎn)移設(shè)備的發(fā)起方：添加升級包、驗(yàn)證升級包。

    • 轉(zhuǎn)移設(shè)備的接收方：查看升級包、發(fā)起升級批次。

  • 分發(fā)的設(shè)備在被分發(fā)到目標(biāo)實(shí)例后可正常進(jìn)行OTA升級。

前提條件

OTA升級步驟

image
說明

本文示例使用C語言Link SDK，其他語言SDK示例請參見設(shè)備接入概述。

步驟一：設(shè)備上報(bào)版本號

  1. 配置OTA。

    1. 設(shè)備接入物聯(lián)網(wǎng)平臺。登錄物聯(lián)網(wǎng)平臺控制臺，單擊對應(yīng)實(shí)例，在左側(cè)導(dǎo)航欄選擇設(shè)備管理 > 設(shè)備，找到目標(biāo)設(shè)備，查看設(shè)備狀態(tài)。設(shè)備狀態(tài)顯示為在線，則表示設(shè)備與物聯(lián)網(wǎng)平臺成功連接。

    2. 初始化OTA功能。

    3. 配置OTA功能。

  2. 設(shè)備上報(bào)當(dāng)前版本號。設(shè)備需要在首次升級前上報(bào)版本號，建議只在系統(tǒng)啟動過程中上報(bào)一次，不需要周期循環(huán)上報(bào)。僅支持每次上報(bào)一個(gè)模塊及對應(yīng)的模塊版本，如果需要上報(bào)多個(gè)模塊的版本，請分次上報(bào)。上報(bào)的Topic和消息格式參見文末的消息格式。

步驟二：推送升級包信息

  1. 購買和查看OTA升級次數(shù)：查看當(dāng)前實(shí)例下可用的OTA升級次數(shù)，如果可用OTA升級次數(shù)不足，請先購買套餐包。

    • 對于新版公共實(shí)例，提供免費(fèi)額度10次/自然月。

    • 對于企業(yè)版實(shí)例，提供免費(fèi)額度1000次/自然月。

  2. 添加升級包：為產(chǎn)品添加OTA模塊和升級包。

    • 模塊：由用戶自定義，是同產(chǎn)品下設(shè)備的不同可升級模塊，例如固件、軟件、驅(qū)動等。默認(rèn)（default）模塊表示整個(gè)設(shè)備的固件。

    • 整包：完整的升級文件，可以添加單個(gè)或多個(gè)升級包，如果添加多個(gè)示例包必須使用C語言的Link SDK。整包升級前，設(shè)備可不上報(bào)OTA模塊版本。如不上報(bào)，配置批量升級時(shí)不能針對指定版本進(jìn)行升級，具體說明，請參見發(fā)起升級批次任務(wù)。

    • 差分：僅包含新版本升級包與之前版本的差異部分，設(shè)備需要本地進(jìn)行差分還原，并還原為完整升級包進(jìn)行升級，差分升級可有效降低OTA升級次數(shù)消耗和設(shè)備下載差分包的流量消耗。差分升級前，設(shè)備必須上報(bào)OTA模塊版本。

      • 使用AliOS Things芯片的設(shè)備，阿里云提供差分包生成方法和差分還原算法，請參見OTA差分工具使用指南。

      • 其他設(shè)備，需要您自行生成差分包并完成差分還原算法開發(fā)。

  3. （可選）驗(yàn)證升級包：添加升級包時(shí)選擇升級包是否需要平臺驗(yàn)證為是，則在批量升級前，需選擇部分設(shè)備用于測試。測試設(shè)備升級成功后，才能使用升級包。

    可以選擇是否由App確認(rèn)升級后才能進(jìn)行OTA升級，App確認(rèn)升級的流程如下：

    1. 用戶自行開發(fā)App，平臺不會主動推送升級消息給設(shè)備，需要App主動查詢。

    2. App側(cè)調(diào)用ListOTAUnfinishedTaskByDevice，查詢未完成狀態(tài)的設(shè)備升級作業(yè)。

    3. App側(cè)調(diào)用ConfirmOTATask，確認(rèn)升級任務(wù)后，平臺才會主動推送升級消息給設(shè)備。

  4. 發(fā)起升級批次任務(wù)：物聯(lián)網(wǎng)平臺向設(shè)備批量下發(fā)升級相關(guān)信息（升級包URL、版本、大小等）。發(fā)起批量升級后，在控制臺顯示的設(shè)備狀態(tài)是待升級或待確認(rèn)。當(dāng)物聯(lián)網(wǎng)平臺接收到設(shè)備上報(bào)的升級進(jìn)度時(shí)，設(shè)備升級正式開始，在控制臺顯示的設(shè)備狀態(tài)是升級中。

步驟三：設(shè)備下載升級包

  1. 設(shè)備獲取升級包信息。設(shè)備離線時(shí)不能接收OTA服務(wù)端推送的升級消息，設(shè)備再次上線后，OTA服務(wù)端驗(yàn)證該設(shè)備是否需要升級。如果需要升級，物聯(lián)網(wǎng)平臺再次推送升級消息給設(shè)備，否則不推送消息。

    • 物聯(lián)網(wǎng)平臺推送升級包信息。設(shè)備訂閱Topic：/ota/device/upgrade/${YourProductKey}/${YourDeviceName}，物聯(lián)網(wǎng)平臺對設(shè)備發(fā)起OTA升級請求后，設(shè)備通過該Topic收到升級信息。具體有以下兩種情況：

      • 發(fā)起升級任務(wù)時(shí)設(shè)備在線，物聯(lián)網(wǎng)平臺會直接推送升級相關(guān)信息。

      • 發(fā)起升級任務(wù)時(shí)設(shè)備離線，之后設(shè)備上線，物聯(lián)網(wǎng)平臺會推送一次升級相關(guān)信息。

    • 設(shè)備主動拉取升級包信息。設(shè)備向Topic發(fā)布消息，物聯(lián)網(wǎng)平臺收到消息并通過另一Topic返回升級包信息。拉取升級包的Topic和消息格式參見文末的消息格式。

    • 物聯(lián)網(wǎng)平臺發(fā)給設(shè)備的HTTPS協(xié)議、MQTT協(xié)議的下載消息格式參見文末的消息格式。

  2. 設(shè)備使用HTTPS協(xié)議或MQTT協(xié)議下載升級包。

  3. 設(shè)備上報(bào)升級進(jìn)度。上報(bào)進(jìn)度的Topic和消息格式參見文末的消息格式。

    重要

    如果設(shè)備上報(bào)進(jìn)度的間隔低于3秒，在物聯(lián)網(wǎng)平臺控制臺的OTA升級包詳情的批次詳情中，可能無法查看到上報(bào)的全部進(jìn)度。

  4. 設(shè)備上報(bào)最新版本號。設(shè)備升級完成后，建議立即重啟設(shè)備，設(shè)備上線后，立即上報(bào)新的版本號。設(shè)備上線請求和上報(bào)版本請求間隔不能超過2秒。

    重要

    如果設(shè)備上報(bào)的版本與OTA服務(wù)要求的版本一致就認(rèn)為升級成功，反之認(rèn)為失敗，這是物聯(lián)網(wǎng)平臺判斷設(shè)備升級成功的唯一條件。即使升級進(jìn)度上報(bào)為100%，如果不上報(bào)新的版本號，可能因?yàn)槌^設(shè)備升級超時(shí)時(shí)間導(dǎo)致升級失敗。

    • Topic：/ota/device/inform/${YourProductKey}/${YourDeviceName}

    • 消息格式

      {
  "id": 1,
  "params": {
    "version": "2.0.0"
  }
}

步驟四：查看升級結(jié)果

  1. 查看升級情況：查看目標(biāo)設(shè)備升級狀態(tài)、升級包信息等。

  2. 查看升級包版本和成功率：查看升級后的版本分布和成功率分布統(tǒng)計(jì)，分析OTA升級失敗原因，進(jìn)而提升設(shè)備升級成功率。

相關(guān)文檔

消息格式

上報(bào)版本號

  • Topic：/ota/device/inform/${YourProductKey}/${YourDeviceName}

  • 消息格式

    {
  "id": 1,
  "params": {
    "version": "1.0.0",
    "module":"mcu"      //該參數(shù)如果不填，表示默認(rèn)版本號default
  }
}

    參數(shù)

    類型

    說明

    id

    String

    消息ID號。數(shù)字可為String或Long類型，以設(shè)備端上報(bào)的數(shù)據(jù)類型為準(zhǔn)。取值范圍為0~4294967295，且每個(gè)消息ID在當(dāng)前設(shè)備中具有唯一性。

    version

    String

    OTA模塊版本。

    module

    String

    OTA模塊名。上報(bào)默認(rèn)（default）模塊的版本號時(shí)，可以不上報(bào)module參數(shù)。默認(rèn)（default）模塊代表整個(gè)設(shè)備的固件版本號。

主動拉取升級包

  1. 設(shè)備發(fā)布消息到Topic：/sys/{productKey}/{deviceName}/thing/ota/firmware/get。

    • 消息格式

      {
    "id": "123",
    "version": "1.0",
    "params": {
        "module": "MCU"
    },
    "method": "thing.ota.firmware.get"
}

    • 參數(shù)說明

      參數(shù)

      類型

      說明

      id

      String

      消息ID號。String類型的數(shù)字，取值范圍0~4294967295，且每個(gè)消息ID在當(dāng)前設(shè)備中具有唯一性。

      version

      String

      協(xié)議版本，固定為1.0。

      params

      Object

      請求參數(shù)。

      module

      String

      升級包所屬的模塊名。不指定則表示請求默認(rèn)（default）模塊的升級包信息。

      method

      String

      請求方法，取值thing.ota.firmware.get。

  2. 物聯(lián)網(wǎng)平臺收到請求后，通過響應(yīng)Topic：/sys/{productKey}/{deviceName}/thing/ota/firmware/get_reply，向設(shè)備端返回升級包信息。

HTTPS協(xié)議下載

單文件包下載

{
    "id": "123",
    "code": 200,
    "data": {
        "size": 93796291,
        "sign": "f8d85b250d4d787a9f483d89a974***",
        "version": "10.0.1.9.20171112.1432",
        "isDiff": 1,
        "url": "https://the_firmware_url",
        "signMethod": "MD5",
        "md5": "f8d85b250d4d787a9f48***",
        "module": "MCU",
        "extData":{
            "key1":"value1",
            "key2":"value2",
            "_package_udi":"{\"ota_notice\":\"升級底層攝像頭驅(qū)動，解決視頻圖像模糊的問題。\"}"
        }
    }
}

多文件包下載

{
    "code": "1000",
    "data": {
        "version": "2.0.0",
        "isDiff": 1,
        "signMethod": "MD5",
        "files":[
            {
                "fileSize":432944,
                "fileName":"file1-name",
                "fileUrl":"https://***/nop***.tar.gz?Expires=1502955804&OSSAccessKeyId=***&Signature=***XJEH0qAKU%3D&security-token=CAISuQJ***",
                "fileMd5":"93230c3bde425a9d***",
                "fileSign":"93230c3bde425a9d****"
            },
            {
                "fileSize":432945,
                "fileName":"file2-name",
                "fileUrl":"https://***/no***.tar.gz?Expires=1502955804&OSSAccessKeyId=***&Signature=***qAKU%3D&security-token=***q6Ft5B2y***",
                "fileMd5":"93230c3bde425a92***",
                "fileSign":"93230c3bde425a92****"
            }
        ],
        "module": "MCU",
        "extData":{
            "key1":"value1",
            "key2":"value2",
            "_package_udi":"{\"ota_notice\":\"升級底層攝像頭驅(qū)動，解決視頻圖像模糊的問題。\"}"
        }
    },
    "id": 1626969597470,
    "message": "success"
}

參數(shù)

類型

說明

id

Long

消息ID號。每個(gè)消息ID在當(dāng)前設(shè)備中具有唯一性。

message

String

結(jié)果信息。

code

String

狀態(tài)碼。

version

String

設(shè)備升級包的版本信息。

size

Long

升級包文件大小，單位：字節(jié)。

OTA升級包中僅有一個(gè)升級包文件時(shí)，包含該參數(shù)。

url

String

升級包在對象存儲（OSS）上的存儲地址。

OTA升級包中僅有一個(gè)升級包文件，且下載協(xié)議為HTTPS時(shí)，包含該參數(shù)。

dProtocol

String

升級包下載協(xié)議。

僅升級包下載協(xié)議為MQTT時(shí)，包含該參數(shù)。

streamId

Long

通過MQTT協(xié)議下載OTA升級包時(shí)的唯一標(biāo)識。

僅升級包下載協(xié)議為MQTT時(shí)，包含該參數(shù)。

streamFileId

Integer

單個(gè)升級包文件的唯一標(biāo)識。

僅升級包下載協(xié)議為MQTT時(shí)，包含該參數(shù)。

isDiff

Long

僅當(dāng)升級包類型為差分時(shí)，消息包含此參數(shù)。

取值為1，表示僅包含新版本升級包與之前版本的差異部分，需要設(shè)備進(jìn)行差分還原。

digestsign

String

OTA升級包文件安全升級后的簽名。僅當(dāng)OTA升級包開啟安全升級功能，才有此參數(shù)。開啟OTA升級包安全升級功能的方法，請參見添加升級包。

sign

String

OTA升級包文件的簽名。

OTA升級包中僅有一個(gè)升級包文件時(shí)，包含該參數(shù)。

signMethod

String

簽名方法。取值：

  • SHA256

  • MD5

對于Android差分升級包類型，僅支持MD5簽名方法。

md5

String

當(dāng)簽名方法為MD5時(shí)，除了會給sign賦值外還會給md5賦值。

OTA升級包中僅有一個(gè)升級包文件時(shí)，包含該參數(shù)。

module

String

升級包所屬的模塊名。模塊名為default時(shí)，物聯(lián)網(wǎng)平臺不下發(fā)module參數(shù)。

extData

Object

升級批次標(biāo)簽列表和推送給設(shè)備的自定義信息。

_package_udi表示自定義信息的字段。

單個(gè)標(biāo)簽格式："key":"value"。

files

Array

多個(gè)升級包文件的信息列表。

OTA升級包中有多個(gè)文件時(shí)，包含該參數(shù)。每個(gè)升級包文件信息如下：

  • fileSize：升級包文件大小。

  • fileName：升級包文件的名稱。

  • fileUrl、fileMd5、fileSign：含義與url、md5、sign相同。

MQTT協(xié)議下載

升級包下載協(xié)議為MQTT時(shí)，只支持單文件包下載。設(shè)備端獲取OTA升級包信息后，可以選擇整包下載或分片下載。

  1. 整包下載

    • 消息格式

      {
    "id": "123",
    "code": 200,
    "data":{
        "size":432945,
        "digestsign":"A4WOP***SYHJ6DDDJD9***",
        "version":"2.0.0",
        "isDiff":1,
        "signMethod":"MD5",
        "dProtocol":"mqtt",
        "streamId":1397345,
        "streamFileId":1,
        "md5":"93230c3bde***",
        "sign":"93230c3bde42***",
        "module":"MCU",
        "extData":{
            "key1":"value1",
            "key2":"value2"
        }
    }
}

    • 參數(shù)說明

      參數(shù)

      類型

      說明

      id

      Long

      消息ID號。每個(gè)消息ID在當(dāng)前設(shè)備中具有唯一性。

      message

      String

      結(jié)果信息。

      code

      String

      狀態(tài)碼。

      version

      String

      設(shè)備升級包的版本信息。

      size

      Long

      升級包文件大小，單位：字節(jié)。

      OTA升級包中僅有一個(gè)升級包文件時(shí)，包含該參數(shù)。

      url

      String

      升級包在對象存儲（OSS）上的存儲地址。

      OTA升級包中僅有一個(gè)升級包文件，且下載協(xié)議為HTTPS時(shí)，包含該參數(shù)。

      dProtocol

      String

      升級包下載協(xié)議。

      僅升級包下載協(xié)議為MQTT時(shí)，包含該參數(shù)。

      streamId

      Long

      通過MQTT協(xié)議下載OTA升級包時(shí)的唯一標(biāo)識。

      僅升級包下載協(xié)議為MQTT時(shí)，包含該參數(shù)。

      streamFileId

      Integer

      單個(gè)升級包文件的唯一標(biāo)識。

      僅升級包下載協(xié)議為MQTT時(shí)，包含該參數(shù)。

      isDiff

      Long

      僅當(dāng)升級包類型為差分時(shí)，消息包含此參數(shù)。

      取值為1，表示僅包含新版本升級包與之前版本的差異部分，需要設(shè)備進(jìn)行差分還原。

      digestsign

      String

      OTA升級包文件安全升級后的簽名。僅當(dāng)OTA升級包開啟安全升級功能，才有此參數(shù)。開啟OTA升級包安全升級功能的方法，請參見添加升級包。

      sign

      String

      OTA升級包文件的簽名。

      OTA升級包中僅有一個(gè)升級包文件時(shí)，包含該參數(shù)。

      signMethod

      String

      簽名方法。取值：

      • SHA256

      • MD5

      對于Android差分升級包類型，僅支持MD5簽名方法。

      md5

      String

      當(dāng)簽名方法為MD5時(shí)，除了會給sign賦值外還會給md5賦值。

      OTA升級包中僅有一個(gè)升級包文件時(shí)，包含該參數(shù)。

      module

      String

      升級包所屬的模塊名。模塊名為default時(shí)，物聯(lián)網(wǎng)平臺不下發(fā)module參數(shù)。

      extData

      Object

      升級批次標(biāo)簽列表和推送給設(shè)備的自定義信息。

      _package_udi表示自定義信息的字段。

      單個(gè)標(biāo)簽格式："key":"value"。

      files

      Array

      多個(gè)升級包文件的信息列表。

      OTA升級包中有多個(gè)文件時(shí)，包含該參數(shù)。每個(gè)升級包文件信息如下：

      • fileSize：升級包文件大小。

      • fileName：升級包文件的名稱。

      • fileUrl、fileMd5、fileSign：含義與url、md5、sign相同。

  2. 可選：分片下載。獲取上面的升級包信息后，設(shè)備通過以下Topic分片下載OTA升級包文件。

    • 請求Topic：/sys/${productKey}/${deviceName}/thing/file/download

    • 響應(yīng)Topic：/sys/${productKey}/${deviceName}/thing/file/download_reply

    • 請求消息格式

      {
 "id": "123456",
 "version": "1.0",
 "params": {
 "fileToken":"1bb8***",
 "fileInfo":{
 "streamId":1234565,
 "fileId":1
 },
 "fileBlock":{
 "size":256,
 "offset":2
 }
 }
}

    • 請求消息的參數(shù)說明

      參數(shù)

      類型

      說明

      id

      String

      消息ID號。String類型的數(shù)字，取值范圍0~4294967295，且每個(gè)消息ID在當(dāng)前設(shè)備中具有唯一性。

      version

      String

      協(xié)議版本，固定為1.0。

      params

      Object

      請求參數(shù)。

      fileToken

      String

      文件的唯一標(biāo)識Token，非必填參數(shù)。支持?jǐn)?shù)字、英文字母、下劃線（_）和英文句號（.），不超過16個(gè)字符。

      使用說明：

      • 若傳入該參數(shù)，物聯(lián)網(wǎng)平臺響應(yīng)設(shè)備請求時(shí)，會返回該參數(shù)，便于您在設(shè)備端多文件下載場景下，從響應(yīng)消息中確認(rèn)下載的對應(yīng)文件。

      • 若確認(rèn)設(shè)備端在下載文件的請求和響應(yīng)周期內(nèi)，不需要對其他文件發(fā)起下載請求，可不設(shè)置該參數(shù)。

      fileInfo

      Object

      OTA升級包文件信息。

      streamId

      Long

      通過MQTT協(xié)議下載OTA升級包時(shí)的唯一標(biāo)識。

      fileId

      Integer

      單個(gè)升級包文件的唯一標(biāo)識。

      fileBlock

      Object

      文件分片信息。

      size

      Integer

      請求下載的文件分片大小，單位字節(jié)，取值范圍為256~131072。若為最后一個(gè)文件分片，取值范圍為1~131072。

      offset

      Integer

      文件分片對應(yīng)字節(jié)的起始地址。取值范圍為0~16777216。

    • 響應(yīng)消息的結(jié)構(gòu)

      image

      結(jié)構(gòu)項(xiàng)

      說明

      JSON Bytes Length

      表示響應(yīng)數(shù)據(jù)中JSON字符串對應(yīng)的字節(jié)數(shù)組長度，必須占位2個(gè)字節(jié)，高位字節(jié)在前，低位字節(jié)在后。

      例如，響應(yīng)的JSON字符串使用UTF-8編碼轉(zhuǎn)碼成字節(jié)數(shù)組的長度為十進(jìn)制的87，對應(yīng)十六進(jìn)制57，則高位字節(jié)為0x00，低位字節(jié)為0x57。

      JSON String Bytes

      表示響應(yīng)數(shù)據(jù)中JSON字符串對應(yīng)的字節(jié)數(shù)組，編碼格式為UTF-8。具體內(nèi)容，請參見下文的“響應(yīng)的JSON數(shù)據(jù)格式”。

      File Block Bytes

      表示當(dāng)前文件分片的字節(jié)數(shù)組，字節(jié)順序按照相對于文件頭的偏移量從小至大排列。

      CRC16/IBM

      表示文件分片的校驗(yàn)值，僅支持CRC16/IBM，占位2個(gè)字節(jié)，低位字節(jié)在前，高位字節(jié)在后。

      例如，文件分片的校驗(yàn)值為0x0809，則低位字節(jié)為0x09，高位字節(jié)為0x08。

    • 響應(yīng)消息格式

      {
 "id": "123456",
 "code":200,
 "msg":"file size has exceeded the limit 16 MB",
 "data": {
 "fileToken":"1bb8***",
 "fileLength":1238848,
 "bSize":1491,
 "bOffset":2
 }
}

    • 響應(yīng)消息的參數(shù)說明

      參數(shù)

      類型

      說明

      id

      String

      消息ID號。String類型的數(shù)字，取值范圍0~4294967295，且每個(gè)消息ID在當(dāng)前設(shè)備中具有唯一性。

      此處消息ID返回的是設(shè)備請求中的消息ID，即請求Topic/sys/${productKey}/${deviceName}/thing/file/download數(shù)據(jù)中的id。

      code

      Integer

      狀態(tài)碼，200表示成功。

      msg

      String

      請求失敗時(shí)，返回的錯(cuò)誤信息。

      data

      Object

      返回設(shè)備端的數(shù)據(jù)。

      fileToken

      String

      文件的唯一標(biāo)識Token。若請求參數(shù)傳入了fileToken值，則返回該參數(shù)。

      fileLength

      Integer

      文件的總大小，單位字節(jié)。

      bSize

      Integer

      當(dāng)前文件分片的大小，單位字節(jié)。

      bOffset

      Integer

      當(dāng)前文件分片對應(yīng)字節(jié)的起始地址，與請求數(shù)據(jù)中的offset值相同。單位字節(jié)。

上報(bào)升級進(jìn)度

  • 設(shè)備發(fā)布消息到Topic：/ota/device/progress/${YourProductKey}/${YourDeviceName}。

  • 消息格式

    {
    "id": "123",
    "params": {
        "step": "-1",
        "desc": "OTA升級失敗，請求不到升級包信息。",
        "module": "MCU"
    }
}

  • 格式說明

    參數(shù)

    類型

    說明

    id

    String

    消息ID號。String類型的數(shù)字，取值范圍0~4294967295，且每個(gè)消息ID在當(dāng)前設(shè)備中具有唯一性。

    step

    String

    OTA升級進(jìn)度。設(shè)備上報(bào)的進(jìn)度值及其描述信息，可根據(jù)設(shè)備實(shí)際升級場景在設(shè)備端配置。設(shè)備端配置方法，請參見示例代碼說明。

    • 1~100的整數(shù)：升級進(jìn)度百分比。

    • -1：升級失敗。

    • -2：下載失敗。

    • -3：校驗(yàn)失敗。

    • -4：燒寫失敗。

    desc

    String

    當(dāng)前步驟的描述信息，長度不超過128個(gè)字符。如果發(fā)生異常，此字段可承載錯(cuò)誤信息。

    module

    String

    升級包所屬的模塊名。模塊的更多信息，請參見添加升級包。

    上報(bào)默認(rèn)（default）模塊的OTA升級進(jìn)度時(shí)，可以不上報(bào)module參數(shù)。