Skip to content
ESPHome

WiFi ESPHome

El componente WiFi ESPHome configura conexiones WiFi a puntos de acceso. Debe tener una configuración de red Wifi o ESPHome fallará en la etapa de validación de la configuración. Tampoco puede tener la configuración de Wifi y Ethernet al mismo tiempo (incluso si su ESP tiene ambos cableados).

Se recomienda proporcionar una IP estática para su nodo, ya que puede mejorar drásticamente los tiempos de conexión.

# Ejemplo de configuración básica
wifi:
  ssid: MiConexión
  password: elpassworddemiconexión

# Opcionalmente, puede configurar una ip estática.
  manual_ip:
    static_ip: 192.168.0.123
    gateway: 192.168.0.1
    subnet: 255.255.255.0

# Se recomienda usar el archivo secrets
wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
Índice de contenido

    Variables de configuración: 

    • ssid (opcional, cadena): el nombre (o identificador del conjunto de servicios) del punto de acceso WiFi al que debe conectarse su dispositivo.
    • password (opcional, cadena): la contraseña (o PSK) para su red WiFi. Deje vacío para ninguna contraseña.
    • networks (Opcional): Configure múltiples redes WiFi para conectarse, se conectará a la mejor que sea accesible. 
    • manual_ip (Opcional): Configure manualmente la IP estática del nodo.
      • static_ip (Requerido, dirección IPv4): La IP estática de su nodo.
      • gateway de enlace (Obligatorio, dirección IPv4): La puerta de enlace de la red local.
      • subned (Obligatorio, dirección IPv4): La subred de la red local.
      • dns1 (opcional, dirección IPv4): el servidor DNS principal que se utilizará.
      • dns2 (opcional, dirección IPv4): el servidor DNS de respaldo que se usará.
    • use_address (opcional, cadena): invalide manualmente qué dirección usar para conectarse al ESP. El valor predeterminado es el valor generado automáticamente. Ejemplo, si ha cambiado su IP estática y desea flashear OTA a la dirección IP previamente configurada.
    • ap (opcional): habilite un modo de punto de acceso en el nodo.
      • ssid (Opcional, cadena): El nombre del punto de acceso a crear. Deje vacío para usar el nombre del dispositivo.
      • password (Opcional, cadena): La contraseña para el punto de acceso. Deje vacío para ninguna contraseña.
      • channel (Opcional, int): El canal en el que el AP debe operar del 1 al 14. El valor predeterminado es 1.
      • manual_ip (Opcional): Configure manualmente las opciones de IP para el AP. Mismas opciones que manual_ip para modo estación.
      • ap_timeout (opcional, tiempo): el tiempo después del cual se habilita el punto de acceso alternativo configurado. El valor predeterminado es 1min.

    Más variables de configuración

    • domain (opcional, cadena): establezca el dominio del nombre de host del nodo utilizado para cargar. Por ejemplo, si se establece en. local, todas las cargas se enviarán a <HOSTNAME>.local. El valor predeterminado es. local.
    • reboot_timeout (opcional, tiempo): la cantidad de tiempo de espera antes de reiniciar cuando no existe una conexión WiFi. Se puede deshabilitar configurando esto en 0s, pero tenga en cuenta que la pila de IP de bajo nivel actualmente parece tener problemas con WiFi donde se requiere un reinicio completo para que la interfaz vuelva a funcionar. El valor predeterminado es 15min.
    • power_save_mode (opcional, cadena): el modo de ahorro de energía para la interfaz WiFi. 
    • output_power (opcional, cadena): la cantidad de potencia de TX para la interfaz WiFi de 8,5 dB a 20,5 dB. El valor predeterminado para ESP8266 es 20dB, 20,5dB pueden causar reinicios inesperados.
    • fast_connect (opcional, booleano): si está habilitado, se conecta directamente a la red WiFi sin realizar primero un escaneo completo. Esto es necesario para redes ocultas y puede mejorar significativamente los tiempos de conexión. El valor predeterminado es off. La desventaja es que esta opción se conecta a la primera red que ve el ESP, incluso si esa red está muy lejos y hay mejores disponibles.
    • id (opcional, ID): especificar de forma manual el ID que ha utilizado para la generación de código.

    Modo de punto de acceso 

    ESPHome tiene un «Modo de punto de acceso» opcional. Si incluye ap: en su configuración wifi, ESPHome configurará automáticamente un punto de acceso al que puede conectarse. Además, puede especificar un modo de estación «normal» y un modo AP al mismo tiempo. Esto hará que ESPHome solo habilite el punto de acceso cuando no se pueda establecer una conexión con el enrutador WiFi.

    wifi: 
 ap:
    ssid: "Kitchen Fallback Hotspot"
    password: "nTYsMKQ0e8Jq"

    También puede crear una configuración ap simple que configurará el punto de acceso para que el nombre de los dispositivos sea el ssid sin contraseña.

    wifi:
  ap: {}

# o si aún desea que la aplicación tenga una contraseña

wifi:
  ap:
    password: "nTYsMKQ0e8Jq"

    IP manuales WiFi ESPHome

    Si tiene problemas con su nodo que no se conecta a WiFi o si el proceso de conexión tarda mucho, puede ser una buena idea asignar una dirección IP estática al ESP. De esta forma, el ESP no necesita pasar por el lento proceso de DHCP.

    Puedes hacerlo con la manual_ip:opción en la configuración WiFi.

    wifi:
  # ...
  manual_ip:
    # Establezca esto en la IP del ESP
    static_ip: 10.0.0.42
    # Establezca esto en la dirección IP del enrutador. A menudo termina con .1h .1
    gateway: 10.0.0.1
    # La subred de la red. 255.255.255.0 funciona para la mayoría de las redes domésticas.
    subnet: 255.255.255.0

    Después de poner una IP manual en su configuración, el ESP ya no necesitará negociar una dirección IP dinámica con el enrutador, mejorando así el tiempo hasta la conexión.

    Además, esto puede ayudar con las actualizaciones por aire si, por ejemplo, la red doméstica no permite las .localdirecciones. Cuando una IP manual está en su configuración, el proceso OTA la elegirá automáticamente como destino para la carga.

    Modo de ahorro de energía 

    La interfaz WiFi de todos los ESP ofrece tres modos de ahorro de energía para reducir la cantidad de energía gastada en WiFi. Si bien algunas opciones pueden reducir el uso de energía del ESP, generalmente también disminuyen la confiabilidad de la conexión WiFi, con desconexiones frecuentes del enrutador en el modo de ahorro de energía más alto.

    • NONE (menos ahorro de energía, predeterminado para ESP8266)
    • LIGHT (Predeterminado para ESP32)
    • HIGH (Más ahorro de energía)
    wifi:
  # ...
  power_save_mode: none

    Conexión a Múltiples Redes – WiFi ESPHome

    A partir de la versión 1.10.0, puede darle a ESPHome una cantidad de redes WiFi para conectarse. ESPHome luego intentará conectarse al que tenga la mayor intensidad de señal.

    Para habilitar este modo, elimine las opciones ssid de su configuración wifi y mueva todo debajo de la tecla passwordnetworks

    # Ejemplo de configuración para connectar a dos redes
wifi:
  networks:
  - ssid: primeraconexion
    password: contraseñasegura
  - ssid: segundaconexion
    password: contraseñasegura
  # Other options
  # ...

    Variables de configuración WiFi ESPHome:

    • ssid (opcional, cadena): el SSID o el nombre de la red WiFi.
    • password (opcional, cadena): la contraseña que se usará para la autenticación. Deje vacío para ninguna contraseña.
    • manual_ip (Opcional): Configure manualmente la IP estática del nodo cuando use esta red. Tenga en cuenta que cuando se utilizan diferentes direcciones IP estáticas en cada red, se requiere configurar use_address, ya que ESPHome no puede inferir a qué red está conectado el nodo.
      • static_ip (Requerido, dirección IPv4): La IP estática de su nodo.
      • gateway de enlace (Obligatorio, dirección IPv4): La puerta de enlace de la red local.
      • subned (Obligatorio, dirección IPv4): La subred de la red local.
      • dns1 (opcional, dirección IPv4): el servidor DNS principal que se utilizará.
      • dns2 (opcional, dirección IPv4): el servidor DNS de respaldo que se usará.
    • eap (opcional ):
    • channel (Opcional, int): El canal de la red (1-14). Si se da, solo se conecta a las redes que están en este canal.
    • bssid (opcional, cadena): el BSSID (dirección MAC) de la conexión. Los BSSID deben constar de seis valores hexadecimales de dos dígitos separados por dos puntos (» :«). Todas las letras deben estar en mayúsculas.
    • hidden (opcional, booleano): si esta red está oculta. El valor predeterminado es falso. Si agrega esta opción, también debe especificar ssid.
    • prioridad (opcional, flotante): la prioridad de esta red. Después de cada tiempo, se elige la red con la prioridad más alta. Si la conexión falla, la prioridad se reduce en uno. El valor predeterminado es 0.

    Capítulos del vídeo

    Sensores WiFi ESPHome

    sensor:
  - platform: wifi_signal
    name: "mini WiFi Signal"
    update_interval: 60s
    text_sensor:
  - platform: wifi_info
    ip_address:
      name: mini IP Address
    ssid:
      name: mini Connected SSID
    bssid:
      name: mini Connected BSSID
    mac_address:
      name: mini Mac Wifi Address
    scan_results:
      name: mini Latest Scan Results

    Sígueme a Youtube

    Sígueme en Youtube - WiFi ESPHome
    Ajustes