Mokxi tiene cinco plantillas para los dispositivos que la gente construye primero en una casa inteligente: un multisenso de habitación, un sensor de pasillo por radar, un abrepuertas de cochera, un controlador de tira LED y un sensor de plantas. Cada uno funciona en un ESP32-C3 simulado, y el curso Dispositivos de Home Assistant recorre los cinco.
Qué se simula y qué no
Mokxi ejecuta sketches de Arduino, no ESPHome. ESPHome convierte un archivo YAML en firmware y se comunica con Home Assistant mediante su API nativa. Mokxi no puede compilar YAML, así que cada plantilla hace a mano, en un sketch de Arduino, lo que harían los componentes de ESPHome. El YAML de abajo es una referencia para cuando pases al hardware real, y leerlo junto al sketch es una buena forma de aprender qué hace cada componente por dentro.
The network is simulated, and there is no MQTT broker. The board joins a
simulated access point and serves pages to the Web tab (WiFi simulado). Nada llega a tu red real ni a un Home Assistant real. Cada sketch imprime el tema y el mensaje que publicaría, una línea por mensaje, como publish home/multisensor/temperature 21.5, and serves its
state as JSON at /state, which is the shape Home Assistant's RESTful sensor
could poll on a real network.
Con el interruptor de Internet real activado (inicia sesión gratis), un sketch también puede publicar un mensaje en un broker MQTT público de prueba. Aun así no puede alcanzar un broker o un Home Assistant en tu propia red.
El multisenso
Un DHT22 para temperatura y humedad en GPIO 3, un sensor de luz BH1750 en I2C (GPIO 4 y 5) y un PIR en GPIO 18. Los sensores que se comunican con los pines de la placa funcionan a 3.3 V; el PIR necesita 5 V para funcionar y entrega 3.3 V. El movimiento se publica en el momento en que cambia, y el clima cada diez segundos.
i2c:
sda: GPIO4
scl: GPIO5
sensor:
- platform: dht
pin: GPIO3
model: DHT22
temperature:
name: "Temperature"
humidity:
name: "Humidity"
update_interval: 10s
- platform: bh1750
name: "Illuminance"
binary_sensor:
- platform: gpio
pin: GPIO18
name: "Motion"
device_class: motion
El sensor de pasillo por radar
Un RCWL-0516 en GPIO 18, un módulo de luz LDR en GPIO 0 y un LED de lámpara en GPIO 19. El RCWL-0516 no es un sensor de presencia mmWave. Es una placa Doppler de microondas que detecta movimiento, incluso a través de plástico y paredes delgadas. Las placas mmWave de 24 GHz que se venden para presencia real, como la LD2410, también detectan a alguien sentado quieto y se comunican por UART; Mokxi no las modela. El sketch mantiene el pasillo ocupado durante diez segundos después del último movimiento, y enciende la luz solo cuando está oscuro, en el propio dispositivo.
binary_sensor:
- platform: gpio
pin: GPIO18
name: "Hallway occupancy"
device_class: occupancy
filters:
- delayed_off: 10s
El abrepuertas de cochera
Un relé en GPIO 18 conectado en paralelo con el botón de pared del abrepuertas, dos interruptores magnéticos en GPIO 3 (cerrada) y GPIO 2 (abierta), y un botón local en GPIO 9. El relé se cierra durante medio segundo, como lo haría un dedo sobre el botón, y los interruptores magnéticos informan dónde está realmente la puerta.
Seguridad. Conecta solo a las terminales de bajo voltaje del botón de pared del abrepuertas, nunca a la red eléctrica ni al motor. El relé debe arrancar apagado y nunca quedarse encendido. Nunca anules las fotocélulas ni la inversión por obstrucción, prueba la inversión después de instalar, y acciona la puerta a distancia solo cuando las funciones de seguridad del propio abrepuertas estén funcionando.
switch:
- platform: gpio
pin: GPIO18
id: door_relay
restore_mode: ALWAYS_OFF
on_turn_on:
- delay: 500ms
- switch.turn_off: door_relay
binary_sensor:
- platform: gpio
pin: { number: GPIO3, inverted: true, mode: INPUT_PULLUP }
id: door_closed
- platform: gpio
pin: { number: GPIO2, inverted: true, mode: INPUT_PULLUP }
id: door_open
cover:
- platform: template
name: "Garage door"
device_class: garage
lambda: |-
if (id(door_closed).state) return COVER_CLOSED;
if (id(door_open).state) return COVER_OPEN;
return {};
open_action:
- switch.turn_on: door_relay
close_action:
- switch.turn_on: door_relay
El controlador de tira LED
Dieciséis pixeles WS2812B en GPIO 18, un botón de encendido en GPIO 9, un botón de efectos en GPIO 10 y una perilla de brillo en GPIO 0. Cada cambio hace una transición de alrededor de medio segundo, y /set en la pestaña Web recibe el estado, el brillo, el color y el efecto. Para una tira real, usa su propia fuente de 5 V dimensionada para ella, inyecta energía a lo largo de tramos largos, comparte la tierra con la placa, pon un desplazador de nivel en la línea de datos y un fusible cerca de la fuente.
light:
- platform: esp32_rmt_led_strip
pin: GPIO18
num_leds: 16
chipset: WS2812
rgb_order: GRB
name: "Strip"
default_transition_length: 600ms
effects:
- addressable_rainbow:
El sensor de plantas
Un sensor de suelo capacitivo en GPIO 3, un módulo de luz LDR en GPIO 4 y un LED rojo en GPIO 19 que se enciende cuando la planta tiene sed. La tierra más húmeda da lecturas más bajas, y dos lecturas de calibración, la estaca en aire seco y en agua, convierten todo lo que hay entre ellas en 0 a 100 por ciento. Es solo un sensor, sin bomba.
sensor:
- platform: adc
pin: GPIO3
name: "Soil moisture"
unit_of_measurement: "%"
attenuation: 12db
filters:
- median:
window_size: 5
- calibrate_linear:
- 2.55 -> 0.0
- 1.27 -> 100.0
Qué sigue
Open a template: Multisenso de Home Assistant, Sensor de pasillo por radar, Abrepuertas de cochera, LED strip controller or Sensor de plantas. Toma el curso dispositivos de Home Assistant, o lee la guía en /learn/home-assistant-esphome-devices.