Componente SNMP de ESPHome

Esta es la descripción del componente externo de ESPHome que habilita el soporte para el protocolo SNMP. El protocolo es ampliamente utilizado en la gestión y monitoreo de redes.

Este componente requiere que el Wi-Fi esté habilitado. Soporta la versión 2c del protocolo. Todos los elementos son de solo lectura.

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

Variables de configuración

• contact (Opcional, cadena): Valor para sysContact (1.3.6.1.2.1.1.4) OID. Por defecto es una cadena vacía.
• location (Opcional, cadena): Valor para sysLocation (1.3.6.1.2.1.1.6) OID. Por defecto es una cadena vacía.

WARNING

SNMP no es compatible con Ethernet.

Instalación

Agrega la siguiente sección a tu archivo de configuración YAML de ESPHome:

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

Lista de OID

OID (Identificador de Objeto) es una dirección utilizada para identificar de manera única los estados.

Sistema

Información general del sistema.

• 1.3.6.1.2.1.1.1 (sysDescr): Descripción del sistema, incluyendo la versión del firmware y el tipo de placa
• 1.3.6.1.2.1.1.2 (sysObjectId): ID del objeto, diferente para ESP32 y ESP8266
• 1.3.6.1.2.1.1.3 (sysUptime): El tiempo (en centésimas de segundo) desde que se estableció la conexión Wi-Fi. Si se utiliza el componente estándar de WiFi, siempre es 0.
• 1.3.6.1.2.1.1.4 (sysContact): Identificación de la persona de contacto. Establecido por la entrada de configuración contact
• 1.3.6.1.2.1.1.5 (sysName): Nombre del nodo
• 1.3.6.1.2.1.1.6 (sysLocation): Ubicación física del nodo. Establecido por la entrada de configuración location
• 1.3.6.1.2.1.1.7 (sysServices): Conjunto de servicios. Siempre 64.
• 1.3.6.1.2.1.25.1.1 (hrSystemUptime): La cantidad de tiempo desde el arranque

Para que sysUptime funcione, debes usar WiFi extendido. Ver más aquí: Tiempo de actividad de la red.

Almacenamiento

Información sobre FLASH y RAM.

• 1.3.6.1.2.1.25.2.2 (hrMemorySize): La cantidad de memoria RAM estándar en kb

FLASH

• 1.3.6.1.2.1.25.2.3.1.1.1: (hrStorageIndex): Siempre 1
• 1.3.6.1.2.1.25.2.3.1.3.1: (hrStorageDesc): Descripción del almacenamiento: FLASH
• 1.3.6.1.2.1.25.2.3.1.4.1: (hrAllocationUnit): Siempre 1
• 1.3.6.1.2.1.25.2.3.1.5.1: (hrStorageSize): Tamaño de la memoria FLASH
• 1.3.6.1.2.1.25.2.3.1.6.1: (hrStorageUsed): Uso de la memoria FLASH

RAM SPI

Para ESP8266 muestra 0 como tamaño y uso.

• 1.3.6.1.2.1.25.2.3.1.1.2: (hrStorageIndex): Siempre 2
• 1.3.6.1.2.1.25.2.3.1.3.2: (hrStorageDesc): Descripción del almacenamiento: PSI RAM
• 1.3.6.1.2.1.25.2.3.1.4.2: (hrAllocationUnit): Siempre 1
• 1.3.6.1.2.1.25.2.3.1.5.2: (hrStorageSize): Tamaño de la memoria SPI RAM
• 1.3.6.1.2.1.25.2.3.1.6.2: (hrStorageUsed): Uso de la memoria SPI RAM

Wi-Fi

Detalles de la señal 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: Dirección IP

Heap ESP32

Disponible solo en chips basados en ESP32.

• 1.3.9999.32.1.0: Tamaño del heap
• 1.3.9999.32.2.0: Heap libre
• 1.3.9999.32.3.0: Mínimo heap libre
• 1.3.9999.32.4.0: Máximo heap asignado

Heap ESP8266

Disponible solo para chips ESP8266.

• 1.3.9999.8266.1.0: Heap libre
• 1.3.9999.8266.2.0: Fragmentación del heap en porcentajes
• 1.3.9999.8266.3.0: Tamaño máximo del bloque de heap libre

Chip

Detalles de la CPU.

• 1.3.9999.2.1.0: tipo de chip, 32 para EPS32, 8266 para ESP8266
• 1.3.9999.2.2.0: Reloj de la CPU
• 1.3.9999.2.3.0: Modelo de chip para ESP32 o versión del núcleo para ESP8266
• 1.3.9999.2.4.0: Número de núcleos de CPU
• 1.3.9999.2.5.0: Revisión del chip ESP32 o 0 para ESP8266

Pruebas

Pruebas de integración están disponibles para este componente: https://github.com/aquaticus/esphome_snmp_tests

Monitoreo de red

Para una guía práctica sobre cómo monitorear dispositivos ESPHome, consulte Monitoreo de red ESPHome.