EasyMonitor

SNMP

Referencia completa de OIDs SNMP

Monitoramento SNMP somente leitura para EasyMonitor e BMS JK. A arvore publica identificacao, dados de pack, celulas, temperaturas, alarmes e capacidade sem permitir alteracoes na BMS.

SNMP nao aceita escrita.

Todos os handlers expostos pelo firmware sao somente leitura. Use API REST ou MQTT para operacoes e configuracoes controladas da BMS.

Conexao e inicio rapido

Versao

SNMP v2c

Transporte

UDP porta 161

Acesso

Community configurada

Ative SNMP em Gerenciar dispositivo > SNMP, defina uma community exclusiva e reinicie o dispositivo quando solicitado. A community padrao de fabrica e public, mas nao deve ser utilizada em redes compartilhadas.

# Percorrer toda a arvore Smart BMS
snmpwalk -v2c -c SUA_COMMUNITY IP_DO_EASYMONITOR .1.3.6.1.2.1.47.1.1.1

# Consultar a tensao do pack
snmpget -v2c -c SUA_COMMUNITY IP_DO_EASYMONITOR .1.3.6.1.2.1.47.1.1.1.2.0.2

Arvore e escalas

.1.3.6.1.2.1.47.1.1.1
├── .1.0.X  Identificacao do EasyMonitor e da BMS
├── .2.0.X  Telemetria consolidada da BMS
└── .2.1.X  Tensao dinamica da celula X
EscalaConversaoExemplo brutoValor real
cVdividir por 100289328.93 V
cAdividir por 100-125-1.25 A
dCdividir por 1032832.8 C
mVdividir por 1000 para V41344.134 V
W, Ah, %sem escala9696 %

Todas as OIDs numericas sao retornadas como inteiros. A escala deve ser aplicada no sistema de supervisao. Corrente e potencia podem ser negativas de acordo com a convencao informada pela BMS.

Identificacao do dispositivo

Ramo base: .1.3.6.1.2.1.47.1.1.1.1.0. Todas as OIDs deste grupo retornam texto.

OIDCampoOrigem / observacao
...1.1.0.1FabricanteValor fixo: TechLabs Technology.
...1.1.0.2SoftwareNome do software instalado.
...1.1.0.3Versao do softwareVersao do firmware TechLabsOS Smart BMS.
...1.1.0.4HardwareModelo ou versao da placa.
...1.1.0.5HostnameHostname do EasyMonitor.
...1.1.0.6IP localEndereco IP observado no inicio do servico SNMP.
...1.1.0.7Endereco MACMAC Wi-Fi do dispositivo.
...1.1.0.8Nome da BMSNome Bluetooth recebido dinamicamente da BMS.
...1.1.0.9Modelo da BMSModelo recebido dinamicamente da BMS.
...1.1.0.10Nome do EasyMonitorNome configurado em Gerenciar dispositivo > Sistema.

Telemetria consolidada da BMS

Ramo base: .1.3.6.1.2.1.47.1.1.1.2.0. Todas as OIDs sao inteiros, exceto ...0.18, que retorna texto.

OIDCampoUnidade / escalaDescricao
...2.0.1BMS online0 ou 10 = offline; 1 = respondendo a telemetria.
...2.0.2Tensao do packcV / 100Tensao total do pack.
...2.0.3Corrente do packcA / 100Pode ser negativa.
...2.0.4Potencia do packWPotencia instantanea arredondada em watts.
...2.0.5SOC%Estado de carga informado pela BMS.
...2.0.6CicloscontagemTotal de ciclos.
...2.0.7Celulas detectadascontagemQuantidade de celulas no frame atual.
...2.0.8Numero da celula minimaindiceCelula com menor tensao, iniciando em 1.
...2.0.9Numero da celula maximaindiceCelula com maior tensao, iniciando em 1.
...2.0.10Tensao minimamV / 1000Menor tensao entre celulas.
...2.0.11Tensao maximamV / 1000Maior tensao entre celulas.
...2.0.12Delta de celulasmVDiferenca entre maior e menor tensao.
...2.0.13Temperatura MOSFETdC / 10Retorna 0 se o sensor nao estiver presente.
...2.0.14Temperatura bateria 1dC / 10Retorna 0 se o sensor nao estiver presente.
...2.0.15Temperatura bateria 2dC / 10Retorna 0 se o sensor nao estiver presente.
...2.0.16Alarmes brutosbitmaskCampo bruto de alarmes JK-BMS. Valor 0 indica nenhum bit ativo.
...2.0.17Capacidade configuradaAhValor arredondado para inteiro.
...2.0.18Tipo de bateriatextoExemplos: Li-ion, LFP e LTO.

Tensao por celula

Ramo: .1.3.6.1.2.1.47.1.1.1.2.1.X. O indice X vai de 1 a 24 e representa o numero fisico da celula. Os handlers sao registrados conforme a quantidade de celulas detectadas pela BMS.

Consulta de uma celula

snmpget -v2c -c SUA_COMMUNITY IP_DO_EASYMONITOR \
.1.3.6.1.2.1.47.1.1.1.2.1.7

# Exemplo: INTEGER: 4127
# 4127 / 1000 = 4.127 V

Descoberta automatica

snmpwalk -v2c -c SUA_COMMUNITY IP_DO_EASYMONITOR \
.1.3.6.1.2.1.47.1.1.1.2.1

Use a OID ...2.0.7 para saber quantas celulas devem ser monitoradas.

O valor e retornado como inteiro em mV. Em plataformas de monitoramento, aplique multiplicador 0.001 para exibir volts. Se uma celula nao constar no frame, o valor armazenado e 0.

Exemplos de integracao

Consultas pontuais

# Estado da BMS
snmpget -v2c -c SUA_COMMUNITY IP .1.3.6.1.2.1.47.1.1.1.2.0.1

# SOC
snmpget -v2c -c SUA_COMMUNITY IP .1.3.6.1.2.1.47.1.1.1.2.0.5

# Temperatura MOSFET
snmpget -v2c -c SUA_COMMUNITY IP .1.3.6.1.2.1.47.1.1.1.2.0.13

Zabbix

O projeto inclui o template zabbix_template_techlabsos_jk_bms_snmp.yaml. Importe-o no Zabbix, associe ao host com interface SNMP v2 e configure a macro de community.

O template aplica automaticamente os multiplicadores de cV, cA, dC e mV e inclui gatilhos iniciais para BMS offline, SOC, tensoes, delta e temperaturas.

Boas praticas e diagnostico

SituacaoVerificacao
Sem resposta SNMPConfirme Wi-Fi, IP, UDP/161, SNMP habilitado e a community. A alteracao da configuracao exige reinicio do EasyMonitor.
BMS online = 0Verifique alimentacao, RS485, configuracao Modbus modo 001 e a conexao fisica com a BMS.
Temperatura igual a 0O firmware usa 0 quando o sensor correspondente nao esta presente; avalie junto do tipo de BMS e instalacao.
Valor de tensao incorretoConfirme se o sistema aplicou o multiplicador correto: pack 0.01, celula 0.001 e temperatura 0.1.
Risco de segurancaSNMP v2c usa community em texto simples. Limite acesso por VLAN, firewall ou VPN e use uma community forte.