# 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](lorawan-prepare-devices-multicast.md).
+ 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](lorawan-define-profiles.md).
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](https://console.aws.amazon.com/iot/home#/wireless/multicastGroups) (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.
1.
**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**.
1.
**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](lorawan-rfregion-permissions.md#lorawan-frequency-bands).
1.
**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.
1.
**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.
1. 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](lorawan-multicast-status.md).
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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateMulticastGroup.html) o il comando CLI [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-multicast-group.html). È 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.
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup) o [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup) o [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListMulticastGroups](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListMulticastGroups) o [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-multicast-groups.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-multicast-groups.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteMulticastGroup) o [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-multicast-group.html)
1.
**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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkAssociateWirelessDeviceWithMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkAssociateWirelessDeviceWithMulticastGroup.html) o il comando CLI [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-associate-wireless-device-with-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-associate-wireless-device-with-multicast-group.html). 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithMulticastGroup.html) o il comando CLI [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-wireless-device-with-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-wireless-device-with-multicast-group.html). 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.
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromMulticastGroup.html) o [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-wireless-device-from-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-wireless-device-from-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkDisassociateWirelessDeviceFromMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkDisassociateWirelessDeviceFromMulticastGroup.html) o [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-disassociate-wireless-device-from-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-disassociate-wireless-device-from-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices) o [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-wireless-devices.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-wireless-devices.html)
**Nota**
L'operazione API `ListWirelessDevices` può essere utilizzata per creare elenchi di dispositivi wireless in generale, o di dispositivi wireless associati a un gruppo multicast o a un'attività FUOTA.
Per elencare i dispositivi wireless associati a un gruppo multicast, utilizzare l'operazione API `ListWirelessDevices` con `MulticastGroupID` come filtro.
Per elencare i dispositivi wireless associati a un'attività processo FUOTA, utilizzare l'operazione API `ListWirelessDevices` con `FuotaTaskID` come filtro.
## 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](lorawan-multicast-schedule-downlink.md).
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](lorawan-mc-fuota-overview.md).
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](lorawan-multicast-status.md) per informazioni su come risolvere il problema.