Erstellen Sie eine FUOTA-Aufgabe und stellen Sie ein Firmware-Image bereit

Um die Firmware Ihrer LoRaWAN-Geräte zu aktualisieren, erstellen Sie zunächst eine FUOTA-Aufgabe und stellen Sie das digital signierte Firmware-Image bereit, das Sie für das Update verwenden möchten. Anschließend können Sie Ihre Geräte und Multicast-Gruppen zur Aufgabe hinzufügen und eine FUOTA-Sitzung planen. Wenn die Sitzung beginnt, wird AWS IoT Core for LoRaWAN eine Fragmentierungssitzung einrichten und Ihre Endgeräte sammeln die Fragmente, rekonstruieren das Image und wenden die neue Firmware an. Weitere Informationen über den FUOTA-Prozess finden Sie unter Übersicht über den FUOTA-Prozess.

Im Folgenden wird gezeigt, wie Sie eine FUOTA-Aufgabe erstellen und das Firmware-Image oder Delta-Image hochladen können, das Sie in einem S3-Bucket speichern werden.

Voraussetzungen

Bevor Sie FUOTA durchführen können, muss das Firmware-Image digital signiert werden, damit Ihre Endgeräte beim Anwenden des Images die Echtheit des Images überprüfen können. Sie können jedes Tool eines Drittanbieters verwenden, um die digitale Signatur für Ihr Firmware-Image zu generieren. Wir empfehlen, dass Sie ein Tool für digitale Signaturen verwenden, wie das, das im ARM Mbed GitHub-Repository eingebettet ist. Dieses Tool umfasst auch Tools zum Generieren des Delta-Images und für Geräte, die dieses Bild verwenden können.

Erstellen Sie eine FUOTA-Aufgabe und laden Sie das Firmware-Image mithilfe der Konsole hoch

Um eine FUOTA-Aufgabe zu erstellen und Ihr Firmware-Image mithilfe der Konsole hochzuladen, wechseln Sie zur Registerkarte FUOTA-Aufgaben der Konsole und wählen Sie dann FUOTA-Aufgabe erstellen.

1. Erstellen einer FUOTA-Aufgabe

   Um Ihre FUOTA-Aufgabe zu erstellen, geben Sie die Eigenschaften und Tags der Aufgabe an.

   1. Geben Sie die FUOTA-Aufgabeneigenschaften an

      Um die Eigenschaften der FUOTA-Aufgabe anzugeben, geben Sie die folgenden Informationen für Ihre FUOTA-Aufgabe ein.

      • Name: Geben Sie einen eindeutigen Namen für Ihre FUOTA-Aufgabe ein. Der Name darf nur Buchstaben, Zahlen, Bindestriche und Unterstriche enthalten. Leerzeichen dürfen nicht enthalten sein.

      • Beschreibung: Sie können eine optionale Beschreibung für Ihre Multicast-Gruppe angeben. Die Beschreibung kann bis zu 2 048 Zeichen lang sein.

      • RFRegion: Stellen Sie das Frequenzband für Ihre FUOTA-Aufgabe ein. Das Frequenzband muss mit dem übereinstimmen, das Sie für die Bereitstellung Ihrer WLAN-Geräte oder Multicast-Gruppen verwendet haben.

   2. Tags für FUOTA-Aufgabe

      Sie können optional beliebige Schlüssel-Wert-Paare als Tags für Ihre FUOTA-Aufgabe angeben. Wählen Sie Weiter aus, um mit dem Erstellen Ihrer Aufgabe fortzufahren.

2. Laden Sie das Firmware-Image hoch

   Wählen Sie die Firmware-Image-Datei aus, mit der Sie die Firmware der Geräte aktualisieren möchten, die Sie der FUOTA-Aufgabe hinzufügen. Die Firmware-Image-Datei wird in einem S3-Bucket gespeichert. Sie können in Ihrem Namen die Berechtigungen für den Zugriff auf das Firmware-Image AWS IoT Core for LoRaWAN bereitstellen. Wir empfehlen, die Firmware-Images digital zu signieren, damit ihre Echtheit überprüft wird, wenn das Firmware-Update durchgeführt wird.

   1. Wählen Sie eine Firmware-Image-Datei

      Sie können entweder eine neue Firmware-Image-Datei in einen S3-Bucket hochladen oder ein vorhandenes Image auswählen, das bereits in einen S3-Bucket hochgeladen wurde.

      Anmerkung

      Die Firmware-Image-Datei darf nicht größer als 1 Megabyte sein. Je größer Ihre Firmware ist, desto länger kann es dauern, bis Ihr Aktualisierungsvorgang abgeschlossen ist.

      • Um ein vorhandenes Image zu verwenden, wählen Sie Ein vorhandenes Firmware-Image auswählen, dann S3 durchsuchen und wählen Sie dann die Firmware-Image-Datei aus, die Sie verwenden möchten.

        AWS IoT Core for LoRaWAN füllt die S3-URL aus, die der Pfad zu Ihrer Firmware-Image-Datei im S3-Bucket ist. Das Format des Pfades ist s3://bucket_name/file_name. Um die Datei in der Amazon Simple Storage Service-Konsole anzuzeigen, wählen Sie Ansicht.

      • So laden Sie ein neues Firmware-Image hoch.

        1. Wählen Sie Neues Firmware-Image hochladen aus und laden Sie Ihr Firmware-Image hoch. Die Image-Datei darf nicht größer als 1 Megabyte sein.

        2. Um einen S3-Bucket zu erstellen und einen Bucket-Namen zum Speichern Ihrer Firmware-Image-Datei einzugeben, wählen Sie S3-Bucket erstellen.

   2. Berechtigung für den Zugriff auf den Bucket.

      Sie können entweder eine neue Servicerolle erstellen oder eine vorhandene Rolle auswählen, damit AWS IoT Core for LoRaWAN in Ihrem Namen auf die Firmware-Image-Datei im S3-Bucket zugreifen kann. Wählen Sie Weiter.

      Um eine neue Rolle zu erstellen, können Sie einen Rollennamen eingeben oder das Feld leer lassen, damit automatisch ein zufälliger Name generiert wird. Um die Richtlinienberechtigungen anzuzeigen, die Zugriff auf den S3-Bucket gewähren, wählen Sie Richtlinienberechtigungen anzeigen.

   Weitere Informationen zur Verwendung eines S3-Buckets zum Speichern Ihres Images und zur Gewährung von AWS IoT Core for LoRaWAN Berechtigungen finden Sie unter Hochladen der Firmware-Datei in einen S3-Bucket und Hinzufügen einer IAM-Rolle.

3. Überprüfen und erstellen

   Um Ihre FUOTA-Aufgabe zu erstellen, überprüfen Sie die von Ihnen angegebenen FUOTA-Aufgaben- und Konfigurationsdetails und wählen Sie dann Aufgabe erstellen.

Erstellen Sie eine FUOTA-Aufgabe und laden Sie das Firmware-Image mithilfe der API hoch

Verwenden Sie die API-Operation oder den create-fuota-task-CLI-Befehl, um eine FUOTA-Aufgabe zu erstellen und Ihre Firmware-Image-Datei mithilfe der CreateFuotaTask-API anzugeben. Sie können eine input.json-Datei als Eingabe für den create-fuota-task-Befehl angeben. Wenn Sie die API oder CLI verwenden, muss die Firmware-Image-Datei, die Sie als Eingabe angeben, bereits in einen S3-Bucket hochgeladen worden sein. Sie geben auch die IAM-Rolle an, die AWS IoT Core for LoRaWAN Zugriff auf das Firmware-Image im S3-Bucket ermöglicht.

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

Wobei:

Inhalt von 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"  
}

Nachdem Sie Ihre FUOTA-Aufgabe erstellt haben, können Sie die folgenden API-Operationen oder CLI-Befehle verwenden, um Ihre FUOTA-Aufgabe zu aktualisieren, zu löschen oder Informationen darüber abzurufen.

• UpdateFuotaTask oder update-fuota-task

• GetFuotaTask oder get-fuota-task

• ListFuotaTasks oder list-fuota-tasks

• DeleteFuotaTask oder delete-fuota-task

Nächste Schritte

Nachdem Sie nun eine FUOTA-Aufgabe erstellt und das Firmware-Image bereitgestellt haben, können Sie der Aufgabe Geräte hinzufügen, um deren Firmware zu aktualisieren. Sie können der Aufgabe entweder einzelne Geräte oder Multicast-Gruppen hinzufügen. Weitere Informationen finden Sie unter Fügen Sie Geräte und Multicast-Gruppen zu einer FUOTA-Aufgabe hinzu und planen Sie eine FUOTA-Sitzung.