次の方法で共有

リリース ノート 19.02、19.03、および 19.04

  • [アーティクル]

Azure Sphere 19.02 プレビュー機能リリースと 19.03 および 19.04 品質リリースには、この記事で説明する変更、新機能、既知の問題が含まれます。

メモ

19.02 機能リリース以降、四半期ごとに 1 つの主要な機能リリースと 2 つのマイナー品質リリースを計画しています。 機能リリースには新しい機能が含まれていますが、品質リリースにはバグ修正が含まれています。 Azure Sphere 19.03 リリースは、最初の品質リリースです。

19.04 品質リリースについて

19.04 品質リリースには、更新された Azure Sphere OS のみが含まれています。更新された SDK は含まれません。 引き続き Visual Studio Marketplace から Azure Sphere SDK プレビューを使用します。 このリリースでは、19.02 リリースと同じ API がサポートされています。 ユーザーに表示される変更は含まれません。

OS フィードで説明したように、Azure Sphere OS の小売評価フィードと小売フィードの両方がサポートされるようになりました。 19.04 更新プログラムは、4 月 10 日に小売評価フィードでリリースされました。 4 月 24 日から、小売フィードで入手できます。 評価期間中は、OTA で展開されたソフトウェアが期待どおりに動作し続けるかどうかを確認できます。

デバイスがインターネットに接続されている場合、デバイス グループが依存しているフィードに 19.04 バージョンがリリースされてから 24 時間以内に OTA が更新されます。

19.03 品質リリースについて

19.03 品質リリースには、更新された Azure Sphere OS のみが含まれています。更新された SDK は含まれません。 引き続き Visual Studio Marketplace から Azure Sphere SDK プレビューを使用します。 このリリースでは、19.02 リリースと同じ API がサポートされています。

OS フィードで説明したように、Azure Sphere OS の小売評価フィードと小売フィードの両方がサポートされるようになりました。 19.03 リリースは、最初は Retail Evaluation フィードでのみ使用できます。 3 月 28 日より、小売フィードで入手できます。 評価期間中は、OTA で展開されたソフトウェアが期待どおりに動作し続けるかどうかを確認できます。

19.03 リリースの変更点

19.03 リリースでは、DHCP サーバーから送信されたパケットに UDP チェックサムがゼロである場合に、Azure Sphere が DHCP オファーを受け入れなかった問題を解決します。

19.03 リリースに更新する方法

小売評価フィードからすぐに 19.03 リリースに更新することも、評価期間が終了した後に Retail フィードから更新することもできます。

評価期間中に更新するには

評価期間中にリリースを取得するには、小売評価フィードに依存する新しいデバイス グループとフィードを設定する必要があります。 OS 評価用にデバイス グループを設定 する方法について説明します。 現在、リテール評価フィードの更新は、空中アプリケーションの更新を有効にするデバイス グループでサポートされています。

この手順では、デバイスが 18.11 リリース以降を実行していることを前提としています。 デバイスが以前のリリースを実行しているか、一度も使用されていない場合は、まず次のセクションの手順に従って Retail フィードのバージョンに更新してから、Retail Evaluation フィードに依存するデバイス グループを設定し、デバイスを割り当てます。 現在、Retail Evaluation フィードは、OS を、Over-the-air (OTA) アプリケーションの展開用に構成されているデバイスにのみダウンロードします。

azsphere device recover コマンドは常に Retail OS バージョンに回復します。 評価期間中に 19.03 リリースに更新し、デバイスを回復すると、デバイスは 19.02 リリースを受け取ります。

評価期間後に更新するには

  • Azure Sphere デバイスが既に 18.11 OS リリース (またはそれ以降) を実行している場合、インターネットに接続されており、リテール OS フィードに依存するデバイス グループのメンバーである場合は、19.03 リリースが Retail フィードで利用可能になってから 24 時間以内に OTA を更新する必要があります。

  • 使用したことがない Azure Sphere デバイスがある場合は、「 Azure Sphere をインストールする」のすべての手順を完了します。 これらの手順を完了すると、デバイスは Retail フィードが提供する OS を実行し、アプリケーション開発の準備が整います。

  • Azure Sphere デバイスが要求されているが TP 4.2.1 を実行している場合は、 18.11 リリース ノート の手順に従って、要求されたデバイス上の Azure Sphere OS を更新し、OTA アプリケーションの更新プログラムを配信しないデバイス グループにデバイスを移動します。 この手順では、デバイスを Retail フィードの現在のリリースに更新します。

インストールを確認する方法

インストールされている OS バージョンを確認するには、Azure Sphere 開発者コマンド プロンプトで次のコマンドを発行します。

azsphere device show-ota-status

インストールされている SDK のバージョンをチェックするには、次のコマンドを使用します。

azsphere show-version

TP 4.2.1 の廃止

TP 4.2.1 リリースはサポートされなくなりました。 TP 4.2.1 を実行しているデバイスは、Azure Sphere Security Service によって証明書が発行されなくなり、その結果、Device Provisioning Service (DPS) に対して認証できなくなります。 認証を試みると、エラー AZURE_SPHERE_PROV_RESULT_DEVICEAUTH_NOT_READYが返されます。 これらのデバイスを現在のリリースに更新する必要があります。

19.02 リリースの新機能と変更点

このリリースには、MT3620 ハードウェアの Azure Sphere OS サポートに多額の投資が含まれています。 以降のセクションでは、新機能と変更された機能について説明します。

Spi

このリリースでは、MT3620 での シリアル周辺機器インターフェイス (SPI) の使用がサポートされます。 SPI 用のベータ API は、アプリケーション開発で使用できます。 LSM6DS3_SPI サンプルは、SPI を使用するアプリケーションを開発する方法を示しています。

I2c

このリリースでは、 MT3620 のインター集積回路 (I2C) インターフェイスのサポートが追加されます。 I2C 用のベータ API は、アプリケーション開発で使用できます。 LSM6DS3_I2Cサンプルは、I2C を使用するアプリケーションを開発する方法を示しています。

DHCP および SNTP サーバー

このリリースでは、Azure Sphere OS には、プライベート LAN 構成に対する DHCP と SNTP サーバーのサポートが含まれています。 プライベート イーサネットのサンプルでは、その使用方法を示します。

アプリケーションのサイズとストレージ

読み取り専用フラッシュ メモリの 1 つの MiB が、実行時に顧客がデプロイしたイメージ パッケージ専用になりました。 開発中、1 MiB の制限には gdbserver デバッガーが含まれています。現在のリリースでは約 280KiB が必要です。 ただし、デバッガーのサイズは将来のリリースで変更される可能性があることに注意してください。 詳細については、次を参照してください。

azsphere device sideload show-quota コマンドが追加され、アプリケーションによって割り当てられ、使用される変更可能なストレージの量が表示されます。

Azure IoT のサポート

Azure Sphere OS は、Azure IoT SDK を LTS Oct 2018 バージョンに更新しました。 さらに、新しい Azure IoT リファレンス ソリューションでは、Azure IoT Central または Azure IoT Hubで Azure Sphere を使用する方法を示します。

OS 更新プログラムの保護

Azure Sphere OS では、デバイスの起動に失敗する可能性がある追加の更新シナリオが検出されるようになりました。 これらの問題のいずれかが発生すると、OS はデバイスを最新の正常な構成に自動的にロールバックします。 デバイスが再起動されますが、それ以外の場合は顧客には表示されないため、ロールバックに成功した更新よりも時間がかかる場合があります。

CMake プレビュー

CMake サンプルは、Azure Sphere アプリケーションを構築するための代替手段として CMake の早期プレビューを提供します。 この制限付きプレビューを使用すると、お客様は Azure Sphere 開発で既存の資産の使用のテストを開始できます。

BLE を使用したセットアップとデバイス制御の Wi-Fi

Wi-Fi セットアップと BLE によるデバイス制御のリファレンス ソリューションは、18.11 でリリースされた Bluetooth Wi-Fi ペアリング ソリューションを拡張して、インターネット アクセスが利用できない場合に BLE を介してデバイスをローカルで制御する方法を示します。 更新された参照ソリューションでは、パスキーを使用して BLE ボンディング プロセスを保護することもできます。 結合されたデバイスのみが Wi-Fi 資格情報を提供したり、暗号化された BLE 接続を介してローカル制御を実行したりできます。

OS フィード

"プレビュー MT3620" フィードの名前が "Retail Azure Sphere OS" に変更されました。 18.11 リリースと同じフィード ID (3369f0e1-dedf-49ec-a602-2aa98669fd61) が保持されます。 フィード ID は変更されていないため、既存のアプリケーションデプロイを変更する必要はありません。

新しい "Retail Evaluation Azure Sphere OS" フィード (フィード ID 82bacf85-990d-4023-91c5-c6694a9fa5b4) は、そのバージョンが Retail フィードにリリースされる約 2 週間前に Azure Sphere OS の評価版を提供します。

フィードの詳細については、「 Azure Sphere OS フィード 」を参照してください。

以前のリリースとの互換性

19.02 Azure Sphere OS リリースには、API セットにいくつかの変更が含まれています。

  • SPI および I2C 用の新しい API と、SNTP と DHCP 用のネットワーク API への追加
  • UART の追加オプションやネットワークの追加エラー コードなど、運用 API の機能強化

19.02 リリースでは、1 と 1 +Beta1902 の 2 つのターゲット API セットがサポートされています。

18.11 アプリケーションと 19.02 リリース

18.11 SDK で構築された既存のアプリケーション イメージは、19.02 OS で正常に実行されます。 19.02 リリースでは、ベータ API を使用するイメージと、運用 API のみを使用するイメージに当てはまります。 したがって、18.11 イメージ パッケージの OTA デプロイを作成した場合は、引き続き 19.02 で動作する必要があります。

ただし、ベータ API を使用する 18.11 アプリケーションを 19.02 SDK を使用してリビルドする場合は、「ベータ API 機能」で説明されているように、Visual Studio プロジェクト>のプロパティ ページで Target API Set プロパティを 1+Beta1902 に更新する必要があります。

Target API Set プロパティを更新しない場合、ビルドは失敗し、次のメッセージが表示されます。

Target API Set %s is not supported by this SDK. Please update your SDK at http://aka.ms/AzureSphereSDKDownload, or open the Project Properties and select a 'Target API Set' that this SDK supports. Available targets are: [ ..., ...]. Ensure that the Configuration selected on that page includes the active build configuration (such as Debug, Release, All Configurations).

19.02 アプリケーションと 18.11 リリース

19.02 SDK をインストールし、デバイスが OTA 更新プログラムを 19.02 に受信する前にアプリケーションをビルドしようとすると、アプリケーションをデバイスにサイドローディングするときにエラーが発生する可能性があります。 不明な場合は、 OS と SDK のバージョンを確認します。 次のセクションでは、想定される動作を要約します。

18.11 SDK に対する 19.02 アプリケーションのビルド

18.11 SDK に対して Target API Set 1 を使用するアプリケーションをビルドしようとすると、新しい UART 列挙型やネットワーク エラー コードなど、19.02 で導入された新しいシンボルがアプリケーションで使用されている場合、コンパイルは失敗します。 そうしないと、ビルドは成功しますが、次のセクションで説明するようにサイドローディングが失敗する可能性があります。

18.11 SDK に対して Target API Set 1 +Beta1902 を使用するアプリケーションをビルドしようとすると、次のいずれかのメッセージでビルドが失敗します。

  • The specified task executable location "C:\Program Files (x86)\Microsoft Azure Sphere SDK\\SysRoot\tools\gcc\arm-poky-linux-musleabi-gcc.exe" is invalid.

または：

  • 1>A task was canceled.、その後に次のような複数のエラーが発生します。 mt3620_rdb.h:9:10: fatal error: soc/mt3620_i2cs.h: No such file or directory

18.11 OS での 19.02 アプリケーションのサイドローディング

Visual Studio と azsphere コマンドの両方が、Azure Sphere デバイスにアプリケーションをサイドロードします。 19.02 SDK に対してビルドされたアプリケーションを 18.11 OS を実行しているデバイスにサイドロードする場合は、次の結果が予想されます。

  • アプリケーションが Target API Set 1 用にビルドされている場合、新しい UART オプションまたはネットワーク エラーを使用すると、実行時に失敗します。

  • アプリケーションが Target API Set 1 +Beta1902 用にビルドされている場合、新しいベータ API、UART オプション、またはネットワーク エラー コードを使用すると、実行時に失敗します。 たとえば、19.02 アプリケーションで新しい I2C API を使用している場合、次のようなエラーが表示されることがあります。

    Error relocating /mnt/apps/c5b532c2-8379-49b9-8771-7228b03c23f3/bin/app: I2CMaster_Open: symbol not found

18.11 OS での 19.02 アプリケーションの OTA 展開

すべてのアプリケーション フィードは、19.02 OS を提供する Retail Azure Sphere OS フィードに依存するため、19.02 アプリケーションを 18.11 OS に OTA でデプロイすることはできません。

サンプル アプリケーション

GitHub のすべての Azure Sphere サンプルには、19.02 SDK が必要です。 19.02 リリースのインストール時に、[GitHub サンプル リポジトリ] のhttps://github.com/Azure/azure-sphere-samples ローカル バージョンを更新することをお勧めします。

19.02 SDK に対して古い (18.11) サンプルをビルドしようとすると、次のエラーが表示されることがあります。

Could not add sysroot details to application manifest from '*filename*'. The specified sysroot '1+Beta1902' contains TargetBetaApis 'Beta1902', but the application manifest only contains the TargetApplicationRuntimeVersion field. Either the TargetApplicationRuntimeVersion field must be removed or the TargetBetaApis field must be added.

このエラーを修正するには、アプリケーション マニフェストから TargetApplicationRuntimeVersion フィールドを削除するか、サンプルを更新します。

19.02 の既知の問題

このセクションでは、現在のリリースの既知の問題の一覧を示します。

Visual Studio 2017 と Visual Studio 2019 Preview の両方のインストール

Visual Studio 2017 と Visual Studio 2019 Preview の両方を使用して 18.11 Azure Sphere SDK Preview for Visual Studio をインストールした場合、Azure Sphere SDK Preview for Visual Studio インストーラーは、"予期しないエラー" というメッセージが表示されたいずれかのバージョンまたは両方のバージョンでインストールまたはアンインストールできない可能性があります。 この問題から回復するには:

  1. Visual Studio 2019 プレビューを開始し、[拡張機能の>拡張機能と更新] に移動します。 "azure Sphere" を検索し、Visual Studio Extension for Azure Sphere Preview をアンインストールします。
  2. Visual Studio 2019 を閉じます。
  3. Azure Sphere SDK Preview for Visual Studio インストーラーをもう一度実行します。

Wi-Fi コマンドは、デバイス エラー 13.1 を返します

azsphere device wifi show-status コマンドは、最新の azsphere device wifi add コマンドが正しくない --key 値を指定した場合に返されるerror: device error 13.1場合があります。 この場合は、 azsphere device wifi delete コマンドを使用して正しくない Wi-Fi ネットワーク構成を削除し、正しいキーを使用してネットワークをもう一度追加します。

パス内の ASCII 以外の文字

Azure Sphere ツールでは、パス内の ASCII 以外の文字はサポートされていません。

C++ でのビルド エラー

Visual Studio 統合開発環境 (IDE) では、C++ ソース ファイルを Azure Sphere プロジェクトに追加してもエラーは生成されません。 ただし、C++ 開発は Azure Sphere ではサポートされていないため、結果のプロジェクトは正しくビルドされません。