Integrar un sensor de depósito con ESPHome

Hoy te enseño a integrar un sensor de depósito con ESPHome, perfecto para controlar pequeños volúmenes como el de la cafetera.

Sensor XKC-Y25-V

Algo que me da rabia cuando voy a hacer el desayuno es iniciar la cafetera y que empiece a hacer un ruido horrible porque no tiene agua. Esto me pasa más de lo que me gustaría, ya que el depósito está en la parte trasera y, como no lo veo, me olvido de llenarlo.

Anteriormente, ya he probado sensores de depósito para recipientes más grandes y sensores de ultrasonido para medir distancias o niveles. No obstante, esta vez buscaba algo discreto y no invasivo (ya que luego el agua pasa al café).

Así, buscando por la comunidad, encontré el sensor XKC-Y25-V que precisamente se utiliza mucho en cafeteras y similares. La ventaja que tiene es que es muy pequeño y no necesita estar en contacto directo con el fluido, por lo que es perfecto para colocarlo justo detrás de la cafetera sin que nadie sepa que está ahí.

Requisitos previos

Para integrar un sensor de depósito con ESPHome necesitas lo siguiente:

XKC-Y25-V
GENERICO

XKC-Y25-V

4,0

Sensor de nivel de líquido sin contacto para depósitos o cafeteras. Opera en local y se integra en Home Assistant mediante ESPHome con conectividad WiFi y Bluetooth.Sensor de nivel de líquido sin contacto para depósitos o cafeteras. Opera en loc...

ESP32-C3 Mini
GENERICO

ESP32-C3 Mini

4,8

Placa microcontroladora compacta ideal para crear proyectos IoT. Ofrece conectividad WiFi y Bluetooth, control 100% local y una integración perfecta con Home Assistant a través de ESPHome.Placa microcontroladora compacta ideal para crear proyectos IoT. Ofrece conectiv...

*Algún precio puede haber cambiado desde la ultima revision

Conexión del sensor XKC-Y25-V

Lo primero que vamos a hacer es conectar el sensor a nuestra placa. Como siempre, lo primero que te recomiendo es que consultes el ‘pinout’ (o distribución de pines) de la placa. En mi caso voy a utilizar una placa ESP32-C3 Mini y este es su ‘pinout’.

Pinout ESP32-C3 Super Mini

Por otro lado, si «pelas» el extremo del cable del sensor XKC-Y25-V, descubrirás que tiene el siguiente aspecto, que nos lleva al esquema de conexión.

  • El cable amarillo irá conectado al GPIO2 de la placa.
  • El cable marrón irá conectado al pin de alimentación 3V3 de la placa.
  • El cable azul irá conectado al pin GND (‘ground’ o tierra) de la placa.
  • El cable negro queda suelto (no se conecta a ningún PIN).

Configuración de ESPHome

Ahora tenemos que ‘flashear’ la placa con ESPHome y la configuración correspondiente. Para ello sigue estos pasos:

  1. Conecta la placa a tu ordenador a través del puerto USB-C.
  2. En Home Assistant, accede al complemento de ESPHome desde el menú lateral y pulsa en + Create Device > Create new project. Busca la placa «ESP32-C3 Super Mini» y pulsa en «Select».
  3. A continuación, asigna un nombre a tu dispositivo (por ejemplo, «Cafetera») y pulsa en «Finish setup». Verás que se ha creado un nuevo dispositivo con el código base.
  4. Añade las siguientes líneas al final del código.
captive_portal:

binary_sensor:
  - platform: gpio
    pin:
      number: GPIO2
      mode:
        input: true
        pulldown: true 
    device_class: moisture
    name: "Depósito"
  1. Pulsa en “Save” e “Install”. En el popup emergente, pulsa sobre «Advanced options» y elige la opción «Download firmware binary». Espera a que termine y elige la opción «Factory image» para descargar el fichero ‘.bin’ correspondiente.
  2. Ahora ve a la página de ESPHome y pulsa en «Connect». En la ventana emergente, selecciona tu placa y pulsa en «Conectar».
  3. Ahora pulsa en «Install» y selecciona el fichero ‘.bin’ obtenido en el paso 5. De nuevo, pulsa en «Install».
  4. Vuelve a Home Assistant y ve a Configuración > Dispositivos y servicios. Lo normal es que tu dispositivo haya sido descubierto y aparezca en la parte superior, esperando únicamente a que pulses el botón de «Añadir». De lo contrario, pulsa en el botón de «Añadir integración», busca «ESPHome» e introduce la IP de tu placa en el campo ‘Host’. Como siempre, te recomiendo que asignes una IP fija en tu router para evitar fallos en el futuro si esta cambia.
  5. Para terminar, ve a Configuración > Dispositivos y servicios > ESPHome. Pulsa sobre el enlace «Configurar» correspondiente a tu dispositivo. En la ventana emergente, marca la casilla «Permitir que el dispositivo realice acciones de Home Assistant» y pulsa en «Enviar». Esto va a permitir que podamos controlar nuestros dispositivos desde el dispositivo.
  6. Si todo ha ido bien, al terminar ya deberías ver la entidad desde el detalle del dispositivo.

El funcionamiento del dispositivo es sencillo. Simplemente tienes que colocar el sensor en contacto con la superficie del depósito, a la altura que quieras considerar como el límite inferior de fluido. Es decir, en el punto que quieres detectar que ha bajado el nivel para que te avise (por ejemplo, al 20% del depósito).

Consigue tu CoFilled!

No iba de farol con lo de la cafetera!! De hecho, he creado un pequeño dispositivo que he bautizado como «CoFilled» para que se integre perfectamente.

La idea es sencilla, pero infalible. He añadido a la placa un segmento de 2 LEDs (de una tira WS2812B que tenía por aquí) y he diseñado una pequeña carcasa con forma de taza de café que se coloca encima de la cafetera.

Tira LED WS2812B
GENERICO

Tira LED WS2812B

5,0

Tira RGB direccionable ideal para proyectos DIY. Permite control local vía WiFi y se integra fácilmente en Home Assistant mediante ESPHome. Perfecta para iluminación personalizada y domótica avanzada.

*Algún precio puede haber cambiado desde la ultima revision

El esquema de conexión de los LEDs es el siguiente:

  • El cable verde (datos) irá conectado al GPIO3 de la placa.
  • El cable rojo (alimentación) irá conectado al pin de alimentación 3V3 de la placa.
  • El cable blanco (tierra) irá conectado al pin GND (‘ground’ o tierra) de la placa.

Una vez hayas conectado los LEDs a la placa, ya puedes colocar los componentes dentro de la carcasa con forma de taza.

También he modificado el código de ESPHome para que los LED se enciendan en color rojo cuando el depósito está vacío, y se apaguen cuando lo llenas. De esta forma se convierte en un dispositivo autónomo, que todo el mundo entiende y ni siquiera necesitas interactuar con Home Assistant (aunque lo tienes integrado).

CoFilled-ESPHome

Comparte tu herramienta con IA!!

Envía tu herramienta gratuita basada en Inteligencia Artificial y compártela con la comunidad. La revisaremos lo antes posible para incluirla en el catálogo!!