OnOfre

---

O EasyIot é o firmware oficial das placas OnOfre e funciona em qualquer placa baseada em ESP8266 ou ESP32. Configura-se por um painel web servido pelo próprio equipamento — sem aplicação para instalar, sem conta para criar, sem ligação à Internet para funcionar.

Tudo o que o equipamento faz, decide-o ele: as luzes respondem ao botão de parede mesmo com o Wi-Fi em baixo, e um programa de rega continua a correr se a rede falhar a meio.

O que faz

Comandar

Luzes e tomadas	botão de pressão ou interruptor, com desligar automático opcional
Estores	um botão, dois botões ou dois interruptores, com tempos de subida e descida
Portões	impulso com tempo configurável
Rega	electroválvulas com contagem decrescente por zona

Medir

Temperatura e humidade	DHT11, DHT21, DHT22, DS18B20, SHT4X
Energia	PZEM-004T v1 e v3, e contador da rede por HAN / Modbus
Água	contador de água por indução com o LDC1612, lido através do registo do próprio contador
Presença e movimento	PIR e radares LD2410 / LD2420
Distância e nível	HC-SR04 e TMF882X
Estado	porta, janela, chuva
Luminosidade	LTR303

Rega autónoma

Programas com hora de início, dias da semana e duração por zona. O ciclo corre no equipamento, não na nuvem nem no Home Assistant. Salta o ciclo se o sensor de chuva estiver activo, e limita quantos sectores abrem ao mesmo tempo — porque a pressão da água é que decide, não o software.

Integrar

MQTT	broker local, tópicos por função
Home Assistant	descoberta automática; sensores de energia e água entram nos painéis de Energia e Água
KNX	endereço de grupo por actuador
OnOfre Cloud	opcional, para acesso remoto e actualizações
REST + SSE	/config, /features, /irrigation, /logs e um fluxo de eventos ao vivo

O painel

Servido pelo equipamento, sem dependências externas — funciona numa cave sem Internet.

Mapa de pinos lido da própria placa. Mostra a que função pertence cada pino ocupado e quais estão reservados. A lista vem do firmware, não da página, por isso não mente sobre o que aquela placa aceita.

Predefinições para as montagens comuns — duas luzes, duas tomadas, estore, portão, contador HAN, rega, contador de água — e configuração função a função quando é preciso sair delas.

Diagnóstico com memória, tempo ligado, estado da rede e das ligações, e o registo do próprio equipamento — o que ele viu desde que arrancou, que é o que interessa colar num relato de avaria.

Tema claro e escuro, e o painel adapta-se ao telefone.

Instalar

As placas OnOfre já vêm com o firmware instalado e actualizam-se pelo ar. Numa placa própria, compila e grava — ver Compilar.

1. Ligar ao ponto de acesso que a placa cria, OnOfre-16776767-9x202 por exemplo, com a palavra-passe bhonofre.
2. Abrir http://192.168.4.1, escolher a rede Wi-Fi, dar um nome ao equipamento e, se quiseres, uma predefinição de funções.
3. Abrir o painel em http://<nome>.local ou pelo endereço IP.
4. Configurar as funções — que pinos, que tipo, que tempos.
5. Opcional: apontar o MQTT ao broker do Home Assistant. As entidades aparecem sozinhas, sem YAML.

Valores por omissão

Palavra-passe do ponto de acesso	bhonofre
Painel web	admin / xpto

Ambos se mudam no painel, em Sistema → Acesso. Muda-os.

Hardware

Compila para ESP8266, ESP32, ESP32-C3 e ESP32-C6. As placas OnOfre trazem o firmware instalado.

• Placa OnOfre
• Placa PZEM

Compilar

Visual Studio Code com PlatformIO.

pio run -e ESP8266_RELEASE          # ou ESP32_RELEASE, ESP32C3_HAN, ESP32C6_...
pio run -e ESP8266_RELEASE -t upload --upload-port /dev/cu.usbmodemXXXX

Antes de um commit ou pull request:

python3 tools/check_project.py --quick
python3 tools/check_project.py --build ESP8266_DEBUG    # com compilação

A matriz completa das verificações está em docs/RELEASE_WORKFLOW.md.

Para ver actualizações de dependências sem mexer no platformio.ini:

python3 tools/audit_dependencies.py
python3 tools/audit_dependencies.py --env ESP8266_DEBUG

Binários locais

Depois de compilar, tools/export_firmware.py guarda o binário como candidato, verifica-o por SHA-256 e, depois de testado na placa, promove-o a versão conhecida e funcional. Os ambientes com DEBUG ou RELEASE no nome guardam o candidato automaticamente no fim de uma compilação bem sucedida. A pasta firmware_bins/ é local e está fora do Git.

Comandos de publicação e promoção em docs/RELEASE_WORKFLOW.md.

Mais

• bhonofre.pt — painel CloudIO, para gerir os equipamentos à distância
• Tutoriais em vídeo

Donativos

Se o projecto te foi útil:

---