Controle o portão da garagem com ESP32 e Home Assistant

A maioria dos motores de portão eletrônico residencial (PPA, Garen, Peccinin e afins) já tem um botão físico de abrir/fechar dentro do quadro de comando — o mesmo botão que o instalador usa para testar o motor. Esse projeto aproveita exatamente esse botão: um relé controlado por ESP32 “aperta” esse botão eletronicamente sempre que você mandar um comando pelo Home Assistant, enquanto um sensor magnético informa se o portão está aberto ou fechado. O controle remoto original continua funcionando normalmente — você só ganha uma forma extra de acionar o portão.

O que você vai montar

• Um ESP32 rodando ESPHome, conectado ao seu Wi-Fi
• Um módulo relé ligado em paralelo ao botão físico existente do motor do portão
• Um sensor magnético (reed switch) instalado no portão para informar aberto/fechado
• Uma entidade cover (tipo “garagem”) no Home Assistant, com histórico e automações

Lista de materiais

Ver no Mercado Livre →

Além dos três itens acima, você vai precisar de: alguns metros de cabo de campainha (2 vias, para o sensor magnético até o quadro de comando) e uma fonte 5V (a maioria dos quadros de comando de motor de portão já tem uma saída auxiliar de 12V/24V — dá para usar um pequeno conversor DC-DC, ou alimentar o ESP32 por um carregador USB comum próximo à tomada do motor).

Esquema de ligação

ESP32 GPIO5   →  Módulo relé (pino IN)
Relé COM/NA   →  em paralelo com os 2 terminais do botão físico do motor
ESP32 GPIO4   →  Sensor magnético (reed switch), com pull-up interno
Sensor GND    →  GND do ESP32
Relé VCC/GND  →  5V e GND do ESP32 (ou fonte externa, se o relé exigir mais corrente)

Importante: desligue o disjuntor que alimenta o motor do portão antes de abrir o quadro de comando. O relé liga apenas nos terminais de baixa tensão do botão existente — nunca na rede 220V que alimenta o motor.

O sensor magnético é instalado como qualquer sensor de porta/janela: o ímã fica na parte móvel do portão, e o sensor (reed switch) na parte fixa da estrutura, alinhados quando o portão está fechado.

Código ESPHome

# esphome/portao-garagem.yaml
esphome:
  name: portao-garagem

esp32:
  board: esp32dev
  framework:
    type: arduino

wifi:
  ssid: "SUA_REDE"
  password: "SUA_SENHA"

api:
  encryption:
    key: "CHAVE_GERADA_PELO_ESPHOME"

ota:
  password: "SUA_SENHA_OTA"

logger:

binary_sensor:
  - platform: gpio
    pin:
      number: GPIO4
      mode: INPUT_PULLUP
      inverted: true
    name: "Portão — fechado"
    device_class: garage_door
    id: sensor_portao_fechado

output:
  - platform: gpio
    pin: GPIO5
    id: rele_aciona_portao

switch:
  - platform: output
    output: rele_aciona_portao
    id: pulso_rele
    name: "Portão — acionar motor (pulso)"

cover:
  - platform: template
    name: "Portão da Garagem"
    device_class: garage
    lambda: |-
      if (id(sensor_portao_fechado).state) {
        return COVER_CLOSED;
      } else {
        return COVER_OPEN;
      }
    open_action:
      - switch.turn_on: pulso_rele
      - delay: 500ms
      - switch.turn_off: pulso_rele
    close_action:
      - switch.turn_on: pulso_rele
      - delay: 500ms
      - switch.turn_off: pulso_rele
    stop_action:
      - switch.turn_on: pulso_rele
      - delay: 500ms
      - switch.turn_off: pulso_rele

O lambda do cover lê o sensor magnético para reportar o estado real (aberto/fechado) ao Home Assistant. Como o motor usa um único botão que alterna abrir/parar/fechar a cada pulso, as três ações (open_action, close_action, stop_action) fazem exatamente a mesma coisa: um pulso de 500ms no relé — é o motor que decide o que fazer com esse pulso, dependendo do estado em que ele já está. Ajuste a duração do pulso (delay: 500ms) se o seu motor precisar de um toque mais longo ou mais curto no botão — teste na prática e ajuste conforme necessário.

Automações recomendadas no Home Assistant

automation:
  - alias: "Portão — avisar se ficou aberto por mais de 10 minutos"
    trigger:
      - platform: state
        entity_id: cover.portao_da_garagem
        to: "open"
        for:
          minutes: 10
    action:
      - service: notify.mobile_app_seu_celular
        data:
          message: "O portão da garagem está aberto há 10 minutos."

  - alias: "Portão — fechar automaticamente à noite se aberto"
    trigger:
      - platform: time
        at: "22:00:00"
    condition:
      - condition: state
        entity_id: cover.portao_da_garagem
        state: "open"
    action:
      - service: cover.close_cover
        entity_id: cover.portao_da_garagem

Dicas e troubleshooting

• O relé aciona, mas o portão não responde: confira se o botão físico do motor é do tipo “seco” (contato simples) e não exige uma tensão específica — alguns modelos usam 12V ou 24V no próprio botão, e nesse caso o relé precisa ser dimensionado para essa tensão, não para os 5V do ESP32.
• O sensor magnético mostra o estado errado: troque o inverted: true por false no YAML (ou vice-versa) — depende de como o reed switch está fiado (normalmente aberto vs normalmente fechado).
• O portão abre mas o Home Assistant continua mostrando “fechado”: o problema é o alinhamento físico do ímã com o sensor — ajuste a distância e o ângulo até o estado mudar corretamente nos dois extremos (aberto e fechado).
• Quero saber se o portão está em movimento: dá para estimar isso no Home Assistant com um template sensor que marca “abrindo/fechando” por alguns segundos após o comando, até o sensor magnético confirmar o novo estado — mas isso é aproximado, não uma leitura real de posição.

Ainda não tem o motor instalado? No Reforma Caseira, nosso site irmão de ferramentas e reforma, tem o passo a passo completo de como instalar o motor de portão eletrônico antes de partir para essa automação.

---

Dúvidas sobre algum produto? Fale com a gente.