EasyMonitor

SNMP

Referência completa de OIDs SNMP

Monitoramento SNMP somente leitura para EasyMonitor e BMS JK. A arvore pública identificação, dados de pack, células, temperaturas, alarmes e capacidade sem permitir alterações na BMS.

SNMP não aceita escrita.

Todos os handlers expostos pelo firmware são somente leitura. Use API REST ou MQTT para operações e configurações controladas da BMS.

Conexão e início rápido

Versão

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 padrão de fábrica e public, mas não deve ser utilizada em redes compartilhadas.

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

# Consultar a tensão 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  Identificação do EasyMonitor e da BMS
├── .2.0.X  Telemetria consolidada da BMS
└── .2.1.X  Tensão dinâmica da célula X
EscalaConversãoExemplo 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 numéricas são retornadas como inteiros. A escala deve ser aplicada no sistema de supervisão. Corrente e potência podem ser negativas de acordo com a convenção informada pela BMS.

Identificação do dispositivo

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

OIDCampoOrigem / observação
...1.1.0.1FabricanteValor fixo: TechLabs Technology.
...1.1.0.2SoftwareNome do software instalado.
...1.1.0.3Versão do softwareVersão do firmware TechLabsOS Smart BMS.
...1.1.0.4HardwareModelo ou versão da placa.
...1.1.0.5HostnameHostname do EasyMonitor.
...1.1.0.6IP localEndereço IP observado no início do serviço SNMP.
...1.1.0.7Endereço 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.
...1.1.0.11Transporte da BMSSerial RS485 ou Bluetooth JK02, conforme a conexão ativa.

Telemetria consolidada da BMS

Ramo base: .1.3.6.1.2.1.47.1.1.1.2.0. Todas as OIDs são inteiros, exceto ...0.18, que retorna texto.

OIDCampoUnidade / escalaDescrição
...2.0.1BMS online0 ou 10 = offline; 1 = respondendo a telemetria.
...2.0.2Tensão do packcV / 100Tensão total do pack.
...2.0.3Corrente do packcA / 100Pode ser negativa.
...2.0.4Potência do packWPotência instantânea arredondada em watts.
...2.0.5SOC%Estado de carga informado pela BMS.
...2.0.6CicloscontagemTotal de ciclos.
...2.0.7Células detectadascontagemQuantidade de células no frame atual.
...2.0.8Número da célula mínimaíndiceCélula com menor tensão, iniciando em 1.
...2.0.9Número da célula máximaíndiceCélula com maior tensão, iniciando em 1.
...2.0.10Tensão mínimamV / 1000Menor tensão entre células.
...2.0.11Tensão máximamV / 1000Maior tensão entre células.
...2.0.12Delta de célulasmVDiferença entre maior e menor tensão.
...2.0.13Temperatura MOSFETdC / 10Retorna 0 se o sensor não estiver presente.
...2.0.14Temperatura bateria 1dC / 10Retorna 0 se o sensor não estiver presente.
...2.0.15Temperatura bateria 2dC / 10Retorna 0 se o sensor não 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.

Tensão por célula

Ramo: .1.3.6.1.2.1.47.1.1.1.2.1.X. O índice X vai de 1 a 24 e representa o número físico da célula. Os handlers são registrados conforme a quantidade de células detectadas pela BMS.

Consulta de uma célula

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 células devem ser monitoradas.

O valor é retornado como inteiro em mV. Em plataformas de monitoramento, aplique multiplicador 0.001 para exibir volts. Se uma célula não constar no frame, o valor armazenado é 0.

Exemplos de integração

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, tensões, delta e temperaturas.

Boas práticas e diagnóstico

SituaçãoVerificação
Sem resposta SNMPConfirme Wi-Fi, IP, UDP/161, SNMP habilitado e a community. A alteração da configuração exige reinício do EasyMonitor.
BMS online = 0Verifique alimentação, RS485, configuração Modbus modo 001 e a conexão física com a BMS.
Temperatura igual a 0O firmware usa 0 quando o sensor correspondente não está presente; avalie junto do tipo de BMS e instalação.
Valor de tensão incorretoConfirme se o sistema aplicou o multiplicador correto: pack 0.01, célula 0.001 e temperatura 0.1.
Risco de segurançaSNMP v2c usa community em texto simples. Limite acesso por VLAN, firewall ou VPN e use uma community forte.