Créez des groupes de multicast et ajoutez des appareils au groupe - AWS IoT Wireless
PrérequisCréer des groupes multicast à l'aide de la consoleCréer des groupes multicast à l'aide de de l'APIÉtapes suivantes

Créez des groupes de multicast et ajoutez des appareils au groupe

Vous pouvez créer des groupes de multicast à l'aide de la console ou de la CLI. Si vous créez votre groupe de multicast pour la première fois, nous vous recommandons d'utiliser la console pour ajouter votre groupe. Lorsque vous souhaitez gérer votre groupe de multicast et ajouter ou supprimer des appareils de votre groupe, vous pouvez utiliser la CLI.

Après avoir échangé des signaux avec les terminaux que vous avez ajoutés, AWS IoT Core for LoRaWAN établit les clés partagées avec les terminaux et définit les paramètres du transfert de données.

Prérequis

Avant de pouvoir créer des groupes de multicast et ajouter des appareils au groupe :

  • Préparez vos appareils pour la multicast et la configuration FUOTA en spécifiant les paramètres de configuration FUOTA GenAppKey et FPorts. Pour en savoir plus, consultez Préparer les appareils pour la multicast et la configuration FUOTA.

  • Vérifiez si les appareils sont compatibles avec les modes de fonctionnement de classe B ou de classe C. En fonction de la classe d'appareil prise en charge par votre appareil, choisissez un profil d'appareil sur lequel l'un ou les deux modes Prise en charge de la classe B ou Prise en charge de la classe C sont activés. Pour plus d'informations sur les profils d'appareil, veuillez consulter Ajoutez des profils à AWS IoT Core for LoRaWAN.

    Au début de la session multicast, une fenêtre de distribution de classe B ou de classe C est utilisée pour envoyer des messages de liaison descendante aux appareils de votre groupe.

Créer des groupes multicast à l'aide de la console

Pour créer des groupes multicast à l'aide de la console, rendez-vous sur la page des Groupes multicast de la console AWS IoT et choisissez Créer un groupe multicast.

  1. Création d'un groupe multicast

    Pour créer votre groupe multicast, spécifiez les propriétés de multicast et les balises de votre groupe.

    1. Spécifiez les propriétés multicast

      Pour définir les propriétés multicast, entrez les informations suivantes pour votre groupe multicast.

      • Nom : saisissez un nom unique pour votre groupe multicast. Le nom ne doit contenir que des lettres, des chiffres, des traits d'union et des traits de soulignement. Il ne doit pas contenir d'espace.

      • Description : vous pouvez fournir une description facultative pour votre groupe multicast. La longueur de la description peut aller jusqu’à 2 048 caractères.

    2. Tags pour groupe multicast

      Vous pouvez éventuellement fournir des paires clé-valeur sous forme de balises pour votre groupe multicast. Pour continuer à créer votre groupe multicast, choisissez Suivant.

  2. Ajout d'appareils à un groupe multicast

    Vous pouvez ajouter des appareils individuels ou un groupe d'appareils à votre groupe multicast. Pour ajouter des appareils :

    1. Spécification des RFRegion

      Spécifiez la région RF ou la bande de fréquence de votre groupe multicast. La RFregion de votre groupe multicast doit correspondre à la RFregion des appareils que vous ajoutez au groupe. Pour plus d'informations sur le RFRegion, consultez Envisagez de sélectionner des bandes de fréquences LoRa pour vos passerelles et la connexion de vos appareils.

    2. Sélectionnez une classe d'appareil de multicast

      Choisissez si vous souhaitez que les appareils du groupe de multicast passent en mode classe B ou classe C au début de la session de multicast. Une session de classe B peut recevoir des messages de liaison descendante à des emplacements de liaison descendante réguliers et une session de classe C peut recevoir des messages de liaison descendante à tout moment.

    3. Choisissez les appareils que vous souhaitez ajouter au groupe

      Choisissez si vous souhaitez ajouter des appareils individuellement ou en masse au groupe multicast.

      • Pour ajouter des appareils individuellement, entrez l'identifiant de chaque appareil sans fil que vous souhaitez ajouter à votre groupe.

      • Pour ajouter des appareils en bloc, vous pouvez filtrer les appareils que vous souhaitez ajouter par profil d'appareil ou par étiquette. Pour le profil d'appareil, vous pouvez ajouter des appareils dont le profil prend en charge la classe B, la classe C ou les deux classes d'appareils.

    4. Pour créer votre groupe multicast, choisissez Créer.

      Les détails du groupe multicast et les appareils que vous avez ajoutés apparaissent dans le groupe. Pour plus d'informations sur l'état du groupe multicast et de vos appareils et pour résoudre les problèmes éventuels, consultez Surveillez et résolvez l'état de votre groupe multicast et des appareils du groupe.

Après avoir créé un groupe multicast, vous pouvez choisir Action pour modifier, supprimer ou ajouter des appareils au groupe. Après avoir ajouté les appareils, vous pouvez planifier une session pour que la charge utile de la liaison descendante soit envoyée aux appareils de votre groupe.

Créer des groupes multicast à l'aide de de l'API

Pour créer des groupes multicast et ajouter des appareils au groupe à l'aide de l'API :

  1. Création d'un groupe multicast

    Pour créer votre groupe multicast, utilisez l'opération API CreateMulticastGroup ou la commande CLI create-multicast-group. Vous pouvez fournir un fichier input.json comme entrée pour la commande create-multicast-group.

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

    où :

    Contenu de input.json

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

    Après avoir créé votre groupe multicast, vous pouvez utiliser les opérations d'API ou les commandes CLI suivantes pour mettre à jour, supprimer ou obtenir des informations sur vos groupes multicast.

  2. Ajout d'appareils à un groupe multicast

    Vous pouvez ajouter des appareils à votre groupe multicast de manière individuelle ou groupée.

    • Pour ajouter des appareils en masse à votre groupe multicast, utilisez l'opération API StartBulkAssociateWirelessDeviceWithMulticastGroup ou la commande CLI start-bulk-associate-wireless-device-with-multicast-group. Pour filtrer les appareils que vous souhaitez associer en bloc à votre groupe multicast, fournissez une chaîne de requête. Ce qui suit montre comment ajouter un groupe d'appareils auquel est associé un profil d'appareil associé à l'ID spécifié.

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

      où :

      Contenu de input.json

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

      Voici l'URL multicast-groups/d6d8ef8e-7045-496d-b3f4-ebcaa1d564bf/bulk utilisée pour associer les appareils au groupe.

    • Pour ajouter des appareils individuellement à votre groupe multicast, utilisez l'opération API AssociateWirelessDeviceWithMulticastGroup ou la CLI associate-wireless-device-with-multicast-group. Indiquez l'identifiant de l'appareil sans fil pour chaque appareil que vous souhaitez ajouter à votre groupe.

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

    Après avoir créé votre groupe multicast, vous pouvez utiliser les opérations API ou commandes CLI suivantes pour obtenir des informations sur votre groupe multicast ou pour dissocier des appareils.

Étapes suivantes

Après avoir créé un groupe multicast et ajouté des appareils, vous pouvez continuer à ajouter des appareils et surveiller l'état du groupe multicast et de vos appareils. Si vos appareils ont été ajoutés avec succès au groupe, vous pouvez configurer et planifier l'envoi d'un message de liaison descendante aux appareils. Avant de pouvoir envoyer un message de liaison descendante, l'état de vos appareils doit être prêt pour la Configuration de la multicast. Une fois que vous avez planifié un message de liaison descendante, le statut passe à Tentative de session. Pour en savoir plus, consultez Programmez un message en liaison descendante à envoyer aux appareils de votre groupe multicast.

Si vous souhaitez mettre à jour le microprogramme des appareils du groupe multicast, vous pouvez effectuer des mises à jour du microprogramme en direct (FUOTA) avec AWS IoT Core for LoRaWAN. Pour en savoir plus, consultez Mises à jour du micrologiciel par liaison radio (FUOTA) pour les appareils AWS IoT Core for LoRaWAN.

Si vos appareils n'ont pas été ajoutés ou si vous voyez une erreur dans le groupe multicast ou dans l'état des appareils, vous pouvez survoler l'erreur pour obtenir plus d'informations et la résoudre. Si le message d'erreur persiste, pour plus d'informations sur le dépannage et la résolution du problème, consultez Surveillez et résolvez l'état de votre groupe multicast et des appareils du groupe.