Transporte I²C
O módulo é um escravo I²C com o mapa de registos completo. Endereço I²C de 7 bits por defeito 0x50 (configurável, ver abaixo). A velocidade de barramento recomendada é 50 kHz em anfitriões ESP32 e ESP8266 e 100 kHz noutros anfitriões (não 400 kHz); o escravo suporta alongamento de relógio e o mestre tem de o tolerar (ver limites abaixo).
O transporte ativo (I²C ou Modbus RTU) é selecionado uma vez por arranque pelo comutador de modo de interface — ver Interface de hardware. Na definição I²C o espaço de registos Modbus não é servido, e vice-versa; os comandos e os dados são os mesmos em ambos.
Ponteiro de registo
- Apontador de registo de 16 bits, big-endian no fio (byte alto primeiro), com incremento automático.
-
Escrita: o mestre envia 2 bytes de ponteiro (alto, baixo), depois um fluxo de dados; cada byte de dados cai no ponteiro, que incrementa após a escrita.
-
Leitura: o mestre escreve os 2 bytes do ponteiro, depois emite um start repetido e lê; os bytes saem a partir do ponteiro com incremento automático.
-
Os campos de vários bytes são little-endian e endereçados por byte — sem exigência de alinhamento no barramento; um mestre pode ler qualquer campo como N bytes little-endian a partir do seu endereço, numa transação ou em várias.
-
Endereços não mapeados: as leituras devolvem
0xFF, as escritas são ignoradas. Os endereços de blocos de canal com índice ≥N_CURRENT/N_VOLTAGEnão são especificados — condicione pelas contagens, não os interprete.
Não existe sondagem ao nível do barramento para endereçamento de 8 vs 16 bits (um dispositivo de 8 bits leria o segundo byte do apontador como dados). Um mestre conhece a convenção pela linha de produtos; a assinatura STD após uma leitura de 16 bits de 0x0000 é 'S','T' + VERSION ≥ 0x30 + bit 9 de CAPABILITIES.
Temporização e robustez
-
Prontidão após reinício: a interface de registos fica pronta em milissegundos após um reinício, antes do caminho de medição — o módulo responde no barramento mesmo enquanto o caminho do sensor ainda está a arrancar. Após um reinício de ativação de firmware, aguarde ~4 s antes de o dispositivo reaparecer.
-
Clock stretching: normalmente insignificante; durante operações de escrita de flash na atualização de firmware, o escravo pode manter o SCL até ≈9 ms. Configure o tempo limite de SCL do mestre para ≥10 ms, caso contrário as repetições ficam registadas durante a OTA (os dados não ficam corrompidos — a transação apenas espera).
-
Durante as escritas em flash disparadas por comandos (gravar configuração/calibração, programação de páginas OTA) o escravo também pode não confirmar brevemente. Repita até decorrer o tempo de estabilização do comando, em vez de abortar à primeira falta de confirmação (ver Comandos para os tempos de estabilização).
-
Coerência: cada transação de leitura é servida a partir de um instantâneo coerente de 128 bytes tirado quando o endereço do registo é definido — os campos lidos numa transação de até 128 bytes são de uma só publicação e não se podem separar (é assim que se leem campos de energia i64 e blocos inteiros). Os campos lidos em transações separadas podem vir de janelas diferentes. Para detetar um reinício do módulo entre leituras, verifique a monotonia de
FRAME_CNT(0x0020) e deBOOT_COUNT(0x00CE).
Alterar o endereço I²C
Dois caminhos:
Direto (endereço conhecido):
- Escreva o novo endereço I²C de 7 bits (0x08..0x77) em
CFG_I2C_ADDR(0x0073). -
COMMAND= 0x04 (SAVE_CONFIG) — validado; um endereço inválido é recusado comERROR0xFD e nada é gravado. As gravações têm limite de frequência: uma repetição dentro de ~5 s responde 0xF9 — tente mais tarde. Aguarde BUSY = 0 eERROR= 0 antes do passo seguinte. -
COMMAND= 0x02 (RESET). O endereço aplica-se no reinício; o dispositivo volta a enumerar-se no novo endereço em ~1 s.
⚠ Após o reset todos os mestres do barramento têm de passar para o novo endereço; planeie isto como uma operação de instalação, não de rotina.
Por UID (vários módulos num endereço por defeito): escreva o UID de 12 bytes do módulo-alvo em ADDR_UID (0x00E0), o novo endereço I²C em ADDR_UID_I2C (0x00EC, 0 = manter) e/ou o novo id de unidade Modbus em ADDR_UID_UNIT (0x00ED, 0 = manter), depois COMMAND = 0x16 (ADDR_BY_UID). Só o módulo cujo UID coincide persiste a alteração — juntamente com quaisquer outros valores CFG_ pendentes, como num SAVE_CONFIG — e reinicia; todos os outros módulos ignoram o comando (ERROR 0xFC aí). Também aceite num broadcast Modbus — ver Transporte Modbus. Ambos os campos de novo endereço a zero → 0xFD; endereço ilegal → 0xFD; limite de frequência de gravação → 0xF9. Passo a passo: Sequências D4.