Pular para o conteúdo
SHCDocumentação SHC

Control Xcene: interface XNET

A interface XNET do Control Xcene (série CS) recebe mensagens em bytes pela rede cabeada XNET. Esta página mostra as mensagens de disparo de cena, status das cargas, comando de botão e consulta dos LEDs de cena.

Configurações de comunicação

Seção intitulada “Configurações de comunicação”

A interface usa estes parâmetros fixos:

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

Disparo de cena

Seção intitulada “Disparo de cena”

Ativa uma cena, com o tempo de transição e a intensidade de cada carga.

Estrutura da mensagem

Seção intitulada “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

Seção intitulada “Exemplo — Disparar cena para equipamento no endereço 0x01”
0x01 | 0x03 | 0x0D | 0x00 | 0x05 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x0D — ID: 0x01, Função: 0x03, Qbyte(-1): 0x0D, Tempo: 0x00, Tempo: 0x05, Carga: 0x50, Carga: 0x50, Carga: 0x50, Carga: 0x50, Carga: 0x50, Carga: 0x50, Carga: 0x50, Carga: 0x50, CRC: 0x0D

Parâmetros

Seção intitulada “Parâmetros”
  • ID: endereço do Control Xcene (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)

Status das cargas

Seção intitulada “Status das cargas”

Informa aos equipamentos o estado das cargas depois do envio de uma cena. O equipamento não envia essa informação sozinho: o seu sistema precisa enviá-la.

Estrutura da mensagem

Seção intitulada “Estrutura da mensagem”

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

Exemplo — Status de cargas do equipamento 0x01 via broadcast

Seção intitulada “Exemplo — Status de cargas do equipamento 0x01 via broadcast”
0xFF | 0x02 | 0x0A | 0x01 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x50 | 0x0D — ID: 0xFF, Função: 0x02, Qbyte(-1): 0x0A, ID: 0x01, Carga: 0x50, Carga: 0x50, Carga: 0x50, Carga: 0x50, Carga: 0x50, Carga: 0x50, Carga: 0x50, Carga: 0x50, CRC: 0x0D

Comando de botão

Seção intitulada “Comando de botão”

Simula o toque num botão de cena do Control Xcene.

Estrutura da mensagem

Seção intitulada “Estrutura da mensagem”

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

O valor de Botão/Comando depende do botão (1 a 12) e do gesto: Release (soltar), Press (pressionar) ou Hold (segurar). Use a tabela de referência.

Exemplos

Seção intitulada “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)
0x01 | 0x01 | 0x04 | 0xCC | 0x0D

Tabela de referência rápida

Seção intitulada “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

LEDs de cena

Seção intitulada “LEDs de cena”

Consulta quais LEDs de cena estão acesos no painel, ou seja, quais cenas estão ativas.

Estrutura da mensagem

Seção intitulada “Estrutura da mensagem”

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

Exemplo — Verificar LED da cena 5 no equipamento 0x01

Seção intitulada “Exemplo — Verificar LED da cena 5 no equipamento 0x01”

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

Explicação dos campos

Seção intitulada “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

Seção intitulada “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

Consultar vários LEDs

Seção intitulada “Consultar vários LEDs”

Some os valores das cenas na tabela. Para as cenas 1, 3, 5 e 6: 0x01 + 0x04 + 0x10 + 0x20 = 0x35. A mensagem fica 0x01 | 0x0A | 0x04 | 0x35 | 0x0D.