すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:OTA アップデートプロセス

最終更新日:Jun 11, 2026

IoT Platform は、OTA (Over-the-Air) テクノロジーを使用して、ワイヤレスネットワーク経由で世界中のデバイスのファームウェア、ソフトウェア、またはドライバーをアップデートします。この例では、MQTT で接続されたデバイスの OTA アップデートプロセスについて説明します。

背景情報

OTA の動作原理、制限、アップグレード手順については、「OTA アップデート」をご参照ください。アップデートプロセスとデータ形式については、「OTA アップデートのトピックとデータ形式」をご参照ください。

この例では、デバイス用 C Link SDK V4.x を使用してデバイスを IoT Platform に接続し、OTA アップデートを実行します。

OTA アップデートプロセス

この例では、デフォルトモジュールと単一ファイルのアップデートパッケージを使用したフルアップデートについて説明します。

次のフローチャートにプロセスを示します。

Device OTA update

次の表でプロセスを説明します。

手順

説明

リファレンス

1

現在の OTA バージョンをトピック: /ota/device/inform/${YourProductKey}/${YourDeviceName} にレポートします。

  1. デバイス A を開発します。OTA ファームウェアのバージョン番号を 1.0.0 に設定します。デバイス A をアクティブ化してオンラインにし、現在のファームウェアバージョンをレポートします。

  2. デバイス A と同じプロダクトに属するデバイス B を開発します。OTA ファームウェアのバージョン番号を 2.0.0 に設定します。デバイス B をアクティブ化してオンラインにし、現在の OTA バージョンをレポートします。

バージョンレポートの例:

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

デバイスでの OTA アップデートの設定

2

IoT Platform コンソールで、プロダクト用の新しいアップデートパッケージ (2.0.0) をアップロードし、バージョン 1.0.0 を実行しているデバイスに更新タスクをプッシュします。これにより、ファームウェアが 1.0.0 から 2.0.0 にアップグレードされます。

デバイスへの OTA 更新タスクのプッシュ

3

デバイスは、IoT Platform が OTA アップデート通知をプッシュするトピック: /ota/device/upgrade/${YourProductKey}/${YourDeviceName} をサブスクライブします。

アップグレードメッセージの例:

{
    "code":"1000",
    "data":{
        "size":11472299,
        "sign":"83254ac96e141affb8aa42cbfec9****",
        "version":"2.0.0",
        "url":"https://iotx-ota.oss-cn-shanghai.aliyuncs.com/ota/dbab6f742ae389b40db88fc2500b****/ck0q5lyav00003i7hezxe****.zip?Expires=1568951190&OSSAccessKeyId=cS8uRRy54Rsz****&Signature=nk0sogaxtyp7dYvKZnjNQ%2BZ8Q9****",
        "signMethod":"Md5",
        "md5":"83254ac96e141affb8aa42cbfec9****"
    },
    "id":1568864790381,
    "message":"success"
}

デバイスログの表示

4

通知からアップデートパッケージの URL を受信した後、デバイスは SDK API を呼び出してパッケージをダウンロードし、ローカルアップグレードを実行します。

この例では、単一の OTA アップデートファイルをダウンロードします。関連する API リファレンス:

5

更新の進捗状況をトピック: /ota/device/progress/${YourProductKey}/${YourDeviceName} にレポートします。

進捗メッセージの例:

{
  "id": 1,
  "params": {
    "step":"1", 
    "desc":"******"
  }   
}

6

アップデート後の OTA バージョンをトピック: /ota/device/inform/${YourProductKey}/${YourDeviceName} にレポートします。

バージョンレポートの例:

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

関連ドキュメント