S3B_SET_PREAMBLE

Com este bloco é possível configurar o parâmetro de preâmbulo (Hopping) do módulo comunicação wireless S3B. Este parametro é utilizado para se criar subredes em um conjunto de rádios. Apenas os rádios configurados como o mesmo valor do parâmetro preâmbulo participam de uma rede e podem trocar informações entre si.

Com este recurso em uma região com vários rários podem exisitir mais de uma subrede independente os os radios apenas trocam dados na sua subrede.

Atenção

Ao ser ativado, o rádio XBee sai do modo transparente e entra no modo de comando AT. Se o canal estiver em comunicação no momento da ativação do bloco, a comunicação será interrompida até que o processo de configuração seja concluído.

Bloco

          S3B_SET_PREAMBLE
         +-----------------+
 BOOL ---|START        DONE|--- BOOL
         |                 |
USINT ---|COMM_SRC   RESULT|--- INT
         |                 |
USINT ---|X_HP             |
         +-----------------+

Parâmetros

Nome	Classe	Tipo	Dim.	V. Ini.	Opções	Descrição
START	Entrada	BOOL		0		Habilita operação do bloco
COMM_SRC	Entrada	USINT		0		Canal de comunicação de interface com XBee
X_HP	Entrada	USINT		0		Valor do preâmbulo (Hopping) a ser configurado (0..7)
DONE	Saída	BOOL		0		Sinaliza o fim do processo
RESULT	Saída	INT		0		Código de retorno do processo

START

Habilita operação do bloco. Este bloco é executado apenas a cada transição da entrada START.

COMM_SRC

O canal de comunicação utilizado é especificado por um identificador (valor numérico) conforme indicado na tabela a seguir:

Nome	Ident.	Descrição
HILS.COM1_PORT_ID	0	Canal serial COM1
HILS.COM2_PORT_ID	1	Canal serial COM2
HILS.COM3_PORT_ID	2	Canal serial COM3
HILS.COM4_PORT_ID	3	Canal serial COM4
HILS.COM5_PORT_ID	4	Canal serial COM5
HILS.COM6_PORT_ID	5	Canal serial COM6
HILS.COM7_PORT_ID	6	Canal serial COM7
HILS.COM8_PORT_ID	7	Canal serial COM8
HILS.SOCK0_PORT_ID	8	Controlador Ethernet 1: Socket 0
HILS.SOCK1_PORT_ID	9	Controlador Ethernet 1: Socket 1
HILS.SOCK2_PORT_ID	10	Controlador Ethernet 1: Socket 2
HILS.SOCK3_PORT_ID	11	Controlador Ethernet 1: Socket 3
HILS.SOCK4_PORT_ID	12	Controlador Ethernet 1: Socket 4
HILS.SOCK5_PORT_ID	13	Controlador Ethernet 1: Socket 5
HILS.SOCK6_PORT_ID	14	Controlador Ethernet 1: Socket 6
HILS.SOCK7_PORT_ID	15	Controlador Ethernet 1: Socket 7
HILS.ETH2_SOCK0_PORT_ID	16	Controlador Ethernet 2: Socket 0
HILS.ETH2_SOCK1_PORT_ID	17	Controlador Ethernet 2: Socket 1
HILS.ETH2_SOCK2_PORT_ID	18	Controlador Ethernet 2: Socket 2
HILS.ETH2_SOCK3_PORT_ID	19	Controlador Ethernet 2: Socket 3
HILS.ETH2_SOCK4_PORT_ID	20	Controlador Ethernet 2: Socket 4
HILS.ETH2_SOCK5_PORT_ID	21	Controlador Ethernet 2: Socket 5
HILS.ETH2_SOCK6_PORT_ID	22	Controlador Ethernet 2: Socket 6
HILS.ETH2_SOCK7_PORT_ID	23	Controlador Ethernet 2: Socket 7

	Este texto pode ser utilizado como parâmetro pois esta definido no tipo COMM_CHAN_ID disponível na biblioteca HI_STD.
	Cada equipamento possui um sub-conjunto dos recursos de comunicação indicados na tabela acima. Para identificar quais recursos estão disponíveis em um dado equipamento, consulte o manual do mesmo.

X_HP

Define o valor do preâmbulo (Hopping) a ser configurado no módulo XBee. O valor deve estar na faixa de 0 a 7. Valores fora desta faixa resultarão em erro de parâmetro inválido.

DONE

Ao finalizar o processo variável booleana DONE é acionada (= TRUE). Para saber se o processo foi executado com sucesso ou não consulte a variável de retorno RESULT.

RESULT

O resultado do processo de configuração é obtido através da variável RESULT, quando o parâmetrod de ssáida DONE estiver ativo. A descrição dos códigos de retorno possíveis para este bloco estão listados abaixo:

Código	Valor	Descrição Padrão	Possíveis causas
SUCCESS	0	Processo executado com sucesso.
GL_INV_PAR	3	Parâmetro inválido.	Valor de X_HP maior que 7.
GL_CMD_TMO	10	Timeout na resposta de equipamento	Não recebeu resposta do XBee para os comandos de configuração.
GL_FUNC_FAIL	13	Falha na execução da função.	Comandos de configuração enviados ao XBee não foram executados com sucesso.

Exemplo

Declaração de variáveis

Nome	Classe	Tipo	Endereço	Dimensão	Valor Inicial	Opções	Descrição
START	Local	BOOL				publ
HP_NUM	Local	USINT			1	publ
XB_CFG	Local	HILS.S3B_SET_PREAMBLE				publ

Clique aqui para baixar a tabela de variáveis

Código ST

XB_CFG(  // S3B_SET_PREAMBLE
  START    := START,    // [BOOL] Habilita operação do bloco
  COMM_SRC := HILS.COM1_PORT_ID,    // [USINT] Canal de comunicação de interface com XBee
  X_HP     := HP_NUM     // [USINT]
  //DONE     => ,  // [BOOL] Sinaliza o fim do processo
  //RESULT   =>    // [INT] Código de retorno do processo
  );

IF XB_CFG.DONE THEN
  START := FALSE;
  IF XB_CFG.RESULT <> HISL.RC_SUCCESS THEN
    // Trata condição de falha no processo

  END_IF;
END_IF;