Ajoutez le profil de votre appareil et le terminal Sidewalk - AWS IoT Wireless
Ajoutez votre appareil Sidewalk (console)Ajoutez votre appareil Sidewalk (CLI)

Ajoutez le profil de votre appareil et le terminal Sidewalk

Cette section explique comment créer un profil d’appareil. Il montre également comment utiliser la console AWS IoT et l’AWS CLI pour ajouter votre terminal Sidewalk à AWS IoT Core pour Amazon Sidewalk.

Ajoutez votre appareil Sidewalk (console)

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

  1. Spécification des détails de l’appareil

    Spécifiez les informations de configuration de votre appareil Sidewalk. Vous pouvez également créer un nouveau profil d’appareil ou choisir un profil existant pour votre appareil Sidewalk.

    1. Spécifiez un nom de l’appareil et une description facultative. La description peut comporter jusqu’à 2 048 caractères. Ces champs peuvent être modifiés après avoir créé l’appareil.

    2. Choisissez un profil d’appareil à associer à votre appareil Sidewalk. Si vous avez des profils d’appareils existants, vous pouvez choisir votre profil. Pour créer un nouveau profil, sélectionnez Créer un nouveau profil, puis saisissez un nom pour le profil.

      Note

      Pour associer des tags au profil de votre appareil, après avoir créé votre profil, accédez au centre de Profils, puis modifiez votre profil pour ajouter ces informations.

    3. Spécifiez le nom de la destination qui acheminera les messages de votre appareil vers un autre Services AWS. Si vous n’avez pas encore créé de destination, rendez-vous dans le centre Destinations pour créer votre destination. Vous pouvez ensuite choisir cette destination pour votre appareil Sidewalk. Pour en savoir plus, consultez Ajoutez une destination pour votre terminal Sidewalk.

    4. Choisissez Suivant pour continuer à ajouter votre appareil Sidewalk.

  2. Associer un appareil Sidewalk à un objet AWS IoT (facultatif)

    Vous pouvez éventuellement associer votre appareil Sidewalk à n’importe quel objet AWS IoT. Les objets IoT sont des entrées dans le registre d'appareils AWS IoT. Les objets peuvent faciliter la recherche et la gestion de vos appareils. Associer un objet à votre appareil permet à celui-ci d’accéder à d’autres fonctionnalités AWS IoT Core.

    Pour associer votre appareil à un objet, choisissez Enregistrement automatique des objets.

    1. Entrez un nom unique pour l’objet IoT que vous souhaitez associer à votre appareil Sidewalk. Les noms d’objets distinguent les majuscules et minuscules et doivent être uniques dans votre Compte AWS et Région AWS.

    2. Fournissez des configurations supplémentaires pour votre objet IoT, par exemple en utilisant un type d’objet, ou des attributs consultables pouvant être utilisés pour filtrer des objets dans une liste d’objets.

    3. Choisissez Suivant et vérifiez les informations relatives à votre appareil Sidewalk, puis choisissez Créer.

Ajoutez votre appareil Sidewalk (CLI)

Pour ajouter votre appareil Sidewalk et télécharger les fichiers JSON qui seront utilisés pour mettre en service votre appareil Sidewalk, effectuez les opérations d’API suivantes.

Étape 1 : Créer un profil d’appareil

Pour créer un profil d’appareil dans votre Compte AWS, utilisez l’opération de l’API CreateDeviceProfile ou la commande CLI create-device-profile. Lorsque vous créez un profil, spécifiez un nom et des balises facultatives sous forme de paires nom-valeur.

Par exemple, la commande suivante crée un profil d’appareil pour vos appareils Sidewalk :

aws iotwireless create-device-profile \ 
    --name sidewalk_profile --sidewalk {}

L’exécution de cette commande renvoie l’Amazon Resource Name (ARN) et l’ID du profil de l’appareil en sortie.

{
    "DeviceProfileArn": "arn:aws:iotwireless:us-east-1:123456789012:DeviceProfile/12345678-a1b2-3c45-67d8-e90fa1b2c34d",
    "DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"
}

Étape 2 : Ajouter votre appareil Sidewalk

Pour ajouter votre appareil Sidewalk à votre compte pour AWS IoT Core pour Amazon Sidewalk, utilisez l’opération d’API CreateWirelessDevice ou la commande d’interface de ligne de commande create-wireless-device. Lorsque vous créez votre appareil, spécifiez les paramètres suivants, en plus du nom et de la description facultatifs de votre appareil Sidewalk.

Note

Si vous souhaitez associer votre appareil Sidewalk à un objet AWS IoT, utilisez l’opération d’API AssociateWirelessDeviceWithThing ou la commande d’interface de ligne de commande associate-wireless-device-with-thing.

La commande suivante montre un exemple de création d’un appareil Sidewalk :

aws iotwireless create-wireless-device \ 
     --cli-input-json "file://device.json"

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

Contenu de device.json

{
  "Type": "Sidewalk",
  "Name": "SidewalkDevice",  
  "DestinationName": "SidewalkDestination",
  "Sidewalk": {
    "DeviceProfileId": "12345678-a1b2-3c45-67d8-e90fa1b2c34d"    
    }
}

L’exécution de cette commande renvoie l’ID de l’appareil et l’Amazon Resource Name (ARN) en sortie.

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/23456789-abcd-0123-bcde-fabc012345678",
    "Id": "23456789-abcd-0123-bcde-fabc012345678"
}