ファームウェアの更新の詳細は、 「OTA 更新」 と「 ファームウェアの更新」をご参照ください。

ファームウェアのバージョンを報告

アップストリーム

  • トピック: /ota/device/inform/{productKey}/{deviceName}

    デバイスは、このトピックに対するメッセージを発行して、現在のファームウェアのバージョンを IoT Platform に報告します。

リクエストメッセージ

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

パラメーターの説明

パラメーター データタイプ 説明
id 文字列 メッセージ ID
version 文字列 ファームウェアのバージョン情報

ファームウェア情報をプッシュ

ダウンストリーム

  • トピック: /ota/device/upgrade/{productKey}/{deviceName}

    IoT Platform はこのトピックに対するメッセージを発行し、ファームウェア情報をプッシュします。 デバイスは、このトピックをサブスクライブしてファームウェア情報を取得します。

リクエストメッセージ

{
  "code": "1000",
  "data": {
    "size": 432945,
    "version": "2.0.0",
    "url": "https://iotx-ota-pre.oss-cn-shanghai.aliyuncs.com/nopoll_0.4.4.tar.gz?Expires=1502955804&OSSAccessKeyId=XXXXXXXXXXXXXXXXXXXX&Signature=XfgJu7P6DWWejstKJgXJEH0qAKU%3D&security-token=CAISuQJ1q6Ft5B2yfSjIpK6MGsyN1Jx5jo6mVnfBglIPTvlvt5D50Tz2IHtIf3NpAusdsv03nWxT7v4flqFyTINVAEvYZJOPKGrGR0DzDbDasumZsJbo4f%2FMQBqEaXPS2MvVfJ%2BzLrf0ceusbFbpjzJ6xaCAGxypQ12iN%2B%2Fr6%2F5gdc9FcQSkL0B8ZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO1wEP4K%2BkkMqH8Uic3h%2Boy%2BgJt8H2PpHhd9NhXuV2WMzn2%2FdtJOiTknxR7ARasaBqhelc4zqA%2FPPlWgAKvkXba7aIoo01fV4jN5JXQfAU8KLO8tRjofHWmojNzBJAAPpYSSy3Rvr7m5efQrrybY1lLO6iZy%2BVio2VSZDxshI5Z3McKARWct06MWV9ABA2TTXXOi40BOxuq%2B3JGoABXC54TOlo7%2F1wTLTsCUqzzeIiXVOK8CfNOkfTucMGHkeYeCdFkm%2FkADhXAnrnGf5a4FbmKMQph2cKsr8y8UfWLC6IzvJsClXTnbJBMeuWIqo5zIynS1pm7gf%2F9N3hVc6%2BEeIk0xfl2tycsUpbL2FoaGk6BAF8hWSWYUXsv59d5Uk%3D",
    "md5": "93230c3bde425a9d7984a594ac55ea1e",
    "sign": "93230c3bde425a9d7984a594********",
    "signMethod": "Md5"
  },
  "id": 1507707025,
  "message": "success"
}

パラメーターの説明

パラメーター データタイプ 説明
id 文字列 メッセージ ID
message 文字列 結果情報
version 文字列 ファームウェアのバージョン情報
size Long ファームウェアのサイズ (バイト単位)
url 文字列 ファームウェアの OSS アドレス
sign 文字列 ファームウェアの署名
signMethod 文字列 署名のメソッドです。 現在サポートされているメソッドは MD5 と sha256 です。
md5 文字列 予備のパラメーターです。 このパラメーターは前のデバイス情報と互換を取る場合にに使用されます。 署名メソッドが MD5 の場合、IoT Platform は sign パラメーターと md5 パラメーターの両方に値を割り当てます。

更新の進捗状況を報告

アップストリーム

  • トピック: /ota/device/progress/{productKey}/{deviceName}

    デバイスはこのトピックをサブスクライブし、ファームウェア更新の進行状況を報告します。

リクエストメッセージ

{
  "id": 1,
  "params": {
    "step": "-1",
    "desc": "Firmware update has failed. No firmware information is available."
  }
}

パラメーターの説明

パラメーター データタイプ 説明
id 文字列 メッセージ ID
step 文字列

ファームウェア更新の進捗情報です。

値の範囲 :
  • 1 ~ 100 の値は進捗率を示します。
  • 値 -1 は、ファームウェアの更新が失敗したことを示します。
  • 値 -2 は、ファームウェアのダウンロードが失敗したことを示します。
  • 値 -3 は、ファームウェアの検証が失敗したことを示します。
  • 値 -4 は、ファームウェアのインストールが失敗したことを示します。
desc 文字列 現在のステップの説明です。 例外が発生した場合、このパラメーターがエラーメッセージを表示します。

IoT Platform からファームウェア情報をリクエスト

  • トピック : /ota/device/request/{productKey}/{deviceName}

リクエストメッセージ

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

パラメーターの説明

パラメーター データタイプ 説明
id 文字列 メッセージ ID
version 文字列 ファームウェアのバージョン情報