Zum Hauptinhalt springen

Tutorial: Einrichtung der Azure IoT Edge Runtime auf RevPi-Geräten

Einführung​

Dieses Tutorial beschreibt, wie Du Microsoft IoT Edge verwenden kannst, um ein Revolution Pi (RevPi)-Gerät mit Azure IoT Hub zu verbinden. Der Prozess umfasst die Konfiguration von Azure IoT Hub, die Registrierung Deines IoT-Geräts und die Einrichtung der IoT Edge Runtime auf Deinem RevPi.

Voraussetzungen​

  1. Ein gültiges Azure-Konto
  2. Ein RevPi-Gerät (mindestens 8 GB Speicher)
  3. Ein PC mit Internetzugang
  4. Grundlegende Kenntnisse der Linux-Befehlszeile
  5. SSH-Zugriff auf Deinen RevPi

Anforderungen​

Hardware:​

  • RevPi-Gerät mit mindestens 8 GB Speicher
  • Stromversorgung
  • Netzwerkverbindung
  • PC mit Internetzugang

Software:​

  • Neueste Version des Raspberry Pi OS
  • Mindestens 600 MB verfügbarer Speicherplatz
  • SSH-Client (z. B. PuTTY)

Vorbereitung​

  1. Erstelle ein Azure-Konto unter azure.microsoft.com/free
  2. Melde Dich im Azure-Portal an
  3. Richte den SSH-Zugriff auf Dein RevPi-Gerät ein
  4. Aktualisiere Deinen RevPi auf die neueste Version des Raspberry Pi OS
  5. Stelle sicher, dass 600 MB freier Speicher verfügbar sind

Schritt 1: Einrichtung von Azure​

Erstellung des IoT Hub​

▷ Melde Dich im Azure-Portal unter portal.azure.com an

▷ Klicke auf "Ressource erstellen" und suche nach "IoT Hub"

▷ Klicke auf "Erstellen"

▷ Wähle Dein Abonnement und eine Ressourcengruppe aus oder erstelle eine neue

▷ Wähle die Region, die Dir am nächsten liegt (Hinweis: Nicht alle Azure-Dienste sind in allen Regionen verfügbar)

▷ Wähle unter "Verwaltung" die Preisklasse, die Deinen Anforderungen entspricht

▷ Klicke auf "Überprüfen und erstellen"

▷ Klicke auf "Erstellen", um Deinen IoT Hub bereitzustellen

Erstellung des Edge-Geräts​

▷ Navigiere zu Deinem neu erstellten IoT Hub

▷ Wähle im Seitenmenü "IoT Edge" unter "Geräteverwaltung" aus

▷ Klicke auf "IoT Edge-Gerät hinzufügen"

▷ Gib eine Geräte-ID für Deinen RevPi ein

▷ Akzeptiere die Standardeinstellungen

▷ Klicke auf "Speichern"

▷ Klicke auf "Aktualisieren"

▷ Wähle Dein neu erstelltes Gerät aus

▷ Kopiere den "Primären Verbindungsstring" – den brauchst Du später

Schritt 2: Einrichtung des RevPi-Geräts​

Installation der benötigten Pakete​

Zunächst das Microsoft-Paket-Repository und den GPG-Schlüssel hinzufügen:

curl https://packages.microsoft.com/config/debian/stretch/multiarch/packages-microsoft-prod.deb > ./packages-microsoft-prod.deb
sudo apt install ./packages-microsoft-prod.deb

curl https://packages.microsoft.com/config/debian/stretch/multiarch/prod.list > ./microsoft-prod.list
sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

sudo apt-get update

Installation der IoT Edge Runtime​

Installiere die Moby-Container-Engine und IoT Edge:

sudo apt-get install moby-engine -y
sudo apt-get install iotedge -y

Konfiguration von IoT Edge​

▷ Öffne die Konfigurationsdatei:

sudo nano /etc/iotedge/config.yaml

▷ Finde den Abschnitt "Manuelle Provisionierungskonfiguration" und aktualisiere den device_connection_string mit Deinem primären Verbindungsstring:

provisioning:
  source: "manual"
  device_connection_string: "HostName=XXX.azure-devices.net;DeviceId=rpi-1;SharedAccessKey=XXXXc="

Starten und Überprüfen von IoT Edge​

▷ Starte den IoT Edge-Dienst neu:

sudo systemctl restart iotedge

▷ Überprüfe den Status:

sudo systemctl status iotedge
sudo iotedge check

▷ Führe "iotedge check" zweimal aus – es ist normal, eine verbleibende Fehlermeldung zu "Produktionsbereitschaft: Edge Hub's Speicherverzeichnis" zu sehen.

Fehlerbehebung​

Falls Probleme auftreten:

  • Sieh im RevPi-Forum nach: revolutionpi.de/forum/
  • Überprüfe die Azure IoT Edge-Protokolle: journalctl -u iotedge
  • Verifiziere die Netzwerkverbindung
  • Stelle sicher, dass alle erforderlichen Ports geöffnet sind
  • Überprüfe die Systemressourcen

Weitere Informationen​