rbAmp
PT
Loja
Docs
Atualizado a · Editar no GitHub (Edit on GitHub)

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 banco stdArmBanks() / 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+) devolve RB_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 (imagem 0x0001007B ou 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 classe WiredCT / BuiltinCT nã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 devolvem RB_ERR_PARAM); os testes unitários no anfitrião (extras/host_tests) executam as fontes reais contra um barramento simulado.

  • RbAmpStdEnergy ganhou 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 novos readReactivePower() / 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()) devolvem RB_ERR_NOT_IMPLEMENTED numa 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 como RB_ERR_PARAM (o canal mantém o modelo anterior).

  • readCTModelCh() abrange todos os canais.

  • Registo gerado de modelos de sensores RbAmpSensorModels.h (defines RBAMP_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_CHANNELS aumentado de 3 para 7. Os esboços existentes que usam arrays de RbAmpSnapshot vã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_MultiModuleBroadcast reescrito 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() e provision() 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) e readCTModelCh() (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 como NaN e 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_ms de 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 — Sct013 aceita {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: double tem 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 com double de 32/64 bits (ESP32, SAMD, STM32, RP2040).

  • Barramento marginal / ESP32: o Wire do 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)