Crea gruppi multicast e aggiungi dispositivi al gruppo - Wireless AWS IoT
PrerequisitiCreazione di gruppi multicast utilizzando la consoleCreazione di gruppi multicast utilizzando l'APIPassaggi successivi

Crea gruppi multicast e aggiungi dispositivi al gruppo

È possibile creare gruppi multicast utilizzando la console o la CLI. Se stai creando il tuo gruppo multicast per la prima volta, ti consigliamo di utilizzare la console per aggiungere il gruppo multicast. Quando si desidera gestire il gruppo multicast e aggiungere o rimuovere dispositivi dal gruppo, è possibile utilizzare la CLI.

Dopo aver scambiato la segnalazione con i dispositivi finali aggiunti, AWS IoT Core per LoRaWAN stabilisce le chiavi condivise con i dispositivi finali e imposta i parametri per il trasferimento dei dati.

Prerequisiti

Prima di procedere con la creazione di gruppi multicast e l'aggiunta di dispositivi al gruppo:

  • Preparare i dispositivi per la configurazione multicast e FUOTA, specificando i parametri di configurazione FUOTA GenAppKey e FPorts. Per ulteriori informazioni, consultare Preparazione dei dispositivi per la configurazione multicast e FUOTA.

  • Verificare se i dispositivi supportano le modalità operative di classe B o di classe C. A seconda della classe supportata dal dispositivo, scegliere un profilo per il dispositivo che abbia entrambe le modalità Supporta Classe B o Supporta Classe C. Per ulteriori informazioni sui profili, consulta Aggiungi profili a AWS IoT Core per LoRaWAN.

    All'inizio della sessione multicast, viene utilizzata una finestra di distribuzione di classe B o di classe C per inviare messaggi di downlink ai dispositivi del gruppo.

Creazione di gruppi multicast utilizzando la console

Per creare gruppi multicast utilizzando la console, vai alla pagina Multicast groups (Gruppi multicast) della console AWS IoT e scegli Create multicast group (Crea gruppo multicast).

  1. Creazione di un gruppo multicast

    Per creare il gruppo multicast, specificare le proprietà e i tag multicast per il gruppo.

    1. Specificazione delle proprietà multicast

      Per specificare le proprietà multicast, inserire le seguenti informazioni per il gruppo multicast.

      • Nome: inserire un nome univoco per il gruppo multicast. Il nome può includere solo lettere, numeri, trattini e caratteri di sottolineatura. Non può contenere spazi.

      • Descrizione: puoi fornire una descrizione per il gruppo multicast. Una descrizione può essere lunga fino a 2.048 caratteri.

    2. Tag per gruppo multicast

      È inoltre possibile fornire qualsiasi coppia chiave-valore come Tag per il tuo gruppo multicast. Per proseguire nella creazione del tuo gruppo multicast, scegli Successivo.

  2. Aggiungere dispositivi a un gruppo multicast

    È possibile aggiungere singoli dispositivi o un gruppo di dispositivi al gruppo multicast. Per aggiungere dispositivi:

    1. Specifica RFRegion

      Specifica il valore di RFRegion o la banda di frequenza per il tuo gruppo multicast. La RFRegion per il tuo gruppo multicast deve corrispondere a RFRegion di dispositivi aggiunti al gruppo multicast. Per ulteriori informazioni su RFRegion, vedi Considerate la selezione delle bande di frequenza LoRa per i gateway e la connessione del dispositivo.

    2. Seleziona una classe di dispositivi multicast

      Scegliere se si desidera che i dispositivi del gruppo multicast passino a una modalità di classe B o classe C all'inizio della sessione multicast. Una sessione di classe B può ricevere messaggi di downlink nei normali slot downlink e una sessione di classe C può ricevere messaggi downlink in qualsiasi momento.

    3. Scegli i dispositivi da aggiungere al gruppo

      Scegli se desideri aggiungere dispositivi al gruppo multicast singolarmente o in blocco.

      • Per aggiungere dispositivi singolarmente, inserire l'ID di ciascun di dispositivo wireless che si desidera aggiungere al gruppo.

      • Per aggiungere dispositivi in blocco, è possibile filtrare i dispositivi che si desidera aggiungere per profilo o tag. Filtrando in base al profilo del dispositivo, è possibile aggiungere dispositivi con un profilo che supporta la classe di dispositivo B, C o entrambe.

    4. Per creare un nuovo gruppo, selezionare Create (Crea).

      I dettagli del gruppo multicast e i dispositivi aggiunti compaiono nel gruppo. Per informazioni sullo stato del gruppo multicast, dei dispositivi e per la risoluzione di eventuali problemi, consultare Monitora e risolvi lo stato del gruppo multicast e dei dispositivi del gruppo.

Dopo aver creato un gruppo multicast, puoi scegliere Action (Azione) per modificare, eliminare o aggiungere dispositivi al gruppo multicast. Dopo aver aggiunto i dispositivi, è possibile pianificare una sessione per l'invio del payload di downlink ai dispositivi del gruppo.

Creazione di gruppi multicast utilizzando l'API

Per creare gruppi multicast e aggiungere dispositivi al gruppo utilizzando l'API:

  1. Creazione di un gruppo multicast

    Per creare il tuo gruppo multicast, usa l'operazione API CreateMulticastGroup o il comando CLI create-multicast-group. È possibile fornire questo file input.json come input per il comando create-multicast-group.

    aws iotwireless create-multicast-group \
    --cli-input-json file://input.json

    dove:

    Contenuti di input.json

    {   
   "Description": "Multicast group to send downlink payload and perform FUOTA.",
   "LoRaWAN": { 
      "DlClass": "ClassB",
      "RfRegion": "US915"
   },
   "Name": "MC_group_FUOTA"  
}

    Dopo aver creato il gruppo multicast, è possibile utilizzare le seguenti operazioni API o comandi CLI per aggiornare, eliminare o ottenere informazioni sui gruppi multicast.

  2. Aggiungere dispositivi a un gruppo multicast

    È possibile aggiungere dispositivi al gruppo multicast singolarmente o in blocco.

    • Per creare il tuo gruppo multicast, usa l'operazione API StartBulkAssociateWirelessDeviceWithMulticastGroup o il comando CLI start-bulk-associate-wireless-device-with-multicast-group. Per filtrare i dispositivi che si desidera associare in blocco al gruppo multicast, fornisci una stringa di query. Di seguito viene illustrato come aggiungere un gruppo di dispositivi con un profilo dispositivo a cui è collegato un ID specificato.

      aws iotwireless start-bulk-associate-wireless-device-with-multicast-group \
    --id "12abd34e-5f67-89c2-9293-593b1bd862e0" \
    --cli-input-json file://input.json

      dove:

      Contenuti di input.json

      {
     "QueryString": "DeviceProfileName: MyWirelessDevice AND DeviceProfileId: d6d8ef8e-7045-496d-b3f4-ebcaa1d564bf",
     "Tags": [
        {
            "Key": "Multicast",
            "Value": "ClassB"
        }
    ]
}

      Qui, multicast-groups/d6d8ef8e-7045-496d-b3f4-ebcaa1d564bf/bulk è l'URL utilizzato per associare dispositivi al gruppo.

    • Per creare il tuo gruppo multicast, usa l'operazione API AssociateWirelessDeviceWithMulticastGroup o il comando CLI associate-wireless-device-with-multicast-group. Fornisci l'ID del dispositivo wireless per ogni dispositivo che desideri aggiungere al tuo gruppo.

      aws iotwireless associate-wireless-device-with-multicast-group \
    --id "12abd34e-5f67-89c2-9293-593b1bd862e0" \
    --wireless-device-id "ab0c23d3-b001-45ef-6a01-2bc3de4f5333"

    Dopo aver creato il gruppo multicast, è possibile utilizzare le seguenti operazioni API o comandi CLI per ottenere informazioni sul gruppo multicast o per disassociare i dispositivi.

Passaggi successivi

Dopo aver creato un gruppo multicast e aggiunto dispositivi, è possibile continuare ad aggiungere dispositivi e monitorare lo stato sia del gruppo multicast che dei dispositivi. Se i dispositivi sono stati aggiunti correttamente al gruppo, puoi configurare e pianificare un messaggio di downlink da inviare ai dispositivi. Prima di poter inviare un messaggio di downlink, lo stato del dispositivo deve essere Multicast setup ready (Configurazione multicast pronta). Dopo aver pianificato un messaggio downlink, lo stato cambia in Session attempting (Tentativo di sessione). Per ulteriori informazioni, consultare Pianifica un messaggio di downlink da inviare ai dispositivi del gruppo multicast.

Se si desidera aggiornare il firmware dei dispositivi nel gruppo multicast, è possibile eseguire aggiornamenti Firmware Over-The-Air (FUOTA) con AWS IoT Core per LoRaWAN. Per ulteriori informazioni, consultare Aggiornamenti Firmware Over-The-Air (FUOTA) per dispositivi AWS IoT Core per LoRaWAN.

Se i dispositivi non sono stati aggiunti o se viene visualizzato un errore nel gruppo multicast o nello stato del dispositivo, puoi passare il mouse sopra l'errore per ottenere ulteriori informazioni e risolverlo. Se viene ancora visualizzato un errore, consultare Monitora e risolvi lo stato del gruppo multicast e dei dispositivi del gruppo per informazioni su come risolvere il problema.