Příprava Azure Sphere na Ethernet

Článek
03/01/2025

Důležité

Toto je dokumentace k Azure Sphere (starší verze). Azure Sphere (starší verze) se vyřazuje 27. září 2027 a uživatelé musí do této doby migrovat do Azure Sphere (integrované). K zobrazení dokumentace k Azure Sphere (integrované) použijte selektor verzí umístěný nad obsahem.

Ke komunikaci přes Ethernet vyžaduje zařízení Azure Sphere externí ethernetový adaptér a image konfigurace desky. K přípravě zařízení na síť přes Ethernet jsou potřeba následující kroky:

Připojte adaptér k zařízení.
Vytvořte a nasaďte image konfigurace panelu.
Povolte ethernetové rozhraní.

Upozornění

Pokud je vaše zařízení připojené přes Ethernet, vyžaduje se síť s nízkým provozem, aby se zabránilo ztrátě dat nebo nízkému výkonu. Zařízení ztratí data z příchozích paketů, které nejsou tcp, když v síti dochází k významnému příchozímu provozu. Data se obvykle neztratí z příchozích paketů TCP bez ohledu na objem přenosů, protože protokol TCP bude přecházet znovu zahozené pakety. Re-přenos je však za cenu výkonu.

Připojení adaptéru k zařízení

Seznam podporovaných adaptérů ethernetových adaptérů a modulů najdete v seznamu podporovaných ethernetových adaptérů a pokynů pro jejich připojení k vývojové desce Azure Sphere.

Vytvoření a nasazení image konfigurace panelu

Pro každý ethernetový adaptér používaný s Azure Sphere se vyžaduje image konfigurace panelu. Image konfigurace panelu obsahuje informace, které služba zabezpečení Azure Sphere vyžaduje, aby do operačního systému Azure Sphere přidala podporu sítě Ethernet. Musíte vytvořit balíček konfigurační image panelu pro adaptér Ethernet a nasadit ho spolu s balíčkem image aplikace. Balíček konfigurační image panelu můžete načíst bokem pro vývoj a ladění. Balíček konfigurační image panelu můžete také nasadit z cloudu spolu s aplikací Azure Sphere pro použití v terénu. Konfigurace panelu se nezapočítává do paměti Flash nebo paměti RAM rezervované pro aplikace vysoké úrovně.

Vytvoření balíčku image konfigurace panelu

K vytvoření balíčku konfigurační image panelu použijte příkaz azsphere image-package pack-board-config CLI.

Zkušební načtení balíčku konfigurační image panelu

Použití balíčku image konfigurace panelu během vývoje a ladění:

Příprava zařízení na vývoj a ladění:
```
azsphere device enable-development
```
Pomocí příkazu azsphere device sideload delete odstraňte ze zařízení všechny existující aplikace. Před načtením balíčku image konfigurace panelu je důležité odstranit existující aplikace, aby nedocházelo ke konfliktům prostředků mezi existujícími aplikacemi a konfigurací panelu.
Načtěte balíček konfigurační image panelu bokem. Pokud jste v předchozí části vytvořili vlastní konfigurační soubor panelu, můžete ho teď načíst bokem. Mezi přednastavené možnosti patří:

Seeed MT3620 Ethernet Shield for Microchip ENC28J60 NIC:
```
azsphere device sideload deploy --image-package lan-enc28j60-isu0-int5.imagepackage
```
Avnet Rev1 Devkit Click Module for Wiznet W5500 NIC:
```
azsphere device sideload deploy --image-package lan-w5500-isu1-int2.imagepackage
```
Avnet Rev2 Devkit Click Module for Wiznet W5500 NIC:
```
azsphere device sideload deploy --image-package lan-w5500-isu0-int5.imagepackage
```
Načtěte aplikaci bokem, buď pomocí sady Visual Studio, nebo pomocí příkazu azsphere device sideload deploy.

Cloud nasadí balíček image konfigurace panelu.

Pokud chcete nasadit balíček image konfigurace panelu prostřednictvím cloudu, musí mít vaše zařízení produkt, patří do skupiny zařízení a nesmí mít nainstalovanou funkci AppDevelopment. Informace o tom, jak je nastavit, najdete v tématu Vytvoření nasazení .

Jakmile je zařízení připravené, můžete nasadit image konfigurace panelu spolu s imagí aplikace v jednom nasazení.

Vytvoření nasazení:

Nahrajte balíček image do tenanta Azure Sphere pomocí příkazu azsphere image add.
Vytvořte nové nasazení pro skupinu zařízení pro nahrané image pomocí příkazu azsphere device-group deployment create.

Nahrajte balíček image:

azsphere image add --image <path-to-image-package>

Vytvořte nové nasazení pro skupinu zařízení:

azsphere device-group deployment create --device-group <device-group-ID> or '<product-name>/<device-group-name>' --images <image-ID> <image-ID>

Pokud chcete zadat více hodnot pro --images zadání seznamu hodnot oddělených mezerami.

Parametr --device-group identifikuje skupinu zařízení. ID skupiny zařízení poskytuje identifikátor GUID, který jednoznačně identifikuje skupinu zařízení ve všech produktech. Alternativně můžete použít dvojici název produktu a název skupiny zařízení ve <formátu product-name>/<device-group-name> . Tato dvojice názvů jednoznačně identifikuje skupinu zařízení pro konkrétní produkt. Nahraďte <ID> image ID id image balíčku image.

Odebrání konfigurace panelu se zkušebním načtením

Pokud při vývoji načtete konfiguraci panelu bokem, budete možná později muset tuto konfiguraci odebrat, aby ostatní aplikace mohly používat prostředky, které panel rezervuje. Pokud se pokusíte spustit aplikaci, která tyto prostředky používá při načítání konfigurace panelu na zařízení Azure Sphere, dojde k chybám konfliktů připnutí.

Pokud chcete odebrat konfiguraci panelu, postupujte takto:

Výpis imagí nainstalovaných v zařízení:
```
azsphere device image list-installed
```

V seznamu vyhledejte ID komponenty pro konfiguraci panelu:

 --> lan-enc28j60-is
 --> Image type:   Board configuration
 --> Component ID: 75a3dbfe-3fd2-4776-b7fe-c4c91de902c6
 --> Image ID:     a726b919-bdbe-4cf4-8360-2e37af9407e1

Odstraňte balíček image konfigurace panelu zadáním JEHO ID součásti:

azsphere device sideload delete --component-id 75a3dbfe-3fd2-4776-b7fe-c4c91de902c6

Restartujte zařízení stisknutím tlačítka Obnovit nebo zadáním příkazu azsphere device restart .

Povolení ethernetového rozhraní

Po načtení konfigurace panelu a restartování zařízení se rozhraní povolí automaticky. Pokud chcete rozhraní zakázat, použijte příkaz azsphere device network disable nebo zavolejte funkci Networking_SetInterfaceState , která je součástí rozhraní API pro konfiguraci sítě.

Všechna rozhraní ve výchozím nastavení používají dynamické IP adresy. Podrobnosti o typech služeb, které může aplikace Azure Sphere používat, najdete v tématu Použití síťových služeb .

Konfigurace Azure Sphere pro Ethernet

Po připojení zařízení Azure Sphere k podporovanému adaptéru Sítě Ethernet a nasazení image konfigurace panelu můžete nakonfigurovat zařízení Azure Sphere tak, aby se připojilo k síti z příkazového řádku (CLI) nebo z vaší aplikace pomocí knihoven aplikací sady Azure Sphere SDK (Applibs).

Konfigurace sítě Ethernet pomocí rozhraní příkazového řádku

Ke správě konfigurace sítě Ethernet z příkazového řádku použijte příkazy rozhraní příkazového řádku azsphere device network CLI. Například příkaz pro povolení sítě zařízení povolí na připojeném zařízení ethernetové rozhraní.

azsphere device network enable --interface "eth0"

Pokud chcete použít nakonfigurovanou ethernetovou síť, musí být síťové rozhraní (eth0) aktivní. K určení, jestli je rozhraní aktivní, použijte příkaz list-interfaces zařízení.


azsphere device network list-interfaces

V případě potřeby ji aktivujte pomocí příkazu povolit síť zařízení.


azsphere device network enable --interface eth0

Konfigurace sítě Ethernet pomocí applibs

Ke konfiguraci sítě Ethernet musí vaše aplikace používat síťové rozhraní API applibs.

Do aplikace zahrňte tento hlavičkový soubor:

#include <applibs/networking.h>

Manifest aplikace musí obsahovat funkci NetworkConfig.

 "Capabilities": {
  "NetworkConfig" : true
}

Pomocí funkce Networking_GetInterfaceConnectionStatus určíte, jestli je síťové rozhraní aktivní.

Networking_GetInterfaceConnectionStatus("eth0", &currentInterfaceStatus);

K aktivaci síťového rozhraní použijte funkci Networking_SetInterfaceState .

Networking_SetInterfaceState("eth0", true);

Poznámka:

Pokud jsou síťová rozhraní (wlan0 a eth0) aktivní a připojená, konkrétní rozhraní, které zařízení použije pro komunikaci, není deterministické. Pokud chcete určit, které síťové rozhraní se v daném okamžiku používá, musí aplikace použít funkci Networking_SetInterfaceState() k explicitní zapnutí a vypnutí požadovaného rozhraní. Ukázka aplikace vysoké úrovně klienta DHCP mimo jiné ukazuje, jak mezi rozhraními přepínat přiřazením hodnoty představující jedno ze dvou rozhraní globální proměnné.

Ukázky

Azure IoT ukazuje, jak používat rozhraní C API sady Azure IoT SDK v aplikaci Azure Sphere ke komunikaci se službou Azure IoT Hub nebo Azure IoT Central.

Aplikace vysoké úrovně klienta DHCP ukazuje, jak obnovit nebo uvolnit aktuální IP adresu, kterou server DHCP sítě přiřadil k zařízení MT3620.

HTTPS cURL Easy ukazuje načtení obsahu přes HTTPS pomocí rozhraní API "easy" cURL

Https cURL Multi ukazuje načtení obsahu přes HTTPS pomocí více rozhraní API cURL.

Aplikace Power Down vysoké úrovně ukazuje funkce Power Down pro platformu Azure Sphere.

Služby privátní sítě ukazují, jak připojit zařízení Azure Sphere k privátní síti a používat síťové služby.

Aplikace vysoké úrovně WolfSSL ukazuje použití WolfSSL pro handshake SSL v aplikaci vysoké úrovně.

Poznámka:

Následující ukázky pocházejí z galerie Azure Sphere, což je kolekce nepotřebných softwarových a hardwarových ukázek od Microsoftu. Další informace najdete v galerii Azure Sphere.

Tisk adres MAC a IP adres síťového rozhraní vytiskne mac a IP adresy zadaného síťového rozhraní.

OSNetworkRequirementChecker-HLApp provádí dva diagnostické testy sítě (MT3620).

Sdílet prostřednictvím