Raspberry Pi — abertura pela internet

1. Plataforma

Escolha uma plataforma — dela dependem os campos seguintes.

microcontrolador

ESP32 / ESP32-S3 / C3 / C6

Shelly Plus 1 e placas DevKit. Ligam-se ao Wi-Fi e o programa carrega-se diretamente do navegador.

microcontrolador

ESP8266

Wemos D1 mini, NodeMCU 1.0. A opção económica, liga-se por Wi-Fi.

Placa Linux

Raspberry Pi (Python)

Pi Zero W / 3 / 4 / 5. Um script Python mais um serviço systemd. Da rede trata o sistema operativo; o programa só precisa de um pino GPIO para o relé.

2. Predefinições prontas

Toque numa predefinição e os seus parâmetros caem no formulário abaixo. Depois pode ajustá-los à mão.

Relés Wi-Fi comerciais (substituir o programa)

Shelly Plus 1 Um relé pronto numa caixa de fábrica bem feita Shelly Plus 1PM O mesmo, e ainda mede o consumo

Monte você mesmo num ESP32

ESP32-S3 DevKit Uma placa com USB mais um módulo de relé à parte ESP32-C3 SuperMini Uma placa compacta mais um módulo de relé ESP32 com relé integrado Uma placa com o relé já soldado ao lado do ESP32 ESP32 (módulo WROOM) Sem USB: o programa carrega-se por USB-UART nos pinos RX/TX/GPIO0, e a alimentação e o relé soldam-se ESP32-S3 (módulo) Um módulo S3 sem placa de suporte: a alimentação e o relé soldam-se, e o programa entra por USB ou USB-UART

Placas de controlador ESP8266

Os relés Wi-Fi comerciais com ESP8266 (Sonoff e afins) não acionam um portão: comutam tensão de rede e não têm contactos secos. Precisa de uma placa simples mais um módulo de relé à parte (ver "Do que mais vai precisar" abaixo) — é isso que dá um par de contactos livres a fazer de botão.

Wemos D1 mini Uma placa ESP8266 com USB — o programa carrega-se diretamente do navegador ESP8266 (módulo ESP-12) Sem USB: o programa carrega-se por USB-UART nos pinos RX/TX/GPIO0, e a alimentação e o relé soldam-se

Raspberry Pi

Num Pi vulgar o relé fica no GPIO — o mesmo módulo de relé que para o ESP (ver "Do que mais vai precisar" abaixo). Ou pegue num HAT de relés que encaixa diretamente no conector do Pi.

Raspberry Pi 4 / 5 A alimentação e a rede estão na placa. O relé vai no GPIO Raspberry Pi Zero W Compacto, por Wi-Fi. O relé vai no GPIO Waveshare RPi Relay Board Um HAT de relés que encaixa diretamente no conector GPIO — sem soldar nada

Do que mais vai precisar

Estas imagens não são clicáveis — mostram apenas o aspeto dos componentes.

Módulo de relé O mesmo para um ESP32, um ESP8266 ou um Raspberry Pi — qualquer placa sem relé integrado. Três fios para o controlador: comando, alimentação e massa (GND). A saída do relé vai para o motor

Adaptador USB-UART É preciso quando não há USB próprio: aparelhos Shelly já prontos e módulos ESP32/ESP8266 nus. As placas com USB (DevKit, Wemos) não precisam dele

3. WiFi

O nome da rede e a palavra-passe são escritos no programa do aparelho. Se mudar de Wi-Fi mais tarde, terá de recompilar e carregar o programa com os novos dados.

3. Rede

Um Raspberry Pi liga-se à rede através do sistema operativo — o Wi-Fi ou a Ethernet configuram-se com o habitual raspi-config, NetworkManager ou /etc/wpa_supplicant/wpa_supplicant.conf. O script em si não precisa de credenciais de Wi-Fi.

É a primeira vez que configura um? Num Pi Zero W o mais simples é pôr o SSID e a palavra-passe na partição de arranque do cartão SD, no ficheiro wpa_supplicant.conf. Num Pi 4 ou 5 é mais simples com raspi-config nonint do_wifi_country RU e raspi-config nonint do_wifi_ssid_passphrase MyHomeWiFi secret.

4. Credenciais do aparelho

Na aplicação acrescente um objeto do tipo "Aparelho" — depois de registado, a aplicação mostra o código do aparelho. Cole-o no campo abaixo: o firmware usa-o para se ligar ao servidor.

5. Relé

6. LED (opcional)

Pode comandar dois indicadores: o estado da ligação ao servidor e a atividade do relé. Deixe-os a -1 se não precisar deles.

Guardar esta configuração

Ligar à aplicação

Na aplicação abra o objeto Aparelho → "Ligar à aplicação", copie o código (começa por ENTX-BIND:), cole-o abaixo e carregue em "Escrever no controlador". A partir daí o controlador só abre com um comando da sua aplicação — o segredo chega-lhe por USB, sem passar pela rede nem pelo servidor.

O controlador já tem de estar gravado e ligado por USB. Se a aplicação reemitiu a chave, repita a ligação com o novo código.

Instalação num Raspberry Pi

Depois de ter descarregado o entrixy.py:

1. Ponha o ficheiro em /opt/entrixy/entrixy.py no Pi (pode usar scp).
2. Instale as dependências: sudo pip install websockets RPi.GPIO (num Pi 5 use gpiod).
3. Descarregue o serviço systemd: entrixy.service, ponha-o em /etc/systemd/system/.
4. Ative-o no arranque: sudo systemctl enable --now entrixy.
5. Verifique: sudo journalctl -u entrixy -f → deve ver [entrixy] auth OK.

O script religa-se sozinho quando a ligação cai e volta depois de o Pi reiniciar.

Ligar o relé ao motor

Usam-se dois contactos da saída do aparelho: NO (normalmente aberto) e COM (comum). Estes dois fios vão para os bornes do "botão Abrir" da placa de comando do seu motor.

Confirme as designações exatas no manual da sua placa de comando. Se a placa já estiver cablada e a funcionar, localize os dois fios que vêm da coluna do botão de Abrir e ligue NO/COM em paralelo com eles.

Aceder ao UART em relés Wi-Fi comerciais

O aparelho Shelly Plus 1 já pronto não tem USB externo. É preciso abrir a caixa e ligar-se aos pinos UART com um adaptador USB-série — CP2102, CH340 ou FTDI, qualquer um serve.

Ligação geral

Pinagem por modelo

Carregamento com esptool (se a via do navegador falhou)

1. Descarregue .bin acima.
2. Instale o esptool: pip install esptool
3. Ligue o aparelho ao USB ou a um adaptador USB-série.
4. Grave-o:
   esptool.py --chip auto --port /dev/ttyUSB0 write_flash 0x0 entrixy-ws.bin
5. No Windows a porta costuma ser COM3 ou COM4.