rbAmp
ES
Tienda
Docs
Actualizado

Transporte I²C

El módulo es un esclavo I²C con el mapa de registros completo. Dirección por defecto de 7 bits 0x50 (configurable, véase abajo). La velocidad de bus recomendada es 50 kHz en hosts ESP32 y ESP8266 y 100 kHz en otros hosts (no 400 kHz); el esclavo admite estiramiento de reloj y el maestro debe tolerarlo (véanse los límites abajo).

El transporte activo (I²C o Modbus RTU) se selecciona una vez por arranque mediante el conmutador de modo de interfaz — véase Interfaz de hardware. Con el ajuste I²C no se sirve el espacio de registros Modbus, y viceversa; los comandos y los datos son los mismos en ambos.

Puntero de registro

  • Puntero de registro de 16 bits, big-endian en el cable (primero el byte alto), con autoincremento.
  • Escritura: el maestro envía 2 bytes de puntero (alto, bajo) y después un flujo de datos; cada byte de datos cae en el puntero, que se incrementa tras cada uno.

  • Lectura: el maestro escribe los 2 bytes del puntero, después emite un start repetido y lee; los bytes salen desde el puntero con autoincremento.

  • Los campos de varios bytes son little-endian y se direccionan por byte; no hay requisito de alineación en el bus. Un maestro puede leer cualquier campo como N bytes little-endian desde su dirección, en una o varias transacciones.

  • Direcciones no asignadas: las lecturas devuelven 0xFF y las escrituras se ignoran. Las direcciones de bloques de canal con índice ≥ N_CURRENT / N_VOLTAGE no están especificadas: condicione el uso a los recuentos y no las interprete.

No existe una sonda a nivel de bus para distinguir direccionamiento de 8 o 16 bits (un dispositivo de 8 bits leería el segundo byte del puntero como dato). Un maestro conoce la convención por línea de producto; la firma STD tras una lectura de 16 bits de 0x0000 es 'S','T' + VERSION ≥ 0x30 + bit 9 de CAPABILITIES.

Tiempos y robustez

  • Disponibilidad tras el reinicio: la interfaz de registros se activa en milisegundos tras un reinicio, antes que la vía de medida — el módulo responde en el bus incluso mientras la vía del sensor todavía arranca. Tras un reinicio por activación de firmware, espere ~4 s antes de que el dispositivo reaparezca.

  • Estiramiento del reloj (clock stretching): normalmente es despreciable; durante las operaciones de escritura en flash de la actualización de firmware, el esclavo puede retener SCL hasta ≈9 ms. Configure el tiempo límite de SCL del maestro en ≥10 ms; de lo contrario, los reintentos durante la OTA quedarán registrados (los datos no se corrompen: la transacción simplemente espera).

  • Durante las escrituras en flash provocadas por comandos (guardado de configuración/calibración, programación de páginas OTA) el esclavo también puede no responder con ACK brevemente. Reintente hasta que transcurra el tiempo de asentamiento del comando en lugar de abortar al primer NACK (véanse los tiempos de asentamiento en Comandos).

  • Coherencia: cada transacción de lectura se sirve desde una instantánea coherente de 128 bytes tomada cuando se fija la dirección de registro: los campos leídos en una transacción de hasta 128 bytes proceden de una misma publicación y no pueden desgarrarse (así se leen los campos de energía i64 y los bloques completos). Los campos leídos en transacciones separadas pueden venir de ventanas distintas. Para detectar un reinicio del módulo entre lecturas, compruebe la monotonía de FRAME_CNT (0x0020) y de BOOT_COUNT (0x00CE).

Cambio de la dirección I²C

Dos caminos:

Directo (dirección conocida):

  1. Escriba la nueva dirección I²C de 7 bits (0x08..0x77) en CFG_I2C_ADDR (0x0073).
  2. COMMAND = 0x04 (SAVE_CONFIG) — validado; una dirección no válida se rechaza con ERROR 0xFD y no se guarda nada. Los guardados tienen límite de frecuencia: una repetición en unos 5 s responde 0xF9 — reintente más tarde. Espere a BUSY = 0 y ERROR = 0 antes del siguiente paso.

  3. COMMAND = 0x02 (RESET). La dirección se aplica en el reinicio; el dispositivo se vuelve a enumerar con la nueva dirección en ~1 s.

Seguridad

⚠ Tras el reinicio, todos los maestros del bus deben cambiar a la nueva dirección; planifíquelo como una operación de instalación, no como una rutina.

Por UID (varios módulos en una misma dirección por defecto): escriba el UID de 12 bytes del módulo destino en ADDR_UID (0x00E0), la nueva dirección I²C en ADDR_UID_I2C (0x00EC, 0 = mantener) y/o el nuevo id de unidad Modbus en ADDR_UID_UNIT (0x00ED, 0 = mantener), y luego COMMAND = 0x16 (ADDR_BY_UID). Solo el módulo cuyo UID coincide guarda el cambio — junto con cualquier otro valor CFG_ pendiente, como en un SAVE_CONFIG — y se reinicia; todos los demás módulos ignoran el comando (ERROR 0xFC allí). También se acepta por difusión Modbus — véase Transporte Modbus. Si ambos campos de nueva dirección son cero → 0xFD; dirección no válida → 0xFD; límite de frecuencia de guardado → 0xF9. Paso a paso: Secuencias D4.