Aggiungi un gateway a AWS IoT Core per LoRaWAN - Wireless AWS IoT
Aggiungere un gateway utilizzando la consoleAggiungi un gateway utilizzando l'API

Aggiungi un gateway a AWS IoT Core per LoRaWAN

È possibile aggiungere il gateway ad AWS IoT Core per LoRaWAN utilizzando la console o la CLI.

Prima di aggiungere il gateway, ti consigliamo di considerare i fattori menzionati in Prima di eseguire l'onboarding del gateway, nella sezione di Integrare i gateway per AWS IoT Core per LoRaWAN.

Se utilizzi il tuo gateway per la prima volta, consigliamo di utilizzare la console. Se desideri aggiungere il gateway utilizzando il CLI, devi aver già creato il ruolo IAM necessario in modo che il gateway possa connettersi con AWS IoT Core per LoRaWAN. Per informazioni su come creare il ruolo, consulta Aggiungi un ruolo IAM per permettere a Configuration and Update Server (CUPS) di gestire le credenziali del gateway.

Aggiungere un gateway utilizzando la console

Vai alla pagina Intro AWS IoT Core per LoRaWAN della console AWS IoT e scegli Get started (Nozioni di base), poi scegli Add gateway (Aggiungi gateway). Se hai già aggiunto un gateway, scegli View gateway (Visualizza gateway) per visualizzare il gateway aggiunto. Se desideri aggiungere altri gateway, scegli Add gateway (Aggiungi gateway).

  1. Fornisci dettagli sul gateway e informazioni sulla banda di frequenza

    Utilizza Gateway details (Dettagli gateway) per fornire informazioni sui dati di configurazione del dispositivo, ad esempio l'EUI del gateway e la configurazione della banda di frequenza.

    • EUI del Gateway

      L'EUI (Extended Unique Identifier) del singolo dispositivo di gateway. L'EUI è un codice alfanumerico a 16 cifre, come c0ee40ffff29df10, che identifica in modo univoco un gateway nella tua rete LoRaWAN. Queste informazioni sono specifiche per il tuo modello gateway e puoi trovarle sul tuo dispositivo gateway o nel relativo manuale utente.

      Nota

      L'EUI del gateway è diverso dall'indirizzo MAC Wi-Fi che potresti vedere stampato sul tuo dispositivo gateway. L'EUI segue uno standard EUI-64 che identifica in modo univoco il gateway e quindi non può essere ripreso in altre regioni e account Account AWS.

    • Banda di frequenza (RFRegion)

      La banda di frequenza del gateway. Puoi scegliere tra US915, EU868, AU915 oppure AS923-1, a seconda del tipo di supporto del gateway e del paese da cui il gateway si connette fisicamente. Per ulteriori informazioni sulle bande, consulta Considerate la selezione delle bande di frequenza LoRa per i gateway e la connessione del dispositivo.

  2. Specificare i dati di configurazione del gateway wireless (opzionale)

    Questi campi sono facoltativi ed è possibile utilizzarli per fornire ulteriori informazioni sul gateway e sulla sua configurazione.

    • Nome, Descrizione e Tag per il gateway

      Le informazioni contenute in questi campi facoltativi provengono da come organizzi e descrivi gli elementi del sistema wireless. Puoi assegnare un Nome al gateway, utilizzare il comando Description (Descrizione) per fornire informazioni sul gateway e utilizzare Tag per aggiungere coppie chiave-valore di metadati sul gateway. Per ulteriori informazioni sulla denominazione e sulla descrizione delle risorse, consulta Descrizione delle risorse AWS IoT Wireless.

    • Configurazione LoRaWAN con sottobande e filtri

      Facoltativamente, è inoltre possibile specificare i dati di configurazione di LoRaWAN, ad esempio le sottobande che si desidera utilizzare e i filtri in grado di controllare il flusso di traffico. Per questo tutorial, è possibile saltare questi campi. Per ulteriori informazioni, consultare Configurare le sottobande e le funzionalità di filtraggio del gateway.

  3. Associa un oggetto AWS IoT con il gateway

    Specifica se creare un oggetto AWS IoT e associarlo al gateway. Gli oggetti in AWS IoT possono semplificare la ricerca e la gestione dei dispositivi. L'associazione di un oggetto al gateway consente al gateway di accedere ad altre caratteristiche di AWS IoT Core.

  4. Crea e scarica il certificato gateway

    Per autenticare il gateway in modo che possa comunicare in modo sicuro con AWS IoT, il gateway LoRaWAN deve presentare ad AWS IoT Core per LoRaWAN una chiave privata e un certificato. Creazione di un Certificato gateway in modo che AWS IoT possa verificare l'identità del gateway utilizzando lo standard X.509.

    Fai clic sul pulsante Create certificate (Crea un certificato) e scarica i file del certificato. Li userai in seguito per configurare il gateway.

  5. Copia gli endpoint CUPS e LNS e scarica i certificati

    Il gateway LoRaWAN deve connettersi a un endpoint CUPS o LNS quando si stabilisce una connessione ad AWS IoT Core per LoRaWAN. Ti consigliamo di utilizzare l'endpoint CUPS in quanto fornisce anche la gestione della configurazione. Per verificare l'autenticità degli endpoint di AWS IoT Core per LoRaWAN, il gateway utilizzerà un certificato di attendibilità per ciascuno degli endpoint CUPS e LNS,

    Fai clic su Copy (Copia) per copiare gli endpoint CUPS e LNS. Queste informazioni serviranno in seguito per configurare il gateway. Quindi fai clic sul pulsante Download server trust certificates (Scarica certificati di attendibilità server) per scaricare i certificati di attendibilità per gli endpoint CUPS e LNS.

  6. Crea il ruolo IAM per le autorizzazioni del gateway

    Aggiungi un ruolo IAM per permettere a Configuration and Update Server (CUPS) di gestire le credenziali del gateway.

    Nota

    In questo passaggio, crei il ruolo IoTWirelessGatewayCertManager. Puoi ignorare questa fase se questo spazio dei nomi è già stato creato. È necessario farlo prima che un gateway LoRaWAN tenti di connettersi con AWS IoT Core per LoRaWAN; tuttavia, è necessario farlo solo una volta.

    Per creare il ruolo IAM IoTWirelessGatewayCertManager per il tuo account, fai clic sul pulsante Create role (Crea ruolo). Se il ruolo esiste già, selezionalo dall'elenco a discesa.

    Fai clic su Submit (Invia) per completare la creazione del gateway.

Aggiungi un gateway utilizzando l'API

Se si sta aggiungendo un gateway per la prima volta utilizzando l'API o la CLI, è necessario aggiungere il ruolo IAM IoTWirelessGatewayCertManager in modo che il gateway possa connettersi con AWS IoT Core per LoRaWAN. Per informazioni sulla creazione del ruolo, consulta la seguente sezione Aggiungi un ruolo IAM per permettere a Configuration and Update Server (CUPS) di gestire le credenziali del gateway.

Gli elenchi seguenti descrivono le operazioni API che eseguono le attività associate all'aggiunta, all'aggiornamento o all'eliminazione di un gateway LoRaWAN.

Operazioni dell'API AWS IoT Wireless per gateway AWS IoT Core per LoRaWAN

Per l'elenco completo delle operazioni e dei tipi di dati disponibili per creare e gestire le risorse AWS IoT Core per LoRaWAN, consulta la documentazione di riferimento delle API AWS IoT Wireless

Come utilizzare AWS CLI per aggiungere un gateway

Puoi utilizzare AWS CLI per creare un gateway wireless utilizzando il comando create-wireless-gateway. Nell'esempio seguente viene creato un gateway per dispositivo LoRaWAN wireless. Puoi anche fornire un file input.json che conterrà ulteriori dettagli, ad esempio il certificato del gateway e le credenziali di provisioning.

Nota

È inoltre possibile eseguire questa procedura con l'API utilizzando i metodi dell'API AWS corrispondenti ai comandi CLI illustrati di seguito. 

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

Per informazioni sulle CLI utilizzabili, consulta Riferimento AWS CLI