Pular para conteúdo

🔧 Descrição da ação

A interface XNET do Control CS permite a comunicação com o sistema de automação XCENE por meio de mensagens estruturadas. Essa comunicação é exclusiva para redes cabeadas via XNET.

⚠️ Atenção: Nunca interligue diretamente a rede XNET com uma rede serial RS232 sem a interface apropriada.

Configurações de Comunicação

As configurações da interface RS232 são fixas e devem ser respeitadas para garantir o correto funcionamento:

Configuração Valor
Velocidade 19.200 baud
Paridade Nenhuma
Bits de dados 8
Stop bit 1

Disparo de Cena

Esta mensagem envia ao equipamento um comando para ativar uma cena com tempos de fade e intensidades específicas para cada carga.

Estrutura da mensagem

ID | Função | Qbyte(-1) | Tempo HI | Tempo LO | Carga 1 ... Carga 8 | CRC

Exemplo — Disparar cena para equipamento no endereço 0x01:

0x01 | 0x03 | 0x0D | 0x00 | 0x05 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x0D

Parâmetros

  • ID: Endereço do equipamento Control CS (0x00 a 0x0F)
  • Função: 0x03 — disparar cena
  • Qbyte(-1): quantidade de bytes a serem transmitidos menos 1
  • Tempo HI / LO: tempo de fade da cena, em milissegundos (HI = parte alta, LO = parte baixa)
  • Carga 1 a 8:
  • 0x00 a 0xF0 (0 a 240): intensidade
  • 0xFF (255): a carga não participa da cena
  • CRC: valor fixo 0x0D (CHECK desativado)

Atualização de Status das Cargas

Permite que o sistema informe o status atual das cargas após o envio de uma cena. O equipamento não envia essa informação automaticamente, portanto, o software deve atualizá-la por conta própria.

Estrutura da mensagem

ID | Função | Qbyte(-1) | ID Control | Carga 1 ... Carga 8 | CRC

Exemplo — Status de cargas do equipamento 0x01 via broadcast:

0xFF | 0x02 | 0x0A | 0x01 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x0D

💡 0xFF é usado como endereço broadcast para atualizar todos os dispositivos da rede com o status informado.

Comando de Botão

Simula a ativação física de um botão de cena no equipamento Control CS.

Estrutura da mensagem

ID | Função | Qbyte(-1) | Botão/Comando | CRC

Para calcular o valor de Botão/Comando, use:

  • Botões de 1 a 12 → base hexadecimal 0xC0 + número do botão
  • Acrescente:
  • +1 para Release
  • +2 para Press
  • +3 para Hold

⚠️ Os valores resultantes devem ser enviados como um único byte hexadecimal.

Exemplos

Pressionar botão 12 (Press)
0x01 | 0x01 | 0x04 | 0xE3 | 0x0D

Soltar botão 12 (Release)
0x01 | 0x01 | 0x04 | 0xE2 | 0x0D

Segurar botão 4 (Hold)
- Botão 4 = 0xC0 + 4 + 3 = 0xCC

Comando completo:
0x01 | 0x01 | 0x04 | 0xCC | 0x0D

Tabela de referência rápida

Botão Release Press Hold
1 0xC1 0xC2 0xC3
2 0xC4 0xC5 0xC6
3 0xC7 0xC8 0xC9
4 0xCA 0xCB 0xCC
5 0xCD 0xCE 0xCF
6 0xD0 0xD1 0xD2
7 0xD3 0xD4 0xD5
8 0xD6 0xD7 0xD8
9 0xD9 0xDA 0xDB
10 0xDC 0xDD 0xDE
11 0xDF 0xE0 0xE1
12 0xE2 0xE3 0xE4

💡 Use o valor da coluna correspondente no campo Botão/Comando da mensagem:

0x01 | 0x01 | 0x04 | <valor acima> | 0x0D

Status do LED de Cena

Essa ação permite consultar o estado atual dos LEDs de cena no equipamento.
O comando retorna quais LEDs estão acesos, ou seja, quais cenas estão visivelmente ativas no painel frontal.

⚠️ Trata-se de uma leitura — não é possível acender ou apagar LEDs com esse comando.

Estrutura da mensagem

ID | Função | Qbyte(-1) | Valor do LED | CRC

Essa estrutura solicita ao equipamento o estado visual atual (ligado/desligado) dos LEDs de cena.

Exemplo — Verificar LED da cena 5 no equipamento 0x01:

0x01 | 0x0A | 0x04 | 0x10 | 0x0D

Explicação dos campos

  • ID: Endereço do equipamento que receberá o comando (ex: 0x01)
  • Função: Código da função — sempre 0x0A para consulta de LEDs de cena
  • Qbyte(-1): Quantidade de bytes a serem transmitidos, menos 1 (ex: 0x04)
  • Valor do LED: Byte com bits ligados representando os LEDs a serem consultados
  • CRC: Código fixo de fim da mensagem — sempre 0x0D

Tabela de referência de LEDs de cena

Cena Valor em Hex Descrição
1 0x01 Consultar status do LED da cena 1
2 0x02 Consultar status do LED da cena 2
3 0x04 Consultar status do LED da cena 3
4 0x08 Consultar status do LED da cena 4
5 0x10 Consultar status do LED da cena 5
6 0x20 Consultar status do LED da cena 6
1 + 2 0x03 LEDs das cenas 1 e 2
1–5 0x1F LEDs das cenas 1 a 5
1–6 (todos) 0x3F Todos os LEDs de cena

Como montar a mensagem

  1. Escolha os LEDs que deseja consultar.
  2. Some os valores hexadecimais correspondentes.
  3. Monte a mensagem com base na estrutura.

Exemplo:
Para consultar os LEDs das cenas 1, 3, 5 e 6:
0x01 + 0x04 + 0x10 + 0x20 = 0x35

Mensagem final: 0x01 | 0x0A | 0x04 | 0x35 | 0x0D

Resumo

  • A comunicação ocorre via rede cabeada XNET
  • A mensagem consulta o status visual dos LEDs de cena
  • Não altera o estado dos LEDs
  • O comando é binário, enviado em hexadecimal
  • O CRC de término é sempre 0x0D