Como usar o modo Push do TCG120

Este documento ajudará você a entender e testar o funcionamento do modo Push do controlador TCG120.

Descrição do modo Push

O modo Push é destinado à integração fácil com programas de monitoramento cliente-servidor. Quando o modo Push está habilitado, o TCG120 (cliente) começa a enviar periodicamente mensagens de requisição HTTP (método POST) para o programa de monitoramento (servidor). Essas mensagens de requisição HTTP contêm dados XML (status.xml), que são enviados ao servidor para processamento. O software de monitoramento (servidor) responde com uma mensagem de resposta HTTP. As mensagens de resposta são usadas não apenas para confirmação, mas também para enviar um comando ao controlador TCG120, por exemplo, set r1=1. Abaixo está uma sessão de comunicação típica entre o TCG120 e o servidor remoto:

1 O TCG120 envia uma requisição HTTP POST com dados XML ao servidor remoto;
2 O SERVIDOR retorna uma mensagem de resposta HTTP, que contém o comando “set r1=1” como texto resumido no corpo da mensagem;
3 O TCG120 envia uma requisição HTTP POST para confirmar o recebimento do comando “set r1=1”;
4 O SERVIDOR envia uma resposta HTTP, que inclui “set FIN” no corpo da mensagem. Isso indica que não há comandos pendentes e a sessão pode ser encerrada;
5 O TCG120 envia a próxima requisição HTTP POST ao servidor em conformidade com o temporizador de período Push;
6 O SERVIDOR responde com “set FIN” — não há comandos pendentes e a sessão pode ser encerrada.

Configurando o modo Push no controlador TCG120

Para habilitar o modo Push, os seguintes parâmetros devem ser configurados:

• Method – HTTP POST deve ser selecionado;
• URL – a URL do servidor remoto;
• Period – o período Push é definido entre 1 e 255 minutos.

Se a caixa de seleção “Connect on any alarm” estiver marcada, a requisição HTTP POST será enviada sempre que qualquer condição de alarme ocorrer. O valor do campo “Key” é enviado nos dados XML e pode ser usado para identificação do dispositivo.

Se a opção “Process Answer” estiver habilitada, o controlador TCG120 será capaz de processar os comandos enviados pelo servidor remoto. Os comandos válidos estão descritos abaixo:

A aplicação típica de monitoramento é exibida na imagem abaixo:

Testando o modo Push

Uma das formas mais simples de testar o funcionamento do modo Push é utilizar um script PHP. O script PHP abaixo é capaz de executar as seguintes tarefas:

• salvar os dados XML enviados pelo controlador TCG120 via método HTTP POST;
• enviar um comando ao controlador TCG120.

Para testar o funcionamento do modo Push, siga as instruções abaixo:

1. Copie o arquivo pushtest.php em um servidor web público com suporte a PHP. Para verificar se o script está funcionando corretamente, você pode digitar a URL (por exemplo, www.seuservidorURL.com/pushtest.php) no seu navegador web. Se o script estiver funcionando, você receberá uma página web com o seguinte conteúdo: “The PHP script is working!”.
2. Configure o TCG120 para enviar requisições HTTP POST ao seu servidor web. Insira o endereço do script (seuservidorURL.com/pushtest.php) no campo URL. Clique no botão “Test Push”.
3. Verifique o resultado. Se o HTTP POST for recebido e processado, o script PHP criará um arquivo XML chamado pushtest.xml no mesmo diretório onde o pushtest.php está localizado. O arquivo XML estará disponível em seuservidorURL.com/pushtest.xml. Este arquivo XML contém informações sobre os sensores e o status das entradas e saídas do TCG120.
4. Envie um comando ao TCG120. Para enviar um comando, é necessário modificar o script — substitua “set FIN” (linha 5) por um dos comandos válidos. Se você substituir “set FIN” por “set tg1=1”, a saída do Relé 1 mudará de estado a cada resposta HTTP recebida do servidor.