IoT Platform:更新パッケージの検証 (オプション)

手順

1. IoT Platform コンソール にログオンします。

2. [概要] ページで、[すべての環境] をクリックします。[すべての環境] タブで、管理するインスタンスを見つけ、インスタンス ID またはインスタンス名をクリックします。

3. 左側のナビゲーションウィンドウで、[メンテナンス] > [OTA 更新] を選択します。
   説明 より良いサービスを提供するために、IoT Platform は OTA 更新機能を改善し、更新パッケージバージョンの統計を追加しました。コンソールで新しい OTA 更新機能を初めて使用するときは、アップロードした更新パッケージをプロダクトに関連付ける必要があります。更新パッケージは 1 つのプロダクトにのみ関連付けることができます。更新パッケージをプロダクトに関連付ける方法の詳細については、コンソールの手順をご参照ください。
4. [更新パッケージ] タブで、検証する更新パッケージを見つけ、[アクション] 列の [検証] をクリックします。検証[更新パッケージの検証] ダイアログボックスで、必要に応じてパラメーターを設定し、 をクリックして、1 つ以上のデバイスで更新パッケージを検証します。次の表にパラメーターを示します。

   パラメーター	説明
   アップグレード対象のバージョン番号	更新対象デバイスの OTA モジュールのバージョン番号。フルアップデートを実行する場合は、このパラメーターはオプションです。 ドロップダウンリストには、更新対象バージョンを除き、現在のプロダクトのすべてのデバイスの OTA モジュールバージョンが表示されます。1 つ以上のバージョンを選択できます。必要なバージョンを選択すると、関連デバイスが候補デバイスとして [検証対象デバイス] ドロップダウンリストに追加されます。 このパラメーターを設定しない場合、検証対象デバイスの OTA モジュールバージョンに制限は設定されません。 差分更新を実行する場合、このパラメーターの値は、更新パッケージを追加するときに指定したバージョン番号です。
   検証対象デバイス	検証対象のデバイス。1 つ以上のデバイスを選択できます。
   IoT Platform が更新タスクをアクティブにプッシュするかどうか	IoT Platform が更新タスクをデバイスに自動的にプッシュするかどうかを指定します。有効な値： [はい]: 更新バッチが作成されると、IoT Platform は指定されたオンラインデバイスに更新タスクを自動的にプッシュします。これはデフォルト値です。 この場合でも、デバイスは IoT Platform から OTA 更新タスクに関する情報を取得するリクエストを開始できます。 [いいえ]: デバイスは IoT Platform から OTA 更新タスクに関する情報を取得するリクエストを開始する必要があります。
   APP によるアップグレードの確認	モバイルアプリを使用して更新を制御するかどうかを指定します。必要に応じてモバイルアプリを開発する必要があります。有効な値： [はい]: デバイスで OTA 更新を実行するには、モバイルアプリを使用して更新を確認する必要があります。ConfirmOTATask 操作を呼び出して、確認待ちの複数の更新タスクを一度に確認できます。その後、デバイスは [iot Platform が更新タスクをアクティブにプッシュするかどうか] パラメーターの設定に基づいて OTA 更新タスクに関する情報を取得できます。 [いいえ]: デバイスは [iot Platform が更新タスクをアクティブにプッシュするかどうか] パラメーターの設定に基づいて OTA 更新タスクに関する情報を取得します。これはデフォルト値です。
   更新パッケージダウンロードプロトコル	更新パッケージのダウンロードに使用するプロトコル。有効な値：[HTTPS] および [MQTT]。デバイスが IoT Platform によってプッシュされた更新パッケージ URL を受信した後、このプロトコルを使用して更新パッケージをダウンロードします。 重要 Message Queuing Telemetry Transport (MQTT) プロトコルを使用して更新パッケージをダウンロードする必要がある場合は、次の点に注意してください。 サービスは、中国 (上海)、中国 (北京)、または中国 (深圳) リージョンにデプロイする必要があります。 OTA 更新パッケージには 1 つのファイルのみを含めることができ、ファイルサイズは 16 MB を超えることはできません。 OTA 更新を実行し、MQTT 経由でファイルをダウンロードするデバイス機能を開発するには、最新バージョンの Link SDK for C を使用する必要があります。詳細については、「サンプルコード」をご参照ください。
   デバイスのアップグレードタイムアウト (分)	単一デバイスの更新のタイムアウト期間。指定されたデバイスがこの期間内に更新されない場合、更新はタイムアウトになります。有効な値：1 ～ 1440。単位：分。 更新パッケージを使用して初めて OTA 更新を実行する場合は、このパラメーターを最大値に設定することをお勧めします。これにより、更新の成功率が向上します。コンソールには、更新レコードに基づいて推奨値が表示されます。 説明 更新期間は、指定されたデバイスが更新の進捗状況を初めて報告したときから開始されます。 更新中、デバイスがオンラインとオフラインを複数回繰り返すため、更新パッケージが指定されたデバイスに繰り返しプッシュされる場合があります。ただし、更新期間の開始時刻は変更されません。 デバイスが更新された後、デバイスは更新されたバージョン番号をすぐに報告する必要があります。そうしないと、タイムアウトエラーにより更新が失敗する可能性があります。 たとえば、タイムアウト期間を 60 分に設定し、デバイスが 10:00 に初めて更新の進捗状況を報告するとします。デバイスが 11:00 までに更新されたバージョン番号を報告しない場合、更新は失敗します。
   バッチラベル	[タグの追加] をクリックします。表示されるフィールドに、タグキー と タグ値 を指定します。 作成した更新バッチが [更新中] 状態の場合、タグを変更したり、タグを追加したりできます。詳細については、「更新バッチの管理」をご参照ください。 更新バッチのタグは、IoT Platform が更新通知をこれらのデバイスにプッシュするときにデバイスに送信されます。 アイコンにポインターを合わせると、タグを設定できるルールが表示されます。

結果

[更新パッケージの検証] ダイアログボックスで、[閉じる] をクリックします。

[更新パッケージ] タブで、[検証中] 状態の更新パッケージを見つけ、[アクション] 列の [表示] をクリックします。[更新パッケージ情報] タブで、検証の進捗状況を確認できます。

次の手順

テストデバイスが更新され、更新パッケージのステータスが [検証済み] と表示されたら、一括更新を実行できます。詳細については、「一括更新の開始」をご参照ください。

関連 API 操作

OTA 更新機能に関連する API 操作の詳細については、「OTA 更新」をご参照ください。