Cette page vous aide lorsqu’une mise à jour du firmware n’atteint pas un appareil, ne se termine pas, ou lorsqu’un déploiement par vagues s’arrête. Commencez par la page du paquet (Firmware > le paquet) : sa liste Devices affiche le State, le Progress, les Tries et le Problem de chaque appareil. L’onglet Firmware de l’appareil indique ce qu’il Runs, sa mise à jour Update et son History.
L’appareil ne se voit pas proposer l’image
Avant d’assigner, sélectionnez Check : What happens liste les appareils qui n’accepteront pas le paquet, avec la raison.
| Raison | Correction |
|---|---|
| Les mises à jour sont désactivées pour son profil | Dans l’onglet Firmware du profil, activez Allow firmware updates for this profile (désactivé pour un nouveau profil) |
| Autre modèle de matériel | Le paquet liste des Hardware models ; l’appareil en signale un autre |
| Destiné à un autre profil | Le paquet est limité à un profil (Only for devices of this profile) |
| Non signé non autorisé | Le paquet est Not signed et le profil n’autorise pas Allow unsigned images (à utiliser uniquement pour les appareils de test) |
| Version actuelle trop ancienne | L’appareil est plus ancien que Lowest version it can update from |
| Version actuelle encore inconnue | L’appareil n’a pas transmis current_fw_version. Il doit l’envoyer à chaque connexion. |
| Une affectation plus spécifique l’emporte | Une affectation à un appareil l’emporte sur une liste d’appareils, et une liste sur un profil |
| Il attend sa vague | Dans un déploiement, un appareil d’une vague ultérieure ne reçoit rien tant que sa vague n’a pas démarré : Waits for wave n |
Le paquet n’est pas prêt
| State | Signification |
|---|---|
| Being checked | Le fichier est analysé à la recherche de virus ; il passe à Ready lorsque l’analyse est propre |
| Rejected | La somme de contrôle, la signature ou l’analyse a échoué ; le fichier a été supprimé. Téléversez-le à nouveau. |
| Après Retire | Il n’est plus proposé pour de nouvelles affectations ; les mises à jour en cours se poursuivent |
| Après Revoke | Il ne doit pas être installé : les mises à jour qui n’ont pas commencé à s’installer ont été arrêtées |
Une signature est vérifiée par rapport à vos Signing keys enregistrées. Révoquer une clé révoque tous les paquets signés avec elle.
Lire l’état de la mise à jour
| State | Signification | Action à mener |
|---|---|---|
| Queued | Affectée ; envoyée lorsque l’appareil est en ligne | Mettre l’appareil en ligne |
| Sent to the device | Notifié ; il doit commencer le téléchargement | S’il reste dans cet état, l’appareil ne gère pas les attributs partagés fw_* sur v1/attributes/set |
| Downloading, Downloaded, Checked, Installing | Progression signalée par l’appareil | Attendre |
| Waiting | L’appareil retient la mise à jour : sur une liaison limitée, hors forfait mobile, ou en attente d’approbation sur l’appareil lui-même | Ce n’est pas une erreur. Voir ci-dessous. |
| Failed | L’appareil a signalé FAILED avec un code fw_error | Consultez Problem ; Try again après correction de la cause |
| No answer in time | L’appareil a cessé de répondre pendant Download may take (minutes) (60 par défaut) ou Installing may take (minutes) (20 par défaut) | Vérifiez la liaison et l’appareil ; augmentez les délais du profil pour les liaisons lentes ou les images volumineuses |
| Went back to the old version | La nouvelle version ne s’est pas lancée correctement, et l’appareil est revenu à l’ancienne | Testez l’image sur un appareil accessible ; vérifiez les journaux de démarrage |
| Not for this device | Le paquet ne lui convient pas | Voir le premier tableau |
| Cancelled | Arrêtée avant l’installation |
Tries per update (3 par défaut, de 1 à 10 dans l’onglet Firmware du profil) définit le nombre de tentatives accordées à une mise à jour. Pour les appareils en échec, en dépassement de délai ou revenus à l’ancienne version, la page du paquet propose Try again.
Attente sur une liaison limitée
Un appareil sur une liaison mobile (LTE) signale fw_wait: metered et attend, car Allow updates over LTE (mobile data) est désactivé par défaut. Pour le laisser se mettre à jour :
- activez le paramètre pour le profil, ou
- réglez Updates over LTE sur Allowed for this device dans l’onglet Firmware de l’appareil.
fw_wait: quota_exhausted signifie que le forfait de données mobiles de l’appareil est épuisé ; approval signifie qu’une personne doit approuver sur l’appareil. Les appareils en attente ne comptent pas comme des échecs à la clôture d’une vague.
Problèmes de téléchargement et d’installation
| Symptôme | Cause |
|---|---|
| Le téléchargement échoue après 15 minutes | fw_url est valide pendant 15 minutes. L’appareil doit redemander fw_url et reprendre avec une requête HTTP Range. |
| La somme de contrôle correspond mais l’appareil refuse l’image | La signature ne se vérifie pas. L’appareil a raison de la refuser : re-signez l’image avec une clé enregistrée. |
| L’appareil signale Updated mais l’état ne change pas | UPDATED sans le nouveau current_fw_version n’est pas accepté seul. Transmettez la version en cours d’exécution après le redémarrage. |
| Le firmware n’est jamais proposé | Le firmware n’est jamais proposé en MQTT simple : l’appareil doit utiliser TLS |
Voir Firmware updates (OTA) pour ce que l’appareil reçoit et signale.
Un déploiement s’est mis en pause automatiquement
Un déploiement par vagues se met en pause automatiquement lorsqu’une vague :
| Raison affichée | Signification | Action à mener |
|---|---|---|
| trop d’appareils en échec | Plus d’échecs que le seuil At most failed (%) de la vague | Consultez le Problem des appareils en échec, corrigez la cause, puis Resume ou Abort |
| trop peu d’appareils mis à jour | La vague s’est close avec moins d’appareils mis à jour que requis | Souvent des appareils hors ligne. Vérifiez-les, puis reprenez. |
| aucun appareil terminé à temps | La vague s’est close sans qu’aucun appareil ne soit terminé | Les appareils sont peut-être hors ligne ou ne peuvent pas télécharger |
« Les appareils qui ont déjà commencé terminent leur mise à jour ; aucun autre appareil ne la reçoit tant que quelqu’un ne reprend pas le déploiement. » Les administrateurs reçoivent un avis dans l’application. Resume accepte ce qui s’est passé jusqu’ici : seuls les nouveaux échecs comptent pour le seuil. Abort supprime l’affectation et ne peut pas être annulé.
Le plan habituel : un canari de 1 % (1 à 10 appareils), puis 10 %, 50 % et le reste ; chaque vague exige que 90 % de ses appareils terminés soient mis à jour, se met en pause au-delà de 5 % d’échecs, et se clôt au plus tard après 240 minutes. Voir Rolling out firmware in waves.
Qui peut faire quoi
| Action | Rôle par défaut |
|---|---|
| Consulter les paquets et les états de mise à jour | User |
| Téléverser, retirer, révoquer, supprimer des paquets ; affecter ; modifier les paramètres OTA ; réessayer | Admin |
| Enregistrer et révoquer les clés de signature | Owner |