Easy artnet interface

easy-artnet-interface

A open-source project aiming to give access to all people a low budget and easy-to-use artnet-dmx interface node

🎭 Professional WT32-ETH01 Art-Net to DMX Node

Um Node Art-Net para DMX512 de alta performance e nível industrial, desenvolvido para a placa WT32-ETH01 (ESP32 Ethernet).

Este projeto resolve os problemas clássicos de rede em eventos ao vivo: não perde a ligação à internet no seu computador (Mac/Windows), possui DHCP Inteligente com Auto-Router, suporte mDNS, proteção contra apagão DMX (40Hz constante) e Reset de Fábrica sem botões.

📁 Estrutura do Repositório

🚀 Principais Características

• Ethernet Fiável: Baseado no chip LAN8720 (ligação por cabo super estável via UDP).
• DHCP Inteligente com Auto-Router:
  • Se ligado a um Router/Switch: obtém IP automaticamente via DHCP.
  • Se ligado direto ao PC/Mac (sem router): a placa transforma-se num Servidor DHCP automático (Gama 10.0.0.x), permitindo ligação imediata Plug & Play.
• Sem Conflito de Internet: O servidor DHCP interno da placa desativa o envio de Gateway/DNS, permitindo que o Mac/PC continue a usar o Wi-Fi para aceder à internet (WhatsApp, navegação, etc.) enquanto controla a iluminação por cabo.
• Acesso por Nome (mDNS): Aceda ao painel via http://dmx-xxxxxx.local (o sufixo único aparece no serial e no próprio painel; também pode usar o IP mostrado no painel).
• Hub local (MVP): app Rust descobre a interface por mDNS/beacon/scan e abre o painel em http://localhost:8080/d/<id>/, sem .local/cloud; inclui claim code + HMAC no painel. Ver hub/README.md.
• Painel Web de Configuração: Interface responsiva para alterar Universo Art-Net, alternar entre DHCP e IP Fixo.
• Proteção DMX Contínua (40 FPS / 25ms): Se a rede falhar ou o software de luz fechar, o ESP32 continua a enviar a última cena DMX aos aparelhos, evitando apagões ou piscadelas no palco.
• Smart Factory Reset: Reset de fábrica por ciclo de energia (ligar/desligar a placa 2 vezes seguidas rapidamente), eliminando a necessidade de botões físicos.
• Logging Profissional: Utiliza o sistema de logs nativo do ESP32 (log_i, log_w, log_e), eliminando o consumo de CPU em produção.

🛠️ Esquema de Hardware & Pinos

Componentes Necessários

1. Módulo WT32-ETH01 (ESP32 com Ethernet).
2. Transcetor RS-485: Módulo MAX485 padrão (usado e validado neste projeto).
3. Fêmea XLR 3 pinos ou 5 pinos.
4. Fonte de alimentação 5V DC ou conector USB de escolha.
5. (opcional) Programador esp32 cp2102

[!WARNING] SOBRE O MÓDULO RS-485 O esquema de ligações abaixo foi desenhado e testado especificamente para o módulo MAX485 clássico. Se optar por utilizar outros chips (como o SN75176) ou módulos RS-485 isolados de nível industrial, precisará de adaptar as ligações físicas. Alguns módulos isolados gerem o sinal de Enable automaticamente, o que significa que o pino EN (IO04) do ESP32 poderá ter de ser ignorado ou ligado de forma diferente no seu hardware.

Conexões (WT32-ETH01 ↔ Transcetor MAX485)

Conexão DMX (Saída XLR):

• MAX485 A ➔ XLR Pino 3 (DMX +)
• MAX485 B ➔ XLR Pino 2 (DMX -)
• MAX485 GND ➔ XLR Pino 1 (Shield / Terra)

💻 Como Compilar e Enviar o Código

PlatformIO (recomendado)

O platformio.ini já define um ambiente por variante:

pio run -e w5500_sem_int -t upload
pio device monitor

Requisitos (Arduino IDE)

[!IMPORTANT] VERSÃO DO CORE DO ESP32 OBRIGATÓRIA Este projeto manipula o núcleo de rede a baixo nível para criar o Servidor DHCP. O código foi construído e otimizado para o ESP32 Core versão 2.x (recomenda-se a 2.0.17). Instalar a versão 3.x mais recente no Boards Manager causará erros de compilação na variável dhcps_offer_option.

1. Instalar o suporte para ESP32 na Arduino IDE via Boards Manager (esp32 by Espressif Systems).
2. Selecionar a placa: ESP32 Dev Module.
3. Definir a partição de memória: Huge APP ou Default 4MB with spiffs.
4. Bibliotecas Externas Necessárias:
   • esp_dmx (por Mitch Weiss) - Utilizar a versão mais recente.
   • ArtnetWifi (por Hideaki Tai) - Utilizar a versão mais recente.

Configuração do Debug / Logs

Em Ferramentas (Tools) > Core Debug Level:

• Escolha Info ou Debug durante os testes.
• Escolha None ao gravar a versão final de produção para desempenho máximo.

📖 Guia de Utilização

1. Primeiro Arranque (Plug & Play)

1. Ligue o cabo Ethernet entre a placa e o seu computador (ou Switch).
2. Abra o navegador web e aceda ao endereço mostrado no serial/painel: http://dmx-xxxxxx.local (sufixo único do chip), ou use o IP indicado.
3. Configure o Universo Art-Net pretendido (Padrão: 0).

2. Softwares Recomendados

[!TIP] 🌟 EDIÇÃO ESPECIAL QLC+ (Recomendado) Disponibilizamos uma versão customizada (Fork) do QLC+ otimizada especificamente para trabalhar em perfeita harmonia com este Node. Se procura a melhor experiência de uso e estabilidade, descarregue a nossa versão aqui: 👉 Download da Nossa Fork do QLC+

O Node funciona com qualquer software compatível com o protocolo Art-Net I, II, III ou IV:

• QLC+
• Lumikit
• Resolume Arena
• GrandMA2 / GrandMA3 (onPC)
• Onyx (Obsidian)
• MadMapper / Chamsys / FreeStyler

3. Reset de Fábrica (Factory Reset)

Se perder o acesso ao IP ou configurar uma rede incorreta:

1. Ligue a placa à energia.
2. Assim que o LED piscar, desligue da tomada.
3. Repita este processo 2 vezes consecutivas (em menos de 4 segundos em cada tentativa).
4. Na 2ª vez, deixe a placa ligada: a memória interna será apagada e o sistema voltará aos padrões de fábrica (DHCP ativo e rede 10.0.0.1 em fallback).

📜 Licença

Este projeto é um software livre distribuído sob os termos da GNU General Public License v3.0 (GPLv3).

Para mais informações consultar o ficheiro LICENSE

Desenvolvido com foco em alta performance e fiabilidade para eventos ao vivo.