Componente SNMP do ESPHome

Esta é a descrição do componente externo do ESPHome que permite suporte para o protocolo SNMP. O protocolo é amplamente utilizado na gestão e monitoramento de redes.

Este componente requer Wi-Fi habilitado. Ele suporta a versão 2c do protocolo. Todos os itens são somente leitura.

# Example configuration entry
snmp:
  contact: Joe
  location: Basement

Variáveis de configuração

• contact (Opcional, string): Valor para o OID sysContact (1.3.6.1.2.1.1.4). O padrão é uma string vazia.
• location (Opcional, string): Valor para o OID sysLocation (1.3.6.1.2.1.1.6). O padrão é uma string vazia.

WARNING

SNMP não é suportado para Ethernet.

Instalação

Adicione a seguinte seção ao seu arquivo de configuração YAML do ESPHome:

external_components:
    # Componente SNMP
    - source: github://aquaticus/esphome-snmp

Lista de OID

OID (Identificador de Objeto) é um endereço usado para identificar unicamente os status.

Sistema

Informações gerais do sistema.

• 1.3.6.1.2.1.1.1 (sysDescr): Descrição do sistema incluindo a versão do firmware e tipo de placa
• 1.3.6.1.2.1.1.2 (sysObjectId): ID do objeto, diferente para ESP32 e ESP8266
• 1.3.6.1.2.1.1.3 (sysUptime): O tempo (em centésimos de segundo) desde que a conexão Wi-Fi foi estabelecida. Se o componente padrão de WiFi for usado, sempre 0.
• 1.3.6.1.2.1.1.4 (sysContact): Identificação da pessoa de contato. Definido pela entrada de configuração contact
• 1.3.6.1.2.1.1.5 (sysName): Nome do nó
• 1.3.6.1.2.1.1.6 (sysLocation): Localização física do nó. Definido pela entrada de configuração location
• 1.3.6.1.2.1.1.7 (sysServices): Conjunto de serviços. Sempre 64.
• 1.3.6.1.2.1.25.1.1 (hrSystemUptime): O tempo desde a inicialização

Para fazer o sysUptime funcionar, você deve usar WiFi estendido. Veja mais aqui: Tempo de atividade da rede.

Armazenamento

Informações sobre FLASH e RAM.

• 1.3.6.1.2.1.25.2.2 (hrMemorySize): A quantidade de memória RAM padrão em kb

FLASH

• 1.3.6.1.2.1.25.2.3.1.1.1: (hrStorageIndex): Sempre 1
• 1.3.6.1.2.1.25.2.3.1.3.1: (hrStorageDesc): Descrição do armazenamento: FLASH
• 1.3.6.1.2.1.25.2.3.1.4.1: (hrAllocationUnit): Sempre 1
• 1.3.6.1.2.1.25.2.3.1.5.1: (hrStorageSize): Tamanho da memória FLASH
• 1.3.6.1.2.1.25.2.3.1.6.1: (hrStorageUsed): Uso da memória FLASH

SPI RAM

Para ESP8266, mostra 0 como tamanho e uso.

• 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex): Sempre 2
• 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc): Descrição do armazenamento: PSI RAM
• 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit): Sempre 1
• 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize): Tamanho da memória SPI RAM
• 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed): Uso da memória SPI RAM

Wi-Fi

Detalhes do sinal Wi-Fi.

• 1.3.9999.4.1.0: RSSI
• 1.3.9999.4.2.0: BSSI
• 1.3.9999.4.3.0: SSID
• 1.3.9999.4.4.0: Endereço IP

Heap do ESP32

Disponível apenas em chips baseados em ESP32.

• 1.3.9999.32.1.0: Tamanho do heap
• 1.3.9999.32.2.0: Heap livre
• 1.3.9999.32.3.0: Heap livre mínimo
• 1.3.9999.32.4.0: Heap alocado máximo

Heap do ESP8266

Disponível apenas para chips ESP8266.

• 1.3.9999.8266.1.0: Heap livre
• 1.3.9999.8266.2.0: Fragmentação do heap em porcentagem
• 1.3.9999.8266.3.0: Tamanho máximo do bloco de heap livre

Chip

Detalhes da CPU.

• 1.3.9999.2.1.0: tipo de chip, 32 para EPS32, 8266 para ESP8266
• 1.3.9999.2.2.0: Clock da CPU
• 1.3.9999.2.3.0: Modelo do chip para ESP32 ou versão do núcleo para ESP8266
• 1.3.9999.2.4.0: Número de núcleos da CPU
• 1.3.9999.2.5.0: Revisão do chip ESP32 ou 0 para ESP8266

Testes

Testes de integração estão disponíveis para este componente: https://github.com/aquaticus/esphome_snmp_tests

Monitoramento de rede

Para um guia prático sobre como monitorar dispositivos ESPHome, veja Monitoramento de rede ESPHome.