11 · Registro de cambios
El historial completo y detallado está en CHANGELOG.md en la raíz del repositorio; este capítulo recoge la versión resumida.
1.6.2: la energía STD se mantiene en los contadores, filas del registro de modelos, error de módulo bloqueado
-
STD, imágenes con contadores y bancos de latch: un módulo así mantiene ahora
readPeriodSnapshot()/energy()sobre sus contadores persistentes (antes cambiaba en silencio a energía integrada en el host desde el banco 0). Las llamadas a bancosstdArmBanks()/stdLatch()/stdReadLatch()siguen disponibles y dependen solo de la capacidad de bancos. La biblioteca 1.6.2 es la versión mínima para dicha imagen; véase Fuente de energía y versión mínima de la biblioteca. -
Nuevo ejemplo
12_StdBanks: dos periodos temporizados por el maestro en sus propios bancos de instantáneas. -
Registro de modelos de sensor: se aceptan las filas de pinzas 2000:1 para 50 A (código 11) y 100 A (código 13).
-
setCTModelChForce()en un módulo BASIC emparejado de fábrica fuera del modo de fábrica (firmware 1.4.22+) devuelveRB_ERR_MODE("configuración bloqueada") y no guarda nada; una escritura forzada funciona solo en modo de fábrica.
1.6.1: energía STD de microresolución, corrección de clasificación SCT-013, guarda de configuración del sensor
Publicada junto con la 1.6.0 (la línea STD) como primera versión pública de la biblioteca de dos líneas.
-
Línea STD: contadores de energía de microresolución (µWh / µvarh), corriente de arranque para la energía (
stdSetEnergyStartCurrent()/stdReadEnergyStartCurrent()), ángulo de fase de tensión (RbAmpStdVoltage::angle_deg) y secuencia de fases (stdReadPhaseSequence()), para los módulos cuya imagen los publica (imagen0x0001007Bo posterior); los módulos anteriores se comportan exactamente igual.stdEnergyDelta()cubre los campos nuevos. -
Línea BASIC — corrección de calibre SCT-013: en firmware hasta la versión 1.4.19, un canal cambiado a otro modelo SCT-013 se lee respecto a la ganancia que aplica el módulo.
begin()lee cada canal y escala la corriente, la potencia y la potencia de periodo (así como la energía derivada de ella); el factor de potencia y la tensión no cambian. Novedades:sctRatingRefresh(),sctRating(),sctRatingScale(),sctPresetGain(). El firmware 1.4.20 y posteriores se corrige solo. Los métodos establecedores de modelo reinician el módulo tras guardar en el firmware que lo necesita (~0.5 s adicionales por llamada). -
Los setters de clase de sensor y de modelo de CT leen antes de escribir (
setSensorClass(),setCTModel(),configureChannels()): una configuración almacenada puede volver a aplicarse en cada arranque sin tocar la calibración del módulo. Un módulo de claseWiredCT/BuiltinCTno se reconfigura (RB_ERR_MODE);setCTModelChForce()es la vía de servicio. Novedad:readSensorClass(),RbAmp::sensorModel()/RbAmp::sensorModelRatedA()(consultas en el registro con los límites actuales del modelo). -
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.
-
En ambas líneas: la ventana de medida / la cadencia de publicación se documenta como 100 ms (200 ms se mantiene solo como nota para imágenes antiguas); el número de canales nunca puede superar
RBAMP_MAX_CHANNELS(los canales por encima devuelvenRB_ERR_PARAM); las pruebas unitarias del host (extras/host_tests) ejecutan las fuentes reales contra un bus simulado. -
RbAmpStdEnergyincorporó campos en esta versión: si su aplicación lo guarda como blob binario en bruto, almacene solo los campos que necesita en su propio formato fijo.
1.6.0 — Línea STD (modelo de registros de 16 bits)
Una sola biblioteca para ambas líneas de producto: begin() detecta si el módulo habla el modelo de registros BASIC (8 bits) o el STD (16 bits, punto fijo) y encamina cada llamada internamente: la superficie de métodos es la misma en ambas líneas.
-
line()(RbAmpLine::Basic/RbAmpLine::Std); lectores unificados en STD (readVoltage(phase),readCurrent(),readPower()…) más los nuevosreadReactivePower()/readApparentPower()(solo STD). -
La API de bloques STD:
stdInfo(),stdReadChannel(),stdReadTotals(),stdReadVoltage(),stdReadHealth(),stdReadConfig(),stdSetHarmonics(),stdCalThdFloor(); bancos de latch (stdArmBanks(),stdLatch(),stdReadLatch(),stdLatchWh()); contadores de vida útil (stdReadEnergy(),stdEnergyDelta()). -
La fuente del período se elige según las capacidades del módulo (bancos de latch o contadores persistentes); la energía de latch sobrevive a un reinicio del módulo; la instantánea de período incorporó
avg_p_total,wh_net,module_restarted. -
Identidad, reloj, historial:
stdIdentify(),RbAmp::stdProbe(),stdReadImageVersion(),stdReadBoardId(),stdSetTime()/stdReadTime(),stdHistInfo()/stdHistRead()/stdHistReadRaw()/stdEventRead()/stdHistFlush(),stdCommand()/stdWaitIdle()/stdLocate(),RbAmp::stdSetAddressByUid(). -
La configuración y los comandos funcionan en STD (
setSensorClass(),setCTModel(),configureChannels(),saveUserConfig(),saveGains(), cambio de dirección); cada comando espera a que el módulo informe que ha terminado y comprueba su veredicto. En STD el modelo de CT es solo una etiqueta de referencia. -
Actualización de firmware por I²C:
stdOtaBegin()→stdOtaWritePage()→stdOtaCommit()→stdOtaActivate(),stdOtaWritePreparedImage()(imágenes preparadas por el fabricante),stdOtaDiag(),stdOtaAbort(),stdOtaBoardOk(). -
Línea de datos listos y eventos en ambas líneas:
setDrdyPin(),waitDataReady(),readAllReady(),readDataSeq(),beginEventFlags(),setEventMask()/readEventMask(),setEventThresholds();readEventFlags()/clearEventFlags()/hasError()funcionan en los módulos STD que dispongan del bloque de eventos. -
Las llamadas exclusivas de BASIC (
factoryReset(), ayudantes de llamada general y de etiqueta,readCapability(),readCommitSeq(),readPeriodLatchMs()) devuelvenRB_ERR_NOT_IMPLEMENTEDen una instancia STD. Sin cambios en la API BASIC. -
Ejemplo
11_StdLine.
1.5.0: modelos de CT por canal + registro de modelos de sensor
-
setCTModel(channel, code)/configureChannels()asocian cualquier canal, incluidos los canales 3 y superiores del SKU superior (a través de la ventana de canales); cada escritura se confirma con una lectura de verificación, y un modelo que el módulo no acepta se notifica comoRB_ERR_PARAM(el canal conserva su modelo anterior). -
readCTModelCh()cubre todos los canales. -
Registro generado de modelos de sensor
RbAmpSensorModels.h(definesRBAMP_CT_*, descriptores,rbamp_sensor_model_lookup()); la validación de modelos de CT está guiada por el registro (el cliente solo rechaza los códigos ausentes del registro: la aceptación la decide el módulo).RbAmpCTModeles un alias congelado de los siete códigos SCT-013. -
La modelo de CT / clase de sensor ahora se persisten en los módulos de producción (
CMD_SAVE_USER_CONFIG). -
Ejemplo
10_PerChannelModels.
1.4.0 — Soporte de referencias SKU superiores (UI5/UI7)
Añade soporte para los módulos de 7 canales de referencia SKU superior (UI5, UI7) y actualiza el ejemplo de difusión GC. Verificado en silicio sobre una flota heterogénea (UI1/UI2/UI3/UI5/UI7), contrato de firmware bd2ad8e.
Añadido
-
Ejemplo
09_SeniorSku: sondeo de 7 canales e integración de energía para los módulos UI5/UI7. -
readCommitSeq(): lectura del número de secuencia de confirmación del firmware.
Modificado
-
RBAMP_MAX_CHANNELSpasó de 3 a 7. Los bocetos existentes que usan arrays deRbAmpSnapshotcrecerán: hay que recompilar (no hacen falta cambios en el código salvo que haya tamaños de array fijados a mano). -
03_MultiModuleBroadcastreescrito para el latch de difusión General-Call de v1.3 (la sincronización coherente en una sola trama sustituye al latch secuencial por dispositivo anterior). -
Cabeceras de registro regeneradas (contrato v1.4.0).
- Energía/Instantánea: crecimiento de matrices en las referencias SKU superiores + despacho según el número de canales.
1.3.0 — Flota + protocolo v1.3
Se adaptó la biblioteca Arduino a la especificación de cable rbAmp v1.3 y al modelo de referencia multiplataforma (STM32 HAL / ESP-IDF / Python). Validado en hardware sobre una flota heterogénea (UI1 + I2 + I3) a través de la API pública, con la verdad de terreno de registros en bruto (suite de cobertura completa 38/38 + prueba de estrés extendida con WDT de aplicación).
Añadido
-
RbAmpFleet: gestor multimódulo:scan()del bus (con detección de colisiones),pollAll()por lotes,totalPower()/totalEnergyWh()/pollErrors()de toda la flota, sincronización por General-Call (enableGcAll()/gcLatch()/checkSync()),assignAddress(),checkConflict()yprovision()para incorporar al bus un módulo recién salido de fábrica. -
Identidad / capacidad:
readVariant(),readCapability(),readProductId(),readUid(). -
Canal de eventos:
readEventFlags(),clearEventFlags(),hasError(),clearError(),readLastError(). -
Configuración de CT por canal:
configureChannels()(en lote, con un solo guardado en flash) yreadCTModelCh()(lectura del espejo del modelo aplicado). -
Primitivas de flota en el dispositivo:
enableGc(),setGroupId(),readGroupId(),readGcTick(),readFleetConfig(),readLabel(),writeLabel(),saveUserConfig(), estáticobroadcastLatchGroup(). -
Ejemplo
08_FleetSync(escaneo → sincronización GC → agregación). - Máscara por campo de
RbAmpSnapshot.implausible: un campo que no supera el filtro de coherencia física se pone aNaNy se marca, mientras el resto de la instantánea sigue siendo utilizable (la lectura completa solo falla ante un fallo de transporte).
Modificado
-
La energía se integra con el reloj de pared del maestro, nunca con el
latch_msde diagnóstico del chip (un temporizador de diagnóstico del módulo, no destinado a la energía). Ante un ancla de período obsoleta, la integración se retiene: el siguiente intervalo válido no se subcuenta. -
Los códigos de modelo de CT siguen el conjunto aceptado por clase de la v1.3:
Sct013acepta{005, 010, 030, 050, 100, 020, 060}.REG_CT_MODELes solo preparación: se asocia mediante el comando por canal; las asociaciones multicanal son independientes del orden y nunca sobrescriben el canal 0. -
El cambio de dirección es un commit mágico de dos fases apto para producción; no se requiere el modo de fábrica.
-
La detección de variante lee
REG_HW_VARIANT; la indicación de topología del constructor es ahora una alternativa para el firmware anterior a v1.3. La indicación por defecto esSingle(segura: sin lecturas espurias de canales ausentes). -
Las escrituras I²C comparten ahora la misma disciplina de reintento ante NACK que las lecturas (una escritura de configuración que se pierde en silencio en un bus con contención sería invisible de otro modo).
-
setSensorClass()rechaza en el cliente las clases fuera de la enumeración (el firmware acepta en silencio una clase incorrecta, así que la guarda del cliente es la única salvaguarda).
Notas
-
AVR:
doubletiene 32 bits (==float) en la cadena de herramientas AVR clásica, así que el acumulador de Wh pierde precisión en registros de larga duración: reinícielo periódicamente o use un núcleo condoublede 32/64 bits (ESP32, SAMD, STM32, RP2040). -
Bus marginal / ESP32: el
Wirede Arduino-ESP32 envuelve un driver que puede bloquearse con un bus retenido por debajo del nivel de la biblioteca. Use resistencias de pull-up externas de ~4.7 kΩ adecuadas, evite el depurador/NRST en producción y active un watchdog de tarea a nivel de aplicación en la tarea de sondeo como vía de recuperación.
1.0.0 — Versión inicial
Medición RT de un solo dispositivo (U / I / P / FP / frecuencia RMS), integración de energía por periodo (Wh), configuración del modelo de CT + clase de sensor, y cambio de la dirección I²C.
Fuente e incidencias: rb-amp/rbamp-arduino · esta página en el repositorio: docs/11_changelog.md (v1.6.2)