Présentation de l’intégration de vos appareils Sidewalk

Création d’un profil d’appareil

Créez un profil d’appareil contenant les configurations partagées pour vos appareils Sidewalk. Lors de la création du profil, spécifiez un name pour le profil sous forme de chaîne alphanumérique. Pour créer un profil, accédez à l’onglet Sidewalk du centre Profiles de la console AWS IoT et choisissez Créer un profil, ou utilisez l’opération d’APICreateDeviceProfile ou la commande CLI create-device-profile comme indiqué dans cet exemple.

// Add your device profile using a name and the sidewalk object.
aws iotwireless create-device-profile --name sidewalk_profile --sidewalk {}

Créez votre terminal Sidewalk

Créez votre terminal Sidewalk avec AWS IoT Core pour Amazon Sidewalk. Spécifiez un nom de destination et l’ID du profil d’appareil obtenu à l’étape précédente. Pour ajouter un appareil, accédez à l’onglet Sidewalk du centre des appareils de la console AWS IoT et choisissez Mise en service d’un appareil, ou utilisez l’opération d’API CreateWirelessDevice ou la commande CLI create-wireless-device comme indiqué dans cet exemple.

// Add your Sidewalk device by using the device profile ID. 
aws iotwireless create-wireless-device --type "Sidewalk" --name sidewalk_device \ 
    --destination-name SidewalkDestination \
    --sidewalk DeviceProfileId="12345678-234a-45bc-67de-e8901234f0a1"

Obtenir le profil de l’appareil et les informations sur les appareils sans fil

Obtenez le profil de l’appareil et les informations de l’appareil sans fil au format JSON. Le JSON contiendra des informations sur les détails de l’appareil, les certificats de l’appareil, les clés privées, DeviceTypeId et le numéro de série de fabrication (SMSN) de Sidewalk.

Créez un rôle IAM

Créez un rôle IAM qui autorise AWS IoT Core pour Amazon Sidewalk à envoyer des données à la règle AWS IoT. Pour créer le rôle, utilisez l’opération d’API CreateRole ou la commande CLI create-role. Vous pouvez nommer le rôle comme SidewalkRole.

aws iam create-role --role-name lambda-ex \ 
    --assume-role-policy-document file://lambda-trust-policy.json

Création d’une règle pour la destination

Créez une règle AWS IoT qui traitera les données de l’appareil et spécifiez le sujet dans lequel les messages sont publiés. Vous observerez les messages relatifs à ce sujet après vous être connecté à la plate-forme matérielle. Utilisez l’opération d’API AWS IoT Core, CreateTopicRule, ou la commande AWS CLI, create-topic-rule, pour créer une règle pour la destination.

aws iot create-topic-rule --rule-name Sidewalkrule \ 
    --topic-rule-payload file://myrule.json

Créer une destination

Créez une destination qui associe votre appareil Sidewalk à la règle IoT qui le traite pour une utilisation avec d’autres AWS services. Vous pouvez ajouter une destination à l’aide du centre de destinations de la console AWS IoT, de l’opération d’API CreateDestination ou de la commande CLI create-destination.

aws iotwireless create-destination --name SidewalkDestination \
    --expression-type RuleName --expression SidewalkRule \
    --role-arn arn:aws:iam::123456789012:role/SidewalkRole

Connectez votre terminal Sidewalk

Connectez le HDK à votre ordinateur et suivez les instructions fournies par la documentation du fournisseur pour vous connecter à votre HDK. Pour plus d’informations, consultez la section Mise en service et enregistrement de votre terminal dans la documentation Amazon Sidewalk.

Afficher et échanger des messages

Utilisez le client MQTT pour vous abonner à la rubrique spécifiée dans la règle et afficher le message reçu. Vous pouvez également utiliser l’opération d’API SendDataToWirelessDevice ou la commande CLI send-data-to-wireless-device pour envoyer un message en liaison descendante à votre appareil et vérifier l’état de la connectivité.

(Facultatif) Vous pouvez activer l’événement d’état d’envoie du message pour vérifier si le message de liaison descendante a bien été reçu.

aws iotwireless send-data-to-wireless-device \
    --id "<Wireless_Device_ID>" \
    --payload-data "SGVsbG8gVG8gRGV2c2lt" \
    --wireless-metadata Sidewalk={Seq=1,AckModeRetryDurationSecs=10}