❮ Escolha um controlador Ligação: BLE (Bluetooth)

Controlador de abertura BLE

Escolha um módulo já pronto ou monte um controlador com meia dúzia de peças, defina alguns parâmetros e carregue-lhe o programa final diretamente a partir do navegador.

O que faz o firmware

Um telemóvel — o do proprietário, ou o de um convidado com uma chave válida — envia o comando Abrir diretamente por Bluetooth quando está perto do controlador. O controlador fecha por um instante um par de contactos do motor (um segundo por predefinição), tal como um botão vulgar, e volta a abri-los; não comuta corrente. Para motores e fechaduras biestáveis pode ativar mais abaixo um modo com abertura e fecho separados e seguimento da posição. A abertura faz-se com um toque na aplicação; também há abertura automática ao aproximar-se.

O que há lá dentro

A ligação entre o telemóvel e o controlador está bem cifrada — não se pode forjar nem intercetar. Não há nada para configurar, a proteção já vem incorporada. Entre aberturas o controlador dorme e quase não consome.

1. Escolha a sua placa

Primeiro decida sobre o que vai montar: pegue num módulo já pronto, com o controlador e o relé já soldados, ou monte-o com peças (uma placa ESP32 à parte mais um módulo de relé). Toque na sua placa e mostramos como a ligar, enquanto as definições certas caem no formulário abaixo. No fim, carrega o programa final — também chamado firmware — no controlador.

Placas de controlador

ESP32 com relé numa só placa

Placas prontas com o ESP32 e o relé já soldados — não é preciso módulo à parte.

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

Se quiser uma caixa de fábrica bem feita e um relé certificado, pegue num aparelho comercial e carregue-lhe o nosso programa em vez do dele. Por dentro continua a ser um relé vulgar: um par de contactos que fecha por um instante e carrega no botão de abrir. Um aparelho destes não precisa do seu próprio Wi-Fi — o Entrixy fala diretamente com o telemóvel.

Do que mais vai precisar

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

Módulo de relé É preciso quando a placa não tem relé. Três fios vão para o ESP32: comando, alimentação e massa (GND). A saída do relé vai para o motor

Programador com soquete Neste soquete encaixa-se um módulo ESP32 ou ESP32-S3 nu para se poder carregar o programa

Adaptador USB-UART Serve para carregar o programa nas placas de relé e no Shelly — liga-se a alguns pinos

As tomadas inteligentes e os interruptores Wi-Fi não servem aqui. O Athom Plug, o Shelly Plus Plug S e equipamentos semelhantes comutam a tensão de rede para uma carga — não têm saída seca NO/COM, apenas uma tomada. Para acionar um motor de portão precisa de um relé Plus 1 ou Plus 1PM, ou de uma placa caseira com módulo de relé.

Antes de carregar o programa num aparelho comercial, verifique qual pino é qual. Os fabricantes mudam os pinos de sítio de vez em quando dentro do mesmo modelo. Tirámos os esquemas de fontes abertas e verificámo-los nas nossas próprias unidades — a sua pode diferir um pouco. Guie-se pelas marcações da própria placa.

2. Placa

Placa que modelo de ESP32 — determina os pinos disponíveis

Não sabe que chip tem? Ligue a placa ao computador com um cabo USB (um módulo nu passa por um programador) e carregue no botão — o navegador deteta o chip e seleciona-o na lista acima. Funciona em computador no Chrome ou no Edge.

3. Tipo de fechadura

A escolha principal: decide como se comporta o relé. Impulso: um único pulso de Abrir. Biestável: duas posições, com abrir e fechar em pinos distintos; o estado é guardado e mostrado na aplicação.

Tipo de fechadura

Modo biestável: o controlador lembra-se da posição atual (aberto ou fechado) e alterna-a em cada ativação. A posição vê-se no ícone do objeto na aplicação, tanto para o proprietário como para o convidado. O pino do comando Fechar define-se mais abaixo, na secção Pinos.

4. Pinos e polaridade

Relé e fechadura

Pino do relé de abertura (PIN_RELAY) O número do GPIO ao qual está ligada a entrada de comando do módulo de relé. Os contactos do relé (NO/COM) vão para os bornes do botão Abrir do seu motor — o controlador fecha-os por um instante, imitando uma pressão. Em modo biestável este é o pino de abertura. Importante: as massas (GND) do controlador e do módulo de relé têm de estar ligadas — sem massa comum o relé não funciona.

Nível durante o pulso

Nível em repouso (entre impulsos)

Um impulso HIGH serve para comutadores de transístor diretos; um LOW (impulso = LOW, repouso = HIGH) serve para a maioria dos módulos de relé comerciais e para o Shelly. O nível em repouso é habitualmente o oposto do impulso.

Duração do impulso, ms Quantos milissegundos o contacto fica fechado em cada ativação. Para um botão Abrir, 500–2000 ms é o habitual. Demasiado curto e o motor pode não reagir; demasiado longo e há aquecimento e consumo desnecessários.

Indicadores

LED de abertura (PIN_OPEN_LED) O pino de um LED indicador externo. Acende durante o impulso de abertura. Se o seu circuito não tiver esse LED, indique -1.

Polaridade do LED de abertura Como o LED está ligado. Ativo a nível baixo significa que o cátodo vai ao pino e o ânodo, por uma resistência, à alimentação — o arranjo habitual. Ativo a nível alto é ao contrário.

LED de estado (integrado) O pino do LED indicador integrado na placa. Depende do modelo: no ESP32-S3 costuma ser GPIO48, no ESP32-C3 GPIO8, no ESP32 clássico (WROOM) GPIO2. O valor predefinido segue o chip escolhido acima e pode ser alterado. Indique -1 se não houver esse LED.

Polaridade do LED de estado Acende com nível alto ou baixo, consoante a placa. A maioria dos DevKit é ativa a nível alto.

Botão de emparelhamento

Pino do botão de emparelhamento (PIN_PAIR_BTN) O pino de um botão físico na placa. Enquanto o controlador não estiver emparelhado, uma pressão curta inicia o emparelhamento com um telemóvel. Uma pressão longa repõe o emparelhamento no estado de fábrica. Na maioria das placas é o botão BOOT integrado, GPIO0.

Tempo de pressão para a reposição, ms Quantos milissegundos o botão tem de ser mantido premido para disparar a reposição do emparelhamento. Como proteção contra acidentes, costumam ser 5000 ms, cinco segundos.

Diagnóstico

Saída de depuração (UART) Um registo técnico para a porta série, preciso apenas durante a depuração. No ESP32-S3 a porta ocupa o GPIO43 e o GPIO44. Em funcionamento normal é melhor desligá-la: não se escreve registo e esses dois pinos ficam livres para o relé.

5. Alimentação e economia de bateria

Período do ciclo de anúncio, ms Com que frequência o controlador acorda e vai ao ar — o ciclo completo de anúncio mais sono. Um valor menor faz o telemóvel encontrar o aparelho mais depressa, mas as pilhas gastam-se mais rápido. Um maior poupa energia à custa de uma resposta um pouco mais lenta.

Duração da janela de anúncio, ms Quantos milissegundos o controlador anuncia ativamente num ciclo antes de adormecer. Tem de chegar para um telemóvel apanhar o aparelho e ligar-se — normalmente 1500–2000 ms.

Manter a ligação, ms Se um telemóvel conseguiu ligar-se, o controlador fica acordado mais estes milissegundos, para receber o comando e responder.

Janela de emparelhamento, ms Quanto tempo o controlador espera por um telemóvel em modo de emparelhamento antes de adormecer. Noventa segundos chegam e sobram, mesmo para telemóveis lentos.

Sono entre ciclos, s Quantos segundos o controlador dorme entre ciclos de anúncio. 0 significa que nunca dorme, para alimentação da rede ou USB. Com pilhas, o ponto ideal está entre 10 e 20 segundos: duas AA duram meses.

6. Relógio externo (opcional)

Um pequeno módulo de relógio (DS3231, DS1307 ou PCF8563) com a sua própria pilha de botão mantém a hora certa durante anos. Sem ele, o relógio interno do controlador desvia-se de forma notória, cerca de 5 % por hora. A hora certa só importa se entregar aos convidados chaves com prazo — caso contrário, salte esta secção.

Tipo de RTC externo

Guardar esta configuração

Nome curto Por exemplo, «Cancela do pátio» ou «Portão da casa de campo». Se tiver sessão iniciada, vai para a sua conta e fica disponível a partir de qualquer aparelho. Caso contrário, é guardada neste navegador para não ter de configurar tudo de novo.

Compilar e carregar o programa

O servidor compila o programa (o firmware) exatamente para as suas definições. Pode descarregar o ficheiro ou carregá-lo no controlador diretamente a partir do navegador.

Manter o emparelhamento com a aplicação (atualizar o firmware sem apagar as definições)

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

A seguir: emparelhar o controlador na aplicação

Depois do carregamento, o controlador espera 90 segundos por um proprietário em modo de emparelhamento. Abra a aplicação Entrixy no papel de proprietário → Adicionar objeto → BLE — o controlador aparece na lista, selecione-o. Se não aparecer, carregue no botão de emparelhamento da placa: o LED começa a piscar e a lista atualiza-se. A aplicação troca as chaves e o controlador passa a ser seu. Os detalhes estão no guia, secção «Emparelhamento».

Ligar o relé ao motor

Usam-se dois contactos do relé: 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 o NO/COM do relé em paralelo com eles.

Carregamento com esptool (se a via do navegador falhou)

Descarregue .bin acima.
Instale o esptool: pip install esptool
Ligue o ESP por USB.
Grave-o: esptool.py --chip auto --port /dev/ttyUSB0 write_flash 0x0 entrixy-ble.bin
No Windows a porta costuma ser COM3 ou COM4.

Aceder ao UART em relés Wi-Fi comerciais

Os aparelhos já prontos (Shelly Plus 1, Plus 1PM) não têm USB externo. É preciso abrir a caixa e ligar-se aos pinos UART do ESP32 com um adaptador USB-série — CP2102, CH340 ou FTDI, qualquer um serve.

Ligação geral

Adaptador USB-série	ESP32 na placa
GND	GND
3.3V	3V3 (só se pretender alimentá-lo pelo adaptador; caso contrário, deixe o aparelho na sua própria alimentação)
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 / Plus 1PM	Dentro da caixa, ao lado do módulo ESP32. Os pads estão marcados como `3V3 GND TX RX GPIO0`. Retire a tampa frontal (dois ou três clipes); a placa fica por cima.	Ligue o GPIO0 ao GND e puxe brevemente o EN ao GND

Se o seu modelo não estiver aqui:

templates.blakadder.com — uma base de dados aberta de modelos Tasmota com os GPIO de cada modelo. Traduz-se para as nossas definições assim: Relay1 → o pino do relé, Button1 → o pino do botão, Led1 → o LED de estado.
devices.esphome.io — o registo do ESPHome.
Se o modelo não estiver em lado nenhum, pegue num multímetro: siga a bobina do relé até um GPIO do ESP32. Esse é o seu PIN_RELAY.

O BLE só funciona no ESP32. Para um ESP8266 (Wemos D1, NodeMCU) ou um relé Wi-Fi comercial use o configurador de internet — aí a ligação vai pela internet.

Se preferir não carregar o programa você mesmo

Três opções para o evitar:

Construir você mesmo — pegue numa placa ESP32 DevKit (uns 5 $) e num módulo de relé de 3,3 V qualquer (uns 2 $). Uma caixa de derivação serve de caixa. Liga-se ao motor tal como um relé industrial. É a via recomendada para a maioria dos casos caseiros.
Um aparelho pela internet — regrave um relé Wi-Fi comercial com contacto seco (Shelly Plus 1) com o nosso programa no configurador de internet, ou deixe-lhe o seu próprio firmware e abra-o através de um webhook. Junto ao motor são precisos Wi-Fi e corrente de rede.
Firmware já pronto, de origem — Tasmota ou ESPHome. Na aplicação cria um objeto Webhook com o endereço do aparelho. Serve-lhe se preferir não pôr o nosso programa no aparelho.

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.