rbAmp
ES
Tienda
Docs
Actualizado

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). ERROR lee 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.