Azure Sphere を Wi-Fi に接続する

[アーティクル]
08/09/2023

CLI または Azure Sphere SDK アプリケーションライブラリ (Applibs) を使用して、Wi-Fi を介してインターネットに接続するように Azure Sphere デバイスを構成できます。

認証方法

次の認証方法がサポートされています。

WPA2
EAP-TLS
open (パスワードなし)

Wi-Fi 用に Azure Sphere を構成する

コマンドライン (CLI) または Azure Sphere SDK アプリケーションライブラリ (Applibs) を使用して、アプリケーションから Wi-Fi ネットワークに接続するように Azure Sphere デバイスを構成できます。

CLI を使用した構成の Wi-Fi

コマンドラインから Wi-Fi 構成を管理するには、 az sphere device wifi CLI コマンドを使用します。たとえば、 device wifi add コマンドは、ワイヤレスネットワークの詳細をデバイスに追加します。


az sphere device wifi add --ssid "New SSID" --psk "key \'value\' with quotes"

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


az sphere device network list-interfaces

デバイスネットワーク enable コマンドを使用して、必要に応じてアクティブ化します。


az sphere device network enable --interface wlan0

構成された Wi-Fi ネットワークを有効にするには、 device wifi enable コマンドを使用します。


az sphere device wifi enable --id <network id>

クイックスタートトピック「 Azure Sphere デバイスで Wi-Fi を設定する」では、コマンドラインから Azure Sphere デバイスで Wi-Fi を構成する方法について説明します。

または、EAP-TLS 認証を使用している場合は、「 CLI から EAP-TLS ネットワークを設定する」を参照してください。

Applibs を使用した Wi-Fi 構成

Wi-Fi を構成するには、アプリケーションで applibs wificonfig API を使用する必要があります。

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

#include <applibs/wificonfig.h>

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

 "Capabilities": {
  "WifiConfig" : true
}

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

Networking_GetInterfaceConnectionStatus("wlan0", &currentInterfaceStatus);

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

Networking_SetInterfaceState("wlan0", true);

メモ

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

アプリケーションから構成された Wi-Fi ネットワークを有効にするには、 WifiConfig_SetNetworkEnabled 関数を使用します。

WifiConfig_SetNetworkEnabled(<network id>, true);

Applibs wificonfig API を使用して、顧客が Azure Sphere を組み込んだ製品の Wi-Fi を構成できるようにするための提案については、フィールドの「Wi-Fi の構成」を参照してください。

トピック「アプリで EAP-TLS ネットワークを設定する」では、概要レベルの Azure Sphere アプリケーションで EAP-TLS ネットワークを構成する方法について説明します。

サンプル

このセクションには、Azure Sphere プラットフォームでの Wi-Fi 機能の使用を示すサンプルアプリケーションへのリンクが含まれています。

WiFi_HighLevelApp サンプルでは、Wi-Fi ネットワークを高レベルアプリケーションで構成する方法を示します。

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

メモ

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

WifiConfigurationViaAppResource サンプルは、埋め込み JSON リソースファイルを使用してデバイス Wi-Fi 設定を構成する方法を示しています。

WifiConfigurationViaNfc サンプルは、NFC を使用してデバイス Wi-Fi 設定を構成する方法を示しています。

WifiConfigurationViaUart サンプルは、UART を使用してデバイス Wi-Fi 設定を構成する方法を示しています。

次の方法で共有