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

IoT Platform:OTAアップデートに関連するエラーに関するFAQ

最終更新日:Apr 09, 2025

このトピックでは、無線 (OTA) 更新に関連するエラーの原因と対応するソリューションについて説明します。

デバイスの更新がタイムアウト

発行

IoT Platformコンソールで [メンテナンス] > [OTAアップデート] を選択し、[OTAアップデート] ページに移動します。 このページでバッチ更新を開始するときは、[デバイスのアップグレードタイムアウト (分)] パラメーターを設定します。 デバイスが初めて更新の進行状況を送信すると、タイミングがトリガーされます。 デバイスアップグレードタイムアウト (分) パラメーターに指定したタイムアウト期間内にデバイスが更新されなかった場合、IoT Platformは更新が失敗したと判断します。

原因

  • デバイスが存在するネットワーク環境は不安定です。 したがって、OTA更新パッケージのダウンロードに使用される期間は、指定されたタイムアウト期間を超えています。

  • デバイスが初めてOTA更新パッケージのダウンロードに失敗するか、更新に失敗すると、デバイスは再起動されます。 次に、デバイスはIoT Platformによってプッシュされた更新タスクを受信し、OTA更新パッケージをダウンロードして更新を実行します。 その結果、プロセス全体の期間が指定されたタイムアウト期間を超えます。

解決策

デバイスアップグレードタイムアウト (分) パラメーターを60より大きい値に設定するか、パラメーターを設定しません。

説明

デバイスアップグレードタイムアウト (分) パラメーターは、動的更新タスクに対してのみ変更できます。 このパラメーターは複数回変更できます。 各変更は、変更後に追加されたデバイスの動的更新タスクに対してのみ有効です。

デバイスが無効なファームウェアバージョン番号を送信する

発行

IoT Platformコンソールで [メンテナンス] > [OTAアップデート] を選択し、[OTAアップデート] ページに移動します。 このページでバッチ更新を開始するときは、[バージョン番号をアップグレードする] パラメーターを設定します。 デバイスが更新パッケージをダウンロードし、更新を開始し、更新の進行状況を送信すると、デバイスはオフラインになります。 次に、デバイスはオンラインになり、ソースバージョンまたは宛先バージョンの番号ではないファームウェアバージョン番号を送信します。 この場合、IoT Platformは更新が失敗したと判断します。

原因

OTA更新中に、オンプレミスのファームウェア更新が同時に実行されます。 オンプレミスのファームウェアの更新が完了すると、デバイスは、バッチ更新タスクの送信元バージョンまたは送信先バージョンの番号ではないファームウェアバージョン番号を送信します。

解決策

デバイスのオンプレミスファームウェアを更新する前に、デバイスをIoT Platformから切断します。 オンプレミスファームウェアの更新が完了すると、デバイスはオンラインになり、最新のファームウェアバージョン番号を送信できます。 デバイスは、デバイスがオンラインになってから2秒以内に最新のファームウェアバージョン番号を送信する必要があります。

IoT Platformコンソールで、[メンテナンス] > [OTAアップデート] を選択して、OTAアップデートページに移動します。 このページでバッチ更新を開始するときは、Maxを設定します。 Retry Timesのパラメーター。 たとえば、Maxを設定できます。 Retry Timesパラメーターを5に設定します。 デバイスが無効なファームウェアバージョン番号を送信すると、IoT Platformは、デバイスがMaxの値に基づいて指定された回数の再試行を実行できるようにします。 Retry Timesのパラメーター。 再試行ポリシーは、OTA更新の成功率を向上させる。

デバイスがエラー値を送信する

発行

更新中に、デバイスは更新の進行状況固有のトピックを使用して次のエラー値のいずれかを送信します。-1 (更新失敗) 、-2 (ダウンロード失敗) 、-3 (検証失敗) 、および-4 (書き込み失敗) 。 次に、IoT Platformは更新が失敗したと判断します。

原因

OTA更新中に複数のエラーが発生する可能性があります。 更新中にエラーが発生した場合、デバイスはエラー値の1つと、トラブルシューティングのための対応するカスタム説明を送信します。

エラー値の説明は、IoT Platformによって事前定義されています。 説明を変更できます。 デバイスは、発生したエラーに基づいてカスタム説明を送信できます。

解決策

IoT Platformコンソールで、[メンテナンス] > [OTAアップデート] を選択して、OTAアップデートページに移動します。 このページでバッチ更新を開始するときは、Maxを設定します。 Retry Timesのパラメーター。 たとえば、Maxを設定できます。 Retry Timesパラメーターを5に設定します。

デバイスがエラー値を送信すると、IoT Platformでは、デバイスがMaxの値に基づいて指定された回数の再試行を実行できるようになります。 Retry Timesのパラメーター。 再試行ポリシーは、OTA更新の成功率を向上させる。

デバイスには同時に複数の更新タスクがあります

発行

デバイスは、進行中の更新タスクを1つだけ持つことができます。 デバイスで別の更新タスクを開始すると、競合が発生し、IoT Platformは新しい更新タスクが失敗したと判断します。

原因

更新タスクが進行中のデバイスで別の更新タスクを開始する場合は、[以前のデバイス更新タスクのオーバーライド] パラメーターを [いいえ] に設定します。

解決策

  • IoT Platformコンソールで、[メンテナンス] > [OTAアップデート] を選択して、OTAアップデートページに移動します。 OTA更新ページでバッチ更新を開始するときは、[以前のデバイス更新タスクのオーバーライド] パラメーターを [はい] に設定します。

  • IoT Platformコンソールの [バッチの詳細] ページで、[アップグレードする] 、[プッシュする] 、[アップグレード中] の状態にあるタスクをキャンセルします。 次に、デバイスで新しい更新タスクを開始します。

重要

キャンセルできるのは、アップグレード中ステータスの更新タスクのみですが、そのような更新タスクは上書きできません。