Les appareils qui décrivent leurs propres réglages peuvent être configurés depuis Hermetry. Vous voyez chaque réglage avec sa valeur actuelle, vous le modifiez, et l’appareil l’applique puis renvoie son état. Pour de nombreux appareils à la fois, vous enregistrez une baseline (un ensemble de réglages nommé) et lancez un job de masse qui modifie les appareils par vagues et s’arrête dès qu’un problème survient.
Appareils compatibles
Un appareil prend en charge les réglages à distance lorsque les deux conditions suivantes sont remplies :
- son firmware annonce ses sections de réglages à la connexion,
- Hermetry dispose de la description des réglages (le manifeste) pour son modèle et la version de son firmware.
Les appareils sous licence sont compatibles. Pour les autres appareils MQTT, utilisez les clés de configuration (attributs partagés cfg.*). Les capteurs LoRaWAN tiers modifient leurs réglages via les downlinks de leur fabricant ; voir Envoi de downlinks.
L’onglet Réglages de l’appareil indique quand un appareil ne peut pas recevoir de réglages :
| Message | Signification |
|---|---|
| Cet appareil ne reçoit pas de réglages depuis le cloud | Son firmware ne le prend pas en charge, ou ce n’est pas un routeur sous licence. Mettez à jour le firmware. |
| Les réglages de ce modèle ne sont pas encore connus | Son modèle et son firmware n’ont pas encore été décrits à la plateforme. Réessayez après la prochaine mise à jour du firmware. |
| Lecture seule : mettez à jour le firmware pour modifier les réglages | Le firmware a dépassé sa période de support (les écritures cessent 24 mois après la sortie d’un firmware). Vous pouvez toujours voir les réglages. |
Autorisations
| Autorisation | Permet | Rôle par défaut |
|---|---|---|
| Lire les réglages de l’appareil | Voir les réglages | Admin |
| Exploitation | Modifier les réglages d’exploitation | Admin |
| Écriture | Modifier les réglages ordinaires | Admin |
| Écriture dangereuse | Modifier les réglages marqués dangereux (qui peuvent couper l’appareil) | Propriétaire |
| Gérer les baselines | Créer, modifier et supprimer des baselines | Admin |
| Gérer les jobs | Créer et lancer des jobs de masse | Admin |
Chaque réglage a une classe dans le manifeste ; ce que vous pouvez modifier dépend de cette classe et de vos autorisations. Si une modification touche une classe que vous ne pouvez pas changer, la page affiche : « Vous ne pouvez pas modifier certains de ces réglages. Demandez à un propriétaire du compte. »
Modifier un appareil
- Ouvrez l’appareil et son onglet Réglages. Il affiche le Modèle et le firmware, ainsi que les Sections de réglages avec leur Statut, la date de dernière Application et l’auteur de la Dernière modification (Depuis ici ou Sur l’appareil).
- Ouvrez une section.
- Modifiez les valeurs et enregistrez. Une modification dangereuse vous demande de confirmer.
L’appareil applique la modification et renvoie son état :
- Pendant son transit : « Cette modification est en route vers l’appareil. Elle est appliquée lorsque l’appareil est en ligne. »
- Pendant que l’appareil la tente : « L’appareil essaie cette modification. Il l’annule automatiquement s’il ne peut plus joindre le cloud. »
Règles :
- Les secrets (mots de passe, clés) ne sont jamais affichés. Laissez un champ secret inchangé pour conserver la valeur actuelle.
- Si quelqu’un d’autre a enregistré la section depuis que vous l’avez ouverte, votre enregistrement est refusé. Rechargez la page et réessayez.
- Une modification restée en attente pendant 7 jours expire et est retirée.
- L’historique de la section conserve les 50 dernières modifications par appareil et par section, pendant 365 jours au maximum.
- Votre organisation peut effectuer jusqu’à 600 écritures de réglages par minute.
Remarque
Lorsqu’un appareil reçoit un nouveau firmware, Hermetry convertit vos réglages enregistrés vers la description du nouveau firmware. Les réglages qu’il ne peut pas convertir en toute sécurité sont marqués à vérifier : « Vérifiez les valeurs après la mise à jour du firmware et enregistrez-les. »
Modifier de nombreux appareils : baselines
Ouvrez Réglages en masse dans le menu IoT et sélectionnez Baselines (« Ensembles de réglages nommés pour vos modèles d’appareils, à appliquer en masse. »).
- Sélectionnez Nouvelle baseline et donnez-lui un Nom et une Description.
- Choisissez les Modèles dont les appareils peuvent la recevoir.
- Pour chaque réglage, cochez Inclure dans cette baseline et définissez la valeur. « Seuls les réglages inclus sont modifiés sur les appareils ; le reste demeure inchangé. »
- Enregistrez.
Une baseline ne contient jamais de secret : « Les mots de passe et clés ne font pas partie d’une baseline : définissez-les sur chaque appareil. » Supprimer une baseline n’affecte pas les jobs déjà lancés ; ils conservent leur propre copie.
Modifier de nombreux appareils : jobs de masse
Sur Réglages en masse (« Modifiez les réglages de nombreux appareils à la fois, par vagues qui s’arrêtent dès qu’un problème survient. ») sélectionnez Nouveau job :
| Champ | Choix |
|---|---|
| Nom du job | Texte libre. |
| Baseline | La baseline à appliquer (ou une seule modification). |
| Quels appareils | Appareils que je choisis, Tous les appareils d’un profil, Tous les appareils de ces modèles. |
| Vagues | 1 %, puis 10 %, puis le reste (recommandé), ou Mes propres tailles en pourcentage (par exemple 5, 25 : 5 %, puis 25 %, puis le reste). |
| Chaque vague doit atteindre au moins cette part appliquée (%) | Par défaut 95. |
| Arrêter si plus de cette part est annulée (%) | Par défaut 1. |
| Attendre les appareils hors ligne (jours) | Un appareil hors ligne depuis plus longtemps que cette durée ne reçoit pas la modification. |
| Quand un autre job modifie le même appareil | Attendre ou Ignorer cet appareil. |
Sélectionnez Vérifier pour voir Ce que fait ce job : les appareils par modèle et firmware, la taille des vagues, les appareils exclus parce que la baseline ne concerne pas leur modèle, les sections qu’un modèle ne possède pas, et un avertissement lorsque le job modifie des réglages susceptibles de couper des appareils. Puis cliquez sur Démarrer le job et tapez START pour confirmer.
Pendant l’exécution d’un job
Après chaque vague, le job vérifie sa condition sur les appareils ayant répondu. Une condition non remplie (« En pause : la vague n n’a pas passé sa vérification (…% appliqués, …% annulés). ») ou une vague où aucun appareil n’a répondu met le job en pause.
| Action | Effet |
|---|---|
| Mettre en pause | Aucun autre appareil n’est modifié jusqu’à la reprise. |
| Reprendre | Le job continue. Après une condition non remplie, il demande Continuer après une vague en échec ? ; Continuer quand même est enregistré. |
| Annuler le job | « Les appareils non encore modifiés sont ignorés. Les appareils déjà modifiés conservent leurs nouveaux réglages. » |
Chaque appareil affiche son état : En attente, Envoyé, Appliqué, Refusé, Annulé, Hors ligne, Ignoré (avec la raison) ou Modifié par une personne. Cinq jobs au maximum tournent en même temps.
- Un seul rédacteur modifie la section d’un appareil à la fois. La modification d’une personne sur la page de l’appareil l’emporte sur un job.
- Un job écrit avec les autorisations de son créateur.