rbAmp
PT
Loja
Docs
Atualizado

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_VOLTAGE nã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 de BOOT_COUNT (0x00CE).

Alterar o endereço I²C

Dois caminhos:

Direto (endereço conhecido):

  1. Escreva o novo endereço I²C de 7 bits (0x08..0x77) em CFG_I2C_ADDR (0x0073).
  2. COMMAND = 0x04 (SAVE_CONFIG) — validado; um endereço inválido é recusado com ERROR 0xFD 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 e ERROR = 0 antes do passo seguinte.

  3. COMMAND = 0x02 (RESET). O endereço aplica-se no reinício; o dispositivo volta a enumerar-se no novo endereço em ~1 s.

Segurança

⚠ 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.