イーサネット用に Azure Sphere を準備する

2025-05-06

イーサネット経由で通信するには、Azure Sphere デバイスに外部イーサネットアダプターとボード構成イメージが必要です。イーサネット経由のネットワーク用にデバイスを準備するには、次の手順が必要です。

アダプターをデバイスに接続します。
ボード構成イメージをデプロイします。
イーサネットインターフェイスを有効にします。

注意事項

デバイスがイーサネット経由で接続されている場合は、データの損失やパフォーマンスの低下を防ぐためにトラフィックの少ないネットワークが必要です。ネットワーク上に大量の着信トラフィックがある場合、デバイスは TCP 以外の受信パケットからデータを失います。 TCP はドロップされたパケットを再送信するため、通常、トラフィック量に関係なく、受信 TCP パケットからデータが失われるわけではありません。ただし、再送信はパフォーマンスの犠牲になります。

アダプターをデバイスに接続する

サポートされているイーサネットアダプターの一覧と、Azure Sphere 開発ボードに接続する方法についてはサポートされているイーサネットアダプターボードとモジュールを参照してください。

ボード構成イメージをデプロイする

Azure Sphere で使用されるイーサネットアダプターごとにボード構成イメージが必要です。イーサネットアダプターのボード構成イメージパッケージを使用し、アプリケーションイメージパッケージと共にデプロイできます。ボード構成イメージパッケージをサイドロードして開発とデバッグを行うことができます。また、ボード構成イメージパッケージをクラウドからデプロイすることもできます Azure Sphere アプリケーションと共にフィールドで使用できます。ボード構成は、高度なアプリ用に予約フラッシュメモリまたは RAM に対してはカウントされません。

ボード構成イメージパッケージを見つける

注

Azure Sphere には事前に生成されたボード構成イメージパッケージが付属しているため、Azure CLI 拡張機能ではボード構成イメージパッケージの作成はサポートされていません。

現在サポートされているボード構成イメージパッケージは、Azure Sphere SDK インストールフォルダーの BoardConfigPresets フォルダーにあります。たとえば、フォルダーは既定で Linux の場合は "/opt/azurespheresdk/BoardConfigPresets" に、Windows では "C:\Program Files (x86)\Microsoft Azure Sphere SDK\BoardConfigPresets" にインストールされます。

次のボード構成がサポートされています。

Microchip ENC28J60 NIC 用の Seeed MT3620 イーサネットシールド: lan-enc28j60-isu0-int5.imagepackage
Wiznet W5500 NIC 用の Avnet Rev1 開発キットクリックモジュール: lan-w5500-isu1-int2.imagepackage
Wiznet W5500 NIC 用の Avnet Rev2 開発キットクリックモジュール: lan-w5500-isu0-int5.imagepackage

ボード構成イメージパッケージをサイドロードする

開発時やデバッグ時にボード構成イメージパッケージを使用するには:

開発とデバッグのためにデバイスを準備します。

az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

az sphere device sideload delete コマンドを使用して、デバイスから既存のアプリケーションを削除します。既存のアプリケーションとボード構成の間でリソースの競合が発生しないように、ボード構成イメージパッケージを読み込む前に既存のアプリケーションを削除することが重要です。
ボード構成イメージパッケージをサイドロードします。前のセクションでカスタムボード構成ファイルを作成した場合は、ここでサイドロードできます。プリセットオプションには、次のものがあります。

Microchip ENC28J60 NIC 用 MT3620 イーサネットシールドを参照してください。
```
az sphere device sideload deploy --image-package lan-enc28j60-isu0-int5.imagepackage
```
Wiznet W5500 NIC 用の Avnet Rev1 開発キットクリックモジュール:
```
az sphere device sideload deploy --image-package lan-w5500-isu1-int2.imagepackage
```
アヴネット Rev2 開発キット Click モジュール（Wiznet W5500 NIC用）
```
az sphere device sideload deploy --image-package lan-w5500-isu0-int5.imagepackage
```
Visual Studio を使用するか、 az sphere device sideload deploy コマンドを使用して、アプリケーションをサイドロードします。

クラウドでボード構成イメージパッケージをデプロイする

ボード構成イメージパッケージをクラウド経由で配置するには、デバイスに製品があり、デバイスがデバイスグループに属している必要があります。また、AppDevelopment 機能がインストールされていてはいけません。これらの設定方法については、「配置の作成」を参照してください。

デバイスの準備ができたら、単一の配置では、ボード構成イメージと共にアプリケーションイメージを配置できます。

デプロイを作成するには:

az sphere image add を使用して、イメージパッケージを Azure Sphere カタログにアップロードします。
az sphere deployment create を使用して、アップロードされたイメージのデバイスグループの新しい デプロイを作成します。

az sphere deployment create --resource-group <resource-group-name> --catalog <catalog-name> --product <product-name> --device-group <device-group-name> --images <image-ID>

<image-ID>をイメージパッケージのイメージ ID に置き換えます。

サイドロードされたボード構成を削除する

開発中にボード構成をサイドロードした場合、そのボードが予約しているリソースを他のアプリケーションが使用できるように、後でその構成の削除が必要になることがあります。 Azure Sphere デバイスにボード構成が読み込まれているときにこれらのリソースを使用するアプリケーションを実行しようとすると、ピンの競合エラーが発生します。

ボード構成を削除するには、次の手順を実行します。

デバイスにインストールされているイメージを一覧表示します。
```
az sphere device image list-installed
```

一覧からボード構成のコンポーネント ID を探します。

 {
 "does_image_type_require_restart": true,
 "image_type": "Board configuration",
 "images": [
   {
     "length_in_bytes": 428,
     "replica_type": 0,
     "uid": "839e699a-1b23-44de-bc56-f2b19e472098",
     "uncompressed_length_in_bytes": 428
   }
 ],
 "is_update_staged": false,
 "name": "lan-enc28j60-isu0-int5_29f10d",
 "uid": "29f10d1e-29aa-4ae0-a48c-cc24305b288a"
 }

コンポーネント ID はボード構成に関連付けられている uid であるため、たとえば上記の出力では "29f10..." が開始されます。

コンポーネント ID を指定して、ボード構成イメージパッケージを削除します。
```
az sphere device sideload delete --component-id 29f10d1e-29aa-4ae0-a48c-cc24305b288a
```
リセットボタンを押すか、 az sphere device restart コマンドを発行して、デバイスを再起動します。

イーサネットインターフェイスを有効にする

ボード構成がロードされ、デバイスが再起動されると、インターフェイスは自動的に有効になります。インターフェイスを無効にする場合は、 az sphere device network disable コマンドを使用するか、ネットワーク構成 API の一部である Networking_SetInterfaceState 関数を呼び出します。

既定では、すべてのインターフェイスが動的 IP アドレスを使用します。 Azure Sphere アプリケーションで使用できるサービスの種類の詳細については、「ネットワークサービスの使用」を参照してください。

イーサネット用に Azure Sphere を構成する

Azure Sphere デバイスをサポートされているイーサネットアダプターに接続し、ボード構成イメージをデプロイした後、コマンドライン (CLI) または Azure Sphere SDK アプリケーションライブラリ (Applibs) を使用してアプリケーションからネットワークに接続するように Azure Sphere デバイスを構成できます。

CLI を使用したイーサネット構成

コマンドラインからイーサネット構成を管理するには、 az sphere device network CLI コマンドを使用します。たとえば、 device network enable コマンドを使用すると、接続されているデバイスのイーサネットインターフェイスが有効になります。

az sphere device network enable --interface "eth0"

構成されたイーサネットネットワークを使用するには、ネットワークインターフェイス (eth0) がアクティブである必要があります。 device network list-interfaces コマンドを使用して、インターフェイスがアクティブかどうかを判断します。


az sphere device network list-interfaces

device network enable コマンドを使用して、必要に応じてアクティブ化します。


az sphere device network enable --interface eth0

Applibs を使用したイーサネット構成

イーサネットを構成するには、アプリケーションで applibs ネットワーク API を使用する必要があります。

アプリケーションに次のヘッダーファイルを含めます。

#include <applibs/networking.h>

アプリケーションマニフェストには、NetworkConfig 機能が含まれている必要があります。

 "Capabilities": {
  "NetworkConfig" : true
}

Networking_GetInterfaceConnectionStatus関数を使用して、ネットワークインターフェイスがアクティブかどうかを判断します。

Networking_GetInterfaceConnectionStatus("eth0", &currentInterfaceStatus);

ネットワークインターフェイスをアクティブにするには、 Networking_SetInterfaceState 関数を使用します。

Networking_SetInterfaceState("eth0", true);

注

ネットワークインターフェイス (wlan0 と eth0) の両方がアクティブで接続されている場合、デバイスが通信に使用する特定のインターフェイスは非決定論的です。任意の時点で使用するネットワークインターフェイスを制御する場合は、アプリケーションで Networking_SetInterfaceState() 関数を使用して目的のインターフェイスを明示的にオンにし、もう一方のインターフェイスをオフにする必要があります。 DHCP クライアントの高レベルアプリサンプルでは、2 つのインターフェイスのいずれかを表す値をグローバル変数に割り当てることでインターフェイスを切り替える方法を示します。

サンプル

Azure IoT は、Azure Sphere アプリケーションで Azure IoT SDK C API を使用して、Azure IoT Hub または Azure IoT Central と通信する方法を示しています。

DHCP クライアントの概要アプリネットワークの DHCP サーバーが MT3620 デバイスに割り当てた現在の IP アドレスを更新または解放する方法を示します。

HTTPS cURL Easy は、cURL の 'easy' API を使用して HTTPS 経由でコンテンツをフェッチする方法を示しています

HTTPS cURL Multi は、cURL の 'multi' API を使用して HTTPS 経由でコンテンツをフェッチする方法を示しています。

Power Down の高度なアプリは、Azure Sphere プラットフォームの Power Down 機能を示しています。

プライベートネットワークサービス Azure Sphere デバイスをプライベートネットワークに接続し、ネットワークサービスを使用する方法を示します。

WolfSSL の高度なアプリでは、高度なアプリケーションでの SSL ハンドシェイクに WolfSSL を使用する方法を示します。

注

次のサンプルは、Microsoft の管理されていないソフトウェアとハードウェアのサンプルのコレクションである Azure Sphere ギャラリーのサンプルです。詳細については、「 Azure Sphere ギャラリー」を参照してください。

ネットワークインターフェイスの MAC アドレスと IP アドレスを出力指定したネットワークインターフェイスの MAC アドレスと IP アドレスを出力します。

OSNetworkRequirementChecker-HLApp は、2 つのデバイス (MT3620) ネットワーク診断テストを実行します。

次の方法で共有

イーサネット用に Azure Sphere を準備する

アダプターをデバイスに接続する

ボード構成イメージをデプロイする

ボード構成イメージ パッケージを見つける

ボード構成イメージ パッケージをサイドロードする

クラウドでボード構成イメージ パッケージをデプロイする