Projetos de hobby

Dispositivos Home Assistant e ESPHome

Cinco dispositivos com ESP32-C3 para o Home Assistant, o código Arduino que eles rodam no Mokxi e o YAML do ESPHome que você gravaria em casa.

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.