rbAmp
ES
Tienda
Docs
Actualizado

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

  1. 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.

  2. Lea UID 0x00F4 (12 B): la identidad del dispositivo para su base de datos; FW_VER 0x0114 (u32, versión de la imagen); BOARD_ID 0x017C.

  3. Espere a los datos en vivo: WIN_SEQ (0x0016) ≠ 0 y avanzando, STATUS bit 1 (sensor_ok) = 1 — espere unos 1 s tras el arranque (disponibilidad al arranque).

  4. Si STATUS bit 4 (time_valid) = 0 → ajuste el reloj (D2, SET_TIME).

  5. Control de salud: cal_ok o CAL_SRC (0x0872) ∈ {1, 2}; LTA_STATUS (0x0870) ≤ 1.
  6. Vuelva a armar el estado en RAM: EVENT_MASK (0x00C1), THRESH_I/P (0x00C4/0x00C8); confirme el arranque limpiando RESET_OCCURRED: escriba 0x20 en EVENT_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

  1. Comprobación de inactividad: CMD_STATE (0x006A; retenido 0x8116) bit 0 = 0.
  2. 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).

  3. Consulte CMD_STATE bit 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).

  4. Lea ERROR (0x0002; holding 0x8114) después de BUSY = 0: 0x00 = OK, los códigos están en Comandos. Opcionalmente, compruebe que CMD_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

  1. Escriba los registros CFG_* deseados (0x0070–0x0085; retenidos 0x8000–0x800C).
  2. COMMAND 0x04 SAVE_CONFIG (no condicionado a UNLOCK) → D2. ERROR 0xFD = 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.

  3. Si el cambio requiere reinicio (dirección I²C, unidad/baudios/trama/retardo de transmisión Modbus, CFG_VIRTUAL_IDS): COMMAND 0x02 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):

  1. 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.

  2. COMMAND 0x16 (FC06 0x8113 = 0x0016; se permite en difusión).

  3. El módulo que coincide se persiste (junto con los valores CFG_ preparados) y se reinicia; todos los demás módulos responden ERROR 0xFC. 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.

  4. 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):

  1. Una transacción I²C ≤ 128 B sobre 0x0800–0x0843: contadores en Wh, contadores en mWh, LT_GEN (instantánea coherente). Además UPTIME 0x08A0. 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).

  2. Energía de intervalo = diferencia de los contadores de mWh (contadores de µWh si se desea mayor resolución).

  3. Cambió LT_GEN → no tome la diferencia; vuelva a fijar la referencia (alguien reinició o adoptó los valores; consulte el registro de eventos).
  4. UPTIME disminuyó → 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

  1. HIST_PERIOD 0x0C00 (retenido 0x8160): 0 = último de 15 min (entonces HIST_BACK debe ser 0) · 1 = anillo horario · 2 = registro de eventos.

  2. HIST_BACK 0x0C04 (retenido 0x8163) = n, 0 = el más reciente.

  3. COMMAND 0x08 HIST_READ → D2. ERROR 0xFC = no existe el registro.
  4. Si tiene éxito: HIST_FLAGS 0x0C02 bit 0 = 1; lea HIST_COUNT / HIST_RECSZ (80 historial / 32 eventos) / HIST_OLDEST / HIST_NEWEST para asignar marcas de tiempo a índices.

  5. Lea el registro en 0x0C20 (HIST_RECSZ bytes, en una sola transacción; pares de bytes de retenido 0x8180+ por Modbus). Estructuras: Medición y energía.

  6. 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

  1. FW_ACTIVE_BANK 0x0156 (holding 0x8301) → elija el archivo de publicación para el otro banco.
  2. Control: BOARD_ID 0x017C == la palabra de placa del archivo; versión del archivo ≥ FW_VER 0x0114; lea OTA_BANK_SIZE 0x014C (nunca lo fije en el código).

  3. (Modbus: UNLOCK) COMMAND 0x10 BEGIN → D2 → OTA_STATUS 0x0140 (retenido 0x8300) = 1.

  4. Por cada página de 256 B no vacía, en orden ascendente, primero la página 0: OTA_IDX 0x0144 = k · carga útil → 0x0500 (Modbus: dos FC16 de 64 registros en 0x8380/0x83C0) · opcional OTA_PCRC_EXP 0x0170 = CRC-32 de la página · COMMAND 0x11 (no condicionado) · sondee BUSY (≤ ~0.5 s) · ERROR 0xFC → reescriba la carga útil y repita la página · compruebe que OTA_STATUS sigue en 1 (si es 3, lea OTA_DIAG 0x0180 y reinicie desde BEGIN).

  5. (UNLOCK) COMMAND 0x12 COMMIT → consultar BUSY ≥ 3 s → OTA_STATUS: 2 = armado (FW_STAGED_VERSION 0x0150 = versión nueva) · 3 = rechazado (motivos 7–15 en OTA_DIAG) · 4 = versión inferior.

  6. Solo cuando status = 2: (UNLOCK) COMMAND 0x13 ACTIVATE — respuesta Modbus ausente o truncada; el módulo vuelve en ~4 s. O bien (UNLOCK) COMMAND 0x14 FW_ABORT para descartar la imagen armada.

  7. No reinicie el módulo durante ~10 s (prueba y autoconfirmación) y después verifique: FW_ACTIVE_BANK cambiado · FW_VER = nueva versión · SWAP_PENDING 0x011C = 0. Si FW_VER es la antigua, se revirtió: lea OTA_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.