Driver Details

New Community

ControlArt

By: Flavio Matioli
Updated: Aug. 8, 2026
Version: 1.4
Download Driver
Rating: 5.0 (1 rating)
Log in to rate this driver

ControlArt Driver

Esse driver controla módulos relé e dimmer associados a uma controladora xPort e módulos cabeados sem a necessidade de uma controladora. Driver otimizado para ID10 APEX também funciona no ID9.

O driver permite controlar:

• Módulos relé e dimmer de 3 cargas.

• Módulos para controle de motor.

• Módulos RGBW

• Keypads IVOLV xBus

• Módulos Cabeados relé MCRL1 e MCRL2.

• Módulos Cabeados Dimmer

O driver funciona por 30 minutos em modo teste sem licença. Recomendado o uso da versão 1.0 ou superior em ambiente de produção.

Vídeos de Configuração disponiveis em: matioliflavio.github.io/RTI-Drivers/

Modo de Uso:

Para módulos xBus (RF wireless com feedback), Relé / Dimmer / Motor / RGBW

1. Utilizando o xConfig, associe os módulos na controladora xPort e tome nota dos endereços MAC e dos nomes dos circuitos de todos os módulos.

3. Configure um IP fixo na controladora xPort e se necessário altere a porta de controle. Certifique-se de que o IP da controladora está fora do range DHCP e na mesma rede da processadora RTi XP-x.

4. Adicione o driver no seu projeto RTI, quando estiver utilizando o APEX, deve ser adicionado uma instância do driver para cada um dos módulos (Relé/Dimmer, Motor, RGBW ou Keypads xBus).

5. Acesse as propriedades do Driver e preencha com as informações que você anotou. (Vc anotou né?)

6. Preencha o endereço de cada módulo exatamente da mesma forma como se encontra na etiqueta. Exemplo: 5E-38-08.

7. Para facilitar a configuração, coloque o nome da cada um dos circuitos. Isso ajuda muito!

8. Adicione os comandos e variáveis aos botões de controle.

9. Teste tudo.

Modo de Uso:

Para módulos cabeados Relé e Dimmer

1. Para módulos cabeados, não é necessário o uso de uma central xPortPro. Porém o módulo deve ser configurado com um endereço de IP fixo e uma porta.

2. No MdConfig deixe marcada a opção "Gtw da xPort" em todos os módulos, sim eu sei que a alexa não vai funcionar mais diretamente no modulo.

3. Tome nota de todos os endereços e porta de todos os módulos cabeados.

4. Adicione o driver no seu projeto RTI, quando estiver utilizando o APEX, deve ser adicionado uma instância do driver para cada um dos módulos cabeados.

5. Acesse as propriedades do Driver e preencha com as informações que você anotou. (Vc anotou né?)

6. Aqui você deve estar achando que eu copiei tudo lá de cima. É verdade, mas é pra fazer assim mesmo!

7. Nomeie os módulos e circuitos para facilitar a programação

8. Caso não esteja utilizando uma central xPort, selecione a opção SEM CONTROLADORA XPORT no tipo de conexão da xPort.

9. Sirva com sal a gosto.

Dicas:

• A variável de texto “Nome” para cada circuito, coloca no botão o nome declarado na configuração. Use essa variável ao invés de colocar o nome diretamente no botão. Quando você faz isso, para mudar o nome do circuito basta editar na configuração do driver e todos os nomes do seu projeto serão atualizados!

• A variável Temperatura de cada módulo (xBus somente) declarado, mostra a temperatura real do MÓDULO e não do ambiente! Ela é atualizada automaticamente a cada 2 minutos vezes número de módulos (10 módulos = 20 minutos para atualizar todos).

• Os eventos dos botões são executados sempre que o estado for alterado, prefira sempre utilizar esses eventos com pulsadores para ter um comportamento melhor.

• Para controle dos motores de cortinas e persianas através do slider (controle por porcentagem), é preciso calibrar a persiana pelo programa xConfigPro. Sem calibração, nada feito, não me culpe.

• Você pode enviar comandos de IR para as portas IR da xPort e módulo RF to IR usando a função Sendir. Basta colar o código no formato global cache com a porta ajustada no código. Ah... não precisa colocar \r no final.

Cenas:

Para executar as cenas que você configurou na central XPort, utilize o comando Send Raw. Nele, você pode colocar qualquer string que a central executará. Você pode mandar outros comandos como um sendir,1:...

Limites:

Módulos dimmer e Rele - até 50.

Módulos motor - até 15.

Módulos RGBW - até 15.

Keypads xBus - até 60.

Módulos Cabeado Rele - até 30.

Módulos Cabeado Dimer - até 20.
Keypads Can - até 25 por módulo.

Changelog:

V1.0 - versão de lançamento na RTI DriverStore - sem mudança no codigo

V1.1 - Corrigido problema dos eventos nos keypads CanBus ligados nos modulos cabeados relé

V1.2 - Melhorado tratativa de feedback.

V1.3 - Corrigido problema ao ajustar brilho nos keypads can ligados aos modulos dimmer.

V1.4 - Ajustes nos eventos dos keypads Can e documentação;

Problemas Conhecidos:

1. Variável de estado da conexão da xPort indica desconectado quando não existem módulos xBus configurados

2. Essa versão do driver será descontinuada para dar lugar a uma melhor e mais fácil de programar e com suporte facilitado a integração nativa com Alexa. Ainda haverá correções de erros críticos e suporte para todos que que já adquiriram uma licença, mas não espere ver novas funcionalidades por aqui ;-)

Funcionalidades a serem implementadas:

Nenhuma

Funcionalidades de cada Módulo

Módulos xBus Relé/Dimmer:

Funções:

ON, OFF, TOGGLE, DIM

Variáveis:

NOME, STATUS, LEVEL, TEMPERATURA DO MÓDULO

Eventos:

LOAD ON, LOAD OFF, LOAD CHANGE, BOTÃO ON(x3), BOTÃO OFF(x3), BOTÃO CHANGE(x3)

TAGs:

1, 2, 3

Módulos xBus Motor:

Funções:

DIREÇÃO 1, DIREÇÃO 2, PARA, LEVEL

Variáveis:

NOME, DIREÇÃO 1, DIREÇÃO 2, LEVEL, TEMPERATURA

Eventos:

DIREÇÃO 1, DIREÇÃO 2, BOTÃO ON(x2), BOTÃO OFF(x2), BOTÃO CHANGE(x2)

TAGs:

Level, Direção 1, Direção 2, Direção Para

Módulos xBus RGBW:

Funções:

ON, OFF, DIM, CENA(x4), GRAVA CENA

Variáveis:

NOME, STATUS, LEVEL, TEMPERATURA DO MÓDULO

Eventos:

BOTÃO ON(x3), BOTÃO OFF(x3), BOTÃO CHANGE(x3)

TAGs:

1 Level, 2 Level, 3 Level, 4 level

Keypads xBus Relé/Dimmer:

Funções:

ON, OFF, TOGGLE, DIM

Variáveis:

NOME, STATUS, LEVEL, TEMPERATURA DO MÓDULO

Eventos:

LOAD ON, LOAD OFF, LOAD CHANGE, BOTÃO PRESS(x6), BOTÃO HOLD(x6), ENTRADA ON(x3), ENTRADA OFF(x3), ENTRADA CHANGE(x3)

TAGs:

1, 2, 3

Módulos Cabeado Rele:

Funções:

ON, OFF, TOGGLE, ALL ON, ALL OFF, ABRE, PARA, FECHA, SET

Variáveis:

NOME, STATUS CONEXÃO, ON, OFF, ABRE, FECHA, POSIÇÃO

Eventos:

LOAD ON, LOAD OFF, LOAD CHANGE, BOTÃO ON(x12), BOTÃO OFF(x12), BOTÃO CHANGE(x12)

TAGs:

1, 2, 3, 4, 5, 6, 7, 8, 9, 10, Shade Up 1, Shade Stop 1, Shade Down 1, Shade Set 1, ..., Shade Set 5

Módulos Cabeado Dimer:

Funções:

DIM, ON, OFF, TOGGLE, ALL ON, ALL OFF

Variáveis:

NOME, STATUS CONEXÃO, ON, OFF, LEVEL

Eventos:

LOAD ON, LOAD OFF, LOAD CHANGE, BOTÃO ON(x12), BOTÃO OFF(x12), BOTÃO CHANGE(x12)

TAGs:

1, 2, 3, 4, 5, 6, 7, 8, 9 (para função Toggle)

1 Level, 2 Level, 3 Level, 4 Level, 5 Level, 6 Level, 7 Level, 8 Level, 9 Level (para função Dim)

M4

Driver works for 30min in trial mode.

Licence cost: US$50,00 / R$250,00

Paypal/Pix: matioliflavio@gmail.com

Send me your deposit to get license number.

Please log in to leave a comment.
Loading comments...