Aparência
Métricas coletadas
Os adapters Solis e SAJ R6 produzem as oito grandezas abaixo. Uma chave MQTT é o nome usado na mensagem para identificar cada métrica. Para uma introdução sem programação, leia dados coletados.
| Chave MQTT | Unidade | Grandeza | Cuidado |
|---|---|---|---|
| power_w | W | Potência ativa de saída | Instantânea; não é energia |
| energy_today_kwh | kWh | Energia acumulada no dia | Não somar todas as amostras |
| energy_total_kwh | kWh | Contador total do equipamento | Verificar resets e cobertura |
| grid_voltage_v | V | Uma tensão AC | Confirmar fase/linha |
| pv1_voltage_v | V | Tensão PV1 | Não representa todas as entradas |
| pv1_current_a | A | Corrente PV1 | Canal comparável depende da topologia |
| internal_temp_c | °C | Temperatura informada | Sensor/modelo importam |
| status_raw | Código | Estado bruto | Dicionários diferentes entre marcas |
Referência técnica: origem nos adapters
| Métrica | Solis: endereço do mapa | SAJ: endereço usado |
|---|---|---|
| Potência | 3005–3006 | 0x601D–0x601E |
| Energia diária | 3015; escala 0,1 | 0x600A–0x600B; escala 0,01 |
| Energia total | 3009–3010 | 0x6004–0x6005; escala 0,01 |
| Tensão AC | 3034; escala 0,1 | 0x6022; escala 0,1 |
| PV1 tensão | 3022; escala 0,1 | 0x6045; escala 0,1 |
| PV1 corrente | 3023; escala 0,1 | 0x6046; escala 0,01 |
| Temperatura | 3042; escala 0,1 | 0x6038; inteiro com sinal e escala 0,1 |
| Estado | 3044 | 0x6013 |
Os endereços são referência de interpretação, não uma instrução para executar diagnóstico. O Solis aplica offset -1; não transferir essa regra ao SAJ.
Ausência, tempo e catálogo
Campos opcionais ausentes no mapper não geram uma amostra zero. measuredAt representa o instante atribuído à medição; receivedAt, a chegada à ingestão. No coletor atual, ts é produzido pelo relógio da aplicação após a leitura, não por leitura comprovada do relógio interno do inversor.
A unidade é inferida pelo sufixo na descoberta da métrica. Depois pode ser revisada no Admin. Alterar o rótulo de unidade não converte valores históricos.
Cobertura da coleta
A tensão AC corresponde a uma única leitura; PV1 corresponde ao primeiro canal DC monitorado. Frequência, demais fases/entradas, potência reativa e aparente não fazem parte do conjunto coletado. O código de estado permanece específico do fabricante. Veja escopo e limitações.
Veja a interpretação das grandezas elétricas e a normalização entre fabricantes.
Revisão editorial: 07/10/2026. Base: SolisAdapter.ts, SajR6Adapter.ts, mapper.ts e contract.ts.