rbAmp
ES
Tienda
Docs
Actualizado · Editar en GitHub

11 · Registro de cambios

Este capítulo refleja CHANGELOG.md de la raíz del repositorio. Las versiones públicas se reanudan con la 1.7.2; las versiones intermedias se publicaron solo internamente.

1.7.3 — La energía STD permanece en los contadores, modelos de pinza de 100 A y 50 A, mensaje de módulo bloqueado (2026-11-01)

Fijo

  • Los módulos STD que informan de ambos bancos de instantáneas (bit de capacidad 8) y de contadores de energía en el dispositivo (bit 13), como la imagen de módulo 0x0001007E: la energía y las llamadas de período ahora usan los contadores persistidos en el módulo. Antes, un módulo así pasaba al banco 0 integrado en el host sin ninguna señal. Las llamadas a bancos de instantáneas (rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch) son una herramienta aparte que depende solo del bit 8 y funcionan en estos módulos como antes. rbamp_std_info_t.period_source indica la fuente realmente utilizada.

Añadido

  • README: sección «línea STD» con la versión mínima de componente para la imagen de módulo 0x0001007E y las llamadas a bancos de instantáneas.

  • El ejemplo std_meter arma su propio banco 1 en cada módulo que informa de bancos de instantáneas, también cuando la energía procede de los contadores.

  • Nombre de firmware para BASIC REG_VERSION 0x0E: rbamp_basic_fw_name() devuelve "1.4.22" (todas las variantes BASIC).

  • Registro de modelos de sensor: los modelos de pinza 2000:1 con códigos 11 (50 A) y 13 (100 A) ahora están caracterizados (clasificados 50.0 A / 100.0 A, escala completa 62.5 A / 116.5 A, pico 88.4 A / 164.7 A). El código 12 (80 A) se mantiene para los módulos ya vinculados a él.

Modificado

  • rbamp_set_ct_model_ch_force() sobre un módulo BASIC de clase 2 o 3 devuelve ESP_ERR_INVALID_STATE con una línea de registro que nombra la configuración bloqueada cuando el módulo rechaza la escritura (el firmware 1.4.22 y posteriores rechazan las escrituras de clase y modelo en un módulo emparejado de fábrica fuera del modo de mantenimiento). Antes, el rechazo aparecía como un error genérico de parámetro. La vía de forzado solo funciona en un módulo así en modo de mantenimiento.

1.7.2: corrección de la nominal del SCT-013, reanudación tras una caída del master, lecturas de ventana en una sola transacción (2026-10-21)

Primera versión pública desde la 1.5.0. Incluye juntas las versiones 1.6.0 – 1.7.2: la línea de módulos STD tras el mismo manejador, la línea de datos listos, los eventos, la energía en µWh y las magnitudes de fase, un número de canales que sigue al módulo (1, 2, 3, 5 o 7), el registro de modelos de sensor con límites de recorte, las lecturas de ventana en una sola transacción, la reanudación tras una caída del master y la corrección de la nominal del SCT-013 para los módulos de línea de corriente cuyo firmware mantiene la calibración de 30 A (el firmware que informa de la capacidad de autocorrección se corrige solo). La validación en hardware de esta línea se hizo en un host con ESP-IDF 5.4.1.

Añadido

  • Se aceptan SCT-013-060 y -100 (antes se rechazaban en el cliente por estar reservados); los límites de recorte del modelo de sensor se actualizaron a los valores medidos.
  • Cambio de nominal del SCT-013: un módulo de sensor de corriente de clase 1 se calibra con el sensor de 30 A, y el firmware hasta la 1.4.19 mantiene esa calibración tras asociar otro modelo. La biblioteca lee ahora la ganancia que aplica el módulo en rbamp_begin(), tras una escritura de modelo y tras cada reinicio de módulo detectado, y escala la corriente, el pico de corriente, la potencia activa, la potencia media del período, la energía integrada, el digest y los umbrales de evento según el modelo seleccionado. La tensión y el factor de potencia no se escalan. rbamp_sct_correction() informa del resultado por canal (rbamp_sct_correction_t: estado, modelo, escala, ganancia aplicada) y rbamp_sct_refresh() vuelve a evaluar bajo demanda. Una ganancia que sigue igual al preajuste bruto (el modelo cambió en este arranque sin reinicio) provoca un CMD_RESET; una ganancia aplicada inesperada, un modelo desconocido o un preajuste bruto que sobrevive al reinicio dejan las lecturas sin escalar, con un aviso. Un módulo que informa de la capacidad de autocorrección (firmware 1.4.20 y posteriores) se corrige solo y adopta escala 1: se detecta por la capacidad, nunca por VERSION. CONFIG_RBAMP_SCT_RATING_CORRECTION (activado por defecto) desactiva el mecanismo.

  • rbamp_begin_resume() — rbamp_begin() sin el cebado de latch. Un módulo BASIC sigue promediando hasta el siguiente latch, así que tras un reinicio o una caída del maestro la primera instantánea consumida integra sobre la ventana propia del módulo y recupera la energía del tiempo de inactividad. Las instantáneas posteriores usan el reloj del maestro como antes. Los módulos STD se comportan exactamente igual que con rbamp_begin().

  • rbamp_period_snapshot_t: module_window_ms (la longitud propia del módulo de la ventana enclavada, 0 en STD; el módulo cuenta confirmaciones de 100 ms en el firmware actual y de 200 ms en el firmware anterior a v1.2 — la biblioteca lo deduce de la propia instantánea y lo informa en module_commit_ms), module_uptime_s, window_from_boot (la ventana empezó en el arranque del módulo: un reinicio, o el primer enclavado desde el arranque) y window_long (más de 6 h, donde el promedio del módulo pierde precisión). En la primera instantánea tras rbamp_begin_resume(), module_restarted = window_from_boot.

  • rbamp_read_uptime_s(): segundos desde el arranque del módulo (BASIC y STD). Devuelve 0 en el firmware BASIC que no lo publica; entonces window_from_boot permanece en false.

  • rbamp_read_digest() — una ventana de un módulo BASIC en una sola transacción: estado, secuencia de ventana y los campos elegidos (corriente, tensión, potencia activa con signo en vatios enteros, factor de potencia) para los canales 0-2. Pensada para leer cada ventana publicada en la línea de datos listos. rbamp_set_digest_fields() elige los campos; la biblioteca escribe la elección en el módulo y la vuelve a escribir tras detectar un reinicio del módulo. Requiere firmware BASIC con la capacidad de resumen; no disponible en STD.

  • rbamp_basic_fw_name() — el nombre de publicación del firmware para un byte de versión BASIC ("1.4.19" para 0x0B, y así sucesivamente).

  • rbamp_read_sensor_class(): la clase de sensor actual del módulo.

  • rbamp_sensor_model_limits() — la corriente eficaz nominal de un modelo de sensor, la corriente eficaz a la que una senoidal empieza a recortarse y el techo instantáneo de recorte, en A, del registro de modelos generado (0 si no se conoce). rbamp_sensor_model_rated_a() es la forma abreviada de la corriente nominal; tenga en cuenta que la clasificación puede diferir de los amperios del nombre del modelo.

  • El registro generado de modelos de sensor se actualizó con esos límites.

  • rbamp_set_ct_model_ch_force(): ruta de servicio que establece el modelo de un canal independientemente de la clase y del modelo actual del módulo. Sustituye la calibración que la unidad tiene para ese canal por el preajuste genérico del modelo; sígala con una calibración.

Modificado

  • rbamp_set_ct_model(), rbamp_set_ct_model_ch() y rbamp_configure_channels() en un módulo de clase 1 sin la capacidad de autocorrección (firmware hasta 1.4.19) terminan con un reinicio del módulo (CMD_RESET, mismo UID verificado, unos segundos): la única forma de que el módulo vuelva a su ganancia calibrada tras una escritura de modelo. La biblioteca vuelve a aplicar lo que le corresponde (cebado de latch, máscara de resumen en el siguiente uso); los acumuladores de periodo se reinician como tras cualquier reinicio del módulo.

  • El transporte ya no llama a i2c_master_bus_reset() por su cuenta antes del último intento de una transacción fallida. El driver ya reinicia su máquina de estados tras cada transacción fallida, y el reinicio explícito no toma ningún bloqueo: cuando otra tarea tiene una transacción en curso, genera un STOP en los pines activos, que el manejador de interrupciones del driver puede tomar por el fin de una lectura y bloquearse en la ISR (observado en un host con un módulo conectado en caliente). CONFIG_RBAMP_BUS_RESET_ON_RETRY_EXHAUSTION restaura el comportamiento anterior para un maestro de una sola tarea.

  • rbamp_set_sensor_class(), rbamp_set_ct_model(), rbamp_set_ct_model_ch() y rbamp_configure_channels() leen antes de escribir. Una clase o un modelo que el módulo ya tiene no se reescribe (ninguna escritura en el bus): en el módulo, una escritura de clase borra los modelos de CT incluso si el valor no cambia, y una escritura de modelo vuelve a aplicar el preajuste genérico sobre la calibración propia de la unidad incluso si el modelo no cambia; por eso, reaplicar una configuración almacenada en cada reconexión solía degradar las lecturas. Un módulo de clase 2 o 3 (enviado y calibrado junto con su sensor) no se reconfigura: ESP_ERR_INVALID_STATE. rbamp_configure_channels() decide toda la solicitud antes de su primera escritura, así que en ese módulo nada queda aplicado a medias.

  • Documentación de latch_ms: solo diagnóstico, puede leerse corto bajo carga; la ventana de integración de energía es master_dt_ms o module_window_ms.

  • La documentación y la ayuda de Kconfig indican ahora la ventana de publicación del módulo como 100 ms en toda la familia (imágenes anteriores: 200 ms). Los 300 ms de asentamiento que aplica la biblioteca tras un latch STD se describen como el límite superior seguro que son. No cambió ningún comportamiento temporal.

Fijo

  • rbamp_read_all() / rbamp_read_all_ready() en un módulo con más de tres canales (UI5/UI7, BASIC o STD) escribían los canales 3 y superiores más allá de los arrays de tres entradas de rbamp_snapshot_t: se sobrescribían frequency, topology y channels (el host veía entonces channels = 0) y el último canal caía cuatro bytes más allá de la estructura, en la pila del llamador. Ahora la llamada rellena solo los canales 0-2 (RBAMP_SNAPSHOT_CHANNELS), exactamente como lo hace la instantánea de periodo; los canales 3 y superiores siguen en rbamp_read_channel() / rbamp_read_all_channels(). Detectado en un host con un módulo de 7 canales. Una simulación en host de todo el componente contra una imagen de registros falsa ahora ejecuta read_all para 1/3/5/7 canales con palabras de guarda tras la estructura.

1.7.1: el número de canales sigue al módulo (2026-10-18)

Fijo

  • rbamp_new() creaba un manejador cuyo número de canales estaba fijado en tres, así que un módulo de un solo canal (UI1, I1) seguía informando de tres canales tras rbamp_begin(). El constructor por defecto ahora adopta el número de canales y la presencia de tensión del registro de variante del módulo; tres canales solo quedan como alternativa para firmware que no publica la variante. rbamp_new_with_topology() sigue fijando el número como antes (se registra una advertencia si el módulo no coincide). Reportado desde un host con un UI1; validado allí: un módulo UI1 informa de un canal y de la variante UI1 tras rbamp_begin().

  • rbamp_read_variant() en la línea BASIC devolvía UNKNOWN para los códigos UI5 / UI7; ahora mapea todos los códigos conocidos.

Añadido

  • rbamp_variant_t rbamp_variant(rbamp_handle_t dev) — la variante guardada en caché por rbamp_begin(), sin tráfico de bus. RBAMP_VARIANT_UNKNOWN antes de rbamp_begin() o cuando el módulo no publica su variante.

  • Pruebas unitarias de host para la política de variantes de ambos constructores (test/host/test_std_decode.c).

1.7.0: energía en µWh, corriente de arranque, ángulos de fase y secuencia (2026-10-17)

Soporte para la versión de imagen de módulo 0x0001007A / 0x0001007B. Cada adición depende de lo que informe el módulo; los módulos anteriores se comportan exactamente como antes.

Validado en módulos STD con versión de imagen de módulo 0x0001007B en una aplicación de host: lectura y escritura de la corriente de arranque con relectura, ángulos de fase y secuencia de fase en un módulo trifásico, indicadores de energía fina, diferencia de energía a través de reinicios del módulo.

Añadido

  • Energía con resolución en µWh / µvarh en rbamp_std_energy_t: act_import_uwh, act_export_uwh, act_net_uwh, rea_import_uvarh, rea_export_uvarh, ch_import_uwh[], ch_export_uwh[], además de fine / fine_reactive. Los campos se rellenan en todos los módulos: a partir de los contadores µ propios del módulo cuando los publica (versión de imagen de módulo 0x0001007A; reactiva desde 0x0001007B); en otro caso, se escalan desde los contadores gruesos con fine en false: los llamadores pueden usar los campos µ sin condiciones. Se leen como instantáneas coherentes (una transacción por bloque). rbamp_std_energy_delta aplica las mismas reglas (cambio de generación → sin delta; caída del tiempo de actividad = reinicio; un contador por debajo de la lectura anterior → 0; neto = importación − exportación). rbamp_read_period_snapshot en la ruta de contadores usa la diferencia en µWh cuando está disponible.

  • Corriente de arranque para energía: rbamp_std_get_start_current / rbamp_std_set_start_current (µA; 0 = desactivada; un valor fuera del conjunto que acepta el módulo → ESP_ERR_INVALID_ARG sin escritura en el bus; se relee y se confirma; rbamp_save_user_config lo persiste). Por debajo de esta corriente de canal, el módulo no cuenta energía; las lecturas no se ven afectadas. También en rbamp_std_config_t (start_ua, start_ua_supported). ESP_ERR_NOT_SUPPORTED sin tráfico de bus antes de la versión de imagen de módulo 0x0001007B.

  • Ángulo de fase de la tensión: rbamp_std_voltage_t.angle_deg / angle_valid (grados respecto a la entrada de tensión 0; versión de imagen de módulo 0x0001007A o posterior, módulos trifásicos; en otro caso angle_valid es false). Misma lectura en una sola ráfaga que antes.

  • Secuencia de fase: rbamp_std_read_phase_seq → rbamp_std_phase_seq_t (RBAMP_STD_PHASE_SEQ_NA / FORWARD / REVERSE / ABNORMAL); ESP_ERR_NOT_SUPPORTED sin tráfico en el bus antes de la versión de imagen de módulo 0x0001007A.

  • Prueba unitaria en host de los auxiliares puros de decodificación: test/host/run.sh (gcc, sin ESP-IDF). Las reglas del delta de energía viven ahora en src/rbamp_std_decode.c.

Modificado

  • rbamp_is_provisioned (línea STD) documenta el marcador de calibración de la versión de imagen de módulo 0x0001007A: una unidad calibrada con un firmware anterior devuelve false tras la actualización hasta que se ejecute un rbamp_save_gains.

Nota de actualización

  • La estructura de instantánea de energía (rbamp_std_energy_t) ganó campos en esta versión. Si su aplicación la guarda como blob binario en bruto (NVS, archivo), guarde solo los campos que necesite en su propio formato fijo: un blob guardado por una versión anterior no coincidirá con el nuevo tamaño.

1.6.1: finalización de comandos, lecturas coherentes, comprobaciones de sesión OTA (2026-10-11)

Correcciones en la biblioteca a partir de la auditoría de firmware / biblioteca del 2026-10-11. Sin API nueva; el comportamiento de las llamadas existentes en la línea STD se ha endurecido.

Modificado

  • La finalización del comando es el registro de estado de comandos del módulo (bit de ocupado borrado y contador de comandos completados incrementado), nunca solo el registro de error; el veredicto se lee solo tras la finalización. Los guardados (rbamp_save_gains, rbamp_save_user_config), rbamp_std_cal_thd_floor, rbamp_reset, el cambio de dirección y cada comando OTA lo usan: sin pausas fijas en los módulos que publican el registro, con tiempos límite de al menos 1 s (3 s para la confirmación OTA). Un comando escrito mientras el módulo está ocupado se espera primero; un comando que el módulo descartó (desbordamiento) falla con ESP_ERR_INVALID_STATE en lugar de devolver el veredicto del comando anterior.

  • Una escritura de comando nunca se reintenta ante un error de transporte (un reintento podría entregar el código de operación dos veces). Las lecturas y escrituras de registros de datos mantienen el reintento.

  • Las lecturas de bloque son una sola transacción: el módulo sirve cada lectura desde una instantánea coherente, así que los contadores de energía, los bloques de canal y los totales ya no se desfasan entre ráfagas. rbamp_read_all en un módulo STD lee el bloque de tensión y cada bloque de canal completo, en lugar de campo a campo.

  • OTA: tras cada página la sesión debe seguir abierta (estado 1); si no, ESP_ERR_INVALID_STATE con el motivo del módulo registrado: reinicie desde begin. Los sondeos durante un bloqueo de escritura en flash ya no reinician el bus. rbamp_std_ota_activate aguanta durante la ventana de prueba de ~10 s del módulo y confirma que la imagen en ejecución es la versión preparada y que el intercambio ya no está pendiente. rbamp_std_ota_write_image (imagen generada en el host, sin firmar) devuelve ESP_ERR_NOT_SUPPORTED antes de tocar el módulo: el firmware del módulo solo acepta imágenes preparadas por el fabricante.

  • Cambio de dirección (rbamp_commit_address_change, STD): el guardado de la configuración es síncrono (límite de frecuencia → ESP_ERR_NOT_FINISHED, reintente tras ~5 s), y el manejador cambia a la nueva dirección solo cuando un módulo responde allí; en caso contrario, ESP_ERR_NOT_FOUND y el manejador conserva la dirección anterior.

  • rbamp_std_read_totals: los campos de energía de los bloques agregados se leen como 0 (el módulo no los rellena; use rbamp_std_read_energy).

  • rbamp_read_frequency (STD): 0 desde el módulo significa que no hay red → ESP_ERR_INVALID_RESPONSE / NaN (rbamp_read_all lo marca como no plausible).

  • rbamp_is_provisioned (STD): documentada como fiable desde la versión de imagen de módulo 0x00010079 (las imágenes anteriores también informan calibración válida con las ganancias por defecto).

1.6.0: línea de módulos STD, línea de datos listos, eventos (2026-10-11)

Añadido

  • Línea de módulos STD (mapa de registros de 16 bits) tras el mismo manejador y la misma API que la línea original: rbamp_std_probe / rbamp_std_identify / rbamp_std_info, lecturas en tiempo real por canal incluidas la potencia reactiva y aparente (rbamp_read_reactive_power, rbamp_read_apparent_power, rbamp_std_read_channel, rbamp_std_read_voltage), totales por fase y totales generales (rbamp_std_read_totals), configuración y armónicos (rbamp_std_read_config, rbamp_std_set_harmonics, rbamp_std_cal_thd_floor).

  • Energía en módulos sin bancos de instantáneas: la fuente del período se elige a partir de las capacidades del módulo en rbamp_begin (rbamp_std_info_t.period_source); la energía del período es la diferencia de dos lecturas de los contadores persistentes, con reglas de reinicio y de reinicio de contador. rbamp_std_read_energy (Wh / varh, más mWh por canal y por grupo en el mapa 0x36+), rbamp_std_energy_delta, rbamp_energy_add_wh, RBAMP_ENERGY_CH_TOTAL. rbamp_period_snapshot_t incorporó avg_p_total, wh_net y module_restarted.

  • Bancos de instantáneas en los módulos que los tienen: rbamp_std_arm_banks, rbamp_std_latch, rbamp_std_read_latch, rbamp_std_latch_wh.

  • Reloj del módulo, historial y registro de eventos: rbamp_std_set_time, rbamp_std_read_time, rbamp_std_read_image_version, rbamp_std_hist_info, rbamp_std_hist_read, rbamp_std_hist_read_raw, rbamp_std_event_read, rbamp_std_hist_flush (el anillo horario es persistente; el registro de 15 minutos es solo el último).

  • Salud: rbamp_std_read_health ampliada con bits de estado, vida útil y fuentes de calibración, contadores de tramas, tiempo de actividad, y causa de reinicio y número de arranques (versión de imagen de módulo 0x00010076 y posteriores, RBAMP_STD_RST_*).

  • Comandos y servicio: rbamp_std_command, rbamp_std_wait_idle, rbamp_std_locate, rbamp_std_read_board_id, rbamp_std_ota_board_ok (comprobación de placa antes de un flujo OTA), rbamp_std_set_address_by_uid.

  • OTA: actualización de imagen en doble banco, incluidas las imágenes firmadas preparadas (rbamp_std_ota_begin … rbamp_std_ota_activate, rbamp_std_ota_write_prepared, rbamp_std_ota_write_prepared_pair, rbamp_std_ota_diag, rbamp_std_ota_staged_version, rbamp_std_ota_abort).

  • Certificado y atestación: rbamp_std_read_certificate, rbamp_std_attest (la verificación de la firma la hace la aplicación).

  • Línea de datos listos (DRDY), ambas líneas de módulos: rbamp_set_drdy_gpio, rbamp_wait_data_ready, rbamp_read_all_ready, rbamp_read_data_seq. Una línea de drenaje abierto puede compartirse entre varios módulos; la biblioteca verifica la secuencia de publicación, cuenta las ventanas perdidas, informa de la latencia y detecta una alarma con la línea retenida en bajo. Respaldo por sondeo mediante CONFIG_RBAMP_DRDY_POLL_MS. Los módulos STD necesitan la versión de imagen de módulo 0x00010075 o posterior.

  • Eventos en ambas líneas: rbamp_read_event_mask, rbamp_set_event_mask, rbamp_set_event_thresholds, rbamp_begin_event_flags, RBAMP_EVENT_NVM_FAULT; rbamp_read_event_flags / rbamp_clear_event_flags / rbamp_has_error / rbamp_clear_error ahora cubren la línea STD.

  • Kconfig: RBAMP_I2C_SCL_WAIT_US (presupuesto de estiramiento de reloj, 10 ms por defecto) y RBAMP_DRDY_POLL_MS.

  • Ejemplo std_meter.

Modificado

  • Las llamadas de período en módulos sin bancos de instantáneas devuelven ESP_ERR_NOT_SUPPORTED en lugar de informar en silencio de un período no válido.

  • rbamp_set_ct_model_ch devuelve ESP_ERR_NOT_SUPPORTED en módulos STD cuyo mapa de canales no es escribible.

  • rbamp_err_to_str cubre ESP_ERR_NOT_FOUND, ESP_ERR_NOT_FINISHED y ESP_ERR_INVALID_CRC.

  • rbamp_period_snapshot_t y rbamp_std_health_t incorporaron campos (compatibles con el código fuente; recompile los dependientes).

  • El componente requiere ahora esp_driver_gpio (componente integrado de IDF).

1.5.0 — Modelo de CT por canal en todos los canales (2026-09-04)

Añadido

  • rbamp_set_ct_model_ch / rbamp_read_ct_model_ch / rbamp_configure_channels aceptan cualquier canal hasta el número de canales detectado (canales 3 y siguientes, a través de la ventana de canales).

  • Los códigos de modelo y sus descriptores proceden del archivo generado rbamp_sensor_models.h (rbamp_sensor_model_lookup); el módulo rechaza los códigos desconocidos y los devuelve al llamador.

Fijo

  • La clase de sensor y el modelo de CT ahora persisten en los módulos de producción: el código de guardado anterior no grababa en flash en el firmware de producción, por lo que la vinculación se aplicaba en RAM y se perdía en el siguiente reinicio. Sin cambios en la API; el mismo asentamiento de ~700 ms.

1.4.0 — Módulos de cinco y siete canales

Añadido

  • Topología FIVE_CH / SEVEN_CH, variantes UI5 / UI7, RBAMP_MAX_CHANNELS = 7; rbamp_read_channel, rbamp_read_all_channels, rbamp_read_commit_seq. La instantánea de período integra todos los canales.

1.3.0 (2026-06-16) — Versión pública

Primera versión pública del componente rbamp para ESP-IDF v5.x.

Características principales

  • Gestor de flota: administra un grupo de módulos en un único bus I²C mediante un único manejador rbamp_fleet_t. Descubrimiento con detección de conflictos y canario de bloqueo de nivel 2, _poll_all resistente a MISS, agregación de potencia total / energía total / errores, latch de difusión para sincronía ajustada. Vea el capítulo 09 · Referencia de la API, sección «Gestor de flota».

  • Aprovisionamiento: rbamp_provision — un flujo de una sola llamada para reasignar un módulo virgen a su dirección de trabajo, con guardado opcional de la configuración en flash. Disciplina: un virgen cada vez en el bus (un OBLIGATORIO normativo).

  • Configuración multicanal: rbamp_configure_channels realiza la configuración atómica por canal de los modelos de CT en una sola operación, con un único ciclo de escritura final en flash (favorable a la flash).

  • Modelo de errores v1.3: separa el resultado de la última escritura (REG_ERROR (0x02) — canal síncrono, validado por los setters) de la señal asíncrona persistente (EVENT_FLAGS.bit3 — sticky, para hechos en tiempo de ejecución). Las funciones correspondientes son rbamp_read_last_error, rbamp_has_error, rbamp_clear_error, rbamp_read_event_flags.

  • Identidad / detección de funciones: rbamp_read_variant, rbamp_read_capability (mapa de funciones), rbamp_has_voltage, rbamp_read_product_id, rbamp_read_uid, rbamp_is_provisioned.

Canon reflejado en la documentación

  • La topología con varios módulos es el modo de operación principal de la biblioteca. El escenario de «un módulo en el bus» es el caso mínimo, no el canon. El despliegue canónico es un módulo de red en la acometida más N módulos en cargas individuales, todos en un único bus I²C bajo un único manejador de flota.

  • SKU admitidos en el hardware actual: UI1 (medidor de red: tensión + corriente + potencia + PF + energía), I1 / I2 / I3 (submedidores: solo corriente, por canal). UI2 / UI3 llegaron en firmware posterior.

  • La energía y la potencia solo se calculan en las variantes UI (que tienen una etapa de tensión). En las variantes I, rbamp_read_power / _power_factor devuelven 0.0f; la agregación de flota de la potencia total / energía suma correctamente e ignora las aportaciones cero.

  • La vinculación de CT es un preparado puro (canon v1.3): escribir REG_CT_MODEL NO aplica el valor automáticamente; la vinculación se hace mediante CMD_SET_CT_MODEL_CHn por canal. El orden de vinculación es arbitrario (las «anacronías de orden ascendente/descendente» anteriores a v1.3 se han eliminado).

  • El cambio de dirección es apto para producción: la confirmación en dos fases + código mágico + reinicio funciona en producción (no hace falta modo de fábrica).

  • Reloj de pared del maestro = base de tiempo canónica para Wh: el temporizador de software del chip PERIOD_LATCH_MS (0xEC) es solo de diagnóstico; no lo use para la energía. El maestro usa su propio esp_timer_get_time() o reloj de pared.

Documentación: capítulos nuevos / reelaborados

  • 01_overview: la introducción se reescribió para dar prioridad a los sistemas con varios módulos; se añadió un diagrama ASCII del escenario del 80 %.

  • 03_sensor_selection — barrido del orden de CT; nueva sección «Módulos multicanal — I2 e I3 (solo corriente)» con un patrón de desagregación UI1+I3.

  • 04_hardware: la sección «Bus con varios módulos: topología principal» pasa a ser el modo de operación principal; requisito explícito de pull-ups externos de ~4.7 kΩ en el bus de la flota; flujo de aprovisionamiento mediante rbamp_provision.

  • 09_api_reference: se añadieron las secciones «Identidad y aprovisionamiento», «Modelo de errores v1.3», «Configuración multicanal», «Gestor de flota: administración de varios módulos» y «Configuración de flota por dispositivo».

  • 10_troubleshooting: se añadieron las secciones «El i2c_master de IDF se cuelga en un bus marginal: mitigación en tres capas» (con una tabla de tasas de bloqueo validada en HW), «Flota: un módulo acabó excluido», «Flota: rbamp_fleet_scan devolvió INVALID_STATE», «Flota: rbamp_provision devolvió un error».

  • 11_changelog: este archivo.


Fuente y incidencias: rb-amp/rbamp-esp-idf · esta página en el repositorio: docs/11_changelog.md (v1.7.3)