Tutorial - Ecoar

Tutorial - Ecoar

Neste primeiro tutorial você aprenderá a fazer um pequeno script que permite que o operador digite algo no micro terminal que será, na sequência, ecoado no display do equipamento. O conceito chave deste exemplo é a definição de um script completo juntamente com a declaração e uso de variáveis, conceito comum em linguagens de programação de qualquer gênero.

1 <?xml version="1.0" encoding="UTF-8" ?>
2 <project name="ecoar-project">
3   <program name="ecoar-program">
4       <session name="session1">
5           <say beep="1" store="ficha">DIGITE:</say>
6           <say wait="1" get="ficha">DIGITADO:</say>
7       </session>
8   </program>
9   <terminal ip="192.168.1.150" name="t1" program="ecoar-program" model="COLLETER_TC100" />
10 </project>

Comentários

Linha 1

Tag XML introdutória, necessária para que um documento XML seja considerado bem formado, note também que toda Tag deve ser digitada em letras minúsculas.

Linha 2

Inicio do bloco que define o projeto "ecoar-project". Uma única Tag deste tipo é permitida por arquivo.

Tags xCPML possuem atributos pré definidos, enquanto alguns devem sempre estar presentes, outros são opcionais. No GUIA DO PROGRAMADOR xCPML você encontrará as definições completas de Tags e atributos xCPML permitidos.

Linha 3

Inicio do bloco que define o programa "ecoar-program". A xCPML permite que você defina vários programas em um único arquivo de projeto.

Linha 4

Inicio do bloco que define uma sessão do seu programa. Esta sessão será acionada a cada pressionamento da tecla F1 do equipamento. Varias sessões são permitidas por programa.

Linha 5

Chamamos as Tags que apresentamos até agora de "Tags de projeto". As Tags de projeto apenas orientam o CPM quanto a estrutura do seu projeto e, portanto, não interagem efetivamente com o equipamento sendo controlado. Já nesta linha encontramos a primeira "Tag de programação" que: exibe no display do equipamento a palavra "DIGITE:" seguido de um único sinal sonoro, aguarda a digitação por parte do operador e armazena o dado digitado na variável "ficha".

Linha 6

A Tag say é, sem dúvida, muito poderosa, nesta linha ela irá exibir a palavra "DIGITADO:" no display do equipamento, seguido do valor atual presente na variável "ficha", na sequência, retardará o fluxo de execução do programa em 1 segundo.

Linha 7

Fim do bloco que define a sessão de nosso programa. Neste caso, automaticamente, a sessão será reiniciada e, com isso, a linha 5 novamente será executada.

Linha 8

Marca o fim do bloco que define o nosso programa.

Linha 9

Novamente uma "Tag de projeto", a Tag terminal permite definir um terminal e atribuir a ele um nome, o IP do equipamento na sua rede, um programa e um modelo. Tudo o que o CPM necessita saber para colocar seu equipamento para operar. Note que a Tag terminal, por não ser uma Tag que define um bloco lógico, inicia e termina numa única linha do arquivo.

Linha 10

Por fim, encontramos nessa linha, a Tag que define o fechamento do bloco que define nosso projeto.