Skip to content

Releases

2026.11.1

Choose a tag to compare

@cateim cateim released this 05 Nov 15:56

🔧 Changed

  • A busca automática agora é opcional e vem desligada. A integração só percorre a rede quando você pede: no cadastro e em Configurar → Procurar módulos na rede. A busca ao iniciar e a cada hora (porta 4998, até 1024 endereços) passou para Configurar → Busca automática, desligada por padrão, também em quem atualizar. Foi o pedido da revisão do catálogo padrão do HACS: tráfego que ninguém pediu, na rede de todo usuário. Numa rede em que o Home Assistant não mostra o card dos módulos sozinho (num roteador Deco, o navegador DHCP do HA não listou nenhum), ligue a opção.

2026.10.8

Choose a tag to compare

@cateim cateim released this 22 Oct 18:55

🔧 Changed

  • O card de descoberto diz o tipo e o IP (Relé - 192.168.1.22, Dimmer - 192.168.1.23) em vez de ControlArt e o MAC inteiro, que repetia o nome da integração da linha de baixo. O MAC inteiro continua no formulário que o card abre e no card do dispositivo depois do cadastro. A lista da busca, em Adicionar integração e em Procurar módulos na rede, usa o mesmo formato.
  • O menu da busca não diz mais "3 módulo(s)": "Módulos ControlArt que responderam na rede do Home Assistant: 3."

2026.10.7

Choose a tag to compare

@cateim cateim released this 22 Oct 17:26

🔧 Changed

  • Pronto para o catálogo padrão do HACS. A validação do HACS no CI roda sem nenhuma checagem desligada (saiu o ignore: brands: o ícone vem da pasta brand/ da integração), que é o que o hacs/default exige. O hacs.json ganhou "country": "BR", porque os módulos ControlArt são vendidos no Brasil: no catálogo, o HACS mostra a integração para quem configurou o Brasil.

2026.10.6

Choose a tag to compare

@cateim cateim released this 22 Oct 11:03

🔧 Changed

  • O README explica o caminho sem nenhum clique: numa rede UniFi, com a integração UniFi Network no Home Assistant, ela informa ao HA o IP e o MAC de cada aparelho a cada início, e o reconhecimento pelo início 00-60-37 (desde a 2026.10.4) abre o card de cada módulo sozinho. Conferido no código do HA (device_tracker/entity.py avisa a descoberta DHCP até dos rastreadores criados desligados); ainda não testado com módulos numa rede UniFi.

🐛 Fixed

  • A busca da 2026.10.5 não achou os módulos de um cliente e o cadastro abriu direto no pedido de IP. Causa, vista no servidor dele: o IP fixo do Home Assistant foi gravado com máscara /32, então a rede "do HA" era só ele mesmo e a busca percorreu zero endereços. Os módulos respondiam normalmente, pelo roteador. Agora uma máscara menor que /24 (como /32) vira o /24 do IP do HA. Com o código novo rodado no próprio servidor do cliente, a busca achou os três módulos em 2 s.
  • A busca ficou mais robusta, nos pontos que apareceram enquanto a causa não era conhecida:
    • Uma conexão só por endereço. A 2026.10.5 abria uma conexão para ver a porta, fechava e abria outra para perguntar. O módulo é um aparelho embarcado, muitas vezes com as conexões do Node-RED abertas; agora a pergunta vai na mesma conexão.
    • Segunda rodada pela tabela ARP. A tentativa em cada endereço faz o sistema aprender o MAC dos aparelhos da rede. Os que começam com 00:60:37 são perguntados de novo, com 5 s de espera e duas tentativas, e trazem o MAC inteiro para o card. Não ajuda num servidor como o desse cliente, que fala com a rede só pelo roteador.
    • Menos tentativas ao mesmo tempo (128, eram 256), para não encher a tabela ARP do sistema, que para em 1024 linhas: um /22 leva uns 8 s.
    • Cada busca deixa uma linha no log (ControlArt: busca em N enderecos…): quantos endereços, os módulos achados, os aparelhos 00:60:37 que o ARP mostrou e quem atendeu sem responder como módulo. "busca em 0 enderecos" teria mostrado o problema na hora.
    • Um aparelho 00:60:37 que o ARP mostrou mas que não respondeu já vem preenchido no pedido de IP.

2026.10.5

Choose a tag to compare

@cateim cateim released this 22 Oct 01:41

✨ Added

  • O cadastro procura os módulos na rede. Em Adicionar integração, a integração tenta a porta 4998 em cada endereço da rede do Home Assistant (alguns segundos) e lista os módulos que responderem, com o MAC da etiqueta e o IP. Basta escolher, dar o nome e marcar as teclas; Informar o IP continua como alternativa. Em Configurar, Procurar módulos na rede faz o mesmo para os módulos seguintes.
  • Busca de hora em hora. Com a integração configurada, a mesma busca roda ao iniciar e a cada hora: um módulo novo aparece como card de Descoberto, e um módulo cadastrado que mudou de IP volta sozinho no endereço novo.

🐛 Fixed

  • Nenhum card aparecia depois de instalar e reiniciar. A 2026.10.4 contava com o Home Assistant achando os módulos pelo início do MAC, mas o HA só vê o módulo quando ele pede IP ao ligar: a varredura de hora em hora do HA só devolve aparelho com nome reverso no DNS do roteador, o que roteador doméstico não costuma ter. Num cliente (Deco), o navegador DHCP do HA não mostrou nenhum módulo. A busca da própria integração resolve, e o reconhecimento pelo MAC continua para quando o módulo liga.

2026.10.4

Choose a tag to compare

@cateim cateim released this 21 Oct 23:45

✨ Added

  • Os módulos aparecem sozinhos depois de instalar e reiniciar. O Home Assistant reconhece o módulo pelo início do MAC, 00-60-37, igual em todo módulo ControlArt, e mostra um card de Descoberto por módulo em Dispositivos e serviços. O IP, o tipo e as saídas o módulo já informou: o card só pede o nome e as entradas de keypad. O primeiro card cria a integração e os seguintes entram nela; Ignorar vale só para aquele módulo. Funciona também com IP fixo no mdConfig, porque o Home Assistant varre a rede ao iniciar e a cada hora. Esse início de MAC é da NXP, a fabricante do chip, então a integração pergunta ao aparelho na porta 4998 antes de mostrar o card, e o que não responder como ControlArt não aparece. O cadastro pelo IP continua, para módulo em outra porta ou outra rede.
  • Um módulo cadastrado que muda de IP volta sozinho. Quando o Home Assistant vê o módulo em outro endereço, a integração troca o IP do cadastro e reconecta. O IP fixo continua recomendado, mas deixou de ser obrigatório.

🔧 Changed

  • O card do dispositivo mostra o MAC inteiro, como o mdConfig e a etiqueta da caixa, em vez de só os três últimos bytes que o módulo informa. Os dispositivos já cadastrados trocam o MAC curto pelo inteiro no primeiro início; os ids das entidades não mudam. O diagnóstico também traz o MAC inteiro.

2026.10.3

Choose a tag to compare

@cateim cateim released this 21 Oct 16:33

🔧 Changed

  • O ícone e o logo são os oficiais da ControlArt. Saíram do logo horizontal do site do fabricante: os dois círculos no ícone e a marca inteira no logo. O tema escuro ganhou versões próprias (dark_icon, dark_logo) com o anel verde e o disco branco, como no site; no tema claro ficam o anel cinza e o disco verde do favicon deles. O README diz de quem é a marca.
  • O README abre com os badges dos outros projetos: HACS, a versão mínima do Home Assistant (2025.1), a versão atual e a licença.

🐛 Fixed

  • O link da licença nos Créditos não abria dentro do HACS. O HACS só reescreve um link relativo quando nada depois dele na mesma linha tem ://, e o link do Hubitat vinha logo depois. O link agora é absoluto.

2026.10.2

Choose a tag to compare

@cateim cateim released this 18 Oct 16:20

🐛 Fixed

  • O MAC voltou ao card do dispositivo. A 2026.10.1 trouxe do projeto original a remoção dele e ainda apagava o MAC dos dispositivos já cadastrados no primeiro início. O MAC (os três bytes que o módulo informa, os mesmos do mdConfig) é o que diz qual módulo é qual, e fica no card. Quem chegou a rodar a 2026.10.1 recebe o MAC de volta no primeiro início.

2026.10.1

Choose a tag to compare

@cateim cateim released this 18 Oct 15:07

Primeira versão como projeto próprio da Self-Labs, inspirado no
tompsonpecini/controlart.

✨ Added

  • Módulo dimmer: o cadastro reconhece o tipo pelo cabeçalho setdmmd e o número de canais pelo tamanho do quadro. Cada canal vira uma light com brilho de 0 a 255, enviado direto ao módulo (128 é 128, conferido em módulo real). Ligado sem brilho escolhido, volta ao último nível aceso desde que o Home Assistant iniciou, ou ao máximo.
  • Transição no dimmer (transition em light.turn_on e light.turn_off): rampa feita pela integração, um nível de cada vez, com pelo menos 0,2 s entre degraus, cancelada por um comando novo no mesmo canal.
  • Sensor de diagnóstico com o endereço IP de cada módulo, visível mesmo com o módulo fora do ar.
  • Botões "Acender tudo" e "Apagar tudo" por módulo, com um comando só (mdcmd_setallonmd e mdcmd_setalloffmd), esperando o quadro de confirmação.
  • Diagnóstico para download: as últimas 50 linhas trocadas com cada módulo nos dois sentidos, as conexões e quedas, as linhas de configuração de motor e as respostas de firmware e MAC, para suporte a distância.
  • Firmware no card do dispositivo, no formato do mdConfig (3.027 nos relés, 1.021 no dimmer).
  • Botões do My Home Assistant no README, para abrir o repositório no HACS e começar o cadastro.
  • Testes com unittest e um Home Assistant falso, rodando no CI junto com hassfest e a validação do HACS.

🔧 Changed

  • Projeto próprio: codeowners, documentation e issue_tracker apontam para self-labs/controlart, e o botão do HACS no README abre este repositório. Quem instalou como repositório personalizado do HACS não precisa trocar nada.
  • Versões em CalVer, publicadas como releases do GitHub: o HACS oferece cada versão nova como atualização, em vez de um commit.
  • Comando que o módulo não confirma em 3 s vira erro no Home Assistant, em vez de passar em silêncio.
  • Módulo mudo derruba a conexão: sem resposta ao getmd em 10 s, a sessão cai e a integração reconecta, e as entidades ficam indisponíveis até o módulo voltar.

🐛 Fixed

  • Tecla de keypad perdia o segundo toque: o quadro de limpeza não zerava as teclas, e dois toques seguidos sem limpeza no meio também se perdiam porque o módulo não avisa quando a tecla é solta. Agora as teclas zeram na limpeza e, depois de cada toque, a integração pede o estado a cada segundo, até 5 vezes, até ver a tecla solta.
  • Estado velho depois de uma queda: o módulo volta a contar como sem estado conhecido quando a conexão cai.
  • Apagar o dimmer com transição deixava um degrau da rampa como "último nível" (20% numa rampa de 1 s), e acender sem brilho parecia não acender. Os degraus da rampa não contam mais.
  • Os três bytes que o módulo informa entravam como MAC de rede (CONNECTION_NETWORK_MAC), que o Home Assistant usa para juntar aparelhos de integrações diferentes. Continuam como identificador do dispositivo e no diagnóstico. Nos dispositivos cadastrados antes, o MAC velho sai do registro no primeiro início, porque o Home Assistant soma connections e nunca tira sozinho.
  • Firmware vazio: o módulo responde só o número (3027), não VERSION... como no driver Hubitat.
  • Aviso de device_registry.async_get_device obsoleto no HA 2026.10: o dispositivo é procurado entre os da própria entrada.

v1.0.1

Choose a tag to compare

@cateim cateim released this 06 Nov 23:59

✨ Added

  • Ícone da integração (brand/).