Mise en service groupée des appareils Sidewalk - AWS IoT Wireless
Mise en service groupée des appareils Sidewalk (console)Mise à jour groupée des appareils Sidewalk (CLI)Mise à jour ou suppression des tâches d’importation

Mise en service groupée des appareils Sidewalk

Cette section explique comment effectuer la mise en service groupée d’appareils Sidewalk dans AWS IoT Core pour Amazon Sidewalk à l’aide de la console AWS IoT et de l’AWS CLI.

Mise en service groupée des appareils Sidewalk (console)

Pour ajouter votre appareil Sidewalk à l’aide de la console AWS IoT, accédez à l’onglet Sidewalk du centre d’Appareils, choisissez Mise en service groupée des appareils, puis effectuez les étapes suivantes.

  1. Choisissez la méthode d’importation

    Spécifiez la manière dont vous souhaitez importer les appareils à intégrer de manière groupée à AWS IoT Core pour Amazon Sidewalk.

    • Pour mettre en service des appareils individuels à l’aide de leur numéro SMSN, choisissez Mettre en service un appareil individuel pris en charge en usine.

    • Pour effectuer la mise en service groupée des appareils en fournissant un fichier CSV contenant une liste des appareils et leurs SMS, choisissez Utiliser le compartiment S3.

  2. Spécifier les appareils à intégrer

    Selon la méthode que vous avez choisie pour intégrer vos appareils, ajoutez les informations des appareils et leurs numéros de série.

    1. Si vous avez choisi Mettre en service un appareil individuel pris en charge en usine, spécifiez les informations suivantes :

      1. Un nom pour chaque appareil à intégrer. Le nom doit être unique dans vos Compte AWS et Région AWS.

      2. Leur numéro de série de fabrication (SMSN) Sidewalk dans le champ Entrez le numéro de série.

      3. Une destination qui décrit la règle IoT permettant d’acheminer les messages d’un appareil à un autre Services AWS.

    2. Si vous avez choisi Utiliser le compartiment S3 :

      1. Fournissez les informations de destination du compartiment S3, qui comprennent les informations URL S3. Pour fournir votre fichier CSV, choisissez Parcourir S3, puis choisissez le fichier CSV que vous souhaitez utiliser.

        AWS IoT Core pour Amazon Sidewalk renseigne automatiquement l’URL S3, qui est le chemin d’accès à votre fichier CSV dans le compartiment S3. Le chemin d'accès à s3://bucket_name/file_name a le format suivant. Pour afficher le fichier dans la console Amazon Simple Storage Service, choisissez Afficher.

      2. Fournissez le rôle de mise en service S3, qui permet à AWS IoT Core pour Amazon Sidewalk d’accéder au fichier CSV dans le compartiment S3 en votre nom. Vous pouvez créer une nouvelle fonction du service ou sélectionner un rôle existant.

        Pour créer un nouveau rôle, vous pouvez soit fournir un nom de rôle, soit le laisser vide pour générer automatiquement un nom aléatoire.

      3. Fournissez une destination qui décrit la règle IoT pour acheminer les messages de l’appareil vers d’autres appareils Services AWS.

  3. Démarre la tâche d’importation

    Fournissez toutes les balises facultatives sous forme de paires nom-valeur et choisissez Soumettre pour démarrer la tâche d’importation de votre appareil sans fil.

Mise à jour groupée des appareils Sidewalk (CLI)

Pour intégrer vos appareils Sidewalk à votre compte pour AWS IoT Core pour Amazon Sidewalk, utilisez l’une des opérations d’API suivantes, selon que vous souhaitez ajouter des appareils individuellement ou en fournissant le fichier CSV contenu dans un compartiment S3.

  • Téléchargez des appareils groupée à l’aide d’un fichier CSV S3

    Pour télécharger des appareils de manière groupée en fournissant le fichier CSV dans un compartiment S3, utilisez l’opération d’API StartWirelessDeviceImportTask ou la commande start-wireless-device-import-taskAWS CLI. Lors de la création de la tâche, spécifiez le chemin d’accès au fichier CSV dans le compartiment Amazon S3 et le rôle IAM qui accorde à AWS IoT Core pour Amazon Sidewalk les autorisations d’accès au fichier CSV.

    Une fois que la tâche démarre, AWS IoT Core pour Amazon Sidewalk commence à lire le fichier CSV et à comparer les numéros de série (SMSN) contenus dans le fichier avec les informations correspondantes du journal de contrôle reçu d’Amazon Sidewalk. Lorsque les numéros de série correspondent, il commence à créer des enregistrements d'appareils sans fil correspondant à ces numéros de série.

    La commande suivante montre un exemple de création d’une tâche d’importation :

    aws iotwireless start-wireless-device-import-task \ 
    --cli-input-json "file://task.json"

    L’exemple suivant affiche le contenu du fichier task.json.

    Contenu de task.json

    {
    "DestinationName": "Sidewalk_Destination",
    "Sidewalk": {
        "DeviceCreationFile": "s3://import_task_bucket/import_file1", 
        "Role": "arn:aws:iam::123456789012:role/service-role/ACF1zBEI"     
    }
}

    L’exécution de cette commande renvoie un ID et un ARN pour la tâche d’importation.

    {    
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
    "Id": "a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
}
  • Mise en service des appareils individuellement à l’aide de leur SMSN

    Pour mettre en service des appareils individuellement à l’aide de leur SMSN, utilisez l’opération d’API StartSingleWirelessDeviceImportTask ou la commande start-single-wireless-device-import-taskAWS CLI. Lors de la création de la tâche, spécifiez la destination Sidewalk et le numéro de série de l’appareil que vous souhaitez intégrer.

    Lorsque le numéro de série correspond aux informations correspondantes dans le journal de contrôle reçu d’Amazon Sidewalk, la tâche s’exécute et crée l’enregistrement de l’appareil sans fil.

    La commande suivante montre un exemple de création d’une tâche d’importation :

    aws iotwireless start-single-wireless-device-import-task \ 
    --destination-name sidewalk_destination \    
    --sidewalk '{"SidewalkManufacturingSn": "82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A"}'

    L’exécution de cette commande renvoie un ID et un ARN pour la tâche d’importation.

    {
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"    
    "Id": "e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"
}

Mise à jour ou suppression des tâches d’importation

Si vous souhaitez ajouter des appareils supplémentaires à une tâche d’importation, vous pouvez mettre à jour la tâche. Vous pouvez également supprimer une tâche si vous n’en avez plus besoin ou si elle a échoué. Pour savoir quand mettre à jour ou supprimer une tâche, veuillez consulte rComment utiliser la mise en service groupée de Sidewalk.

Avertissement

Les actions de suppression sont permanentes et ne peuvent être annulées. La suppression d’une tâche d’importation déjà terminée avec succès ne supprimera pas les terminaux déjà intégrés à l’aide de cette tâche.

Pour mettre à jour ou supprimer des tâches d’importation :

  • Utilisation de la console AWS IoT

    Les étapes suivantes expliquent comment mettre à jour ou supprimer vos tâches d’importation à l’aide de la console AWS IoT.

    Pour mettre à jour une tâche d’importation :

    1. Accédez au centre des appareils Sidewalk de la console AWS IoT.

    2. Sélectionnez la tâche d’importation que vous souhaitez mettre à jour, puis choisissez Modifier.

    3. Fournissez un autre fichier S3 contenant les numéros de série des appareils que vous souhaitez ajouter à la tâche, puis choisissez Soumettre.

    Pour supprimer une tâche d’importation :

    1. Accédez au centre des appareils Sidewalk de la console AWS IoT.

    2. Sélectionnez la tâche que vous voulez supprimer et choisissez Supprimer.

  • Utilisation de l’API AWS IoT Wireless ou de l’AWS CLI

    Utilisez les opérations d’API AWS IoT Wireless ou les commandes d’interface de ligne de commande suivantes pour mettre à jour ou supprimer votre tâche d’importation.