Comandos
Todas las acciones del dispositivo pasan por el registro COMMAND (0x0060, u8) — en Modbus, holding 0x8113 (solo escritura allí). Una escritura encola el opcode; la ejecución ocurre en el bucle principal del dispositivo (milisegundos para la mayoría de comandos; los que tocan flash tardan más).
Semántica de finalización y de resultado
-
Ocupado:
CMD_STATE(0x006A) bit 0 = BUSY mientras se ejecuta un comando. BUSY es la señal de finalización — consúltelo hasta 0 antes de leer el resultado. Un comando nuevo escrito mientras BUSY está activo se descarta (bit 1 OVERRUN activado; el comando en ejecución no se altera; OVERRUN se borra cuando se acepta el siguiente comando). En Modbus, una escritura de COMMAND mientras está ocupado → excepción 06. -
Resultado:
ERROR(0x0002; relectura Modbus en retenido 0x8114) contiene el resultado tras la finalización (0x00 = OK).ERRORlee 0xF0 (Modbus 0xFFFF) durante toda la ejecución y se escribe junto con la finalización; juzgue la finalización por BUSY y lea el resultado de ERROR después. -
Frescura:
CMD_SEQ(0x0067) aumenta una vez por cada comando terminado; sondéelo para distinguir un resultado nuevo de uno antiguo. -
Patrón: compruebe BUSY = 0 → escriba los parámetros y después COMMAND → sondee BUSY hasta 0 (tiempos límite: ≥1 s para comandos simples y guardados, ≥0.5 s para la escritura de una página de actualización, ≥3 s para COMMIT de actualización; en I²C tolere un estiramiento de reloj de ≥10 ms y reintente las lecturas con NACK: nunca reenvíe a ciegas una escritura de COMMAND) → lea
ERROR. Recorrido completo: Secuencias D2. -
Comandos que reinician el módulo (0x02 RESET, 0x13 ACTIVATE, 0x16 ADDR_BY_UID en el módulo correspondiente): por Modbus, la respuesta puede estar truncada o ausente (y un retardo de transmisión configurado puede suprimirla); confírmelo volviendo a sondear el dispositivo tras el reinicio.
Códigos de error (ERROR 0x0002)
| Código | Nombre | Significado |
|---|---|---|
| 0x00 | OK | aceptado / completado |
| 0xF0 | PENDING | el comando sigue ejecutándose (con BUSY = 1) |
| 0xF6 | NVM_IO | falló una escritura persistente (SAVE_CAL / SAVE_CONFIG / importación de historial) |
| 0xF7 | NO_KEY | atestación rechazada: no hay clave de dispositivo aprovisionada |
| 0xF8 | — | operación rechazada por la política de servicio |
| 0xF9 | NVM_RATE_LIMIT | reescritura persistente limitada en frecuencia (mínimo ~5 s entre guardados) — reintente más tarde |
| 0xFA | OP_RETRY | operación ya en curso · rechazada en el estado actual (p. ej., almacén de energía en FAULT, valor de adopción negativo) |
| 0xFB | KEY_GATE | comando protegido por clave sin una clave de un solo uso válida (LT_KEY) |
| 0xFC | VALUE_CRC | discrepancia de CRC de la página de actualización (reenviar la página) · época de hora inferior a 1600000000 · discrepancia de UID (ADDR_BY_UID) · no existe ese registro de historial (HIST_READ) |
| 0xFD | PARAM | parámetro o valor de configuración no válido: no se guarda nada |
| 0xFE | UNKNOWN_CMD | opcode no soportado |
Conjunto de comandos
Comandos de la familia
| Op. | Nombre | Efecto |
|---|---|---|
| 0x01 | SAVE_CAL | guardar registros de calibración (servicio/fábrica; protegido por UNLOCK en Modbus; limitado en frecuencia → 0xF9) |
| 0x02 | RESET | reinicio en caliente (protegido por UNLOCK en Modbus; espere respuesta Modbus ausente o truncada) |
| 0x03 | LATCH_PERIOD | en el siguiente límite de ventana, tome una instantánea del banco seleccionado por LATCH_BANK (0..7; ≥ 8 → 0xFD) y reinicie su acumulación — bit de capacidad 8; si no, 0xFE |
| 0x04 | SAVE_CONFIG | guardar la configuración (lectura-modificación-escritura; la calibración no se toca; no protegido por UNLOCK). Valores validados contra la tabla de valores legales; no válido → 0xFD, no se guarda nada; limitado en frecuencia → 0xF9; un guardado sin cambios es una operación OK sin efecto (aun así activa CONFIG_CHANGED) |
| 0x06 | SET_TIME | aplicar la época escrita en TIME_SET/RTC_EPOCH; época < 1600000000 → 0xFC; STATUS bit 4 se activa de inmediato |
| 0x07 | ENERGY_RESET | código de operación de familia, condicionado a UNLOCK. No se usa (0xFE / excepción 03): el reinicio del contador es el LT_RESET con clave que aparece más abajo |
| 0x0E | IDENTIFY | hacer parpadear los LED durante 10 s: localizar el módulo en un armario. Sin condicionar |
| 0x0F | ATTEST | firme el desafío de 32 B en 0x0B80 (mapa de registros); ~55 ms; 0xF7 = sin clave |
| 0x10 | OTA_BEGIN | abrir una sesión de actualización (Actualización de firmware) |
| 0x11 | OTA_BLOCK_WR | programa una página de 256 B (limitada a una página / ~250 ms: BUSY hasta su turno) |
| 0x12 | OTA_COMMIT | verificar y armar la imagen preparada (sin reinicio); consultar BUSY ≥ 3 s |
| 0x13 | OTA_ACTIVATE | reinicio a la imagen armada (solo cuando OTA_STATUS = 2; reaparece en ~4 s) |
| 0x14 | FW_ABORT | cerrar la sesión de actualización / desarmar una imagen armada |
| 0x15 | — | reservado (fábrica/servicio) |
| 0x16 | ADDR_BY_UID | el módulo cuyo UID coincide con ADDR_UID adopta la(s) dirección(es) preparada(s), las guarda junto con cualquier otro cambio CFG_ pendiente y se reinicia; los demás módulos responden 0xFC. Si ambos campos de nueva dirección están a cero → 0xFD; dirección no válida → 0xFD; límite de frecuencia de guardado → 0xF9. Funciona en difusión Modbus. Sin control de acceso |
Comandos con clave (contadores de vida e historial)
Estos comandos cambian el estado que afecta a la medición, así que cada uno requiere la clave de un solo uso correspondiente, escrita en LT_KEY (0x0844 / retenido 0x8142–43 de Modbus, palabra alta primero) inmediatamente antes del comando. La clave la consume cualquier comando siguiente; una clave incorrecta o ausente → ERROR 0xFB. Es una protección deliberada sobre el transporte (no es el UNLOCK de Modbus).
| Op. | Nombre | Clave (u32) | Efecto |
|---|---|---|---|
| 0x08 | HIST_READ | — (sin clave) | carga en HIST_REC el registro seleccionado por HIST_PERIOD/HIST_BACK; si no existe el registro → 0xFC |
| 0x09 | HIST_FLUSH | — (sin clave) | volcar la energía ahora: siempre la copia de retención; el registro NVM solo si han pasado ≥ 10 s desde su última escritura (también implícito en RESET y en la activación de la actualización) |
| 0x0A | LT_RESET | 0x4C545253 "LTRS" |
pone a cero la energía de vida; contador de generación ++ (registrado). Fallo del almacén → 0xFA |
| 0x0B | LT_ADOPT | 0x4C544150 "LTAP" |
adoptar los valores de contador en preparación (sustitución de placa / migración); generación ++ (registrado). Orden de preparación: importación Wh · exportación Wh · importación reactiva varh · exportación reactiva varh (4×i64); un valor negativo → 0xFA |
| 0x0C | HIST_WRITE | 0x48494D50 "HIMP" |
importar el registro de 80 B de HIST_REC al anillo horario (HIST_PERIOD debe ser 1, si no 0xFC); marca de tiempo no más reciente → 0xFD; error de E/S de NVM → 0xF6 |
| 0x0D | HIST_CLEAR | 0x48434C52 "HCLR" |
borrado paso a paso del anillo horario; repetir mientras se ejecuta → 0xFA (registrado) |
Los reinicios de contadores de vida, las adopciones y las escrituras de historial quedan registrados en el registro de eventos con los valores antes y después: no pueden ocurrir en silencio.
Resumen de control de acceso
| Mecanismo | Alcance | Cómo |
|---|---|---|
| UNLOCK de Modbus | 0x01 · 0x02 · 0x07 · 0x10 · 0x12 · 0x13 · 0x14 · 0x15 | clave 0xA5C3 → retenido 0x8112; ventana de 10 s, un comando; puede compartir un FC16 con el código de operación (Modbus) |
| LT_KEY | 0x0A–0x0D, ambos transportes | marca por comando, de un solo uso |
| Lista blanca de difusión | Unidad Modbus 0 | solo ajuste de hora, instantánea y dirección por UID (Modbus) |
Sin protección en ninguno de los dos transportes: 0x04, 0x06, 0x08, 0x09, 0x0E, 0x0F, 0x11, 0x16. I²C no tiene paso UNLOCK: el acceso físico al bus I²C de la placa es el límite de confianza de la instalación; los comandos con clave están protegidos en ambos transportes en cualquier caso.