Mises à jour firmware (OTA)

Hermetry livre les micrologiciels à distance (OTA). Vous téléversez un paquet, vous l’assignez, et chaque appareil le télécharge, le vérifie et l’installe de lui-même, en signalant sa progression au fil de l’opération. Hermetry ne signe jamais les micrologiciels : la signature se fait dans votre chaîne de publication, et Hermetry ne conserve que vos clés publiques.

Ouvrez Firmware dans le menu IoT (« Téléversez des images de micrologiciel, assignez-les aux appareils et suivez chaque mise à jour. »).

Permissions

Action	Rôle par défaut
Consulter les paquets, les assignations et les états de mise à jour des appareils	Utilisateur
Téléverser, retirer, révoquer et supprimer des paquets	Administrateur
Assigner des micrologiciels, modifier les paramètres OTA, relancer les mises à jour	Administrateur
Enregistrer et révoquer les clés publiques de signature	Propriétaire

1. Activer les mises à jour pour le profil

Les mises à jour sont désactivées pour un nouveau profil. Activez-les lorsque ses appareils signalent leur progression de mise à jour. Ouvrez l’onglet Firmware du profil (Mises à jour du micrologiciel) :

Paramètre	Par défaut	Plage
Autoriser les mises à jour du micrologiciel pour ce profil	Désactivé	—
Autoriser les images non signées	Désactivé	« Uniquement pour les appareils de test. »
Autoriser les mises à jour via LTE (données mobiles)	Désactivé	Un appareil peut avoir son propre paramètre.
Durée de téléchargement possible (minutes)	60	5 à 1 440
Durée d’installation possible (minutes)	20	2 à 240
Tentatives par mise à jour	3	1 à 10

L’onglet affiche aussi ce qui est Assigné à ce profil ainsi qu’un bouton Assigner un micrologiciel.

2. Enregistrer une clé de signature

1. Dans Firmware, ouvrez Clés de signature (« Les clés publiques avec lesquelles vos micrologiciels sont signés. Les images téléversées sont vérifiées par rapport à elles. Les clés privées ne sont jamais envoyées ici. »).
2. Sélectionnez Ajouter une clé, donnez-lui un Nom, choisissez son Type et collez la Clé publique.

Deux types de signature sont pris en charge : un fichier de signature Ed25519 détaché (.sig) produit pour l’image, où vous collez le fichier de clé publique complet ; et une signature intégrée à l’image, produite par le schéma de démarrage sécurisé de l’appareil, où vous collez l’empreinte de clé de 64 caractères. Seuls les propriétaires peuvent ajouter ou révoquer des clés.

3. Téléverser un paquet

Sélectionnez Téléverser un micrologiciel et renseignez :

Champ	Règles
Type	Firmware ou Software.
Nom	Lettres, chiffres et . _ + - uniquement. Il doit correspondre à ce que l’appareil attend (son titre de micrologiciel).
Version	1 à 64 lettres, chiffres ou . _ + ~ -, par exemple 24.10.0-r1234. Une paire nom et version n’est utilisable qu’une fois ; le formulaire affiche la version la plus récente à ce jour.
Image du micrologiciel	Le fichier .bin ou .img que vous installez sur l’appareil.
Signé avec	Le type de clé, ou Non signé (seuls les profils qui autorisent les images non signées peuvent le recevoir).
Fichier de signature (.sig)	Pour les signatures détachées. Pour les images à démarrage sécurisé, la signature est dans l’image.
Modèles matériels	Facultatif, séparés par des virgules : seuls les appareils qui en signalent un de ces modèles reçoivent l’image.
Version minimale à partir de laquelle elle peut mettre à jour	Facultatif : les appareils sur une version plus ancienne sont exclus.
Uniquement pour les appareils de ce profil	Laissez Tous les profils lorsque l’image convient à tous les profils.
Notes de version	Facultatif.

Votre navigateur calcule le SHA-256 du fichier pendant le téléversement (« Comparez-le à celui que votre build vous a donné. »). Le serveur recalcule le SHA-256, vérifie la signature avec vos clés enregistrées et analyse le fichier à la recherche de virus. Le paquet est En cours de vérification jusqu’à ce que l’analyse soit saine, puis Prêt ; un fichier qui échoue est Rejeté et supprimé.

4. Assigner le paquet

Sur la page du paquet, sélectionnez Assigner, ou utilisez l’onglet Firmware d’un profil ou d’un appareil. Sous Envoyer à, choisissez :

Choix	Couvre
Chaque appareil d’un profil	« Les appareils ajoutés ultérieurement au profil le reçoivent aussi. »
Certains appareils	« Une liste fixe : les appareils ajoutés plus tard ne sont pas inclus. »
Un appareil	Cet appareil.

L’assignation la plus spécifique l’emporte : une assignation à un appareil prime sur une liste d’appareils, et une liste prime sur un profil. Sélectionnez Vérifier pour voir Ce qui se passe : le nombre d’appareils couverts, le nombre qui exécutent déjà cette version, le nombre hors ligne (ils se mettent à jour à leur reconnexion) et ceux qui ne le recevront pas, avec la raison (autre modèle matériel, mises à jour désactivées pour leur profil, prévu pour un autre profil, image non signée non autorisée, version actuelle trop ancienne ou encore inconnue). Sélectionnez ensuite Assigner et confirmez.

Pour un profil ou une liste d’appareils, vous pouvez activer Envoyer par vagues. Voir Déploiement du micrologiciel par vagues.

Ce que reçoit l’appareil

Hermetry écrit ces attributs partagés dans un seul message :

Clé	Exemple
fw_title	boiler-fw
fw_version	26.11.0
fw_size	14680064
fw_checksum	hexadécimal en minuscules
fw_checksum_algorithm	SHA256
fw_url	une adresse de téléchargement HTTPS à courte durée de validité
fw_sig	la signature détachée, lorsqu’elle existe
fw_allow_metered	indique si l’appareil peut télécharger via une liaison facturée au volume

• fw_url est valable 15 minutes et régénéré à chaque envoi et à chaque demande d’attribut. S’il a expiré, l’appareil redemande fw_url et reprend avec une requête HTTP Range.
• Le micrologiciel n’est jamais proposé en MQTT non chiffré.
• Supprimer une assignation supprime les clés.

Ce que signale l’appareil

Attribut client	Valeurs
fw_state	DOWNLOADING, DOWNLOADED, VERIFIED, UPDATING, UPDATED, FAILED
fw_error	un code d’erreur, uniquement avec FAILED
fw_progress	0 à 100, pendant DOWNLOADING
fw_wait	metered, quota_exhausted ou approval tant que l’appareil retient la mise à jour
current_fw_title, current_fw_version	ce qui fonctionne actuellement ; à envoyer après chaque connexion

L’appareil doit refuser une image dont la signature ne se vérifie pas, même si la somme de contrôle correspond. Après le redémarrage, il signale current_fw_version ; UPDATED sans la nouvelle version en cours d’exécution n’est pas accepté seul. Si l’ancienne version revient, Hermetry marque la mise à jour comme revenue en arrière.

États de mise à jour

État	Signification
En file d’attente	Assignée ; envoyée lorsque l’appareil est en ligne.
Envoyée à l’appareil	L’appareil a été informé et doit commencer le téléchargement.
Téléchargement, Téléchargé, Vérifié, Installation	Progression signalée par l’appareil.
Mis à jour	L’appareil exécute la nouvelle version.
En attente	L’appareil retient la mise à jour : sur une liaison facturée au volume, sans données mobiles, ou en attente d’approbation sur l’appareil lui-même. Ce n’est pas une erreur.
Échec	L’appareil n’a pas pu terminer.
Pas de réponse à temps	L’appareil a cessé de répondre pendant la durée de téléchargement ou d’installation.
Retour à l’ancienne version	La nouvelle version ne s’est pas lancée correctement.
Non destiné à cet appareil	Le paquet ne lui convient pas.
Annulée	Arrêtée avant l’installation.

Suivre les mises à jour

• La page du paquet affiche Où il est assigné, ses Appareils avec État, Progression, Tentatives et Problème, ainsi que Réessayer pour les appareils en échec, en délai dépassé ou revenus à l’ancienne version.
• L’onglet Firmware de l’appareil affiche ce qu’il Exécute, sa Mise à jour, son Historique, et Mises à jour via LTE pour cet appareil (Identique à son profil, Autorisé pour cet appareil, Non autorisé pour cet appareil).
• Événements webhook : ota.update.initiated, ota.update.succeeded, ota.update.failed, et pour les déploiements ota.rollout.*.

Retirer, révoquer, supprimer

Action	Effet
Retirer	« Elle reste dans l’historique et les mises à jour en cours continuent, mais elle n’est plus proposée pour de nouvelles affectations. »
Révoquer	« Utilisez cette option lorsque l’image ne doit pas être installée. Les mises à jour qui n’ont pas encore commencé l’installation sont arrêtées. Les appareils qui l’ont déjà installée la conservent. »
Supprimer	Supprime le fichier et ses informations. Refusé tant qu’il est affecté ou qu’il a un historique de mises à jour : retirez-le plutôt.

Voir aussi

• Déployer le firmware par vagues
• API firmware et paramètres des appareils
• Les mises à jour firmware ne se terminent pas