O Mokxi tem cinco modelos para os dispositivos que as pessoas montam primeiro em uma casa inteligente: um multissensor de ambiente, um sensor de presença por radar para corredor, um abre-portas de garagem, um controlador de fita de LED e um sensor de planta. Cada um roda em um ESP32-C3 simulado, e o curso Dispositivos Home Assistant percorre os cinco.
O que é simulado, e o que não é
O Mokxi roda sketches Arduino, não ESPHome. O ESPHome transforma um arquivo YAML em firmware e conversa com o Home Assistant pela API nativa dele. O Mokxi não consegue compilar YAML, então cada modelo faz à mão, em um sketch Arduino, o que os componentes do ESPHome fariam. O YAML abaixo é referência para quando você passar ao hardware de verdade, e lê-lo ao lado do sketch é uma boa forma de aprender o que cada componente faz por baixo.
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 alcança sua rede real nem um Home Assistant real. Cada sketch imprime o tópico e o payload que publicaria, uma linha por mensagem, 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.
Com a chave Internet real ativada (entre grátis), um sketch também pode publicar uma mensagem em um broker MQTT público de teste. Ainda assim ele não consegue alcançar um broker ou um Home Assistant na sua própria rede.
O multissensor
Um DHT22 para temperatura e umidade no GPIO 3, um sensor de luz BH1750 em I2C (GPIO 4 e 5) e um PIR no GPIO 18. Os sensores que conversam com os pinos da placa funcionam com 3,3 V; o PIR precisa de 5 V para funcionar e entrega 3,3 V na saída. O movimento é publicado no momento em que muda, e o clima a cada dez 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
O sensor de presença por radar para corredor
Um RCWL-0516 no GPIO 18, um módulo de luz com LDR no GPIO 0 e um LED de lâmpada no GPIO 19. O RCWL-0516 não é um sensor de presença mmWave. Ele é uma placa Doppler de micro-ondas que detecta movimento, inclusive através de plástico e paredes finas. As placas mmWave de 24 GHz vendidas para presença de verdade, como a LD2410, também percebem alguém parado e conversam por UART; o Mokxi não as modela. O sketch mantém o corredor ocupado por dez segundos após o último movimento e acende a luz só quando está escuro, no próprio dispositivo.
binary_sensor:
- platform: gpio
pin: GPIO18
name: "Hallway occupancy"
device_class: occupancy
filters:
- delayed_off: 10s
O abre-portas de garagem
Um relé no GPIO 18 ligado em paralelo com o botão de parede do abre-portas, dois reed switches no GPIO 3 (fechado) e GPIO 2 (aberto), e um botão local no GPIO 9. O relé fecha por meio segundo, como um dedo no botão faria, e os reed switches informam onde a porta realmente está.
Segurança. Conecte apenas aos terminais de baixa tensão do botão de parede do abre-portas, nunca à rede elétrica nem ao motor. O relé deve iniciar desligado e nunca ficar travado ligado. Nunca anule os fotossensores nem a reversão por obstrução, teste a reversão depois de instalar e acione a porta remotamente apenas quando os recursos de segurança do próprio abre-portas estiverem 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
O controlador de fita de LED
Dezesseis pixels WS2812B no GPIO 18, um botão de energia no GPIO 9, um botão de efeito no GPIO 10 e um botão de brilho no GPIO 0. Cada mudança faz uma transição de cerca de meio segundo, e /set na aba Web aceita estado, brilho, cor e efeito. Para uma fita de verdade, use a própria fonte de 5 V dela dimensionada para ela, injete energia ao longo de trechos longos, compartilhe o terra com a placa, coloque um conversor de nível na linha de dados e um fusível perto da fonte.
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:
O sensor de planta
Um sensor de umidade de solo capacitivo no GPIO 3, um módulo de luz com LDR no GPIO 4 e um LED vermelho no GPIO 19 que acende enquanto a planta está com sede. Solo mais úmido dá leitura mais baixa, e duas leituras de calibração, a estaca no ar seco e na água, mapeiam tudo entre elas para 0 a 100 por cento. É só um sensor, sem 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
Para onde ir agora
Open a template: Multissensor Home Assistant, Sensor de presença por radar para corredor, Abre-portas de garagem, LED strip controller or Sensor de planta. Faça o curso, dispositivos para Home Assistant, ou leia o guia em /learn/home-assistant-esphome-devices.