Verbinden Sie Ihr Raspberry Pi 3 mit der Remoteüberwachungslösung, und senden Sie mithilfe von Node.js simulierte Telemetriedaten.
In diesem Tutorial wird gezeigt, wie Sie das Raspberry Pi 3 nutzen, um Temperatur- und Luftfeuchtigkeitsdaten zu simulieren, die in die Cloud gesendet werden sollen. Im Tutorial wird Folgendes verwendet:
- Raspbian OS, die Programmiersprache Node.js und das Microsoft Azure IoT SDK für Node.js, um ein Beispielgerät zu implementieren.
- Die von IoT Suite vorkonfigurierte Remoteüberwachungslösung als cloudbasiertes Back-End.
Überblick
In diesem Tutorial führen Sie folgende Schritte aus:
- Bereitstellen einer Instanz der vorkonfigurierten Remoteüberwachungslösung für Ihr Azure-Abonnement. Durch diesen Schritt werden automatisch mehrere Azure-Dienste bereitgestellt und konfiguriert.
- Einrichten Ihres Geräts für die Kommunikation mit Ihrem Computer und der Remoteüberwachungslösung.
- Aktualisieren des Beispielgerätecodes für die Verbindungsherstellung mit der Remoteüberwachungslösung und Senden simulierter Telemetriedaten, die auf dem Lösungsdashboard angezeigt werden können.
Voraussetzungen
Um dieses Tutorial abzuschließen, benötigen Sie ein aktives Azure-Abonnement.
Hinweis
Wenn Sie über kein Konto verfügen, können Sie in nur wenigen Minuten ein kostenloses Testkonto erstellen. Ausführliche Informationen finden Sie unter Einen Monat kostenlos testen.
Erforderliche Software
Sie benötigen einen SSH-Client auf Ihrem Desktopcomputer, um per Remotezugriff auf die Befehlszeile des Raspberry Pi zugreifen zu können.
- In Windows ist kein SSH-Client enthalten. Wir empfehlen die Verwendung von PuTTY.
- In den meisten Linux-Distributionen sowie in Mac OS ist ein SSH-Befehlszeilenprogramm enthalten. Weitere Informationen finden Sie unter SSH Using Linux or Mac OS (SSH unter Linux oder Mac OS).
Erforderliche Hardware
Ein Desktopcomputer, über den Sie eine Remoteverbindung mit der Befehlszeile auf dem Raspberry Pi herstellen können.
Microsoft IoT Starter Kit für Raspberry Pi 3 oder entsprechende Komponenten. In diesem Tutorial wird Folgendes aus dem Kit verwendet:
- Raspberry Pi 3
- MicroSD-Karte (mit NOOBS)
- Ein Mini-USB-Kabel
- Ein Ethernetkabel
Bereitstellen der Lösung
Wenn Sie die vorkonfigurierte Lösung für die Remoteüberwachung noch nicht in Ihrem Konto bereitgestellt haben:
- Melden Sie sich mit den Anmeldeinformationen für Ihr Azure-Konto bei azureiotsuite.com an, und klicken Sie auf +, um eine Lösung zu erstellen.
- Klicken Sie auf der Kachel Remoteüberwachung auf Auswählen.
- Geben Sie einen Lösungsnamen für Ihre vorkonfigurierte Remoteüberwachungslösung ein.
- Wählen Sie die gewünschten Angaben für Region und Abonnement, um die Lösung bereitzustellen.
- Klicken Sie auf Lösung erstellen , um den Bereitstellungsprozess zu beginnen. Dies dauert in der Regel einige Minuten.
Warten auf den Abschluss des Bereitstellungsvorgangs
- Klicken Sie auf die Kachel für Ihre Lösung mit dem Status Bereitstellung .
- Beachten Sie die Bereitstellungsstatus während der Bereitstellung von Azure-Diensten im Azure-Abonnement.
- Nach Abschluss der Bereitstellung ändert sich der Status in Bereit.
- Klicken Sie auf die Kachel, um im rechten Bereich Details zur Lösung anzuzeigen.
Hinweis
Falls beim Bereitstellen der vorkonfigurierten Lösung Probleme auftreten, helfen Ihnen die Informationen unter Berechtigungen für die Website „azureiotsuite.com“ und die häufig gestellten Fragen weiter. Sollten die Probleme weiterhin auftreten, können Sie im Portal ein Dienstticket erstellen.
Erwarten Sie Informationen zu Ihrer Lösung, die nicht aufgeführt werden? Senden Sie uns Vorschläge für neue Funktionen über den Feedbackbereichzu.
Warnung
Die Remoteüberwachungslösung stellt eine Gruppe von Azure-Diensten im Azure-Abonnement bereit. Die Bereitstellung gibt eine echte Unternehmensarchitektur wieder. Um unnötige Azure-Nutzungsgebühren zu vermeiden, löschen Sie Ihre Instanz der vorkonfigurierten Lösung auf „azureiotsuite.com“, sobald Sie damit fertig sind. Wenn Sie die vorkonfigurierte Lösung erneut benötigen, können Sie sie problemlos wiederherstellen. Weitere Informationen zur Senkung der Nutzung während der Ausführung der Remoteüberwachungslösung finden Sie unter Configuring Azure IoT Suite preconfigured solutions for demo purposes (Konfigurieren vorkonfigurierter Azure IoT Suite-Lösungen zu Demonstrationszwecken).
Anzeigen des Lösungsdashboards
Im Lösungsdashboard können Sie die bereitgestellte Lösung verwalten. Sie können beispielsweise Telemetriedaten anzeigen, Geräte hinzufügen und Methoden aufrufen.
Wenn die Bereitstellung abgeschlossen ist und auf der Kachel für die vorkonfigurierte Lösung Bereit angezeigt wird, wählen Sie Starten aus, um eine neue Registerkarte mit dem Portal für die Remoteüberwachungslösung zu öffnen.
Standardmäßig zeigt das Lösungsportal das Dashboard an. Über das Menü auf der linken Seite gelangen Sie zu anderen Bereichen des Lösungsportals.
Hinzufügen eines Geräts
Damit ein Gerät eine Verbindung mit der vorkonfigurierten Lösung herstellen kann, muss es sich mit gültigen Anmeldeinformationen bei IoT Hub identifizieren können. Sie können die Anmeldeinformationen für das Gerät aus dem Lösungsdashboard abrufen. Sie fügen die Anmeldeinformationen für das Gerät später in diesem Tutorial zu Ihrer Clientanwendung hinzu.
Fügen Sie Ihrer Remoteüberwachungslösung ein benutzerdefiniertes Gerät hinzu (sofern noch nicht geschehen). Führen Sie im Lösungsdashboard folgende Schritte aus:
Klicken Sie in der linken unteren Ecke des Dashboards auf Gerät hinzufügen.
Klicken Sie im Bereich Benutzerdefiniertes Gerät auf Neue hinzufügen.
Wählen Sie die Option Ich möchte meine eigene Geräte-ID definieren. Geben Sie eine Geräte-ID ein (beispielsweise rasppi), und klicken Sie auf ID prüfen, um sich zu vergewissern, dass Sie den Namen noch nicht in Ihrer Lösung verwendet haben. Klicken Sie anschließend auf Erstellen, um das Gerät bereitzustellen.
Notieren Sie sich die Geräteanmeldeinformationen (Geräte-ID, IoT Hub Hostname und Geräteschlüssel). Ihre Clientanwendung auf dem Raspberry Pi benötigt diese Werte, um eine Verbindung mit der Remoteüberwachungslösung herzustellen. Klicken Sie anschließend auf Fertig.
Wählen Sie Ihr Gerät im Lösungsdashboard in der Liste mit den Geräten aus. Klicken Sie anschließend im Bereich Gerätedetails auf Gerät aktivieren. Der Status Ihres Geräts lautet jetzt Wird ausgeführt. Die Remoteüberwachungslösung kann jetzt Telemetriedaten von Ihrem Gerät empfangen und Methoden auf dem Gerät aufrufen.
Vorbereiten des Raspberry Pi
Installieren von Raspbian
Wenn Sie den Raspberry Pi zum ersten Mal verwenden, müssen Sie das Raspbian-Betriebssystem mithilfe von NOOBS auf der im Kit enthaltenen SD-Karte installieren. Eine entsprechende Installationsanleitung finden Sie im Softwarehandbuch für den Raspberry Pi. In diesem Tutorial wird davon ausgegangen, dass Sie das Raspbian-Betriebssystem bereits auf Ihrem Raspberry Pi installiert haben.
Hinweis
Auf der SD-Karte des Microsoft Azure IoT Starter Kits für Raspberry Pi 3 ist NOOBS bereits installiert. Sie können den Raspberry Pi über diese Karte starten und das Raspbian-Betriebssystem installieren.
Führen Sie folgende Schritte aus, um die Hardwareeinrichtung abzuschließen:
- Verbinden Sie Ihren Raspberry Pi mit dem im Kit enthaltenen Netzteil.
- Verbinden Sie Ihren Raspberry Pi über das im Kit enthaltene Ethernetkabel mit Ihrem Netzwerk. Alternativ können Sie eine WLAN-Verbindung für Ihren Raspberry Pi einrichten.
Damit ist die Hardwareeinrichtung Ihres Raspberry Pi abgeschlossen.
Anmelden und Zugreifen auf das Terminal
Sie können auf Ihrem Raspberry Pi auf zwei Arten auf eine Terminalumgebung zuzugreifen:
Wenn Sie eine Tastatur und einen Monitor an Ihren Raspberry Pi angeschlossen haben, können Sie über die grafische Raspbian-Benutzeroberfläche auf ein Terminalfenster zugreifen.
Sie können aber auch auf Ihrem Desktopcomputer per SSH auf die Befehlszeile Ihres Raspberry Pi zugreifen.
Verwenden eines Terminalfensters auf der grafischen Benutzeroberfläche
Die Anmeldeinformationen für Raspbian lauten standardmäßig pi (Benutzername) und raspberry (Kennwort). Auf der Taskleiste der grafischen Benutzeroberfläche können Sie über das Monitorsymbol das Hilfsprogramm Terminal starten.
Anmelden mit SSH
Sie können über SSH auf die Befehlszeile Ihres Raspberry Pi zugreifen. Im Artikel SSH (Secure Shell) erfahren Sie, wie Sie SSH auf Ihrem Raspberry Pi konfigurieren und unter Windows oder unter Linux und Mac OS eine Verbindung herstellen.
Melden Sie sich mit dem Benutzernamen pi und dem Kennwort raspberry an.
Optional: Freigeben eines Ordners auf Ihrem Raspberry Pi
Bei Bedarf können Sie auch einen Ordner auf Ihrem Raspberry Pi für Ihre Desktopumgebung freigeben. Wenn Sie einen Ordner freigeben, können Sie Dateien auf Ihrem Raspberry PI mithilfe Ihres bevorzugten Desktop-Texteditors (etwa Visual Studio Code oder Sublime Text) bearbeiten, anstatt nano
oder vi
zu verwenden.
Wenn Sie einen Ordner für Windows freigeben möchten, konfigurieren Sie einen Samba-Server auf dem Raspberry Pi. Alternativ können Sie den integrierten SFTP-Server mit einem SFTP-Client auf Ihrem Desktop verwenden.
Herunterladen und Konfigurieren des Beispiels
Sie können jetzt Sie die Clientanwendung für die Remoteüberwachung auf Ihr Raspberry Pi herunterladen und anschließend konfigurieren.
Installieren von Node.js
Falls noch nicht geschehen, installieren Sie Node.js auf Ihrem Raspberry Pi. Das IoT SDK für Node.js erfordert Version 0.11.5 von Node.js oder höher. In den folgenden Schritten wird gezeigt, wie Sie Node.js 6.10.2 auf Ihrem Raspberry Pi installieren:
Verwenden Sie den folgenden Befehl aus, um Ihr Raspberry Pi zu aktualisieren:
sudo apt-get update
Verwenden Sie den folgenden Befehl zum Herunterladen der Node.js-Binärdateien auf Ihr Raspberry Pi:
wget https://nodejs.org/dist/v6.10.2/node-v6.10.2-linux-armv7l.tar.gz
Verwenden Sie den folgenden Befehl, um die Binärdateien zu installieren:
sudo tar -C /usr/local --strip-components 1 -xzf node-v6.10.2-linux-armv7l.tar.gz
Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Sie Node.js 6.10.2 erfolgreich installiert haben:
node --version
Klonen der Repositorys
Falls nicht bereits erfolgt, klonen Sie die erforderlichen Repositorys durch Ausführen der folgenden Befehle in einem Terminal auf Ihrem Pi:
cd ~
git clone --recursive https://github.com/Azure-Samples/iot-remote-monitoring-node-raspberrypi-getstartedkit.git
Aktualisieren der Verbindungszeichenfolge des Geräts
Öffnen Sie die Beispielquelldatei im Nano-Editor mithilfe des folgenden Befehls:
nano ~/iot-remote-monitoring-node-raspberrypi-getstartedkit/simulator/remote_monitoring.js
Suchen Sie die folgende Zeile:
var connectionString = 'HostName=[Your IoT hub name].azure-devices.net;DeviceId=[Your device id];SharedAccessKey=[Your device key]';
Ersetzen Sie die Platzhalterwerte durch die Geräte- und IoT Hub-Informationen, die Sie am Anfang dieses Tutorials erstellt und gespeichert haben. Speichern Sie Ihre Änderungen (STRG+O, EINGABETASTE), und beenden Sie den Editor (STRG+X).
Ausführen des Beispiels
Führen Sie die folgenden Befehle zum Installieren der erforderlichen Pakete für das Beispiel aus:
cd ~/iot-remote-monitoring-node-raspberrypi-getstartedkit/simulator
npm install
Sie können nun das Beispielprogramm auf dem Raspberry Pi ausführen. Geben Sie den folgenden Befehl ein:
sudo node ~/iot-remote-monitoring-node-raspberrypi-getstartedkit/simulator/remote_monitoring.js
Die folgende Beispielausgabe ist ein Beispiel der Ausgabe, die an der Eingabeaufforderung auf dem Raspberry Pi angezeigt wird:
Drücken Sie STRG+C, um das Programm zu einem beliebigen Zeitpunkt zu beenden.
Anzeigen der Telemetrie
Der Raspberry Pi sendet nun Telemetriedaten an die Remoteüberwachungslösung. Die Telemetriedaten können auf dem Lösungsdashboard angezeigt werden. Über das Lösungsdashboard können Sie auch Nachrichten an Ihren Raspberry Pi senden.
- Navigieren Sie zum Lösungsdashboard.
- Wählen Sie in der Dropdownliste Anzuzeigendes Gerät Ihr Gerät aus.
- Die Telemetriedaten des Raspberry Pi werden auf dem Dashboard angezeigt.
Ausführen von Aktionen für das Gerät
Über das Lösungsdashboard können Sie Methoden auf Ihrem Raspberry Pi aufrufen. Wenn der Raspberry Pi eine Verbindung mit der Remoteüberwachungslösung herstellt, sendet er Informationen zu den unterstützten Methoden.
Klicken Sie im Lösungsdashboard auf Geräte, um die Seite Geräte aufzurufen. Wählen Sie in der Geräteliste Ihren Raspberry Pi aus. Wählen Sie anschließend Methoden aus:
Wählen Sie auf der Seite Methode aufrufen in der Dropdownliste Methode die Option LightBlink aus.
Wählen Sie InvokeMethod aus. Der Simulator gibt in der Konsole auf dem Raspberry Pi eine Meldung aus. Die App auf dem Raspberry Pi gibt eine Bestätigung an das Lösungsdashboard zurück:
Die LED kann mithilfe der Methode ChangeLightStatus ein- und ausgeschaltet werden. Legen Sie dazu LightStatusValue auf 1 (Ein) bzw. 0 (Aus) fest.
Warnung
Wenn Sie die Ausführung der Remoteüberwachungslösung in Ihrem Azure-Konto nicht beenden, wird Ihnen die Ausführungszeit in Rechnung gestellt. Weitere Informationen zur Senkung der Nutzung während der Ausführung der Remoteüberwachungslösung finden Sie unter Configuring Azure IoT Suite preconfigured solutions for demo purposes (Konfigurieren vorkonfigurierter Azure IoT Suite-Lösungen zu Demonstrationszwecken). Löschen Sie die vorkonfigurierte Lösung aus Ihrem Azure-Konto, wenn Sie sie nicht mehr benötigen.
Nächste Schritte
Besuchen Sie das Azure IoT Dev Center, in dem Sie weitere Beispiele und Dokumentation zu Azure IoT finden.