Saltar para o conteúdo
Entrixy Entrixy
Para desenvolvedores

Ligue o seu próprio equipamento ao Entrixy

Um protocolo aberto com exemplos de código e vetores de teste. Construa você mesmo um controlador em ESP32 ou Raspberry Pi, acrescente suporte a Entrixy ao seu próprio aparelho, ou encomende um sistema chave na mão.

Para desenvolvedores

Pegue no que já está pronto e construa o seu

Todos os sketches e imagens de firmware estão publicados abertamente. Ligue um ESP32 ao relé de uma cancela numa tarde, ou construa uma fechadura BLE a pilhas — com HMAC e cifra de ponta a ponta de origem.

pronto · configurador

ESP32 — controlador BLE

Controlo direto a partir do telemóvel por Bluetooth, sem internet nem servidor. ESP32 / S3 / C3 / C6, sono profundo, meses com pilhas AA, ECDH X25519 com HMAC. O .bin é compilado no próprio navegador para os pinos e o chip de que precisa.

pronto · configurador

ESP32 / ESP8266 — Internet

Um canal permanente para o servidor Entrixy por WSS. Um comando da aplicação chega em cerca de 0,5 s e o relé dispara. ESP32, S3, C3, ESP8266 (Wemos D1 mini, NodeMCU). Os relés comerciais Shelly Plus 1 e 1PM podem ser regravados. Compilação no navegador com as credenciais de Wi-Fi e o device_key.

pronto · configurador

Raspberry Pi (Python)

Pi Zero W / 3 / 4 / 5. Um script Python mais uma unidade systemd: um cliente WebSocket que se religa e comanda o GPIO. O configurador no navegador preenche o device_key, o pino GPIO e a duração do impulso.

guia

Documentação para utilizadores

Instalação da aplicação, escolha e gravação de um controlador, emparelhamento, chaves de convidado, automação (geo, Wi-Fi e horário) e segurança. Com passos e capturas de ecrã.

Para fabricantes de equipamento

Integre o Entrixy no seu produto

A barrier, a lock, an intercom, a gate controller. Implement the open protocol and your customers get a mobile app, guest keys and geo-automation without you running a server or an app. Public protocol specifications are temporarily unavailable.

1. Protocol documentation

Public protocol specifications are temporarily unavailable. Contact us to discuss integration.

2. Um protótipo hoje mesmo

Firmware para ESP32 e ESP8266 e o script para Raspberry Pi (código aberto, MIT) — use-os como referência ou compile para a sua própria placa no configurador, que devolve um .bin e o código-fonte. Um objeto do tipo Dispositivo na aplicação e todo o protocolo pode ser verificado de uma vez.

3. Para produção

Um controlador BLE sai vazio: a ligação a um proprietário faz-se localmente e nenhum servidor intervém. Para os aparelhos socket em produção existe a conta de fabricante: emita um lote com um botão, o servidor distribui chaves e códigos de ligação, e imprime um código QR na caixa. O comprador digitaliza-o e liga o aparelho à sua conta. Uma aplicação de marca branca com a sua própria marca está disponível mediante acordo.

Quer que o seu produto funcione independentemente de nós, em vez de depender de uma só empresa? O protocolo é aberto, o servidor é substituível e o BLE funciona offline — veja a arquitetura aberta. Fabrica equipamento? Torne-se fabricante →

Para integradores de sistemas

Monte um sistema para o seu cliente

Um condomínio, um edifício de escritórios, um armazém, uma moradia. Ligue o equipamento existente através de um webhook ou de uma pilha IoT já pronta. As chaves de convidado distribuem-se por código QR, sem telefonar ao porteiro.

Webhook com HMAC

Tudo o que tenha um endpoint HTTP liga-se num minuto. O Entrixy envia um POST para o seu URL, assinado com um segredo partilhado. A proteção contra falsificação segue o RFC 2104.

Aparelhos pela internet

Um controlador com ligação permanente, para locais onde um webhook não serve: sem IP público, com NAT, com internet móvel. ESP32, ESP8266, Raspberry Pi, mais a regravação dos Shelly Plus 1 e 1PM.

Um botão dentro do seu próprio serviço

O seu cliente concede acesso à empresa e a sua aplicação ganha um botão Abrir. Nada circula por conversas: a chave está ligada à sua conta e cada abertura leva o nome do funcionário.

Sistemas de casa inteligente

Home Assistant

Um acionador de webhook em configuration.yaml — o Entrixy pode acionar qualquer entidade do HA: um relé, uma lâmpada, um script. O Home Assistant não verifica a assinatura, por isso o README mostra como colocar à frente dele o receptor em Flask.

ESPHome

Uma configuração YAML que torna o relé um interruptor no Home Assistant. O comando do Entrixy chega-lhe através do Home Assistant.

OpenHAB

Uma regra que transforma um comando num sinal curto no relé. O comando chega através do cliente em Node.js, porque o openHAB não verifica a assinatura.

Node.js

Um cliente WebSocket pronto para o seu próprio servidor, com religação. Também passa comandos ao openHAB, Shelly e Tasmota.

Tasmota

Um comando HTTP enviado pelo telefone dentro da sua rede doméstica ou passado pelo cliente em Node.js. O PulseTime transforma-o num sinal curto.

Shelly

Um comando HTTP enviado pelo telefone dentro da sua rede doméstica ou passado pelo cliente em Node.js. Sem regravar o firmware.

Não vê o seu caso?

Escreva-nos: ajudamos a escolher a via de integração e partilhamos rascunhos de documentação que ainda não estão no site.

hello@entrixy.com