Los dispositivos que describen sus propios ajustes pueden configurarse desde Hermetry. Ves cada ajuste con su valor actual, lo cambias, y el dispositivo lo aplica y responde. Para muchos dispositivos a la vez, guardas un baseline (un conjunto de ajustes con nombre) y ejecutas un trabajo masivo que cambia los dispositivos por oleadas y se detiene cuando algo sale mal.
Qué dispositivos lo admiten
Un dispositivo admite ajustes remotos cuando se cumplen las dos condiciones siguientes:
- su firmware anuncia sus secciones de ajustes al conectarse,
- Hermetry tiene la descripción de ajustes (el manifest) de su modelo y de su versión de firmware.
Los dispositivos con licencia lo admiten. Para otros dispositivos MQTT, usa las claves de configuración (atributos compartidos cfg.*). Los sensores LoRaWAN de terceros cambian sus ajustes mediante los downlinks de su fabricante; consulta Envío de downlinks.
La pestaña Settings del dispositivo indica cuándo un dispositivo no puede recibir ajustes:
| Mensaje | Significado |
|---|---|
| Este dispositivo no acepta ajustes desde la nube | Su firmware no lo admite, o no es un router con licencia. Actualiza el firmware. |
| Los ajustes de este modelo aún no se conocen | Su modelo y firmware aún no se han descrito a la plataforma. Vuelve a intentarlo después de la próxima actualización de firmware. |
| Solo lectura: actualiza el firmware para cambiar los ajustes | El firmware ha superado su periodo de soporte (las escrituras se detienen 24 meses después de la publicación de un firmware). Aún puedes ver los ajustes. |
Permisos
| Permiso | Permite | Rol por defecto |
|---|---|---|
| Leer ajustes del dispositivo | Ver ajustes | Admin |
| Operate | Cambiar ajustes operativos | Admin |
| Write | Cambiar ajustes ordinarios | Admin |
| Write dangerous | Cambiar ajustes marcados como peligrosos (que pueden dejar el dispositivo desconectado) | Owner |
| Gestionar baselines | Crear, modificar y eliminar baselines | Admin |
| Gestionar trabajos | Crear y ejecutar trabajos masivos | Admin |
Cada ajuste tiene una clase en el manifest; lo que puedes cambiar depende de esa clase y de tus permisos. Si un cambio afecta a una clase que no puedes modificar, la página muestra «No puedes cambiar algunos de estos ajustes. Pide ayuda a un owner de la cuenta.»
Cambiar un dispositivo
- Abre el dispositivo y su pestaña Settings. Muestra el Model y el firmware, y las Settings sections con su Status, la fecha de la última vez que se Applied y quién hizo el Last change (From here o On the device).
- Abre una sección.
- Cambia los valores y guarda. Un cambio peligroso te pide confirmación.
El dispositivo aplica el cambio y responde:
- Mientras viaja: «Este cambio está en camino al dispositivo. Se aplica cuando el dispositivo esté en línea.»
- Mientras el dispositivo lo intenta: «El dispositivo está probando este cambio. Lo deshace por sí mismo si no puede volver a alcanzar la nube.»
Reglas:
- Los secretos (contraseñas, claves) nunca se muestran. Deja un campo secreto sin cambios para mantener el valor actual.
- Si otra persona guardó la sección después de que la abrieras, tu guardado se rechaza. Recarga y vuelve a intentarlo.
- Un cambio que sigue pendiente durante 7 días caduca y se retira.
- El historial de la sección guarda los últimos 50 cambios por dispositivo y sección, durante un máximo de 365 días.
- Tu organización puede realizar hasta 600 escrituras de ajustes por minuto.
Nota
Cuando un dispositivo recibe nuevo firmware, Hermetry convierte los ajustes guardados a la descripción del nuevo firmware. Los ajustes que no puede convertir con seguridad se marcan para revisión: «Revisa los valores después de la actualización de firmware y guárdalos.»
Cambiar muchos dispositivos: baselines
Abre Bulk settings en el menú de IoT y selecciona Baselines («Conjuntos de ajustes con nombre para tus modelos de dispositivo, para aplicarlos en masa»).
- Selecciona New baseline e indica un Name y una Description.
- Elige los Models cuyos dispositivos pueden recibirlo.
- Para cada ajuste, marca Include in this baseline e indica el valor. «Solo se cambia en los dispositivos lo que incluyas; todo lo demás permanece como está.»
- Guarda.
Un baseline nunca contiene un secreto: «Las contraseñas y claves no forman parte de un baseline: configúralas en cada dispositivo.» Eliminar un baseline no afecta a los trabajos ya iniciados; estos conservan su propia copia.
Cambiar muchos dispositivos: trabajos masivos
En Bulk settings («Cambia los ajustes de muchos dispositivos a la vez, en oleadas que se detienen si algo sale mal.») selecciona New job:
| Campo | Opciones |
|---|---|
| Job name | Texto libre. |
| Baseline | El baseline a aplicar (o un único cambio). |
| Which devices | Devices I pick, Every device of a profile, Every device of these models. |
| Waves | 1 %, then 10 %, then the rest (recommended), o My own sizes in percent (por ejemplo 5, 25: 5 %, después 25 %, y el resto). |
| Each wave needs at least this share applied (%) | Por defecto 95. |
| Stop when more than this share is undone (%) | Por defecto 1. |
| Wait for offline devices (days) | Un dispositivo sin conexión durante más tiempo que este valor no recibe el cambio. |
| When another job is changing the same device | Wait for it o Skip that device. |
Selecciona Check para ver What this job does: los dispositivos por modelo y firmware, los tamaños de las oleadas, los dispositivos excluidos porque el baseline no es para su modelo, las secciones que un modelo no tiene, y una advertencia cuando el trabajo cambia ajustes que pueden dejar dispositivos desconectados. Después, Start the job y escribe START para confirmar.
Mientras un trabajo se ejecuta
Después de cada oleada, el trabajo comprueba su control sobre los dispositivos que respondieron. Un control fallido («Paused: wave n did not pass its check (…% applied, …% undone).») o una oleada en la que ningún dispositivo responde pausa el trabajo.
| Acción | Efecto |
|---|---|
| Pause | No se cambia ningún otro dispositivo hasta que lo reanudes. |
| Resume | Continúa. Tras un control fallido pregunta Go on past a failed wave?; Go on anyway queda registrado. |
| Cancel job | «Los dispositivos que aún no han cambiado se omiten. Los dispositivos ya cambiados conservan sus nuevos ajustes.» |
Cada dispositivo muestra su estado: Waiting, Sent, Applied, Refused, Undone, Offline, Skipped (con el motivo) o Changed by a person. Como máximo se ejecutan cinco trabajos a la vez.
- Solo un escritor cambia la sección de un dispositivo a la vez. Un cambio de una persona en la página del dispositivo prevalece sobre un trabajo.
- Un trabajo escribe con los permisos que tenía su creador.