❮ Escolha um controlador Plataforma: Raspberry Pi · Ligação: internet

Raspberry Pi — abertura pela internet

Preencha alguns parâmetros e o servidor gera um script Python pronto para a sua placa. Só falta copiá-lo para o Raspberry Pi e executá-lo como serviço: não há nada para gravar.

O que faz o programa: O Raspberry Pi mantém-se ligado ao servidor, por Wi-Fi ou por cabo, como lhe der mais jeito. Carrega em Abrir na aplicação a qualquer distância e a placa fecha por um instante os contactos do seu portão, cancela ou intercomunicador, tal como um botão vulgar. Não comuta corrente. Para motores e fechaduras biestáveis há mais abaixo um modo com abertura e fecho separados e seguimento da posição.

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é.

Placa que placa tem — determina os pinos disponíveis

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)

Monte você mesmo num ESP32

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

As tomadas inteligentes e os interruptores Wi-Fi não servem aqui. O Athom Plug, o Shelly Plus Plug S e afins são tomadas inteligentes: comutam tensão de rede para uma carga e não têm contactos secos à parte para um botão. Um motor precisa de um relé com um par de contactos livres — um Shelly Plus 1, ou uma placa ESP32/ESP8266 com módulo de relé.

3. WiFi

SSID da rede o nome do seu Wi-Fi de casa (2,4 GHz; 5 GHz não é suportado)

Palavra-passe a palavra-passe WPA2/WPA3 da rede

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.

Código do aparelho 64 carateres hex da aplicação — o botão "Mostrar parâmetros de acesso" num objeto do tipo Aparelho

Cole o código exatamente como a aplicação o mostra — um carácter errado e o controlador não se liga.

5. Relé

Pino do relé (PIN_RELAY) a saída para a bobina do relé; NO/COM vão para os bornes Open do motor

Polaridade do relé

Duração do impulso, ms quanto tempo o relé fica fechado; para um botão Abrir, 500–2000 ms é o habitual

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.

Pino do LED de estado aceso quando o Wi-Fi e o servidor estão ligados, a piscar quando a ligação cai; -1 significa nenhum

Polaridade do LED de estado

Pino do LED de abertura pisca durante o impulso do relé; -1 significa nenhum

Polaridade do LED de abertura

Tipo de fechadura

Guardar esta configuração

Nome curto Por exemplo, "Portão do pátio". Se iniciar sessão, fica guardado na sua conta e disponível a partir de qualquer aparelho; caso contrário, fica apenas neste navegador.

As minhas configurações guardado neste navegador

Descarregar ficheiro Descarregar o código-fonte

Se quiser ler o código-fonte, ajustá-lo à mão, descarregar .ino ou partilhar uma ligação, carregue em "Abrir no editor". É exatamente o código que o servidor compilou em .bin.

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:

Ponha o ficheiro em /opt/entrixy/entrixy.py no Pi (pode usar scp).
Instale as dependências: sudo pip install websockets RPi.GPIO (num Pi 5 use gpiod).
Descarregue o serviço systemd: entrixy.service, ponha-o em /etc/systemd/system/.
Ative-o no arranque: sudo systemctl enable --now entrixy.
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.

Motor	Onde ligar NO/COM
BFT (Phobos, Deimos, Ares)	Bornes `START` ou `OPEN` (no esquema costumam estar numerados 21–22)
CAME (BX, ATI, BK)	Bornes `2–7` (abrir), ou PED para um portão pedonal
NICE (Robus, Run, Spin)	Bornes `1–3` (passo a passo)
FAAC (740, 844, 391)	Bornes `OPEN A` (abertura total)
DoorHan (Sliding, Arm)	Bornes `CMD` + `GND`
Cancela de lança	A coluna com o botão de Abrir — em paralelo com os seus contactos
Intercomunicador (Cyfral, Vizit, Eltis)	O relé em paralelo com o botão de abertura do auscultador, ou diretamente nos bornes da fechadura magnética

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

Adaptador USB-série	Aparelho
GND	GND
3.3V	3V3
TX	RX
RX	TX
—	EN/RESET — brevemente a GND para arrancar no bootloader
—	GPIO0 — a GND ao alimentar, para entrar no bootloader

Não aplique tensão de rede aos bornes de rede do aparelho enquanto o adaptador USB estiver ligado. Alimente-o pelos 3,3 V do adaptador ou deixe a rede totalmente desligada. Caso contrário, as massas do USB e da rede podem ficar a potenciais diferentes e a porta USB do seu computador será destruída.

Pinagem por modelo

Aparelho	Onde fica o UART	Entrar no bootloader
Shelly Plus 1 / 1PM (ESP32)	Os pads dentro da caixa, ao lado do módulo ESP32	Ligue o GPIO0 ao GND e puxe brevemente o EN ao GND

Carregamento com esptool (se a via do navegador falhou)

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

Depois de carregar no botão, espere um momento — o ficheiro costuma estar pronto em menos de um minuto. Assim que o programa estiver compilado, aparece um botão para descarregar.