11 · Registo de alterações
O histórico completo e detalhado está em CHANGELOG.md na raiz do repositório; este capítulo mantém a versão resumida.
1.6.2 — A energia STD fica nos contadores, linhas do registo de modelos, erro de módulo bloqueado
-
STD, imagens com contadores e bancos de latch: um módulo deste tipo passa agora a manter
readPeriodSnapshot()/energy()nos seus contadores persistidos (antes, mudava silenciosamente para energia integrada no host a partir do banco 0). As chamadas de bancostdArmBanks()/stdLatch()/stdReadLatch()continuam disponíveis e dependem apenas da capacidade de banco. A biblioteca 1.6.2 é o mínimo para uma imagem deste tipo; ver Fonte de energia e versão mínima da biblioteca. -
Novo exemplo
12_StdBanks: dois períodos temporizados pelo mestre nos respetivos bancos de instantâneos. -
Registo de modelos de sensores: as pinças 2000:1 de 50 A (código 11) e 100 A (código 13) são aceites.
-
setCTModelChForce()num módulo BASIC emparelhado de fábrica fora do modo de fábrica (firmware 1.4.22+) devolveRB_ERR_MODE("configuração bloqueada") e não grava nada; uma escrita forçada funciona apenas em modo de fábrica.
1.6.1 — Energia de micro-resolução STD, correção da classificação SCT-013, guarda de configuração do sensor
Lançado em conjunto com a 1.6.0 (a linha STD) como a primeira versão pública da biblioteca de duas linhas.
-
Linha STD: contadores de energia de micro-resolução (µWh / µvarh), a corrente de arranque para a energia (
stdSetEnergyStartCurrent()/stdReadEnergyStartCurrent()), o ângulo de fase de tensão (RbAmpStdVoltage::angle_deg) e a sequência de fases (stdReadPhaseSequence()) — para módulos cuja imagem os publica (imagem0x0001007Bou posterior); os módulos mais antigos comportam-se exatamente como antes.stdEnergyDelta()cobre os novos campos. -
Linha BASIC — correção de calibre SCT-013: no firmware até 1.4.19, um canal comutado para outro modelo SCT-013 é lido em relação ao ganho que o módulo aplica.
begin()lê cada canal e escala a corrente / potência / potência de período (e a energia derivada); o fator de potência e a tensão não mudam. Novo:sctRatingRefresh(),sctRating(),sctRatingScale(),sctPresetGain(). O firmware 1.4.20 e posteriores corrige-se a si próprio. Os setters de modelo reiniciam o módulo após a gravação no firmware que o exige (~0.5 s extra por chamada). -
Os setters de classe de sensor / modelo de TC leem antes de escrever (
setSensorClass(),setCTModel(),configureChannels()): uma configuração guardada pode ser reaplicada em cada arranque sem tocar na calibração do módulo. Um módulo de classeWiredCT/BuiltinCTnão é reconfigurado (RB_ERR_MODE);setCTModelChForce()é o caminho de assistência técnica. Novo:readSensorClass(),RbAmp::sensorModel()/RbAmp::sensorModelRatedA()(consultas no registo com os limites atuais do modelo). -
SCT-013-060 e -100 são aceites (antes eram recusados do lado do cliente por estarem reservados); os limites de corte do modelo de sensor foram atualizados para os valores medidos.
-
Ambas as linhas: a janela de medição / cadência de publicação está documentada como 100 ms (200 ms mantido apenas como nota para imagens antigas); o número de canais nunca pode exceder
RBAMP_MAX_CHANNELS(os canais acima devolvemRB_ERR_PARAM); os testes unitários no anfitrião (extras/host_tests) executam as fontes reais contra um barramento simulado. -
RbAmpStdEnergyganhou campos nesta versão: se a sua aplicação o guardar como blob binário bruto, guarde apenas os campos de que precisa num formato próprio e fixo.
1.6.0 — Linha STD (modelo de registos de 16 bits)
Uma biblioteca, duas linhas de produto: begin() deteta se o módulo fala o modelo de registos BASIC (8 bits) ou STD (16 bits, vírgula fixa) e encaminha cada chamada internamente — a superfície de métodos é a mesma em ambas as linhas.
-
line()(RbAmpLine::Basic/RbAmpLine::Std); leitores unificados na STD (readVoltage(phase),readCurrent(),readPower()…) mais os novosreadReactivePower()/readApparentPower()(apenas STD). -
A API de blocos STD:
stdInfo(),stdReadChannel(),stdReadTotals(),stdReadVoltage(),stdReadHealth(),stdReadConfig(),stdSetHarmonics(),stdCalThdFloor(); bancos de latch (stdArmBanks(),stdLatch(),stdReadLatch(),stdLatchWh()); contadores de vida útil (stdReadEnergy(),stdEnergyDelta()). -
A fonte do período é escolhida a partir das capacidades do módulo (bancos de latch ou contadores persistidos); a energia de latch sobrevive a um reinício do módulo; o instantâneo do período ganhou
avg_p_total,wh_net,module_restarted. -
Identidade, relógio, histórico:
stdIdentify(),RbAmp::stdProbe(),stdReadImageVersion(),stdReadBoardId(),stdSetTime()/stdReadTime(),stdHistInfo()/stdHistRead()/stdHistReadRaw()/stdEventRead()/stdHistFlush(),stdCommand()/stdWaitIdle()/stdLocate(),RbAmp::stdSetAddressByUid(). -
A configuração e os comandos funcionam na STD (
setSensorClass(),setCTModel(),configureChannels(),saveUserConfig(),saveGains(), alteração de endereço); cada comando aguarda que o módulo indique que terminou e verifica o seu veredito. Na STD o modelo de TC é apenas uma etiqueta de referência. -
Atualização de firmware por I²C:
stdOtaBegin()→stdOtaWritePage()→stdOtaCommit()→stdOtaActivate(),stdOtaWritePreparedImage()(imagens preparadas pelo fabricante),stdOtaDiag(),stdOtaAbort(),stdOtaBoardOk(). -
Linha de dados pronta e eventos nas duas linhas:
setDrdyPin(),waitDataReady(),readAllReady(),readDataSeq(),beginEventFlags(),setEventMask()/readEventMask(),setEventThresholds();readEventFlags()/clearEventFlags()/hasError()funcionam em módulos STD que disponibilizam o bloco de eventos. -
As chamadas exclusivas do BASIC (
factoryReset(), auxiliares General-Call e de etiqueta,readCapability(),readCommitSeq(),readPeriodLatchMs()) devolvemRB_ERR_NOT_IMPLEMENTEDnuma instância STD. Sem alteração na API BASIC. -
Exemplo
11_StdLine.
1.5.0 — Modelos de TC por canal + registo de modelos de sensor
-
setCTModel(channel, code)/configureChannels()associam qualquer canal, incluindo os canais 3+ do SKU superior (através da janela de canais); cada escrita é confirmada por uma leitura de verificação, e um modelo que o módulo não aceita é reportado comoRB_ERR_PARAM(o canal mantém o modelo anterior). -
readCTModelCh()abrange todos os canais. -
Registo gerado de modelos de sensores
RbAmpSensorModels.h(definesRBAMP_CT_*, descritores,rbamp_sensor_model_lookup()); a validação do modelo de TC é orientada pelo registo (o cliente só rejeita códigos ausentes do registo — a aceitação é decidida pelo módulo).RbAmpCTModelé um alias congelado para os sete códigos SCT-013. -
A variante CT / a classe do sensor passam agora a persistir em módulos de produção (
CMD_SAVE_USER_CONFIG). -
Exemplo
10_PerChannelModels.
1.4.0 — Suporte às SKU sénior (UI5/UI7)
Acrescenta suporte aos módulos de 7 canais da SKU sénior (UI5, UI7) e atualiza o exemplo de difusão GC. Verificado em silício numa frota heterogénea (UI1/UI2/UI3/UI5/UI7), contrato de firmware bd2ad8e.
Adicionado
-
Exemplo
09_SeniorSku— consulta de 7 canais + integração de energia para os módulos UI5/UI7. -
readCommitSeq()— leitura do número de sequência de commit do firmware.
Alterado
-
RBAMP_MAX_CHANNELSaumentado de 3 para 7. Os esboços existentes que usam arrays deRbAmpSnapshotvão crescer — é necessário recompilar (não são precisas alterações ao código, salvo se tiver tamanhos de array fixos no código). -
03_MultiModuleBroadcastreescrito para a difusão General-Call latch da v1.3 (a sincronização coerente numa só trama substitui o antigo latch sequencial por dispositivo). -
Cabeçalhos de registos regenerados (contrato v1.4.0).
- Energia/Instantâneo: crescimento do array das SKU sénior + despacho por número de canais.
1.3.0 — Frota + protocolo v1.3
Alinhou a biblioteca Arduino com o contrato de fio rbAmp v1.3 e com o modelo de referência multiplataforma (STM32 HAL / ESP-IDF / Python). Validado em hardware numa frota heterogénea (UI1 + I2 + I3) através da API pública, com verdade de terreno em registos brutos (suite de cobertura total 38/38 + ensaio prolongado com WDT da aplicação).
Adicionado
-
RbAmpFleet— gestor multimódulo:scan()do barramento (com deteção de colisões),pollAll()em lote,totalPower()/totalEnergyWh()/pollErrors()à escala da frota, sincronização General-Call (enableGcAll()/gcLatch()/checkSync()),assignAddress(),checkConflict()eprovision()para pôr um módulo de fábrica no barramento. -
Identidade / capacidade:
readVariant(),readCapability(),readProductId(),readUid(). -
Canal de eventos:
readEventFlags(),clearEventFlags(),hasError(),clearError(),readLastError(). -
Configuração de TC por canal:
configureChannels()(em lote, uma gravação na flash) ereadCTModelCh()(leitura do espelho do modelo aplicado). -
Primitivas de frota no dispositivo:
enableGc(),setGroupId(),readGroupId(),readGcTick(),readFleetConfig(),readLabel(),writeLabel(),saveUserConfig(),broadcastLatchGroup()estático. -
Exemplo
08_FleetSync(varrimento → sincronização GC → agregação). - Máscara por campo de
RbAmpSnapshot.implausible: um campo que falha o filtro de sanidade física é definido comoNaNe assinalado, enquanto o resto do instantâneo continua utilizável (a leitura completa só falha numa falha de transporte).
Alterado
-
A energia é integrada contra o relógio de parede do master, nunca contra o
latch_msde diagnóstico do chip (um temporizador de diagnóstico do módulo, não para a energia). Numa âncora de período desatualizada, a integração fica retida — a janela válida seguinte não é subcontada. -
Os códigos de modelo de TC seguem o conjunto aceite por classe da v1.3 —
Sct013aceita{005, 010, 030, 050, 100, 020, 060}.REG_CT_MODELé apenas preparação: associe através do comando por canal; as associações multicanal são independentes da ordem e nunca sobrepõem o canal 0. -
A alteração de endereço é um commit em duas fases, aprovado para produção; o modo de fábrica não é necessário.
-
A deteção de variante lê
REG_HW_VARIANT; a sugestão de topologia do construtor passa agora a ser uma alternativa para o firmware anterior à v1.3. A sugestão predefinida éSingle(segura — sem leituras espúrias de canais ausentes). -
As escritas I²C partilham agora a mesma disciplina de repetição de NACK das leituras (uma escrita de configuração que cai em silêncio num barramento disputado seria, de outro modo, invisível).
-
setSensorClass()rejeita classes fora do enum do lado do cliente (o firmware aceita silenciosamente uma classe má, pelo que a guarda do cliente é a única salvaguarda).
Notas
-
AVR:
doubletem 32 bits (==float) na toolchain AVR clássica, pelo que o acumulador de Wh perde precisão em registos de longa duração — reponha-o periodicamente ou use um core comdoublede 32/64 bits (ESP32, SAMD, STM32, RP2040). -
Barramento marginal / ESP32: o
Wiredo Arduino-ESP32 envolve um driver que pode bloquear num barramento retido abaixo do nível da biblioteca. Use pull-ups externos de ~4.7 kΩ adequados, evite o depurador/NRST em produção e arme um watchdog de tarefa ao nível da aplicação na tarefa de consulta como caminho de recuperação.
1.0.0 — Versão inicial
Medição RT de um único dispositivo (U / I / P / PF / frequência eficazes RMS), integração de energia por período (Wh), configuração de modelo de TC + classe do sensor, e alteração do endereço I²C.
Fonte e problemas: rb-amp/rbamp-arduino · esta página no repositório: docs/11_changelog.md (v1.6.2)