Créer une tâche FUOTA et fournir une image du microprogramme - AWS IoT Wireless
PrérequisCréez une tâche FUOTA et téléchargez l'image du microprogramme à l'aide de la consoleCréez une tâche FUOTA et téléchargez l'image du micrologiciel à l'aide de l'APIÉtapes suivantes

Créer une tâche FUOTA et fournir une image du microprogramme

Pour mettre à jour le micrologiciel de vos appareils LoRaWAN, créez d'abord une tâche FUOTA et fournissez l'image du microprogramme signée numériquement que vous souhaitez utiliser pour la mise à jour. Vous pouvez ensuite ajouter vos appareils et vos groupes multicast à la tâche et planifier une session FUOTA. Lorsque la session démarre, AWS IoT Core for LoRaWAN configure une session de fragmentation et vos appareils finaux collectent les fragments, reconstruisent l'image et appliquent le nouveau microprogramme. Pour plus d'informations sur le processus FUOTA, consultez Présentation du processus FUOTA.

Ce qui suit montre comment créer une tâche FUOTA et télécharger l'image du microprogramme ou l'image delta que vous allez stocker dans un compartiment S3.

Prérequis

Avant de pouvoir effectuer une mise à jour FUOTA, l’image du micrologiciel doit être signée numériquement afin que vos appareils puissent vérifier l’authenticité de l’image lors de son application. Vous pouvez utiliser n'importe quel outil tiers pour générer la signature numérique de l'image de votre microprogramme. Nous vous recommandons d'utiliser un outil de signature numérique tel que celui intégré au référentiel GitHub ARM Mbed, qui inclut également des outils permettant de générer l'image delta et aux appareils d'utiliser cette image.

Créez une tâche FUOTA et téléchargez l'image du microprogramme à l'aide de la console

Pour créer une tâche FUOTA et télécharger l'image de votre microprogramme à l'aide de la console, accédez à l'onglet des tâches FUOTA de la console, puis choisissez Créer une tâche FUOTA.

  1. Création d'une tâche FUOTA

    Pour créer votre tâche FUOTA, spécifiez les propriétés et les balises de la tâche.

    1. Spécifier les propriétés FUOTA

      Pour définir les propriétés de la tâche FUOTA, entrez les informations suivantes pour votre tâche FUOTA.

      • Nom : saisissez un nom unique pour votre tâche FUOTA. 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. Le champ de description peut contenir jusqu’à 2 048 caractères.

      • RFRegion : définissez la bande de fréquence pour votre tâche FUOTA. La bande de fréquence doit correspondre à celle que vous avez utilisée pour approvisionner vos appareils sans fil ou vos groupes multicast.

    2. Balises pour la tâche FUOTA

      Vous pouvez éventuellement fournir des paires clé-valeur sous forme de balises pour votre tâche FUOTA. Choisissez Suivant pour continuer à créer votre tâche.

  2. Télécharger l'image du microprogramme

    Choisissez le fichier image du microprogramme que vous souhaitez utiliser pour mettre à jour le microprogramme des appareils que vous ajoutez à la tâche FUOTA. Le fichier image du microprogramme est stocké dans un compartiment S3. Vous pouvez fournir les autorisations AWS IoT Core for LoRaWAN nécessaires pour accéder à l'image du microprogramme en votre nom. Nous vous recommandons de signer numériquement les images du microprogramme afin que son authenticité soit vérifiée lors de la mise à jour du microprogramme.

    1. Choisissez le fichier image du microprogramme

      Vous pouvez soit télécharger un nouveau fichier image du microprogramme dans un compartiment S3, soit choisir une image existante qui a déjà été téléchargée dans un compartiment S3.

      Note

      La taille du fichier image du micrologiciel ne doit pas dépasser 1 mégaoctet. Plus la taille de votre microprogramme est grande, plus le processus de mise à jour peut prendre du temps.

      • Pour utiliser une image existante, choisissez Sélectionner une image de microprogramme existante, choisissez Parcourir S3, puis choisissez le fichier image de microprogramme que vous souhaitez utiliser.

        AWS IoT Core for LoRaWAN renseigne l'URL S3, qui est le chemin d'accès à votre fichier image du microprogramme dans le compartiment S3. Le format du chemin est s3://bucket_name/file_name. Pour afficher le fichier dans la console Amazon Simple Storage Service, choisissez Afficher.

      • Pour télécharger une nouvelle image de microprogramme.

        1. Choisissez Télécharger une nouvelle image de microprogramme, puis téléchargez l'image de votre microprogramme. Le fichier image ne doit pas dépasser 1 mégaoctet.

        2. Pour créer un compartiment S3 et saisir un nom de compartiment pour stocker le fichier image du microprogramme, choisissez Créer un compartiment S3.

    2. Autorisations pour accéder au compartiment

      Vous pouvez créer une nouvelle fonction du service ou choisir un rôle existant pour autoriser AWS IoT Core for LoRaWAN à accéder au fichier image du microprogramme dans le compartiment S3 en votre nom. Choisissez Suivant.

      Pour créer un nouveau rôle, vous pouvez saisir un nom de rôle ou le laisser vide pour qu'un nom aléatoire soit généré automatiquement. Pour consulter les autorisations de politique qui accordent l'accès au compartiment S3, choisissez Afficher les autorisations de politique.

    Pour plus d'informations sur l'utilisation d'un compartiment S3 pour stocker votre image et sur l'octroi d'autorisations AWS IoT Core for LoRaWAN pour y accéder, consultez Téléchargement du fichier du micrologiciel vers un compartiment S3 et ajout d’un rôle IAM.

  3. Vérifier et créer

    Pour créer votre tâche FUOTA, passez en revue la tâche FUOTA et les détails de configuration que vous avez spécifiés, puis choisissez Créer une tâche.

Créez une tâche FUOTA et téléchargez l'image du micrologiciel à l'aide de l'API

Pour créer une tâche FUOTA et spécifier le fichier image du microprogramme à l'aide de l'API, utilisez l'opération API CreateFuotaTask ou la commande CLI create-fuota-task. Vous pouvez fournir un fichier input.json comme entrée pour la commande create-fuota-task. Lorsque vous utilisez l'API ou la CLI, le fichier image du microprogramme que vous fournissez en entrée doit déjà être chargé dans un compartiment S3. Vous spécifiez également le rôle IAM qui donne à AWS IoT Core for LoRaWAN l’accès à l'image du microprogramme dans le compartiment S3.

aws iotwireless create-fuota-task \
    --cli-input-json file://input.json

où :

Contenu de input.json

{   
   "Description": "FUOTA task to update firmware of devices in multicast group.",
   "FirmwareUpdateImage": "S3:/firmware_bucket/firmware_image
   "FirmwareUpdateRole": "arn:aws:iam::123456789012:role/service-role/ACF1zBEI"
   "LoRaWAN": { 
      "RfRegion": "US915"
   },
   "Name": "FUOTA_Task_MC"  
}

Après avoir créé votre tâche FUOTA, vous pouvez utiliser les opérations API ou commandes CLI suivantes pour mettre à jour, supprimer ou obtenir des informations sur votre tâche FUOTA.

Étapes suivantes

Maintenant que vous avez créé une tâche FUOTA et que vous avez fourni l'image du microprogramme, vous pouvez ajouter des appareils à la tâche de mise à jour de leur microprogramme. Vous pouvez ajouter des appareils individuels ou des groupes multicast à la tâche. Pour en savoir plus, consultez Ajoutez des appareils et des groupes multicast à une tâche FUOTA et planifiez une session FUOTA.