Hinzufügen eines Gateways zu AWS IoT Core for LoRaWAN - AWS IoT Wireless
Hinzufügen eines Gateway mit der KonsoleFügen Sie mithilfe der API ein Gateway hinzu

Hinzufügen eines Gateways zu AWS IoT Core for LoRaWAN

Sie können Ihr Gateway mithilfe der Konsole oder der CLI zu AWS IoT Core for LoRaWAN hinzufügen.

Bevor Sie Ihr Gateway hinzufügen, empfehlen wir Ihnen, die im Abschnitt Vor dem Onboarding Ihres Gateways von Einbinden Ihrer Gateways in AWS IoT Core for LoRaWAN genannten Faktoren zu berücksichtigen.

Wenn Sie Ihr Gateway zum ersten Mal hinzufügen, empfehlen wir Ihnen, die Konsole zu verwenden. Wenn Sie Ihr Gateway stattdessen mithilfe der CLI hinzufügen möchten, müssen Sie bereits die erforderliche IAM-Rolle erstellt haben, damit das Gateway eine Verbindung zu AWS IoT Core for LoRaWAN herstellen kann. Informationen zum Erstellen der Rolle finden Sie unter Fügen Sie eine IAM-Rolle hinzu, damit der Configuration and Update Server (CUPS) die Gateway-Anmeldeinformationen verwalten kann.

Hinzufügen eines Gateway mit der Konsole

Navigieren Sie zur AWS IoT Core for LoRaWANEinführungsseite der AWS IoT Konsole und wählen Sie Start und dann Gateway hinzufügen aus. Wenn Sie bereits ein Gateway hinzugefügt haben, wählen Sie Gateway anzeigen aus, um das Gateway anzuzeigen, das Sie hinzugefügt haben. Wenn Sie weitere Gateways hinzufügen möchten, wählen Sie Gateway hinzufügen.

  1. Geben Sie Gateway-Details und Frequenzbandinformationen an

    Verwenden Sie den Abschnitt Gateway-Details, um Informationen über die Gerätekonfigurationsdaten wie die EUI des Gateways und die Frequenzbandkonfiguration bereitzustellen.

    • Die EUI des Gateways

      Die EUI (Extended Unique Identifier) des einzelnen Gateway-Geräts. Die EUI ist ein 16-stelliger alphanumerischer Code, der beispielsweise ein Gateway c0ee40ffff29df10 Ihrem LoRaWAN-Netzwerk eindeutig identifiziert. Diese Informationen sind spezifisch für Ihr Gateway-Modell und Sie finden sie auf Ihrem Gateway-Gerät oder in dessen Bedienungsanleitung.

      Anmerkung

      Die EUI des Gateways unterscheidet sich von der Wi-Fi-MAC-Adresse, die möglicherweise auf Ihrem Gateway-Gerät aufgedruckt ist. Die EUI folgt einem EUI-64-Standard, der Ihr Gateway eindeutig identifiziert und daher nicht in anderen AWS-Konto und Regionen wiederverwendet werden kann.

    • Frequenzband (HF-Region)

      Das Frequenzband des Gateways. Sie können zwischenUS915, EU868, AU915 oder AS923-1 wählen, je nachdem, was Ihr Gateway unterstützt und aus welchem Land oder welcher Region das Gateway physisch eine Verbindung herstellt. Weitere Informationen zu Bändern finden Sie unter Erwägen Sie die Auswahl von LoRa-Frequenzbändern für Ihre Gateways und die Geräteverbindung.

  2. Geben Sie Ihre Wireless-Gateway-Konfigurationsdaten an (optional)

    Diese Felder sind optional und Sie können sie verwenden, um zusätzliche Informationen über das Gateway und seine Konfiguration bereitzustellen.

    • Name, Beschreibung und Tags für Ihr Gateway

      Die Informationen in diesen optionalen Feldern ergeben sich aus der Art und Weise, wie Sie die Elemente in Ihrem Funksystem organisieren und beschreiben. Sie können dem Gateway einen Namen zuweisen, das Beschreibungsfeld verwenden, um Informationen über das Gateway bereitzustellen, und mithilfe von Tags Schlüsselwertpaare von Metadaten über das Gateway hinzufügen. Ausführlichere Informationen zur Benennung und Beschreibung von Ressourcen finden Sie unter Beschreiben Ihrer AWS IoT Wireless-Ressourcen.

    • LoRaWAN-Konfiguration mit Subbändern und Filtern

      Optional können Sie auch LoRaWAN-Konfigurationsdaten angeben, z. B. die Unterbänder, die Sie verwenden möchten, und Filter, die den Verkehrsfluss steuern können. Für dieses Tutorial können Sie diese Felder überspringen. Weitere Informationen finden Sie unter Konfiguration der Subbänder und Filterfunktionen Ihres Gateways.

  3. Ordnen Sie dem Gateway ein AWS IoT zu

    Geben Sie an, ob ein AWS IoT erstellt und dem Gateway zugeordnet werden soll. Die in AWS IoT enthaltenen Informationen können die Suche und Verwaltung Ihrer Geräte erleichtern. Wenn Sie Ihrem Gateway etwas zuordnen, kann das Gateway auf andere AWS IoT Core Funktionen zugreifen.

  4. Erstellen Sie das Gateway-Zertifikat und laden Sie es herunter

    Um Ihr Gateway zu authentifizieren, damit es sicher mit AWS IoT kommunizieren kann, muss Ihr LoRaWAN-Gateway einen privaten Schlüssel und ein Zertifikat AWS IoT Core for LoRaWAN vorlegen. Erstellen Sie ein Gateway-Zertifikat, mit dem AWS IoT die Identität Ihres Gateways mithilfe des X.509-Standards überprüfen kann.

    Klicken Sie auf die Schaltfläche Zertifikat erstellen und laden Sie die Zertifikatsdateien herunter. Sie werden sie später verwenden, um Ihr Gateway zu konfigurieren.

  5. Kopieren Sie die CUPS- und LNS-Endpunkte und laden Sie die Zertifikate herunter

    Ihr LoRaWAN-Gateway muss eine Verbindung zu einem CUPS- oder LNS-Endpunkt herstellen, wenn Sie eine Verbindung zu AWS IoT Core for LoRaWAN herstellen. Wir empfehlen die Verwendung des CUPS-Endpunkts, da er auch das Konfigurationsmanagement ermöglicht. Um die Authentizität von AWS IoT Core for LoRaWAN-Endpunkten zu überprüfen, verwendet Ihr Gateway für jeden CUPS- und LNS-Endpunkt ein Vertrauenszertifikat.

    Klicken Sie auf die Schaltfläche Kopieren, um die CUPS- und LNS-Endpunkte zu kopieren. Sie benötigen diese Information später, um Ihr Gateway zu konfigurieren. Klicken Sie anschließend auf die Schaltfläche Server-Vertrauenszertifikate herunterladen, um die Vertrauenszertifikate für die CUPS- und LNS-Endpunkte herunterzuladen.

  6. Erstellen Sie die IAM-Rolle für die Gateway-Berechtigungen

    Sie müssen eine IAM-Rolle hinzufügen, damit der Configuration and Update Server (CUPS) die Gateway-Anmeldeinformationen verwalten kann.

    Anmerkung

    In diesem Schritt erstellen Sie die Rolle IoTWirelessGatewayCertManager. Wenn Sie diese Rolle bereits erstellt haben, können Sie diesen Schritt überspringen. Stellen Sie sicher, dass Sie dieses Verfahren durchführen, bevor ein LoRaWAN-Gateway versucht, eine Verbindung zu AWS IoT Core for LoRaWAN herzustellen. Sie müssen dies jedoch nur einmal tun.

    Um die IAM-Rolle IoTWirelessGatewayCertManager für Ihr Konto zu erstellen, klicken Sie auf die Schaltfläche Rolle erstellen. Wenn die Rolle bereits existiert, wählen Sie sie aus der Dropdown-Liste aus.

    Klicken Sie auf Senden, um die Gateway-Erstellung abzuschließen.

Fügen Sie mithilfe der API ein Gateway hinzu

Wenn Sie zum ersten Mal ein Gateway mithilfe der API oder CLI hinzufügen, müssen Sie die IAM-Rolle IotWirelessGatewayCertManager hinzufügen, damit das Gateway eine Verbindung zu AWS IoT Core for LoRaWAN herstellen kann. Weitere Informationen zur Erstellung der Rolle, finden Sie im folgenden Abschnitt Fügen Sie eine IAM-Rolle hinzu, damit der Configuration and Update Server (CUPS) die Gateway-Anmeldeinformationen verwalten kann.

In den folgenden Listen werden die API-Aktionen beschrieben, mit denen die Aufgaben im Zusammenhang mit dem Hinzufügen, Aktualisieren oder Löschen eines LoRaWAN-Gateways ausgeführt werden.

AWS IoT Wireless-API-Aktionen für AWS IoT Core for LoRaWAN-Gateways

Eine vollständige Liste der Aktionen und Datentypen, die zum Erstellen und Verwalten von AWS IoT Core for LoRaWAN Ressourcen verfügbar sind, finden Sie in der AWS IoT Wireless API-Referenz.

So verwenden Sie die AWS CLI zum Hinzufügen eines Gateways

Sie können die AWS CLI verwenden, um ein drahtloses Gateway zu erstellen, indem Sie den Befehl create-wireless-gateway verwenden. Im folgenden Beispiel wird ein drahtloses LoRaWAN-Geräte-Gateway erstellt. Sie können auch eine input.json-Datei verwenden, die zusätzliche Details enthält, z. B. das Gateway-Zertifikat und die Anmeldeinformationen für die Bereitstellung.

Anmerkung

Sie können dieses Verfahren auch mit der API durchführen, indem Sie die Methoden der AWS-API verwenden, die den hier gezeigten CLI-Befehlen entsprechen. 

aws iotwireless create-wireless-gateway \
    --lorawan GatewayEui="a1b2c3d4567890ab",RfRegion="US915" \
    --name "myFirstLoRaWANGateway" \
    --description "Using my first LoRaWAN gateway"
    --cli-input-json input.json

Informationen zu den CLIs, die Sie verwenden können, finden Sie in der AWS CLI-Referenz.