Secuencias — flujos de control paso a paso
Flujos canónicos del lado del host. Cada paso indica el registro (dirección I²C; Modbus entre corchetes) y qué comprobar. Las reglas de sondeo de comandos usadas en todo el documento se definen una sola vez en D2.
D1 — Encendido / descubrimiento
-
Lea 12 bytes en 0x0000 en una sola transacción:
ID= 'S','T' ·VERSION≥ 0x36 ·CAPABILITIES(espere el bit 9 activo; THD bit 2 = 0, bit 8 de bancos de instantáneas = 1 cuando hay bancos, bit 13 de energía en el dispositivo = 1) ·STATUS·N_VOLTAGE/N_CURRENT·VARIANT(UI1 0x11 = 1/1, 0x63 = 3/3) ·HW_REV/FW_VERSION. -
Lea
UID0x00F4 (12 B): la identidad del dispositivo para su base de datos;FW_VER0x0114 (u32, versión de la imagen);BOARD_ID0x017C. -
Espere a los datos en vivo:
WIN_SEQ(0x0016) ≠ 0 y avanzando,STATUSbit 1 (sensor_ok) = 1 — espere unos 1 s tras el arranque (disponibilidad al arranque). -
Si
STATUSbit 4 (time_valid) = 0 → ajuste el reloj (D2, SET_TIME). - Control de salud: cal_ok o
CAL_SRC(0x0872) ∈ {1, 2};LTA_STATUS(0x0870) ≤ 1. - Vuelva a armar el estado en RAM:
EVENT_MASK(0x00C1),THRESH_I/P(0x00C4/0x00C8); confirme el arranque limpiando RESET_OCCURRED: escriba 0x20 enEVENT_FLAGS(0x00C0).
Por Modbus: el mismo conjunto de identidad está en la entrada 0x6000–0x601F (espejo); FW_VER en retenido 0x8315–16, BOARD_ID en retenido 0x831B–1C.
D2 — Ejecución de un comando
- Comprobación de inactividad:
CMD_STATE(0x006A; retenido 0x8116) bit 0 = 0. -
Escriba los registros de parámetros del comando y después el código de operación en
COMMAND(0x0060; retenido 0x8113: para un código de operación condicionado de Modbus, envíe un FC16{0x8112 = 0xA5C3, 0x8113 = código}; excepción 06 = ocupado, excepción 03 = código desconocido o falta de desbloqueo). -
Consulte
CMD_STATEbit 0 → 0. Tiempos de espera: ≥ 1 s para comandos simples y guardados · ≥ 0.5 s para escritura de página de actualización · ≥ 3 s para COMMIT de actualización. En I²C tolere ≥ 10 ms de estiramiento de reloj; reintente las lecturas con NACK; nunca reenvíe a ciegas una escritura de COMMAND (un duplicado se descartaría como OVERRUN, pero se pierde el rastro de cuál escritura surtió efecto). -
Lea
ERROR(0x0002; holding 0x8114) después de BUSY = 0: 0x00 = OK, los códigos están en Comandos. Opcionalmente, compruebe queCMD_SEQ(0x0067) avanzó en 1 y que OVERRUN (bit 1) = 0.
Fijar la hora (el comando más habitual): escriba la época u32 LE en TIME_SET 0x08C0 (Modbus FC16 0x8100 = palabra alta, 0x8101 = palabra baja — en difusión es una trama propia y el comando va como segunda trama) → COMMAND 0x06 → consultar → ERROR 0xFC = época inferior a 1600000000. STATUS bit 4 se activa de inmediato.
D3 — Configuración
- Escriba los registros
CFG_*deseados (0x0070–0x0085; retenidos 0x8000–0x800C). -
COMMAND0x04 SAVE_CONFIG (no condicionado a UNLOCK) → D2.ERROR0xFD = valor no válido, no se guardó nada · 0xF9 = límite de frecuencia, reintente tras ~5 s · 0xF6 = error de E/S del almacén. -
Si el cambio requiere reinicio (dirección I²C, unidad/baudios/trama/retardo de transmisión Modbus,
CFG_VIRTUAL_IDS):COMMAND0x02 RESET (protegido por UNLOCK en Modbus; espere respuesta Modbus ausente o truncada) y vuelva a consultar el dispositivo tras ~1 s.
CFG_LED / CFG_WORD_ORDER surten efecto al escribirse, pero se revierten al arrancar si no se guardan. CFG_CLASS, CFG_CT_MODEL, CFG_TZ_OFFSET_MIN, CFG_TIME_AUTH, CFG_ENERGY_PERSIST_S son metadatos almacenados.
D4 — Cambio de dirección / serie
Dirección I²C (dispositivo conocido): CFG_I2C_ADDR 0x0073 = 0x08..0x77 → SAVE_CONFIG → BUSY 0 y ERROR 0 → RESET → espere ~1 s → sondee ID = 'S','T' en la nueva dirección.
Serie Modbus: retenido 0x8000 unidad (1–247) / 0x8001 velocidad (0–10) / 0x8002 trama / 0x8003 retardo de transmisión (validado al escribir: excepción 03) → FC06 0x8113 = 0x0004 → sondee 0x8114 = 0 → FC16 {0x8112 = 0xA5C3, 0x8113 = 0x0002} (la respuesta puede perderse) → reconecte con los nuevos ajustes.
Por UID (varios módulos en una misma dirección, con ambos transportes):
-
I²C: una escritura de 0x00E0: UID (12 B) + nueva dirección I²C (0x00EC, o 0) + nueva unidad Modbus (0x00ED, o 0). Modbus: FC16 0x8118–0x811E (pares de bytes del UID + 0x811E = dirección<<8 | unidad): difusión permitida.
-
COMMAND0x16 (FC06 0x8113 = 0x0016; se permite en difusión). -
El módulo que coincide se persiste (junto con los valores CFG_ preparados) y se reinicia; todos los demás módulos responden
ERROR0xFC. Si alguno de los dos campos de nueva dirección es 0 o una dirección no válida → 0xFD; límite de frecuencia de guardado → 0xF9. -
Sondee el módulo en su nueva dirección o unidad; identifíquelo por UID.
D5 — Energía: lectura, reinicio, adopción
Lectura (en cada límite de intervalo, con su reloj):
-
Una transacción I²C ≤ 128 B sobre 0x0800–0x0843: contadores en Wh, contadores en mWh,
LT_GEN(instantánea coherente). AdemásUPTIME0x08A0. Modbus: entrada 0x6B00/0x6B14 + retenido 0x8140. Bit 15 de capacidades: los mismos contadores con resolución en µWh; total en 0x08D0 (3×i64; entrada Modbus 0x6BB0), por canal en 0x0C80 + g·0x10 (Modbus 0x6BC0 + g·8): la misma instantánea que los campos en mWh (imp/exp mWh = floor(µWh/1000); neta = imp − exp en la misma unidad), con las mismas reglas de diferencia, generación y reinicio. El módulo también publica el total de reactiva en µvarh en 0x08E8/0x08F0 (Modbus 0x6BAC/0x6BBC, no contiguos): la lectura coherente de alta resolución es una transacción sobre 0x08D0–0x08F7 (40 B). -
Energía de intervalo = diferencia de los contadores de mWh (contadores de µWh si se desea mayor resolución).
- Cambió
LT_GEN→ no tome la diferencia; vuelva a fijar la referencia (alguien reinició o adoptó los valores; consulte el registro de eventos). UPTIMEdisminuyó → el módulo se reinició: diferencia =max(0, Δ)(puede faltar hasta aproximadamente el último segundo de energía); vuelva a enviar la hora (D2).
Reinicio (deliberado, registrado): LT_KEY 0x0844 = 0x4C545253 ("LTRS"; Modbus FC16 0x8142–43, primero la palabra alta) → de inmediato COMMAND 0x0A (cualquier comando consume la clave) → D2. ERROR 0xFB = clave incorrecta o ausente · 0xFA = fallo del almacén. No se necesita UNLOCK en Modbus — la clave es el control de acceso. (El opcode de familia 0x07 ENERGY_RESET no se usa: 0xFE / excepción 03.)
Adopción (cambio de placa / migración): prepare 4×i64 en LT_ADOPT 0x0848 (Modbus 0x8144–0x8153) en el orden importación Wh · exportación Wh · importación reactiva varh · exportación reactiva varh → LT_KEY = 0x4C544150 ("LTAP") → COMMAND 0x0B. Valor negativo → 0xFA. Tanto el reinicio como la adopción incrementan LT_GEN y quedan en el registro de eventos con valores antes/después.
D6 — Historial y registro de eventos
-
HIST_PERIOD0x0C00 (retenido 0x8160): 0 = último de 15 min (entoncesHIST_BACKdebe ser 0) · 1 = anillo horario · 2 = registro de eventos. -
HIST_BACK0x0C04 (retenido 0x8163) = n, 0 = el más reciente. COMMAND0x08 HIST_READ → D2.ERROR0xFC = no existe el registro.-
Si tiene éxito:
HIST_FLAGS0x0C02 bit 0 = 1; leaHIST_COUNT/HIST_RECSZ(80 historial / 32 eventos) /HIST_OLDEST/HIST_NEWESTpara asignar marcas de tiempo a índices. -
Lea el registro en 0x0C20 (
HIST_RECSZbytes, en una sola transacción; pares de bytes de retenido 0x8180+ por Modbus). Estructuras: Medición y energía. -
Recorra
HIST_BACK= 0 … COUNT−1 para leer los registros; las reglas de diferencia se aplican según los FLAGS de cada registro.
D7 — Actualización de firmware
FW_ACTIVE_BANK0x0156 (holding 0x8301) → elija el archivo de publicación para el otro banco.-
Control:
BOARD_ID0x017C == la palabra de placa del archivo; versión del archivo ≥FW_VER0x0114; leaOTA_BANK_SIZE0x014C (nunca lo fije en el código). -
(Modbus: UNLOCK)
COMMAND0x10 BEGIN → D2 →OTA_STATUS0x0140 (retenido 0x8300) = 1. -
Por cada página de 256 B no vacía, en orden ascendente, primero la página 0:
OTA_IDX0x0144 = k · carga útil → 0x0500 (Modbus: dos FC16 de 64 registros en 0x8380/0x83C0) · opcionalOTA_PCRC_EXP0x0170 = CRC-32 de la página ·COMMAND0x11 (no condicionado) · sondee BUSY (≤ ~0.5 s) ·ERROR0xFC → reescriba la carga útil y repita la página · compruebe queOTA_STATUSsigue en 1 (si es 3, leaOTA_DIAG0x0180 y reinicie desde BEGIN). -
(UNLOCK)
COMMAND0x12 COMMIT → consultar BUSY ≥ 3 s →OTA_STATUS: 2 = armado (FW_STAGED_VERSION0x0150 = versión nueva) · 3 = rechazado (motivos 7–15 enOTA_DIAG) · 4 = versión inferior. -
Solo cuando status = 2: (UNLOCK)
COMMAND0x13 ACTIVATE — respuesta Modbus ausente o truncada; el módulo vuelve en ~4 s. O bien (UNLOCK)COMMAND0x14 FW_ABORT para descartar la imagen armada. -
No reinicie el módulo durante ~10 s (prueba y autoconfirmación) y después verifique:
FW_ACTIVE_BANKcambiado ·FW_VER= nueva versión ·SWAP_PENDING0x011C = 0. SiFW_VERes la antigua, se revirtió: leaOTA_DIAG.
D8 — Desbloqueo Modbus
FC06 holding 0x8112 = 0xA5C3 → válido 10 s, consumido por un comando protegido; un valor incorrecto borra un desbloqueo activo; si falta o caducó → excepción 03 en el comando protegido. La clave y el opcode pueden ir en un mismo FC16 en 0x8112–0x8113.
Protegidos: 0x01 · 0x02 · 0x07 · 0x10 · 0x12 · 0x13 · 0x14 · 0x15. Sin protección: 0x04 · 0x06 · 0x08–0x0F · 0x11 · 0x16.