Manual Do Usuario

Gertec Telecomunicações Ltda.TC504

Manual doUsuárioVersão: 2.10

Revisão: Agosto/2004

Manual doUsuário - TC504

1

Obrigado por escolher os produtos da GERTEC Telecomunicações Ltda. Continuaremosnos empenhando para corresponder às suas expectativas!

Rumo à qualidade total, a GERTEC Telecomunicações Ltda é certificada ISO 9002,pelo órgão Fundação Vanzolini No SQ-549-765/98. Seus produtos e serviços atendem arígidas normas internas de processos e procedimentos.

Devido à contínua evolução dos produtos GERTEC, este manual poderá não contertodas as informações referentes a alterações do produto a que se refere. Em caso dedúvidas remanescentes à leitura deste, recomendamos contatar nosso Departamento deSuporte Técnico – telefone: (0xx11)4044-65.49 ou e-mail [email protected].

A GERTEC se isenta de quaisquer responsabilidades, diretas ou indiretas, por danosdecorrentes da má util ização ou inabil idade no uso do produto ou de sua documentaçãoe agradece eventuais críticas, comentários e sugestões que permitam corrigir, completarou aprimorar as informações deste manual.

Este manual contém informações de caráter técnico-informativo, que poderão seralteradas ou complementadas sempre que necessário, sem nenhum tipo de aviso prévio.

Nenhuma parte deste manual poderá ser reproduzida total ou parcialmente, outransmitida sob quaisquer formas, sem o consentimento prévio, por escrito, da GERTECTelecomunicações Ltda.

© Copyright © 2003 por GERTEC Telecomunicações Ltda.Todos os direitos reservados

GERTEC Telecomunicações Ltda.

Rua Guaicurus, nº 145 - Vila Conceição - Diadema – SP – Brasil - CEP: 09911-630Telefone: (0xx11)4044-6549, Fax: (0xx11)4043-3495

e-mail: [email protected]. http://www.gertec.com.br.S .A.C. – Sugestões e Reclamações:

e-mail: [email protected].


2

Índice

�� _________________________________________________________________________________ 3

�� _____________________________________________________________ 3

�� ____________________________________________________________ 5

�� ________________________________________________________________ 6

�� _____________________________________________________________ 8

�� __________________________________________________________ 12

�� !"#�� !"#�� !"#�� !"#______________________________________ 13

��$�� !"#��$�� !"#��$�� !"#��$�� !"# _________________________ 15

�� !"#�� !"#�� !"#�� !"#_______________________________________ 16

Mensagens de Configurações Gerais ____________________________________________________________ 19

Mensagens do Display de LCD ________________________________________________________________ 22

Mensagens do Teclado________________________________________________________________________ 27

Mensagens do Leitor de Cartão Magnético_______________________________________________________ 28

Mensagens da Porta Serial ____________________________________________________________________ 29

Mensagens de IO de Arquivos _________________________________________________________________ 32

Mensagens de Atualização_____________________________________________________________________ 34

�� !"#�� !"#�� !"#�� !"#�� ____________________________________________________ 37

%�� &�� !"#%�� &�� !"#%�� &�� !"#%�� &�� !"# ___________________________________________________ 45

��'��'��'��'�� ________________________________________________________________________ 47

��(��(��(��(�� _________________________________________________________________________________ 48

) �� ) �� ) �� ) �� ____________________________________________________________________ 48


3

��

O terminal de consulta TC504 é um equipamento moderno destinado ao uso emestabelecimentos comerciais servindo para consulta de preços, interação com usuário, suporte aprograma de fidelidade além de permitir a divulgação de anúncios comerciais.

Esse terminal foi desenvolvido para oferecer uma grande versatilidade de funções e ao mesmotempo, facilidade de uso e operação.

Desenvolvido pela Gertec Telecomunicações, com tecnologia nacional, o terminal deconsultas TC504 permite fácil atualização de seu firmware pela internet, além de prover um “kit dedesenvolvimento de software” (SDK) para aplicações personalizadas.

O terminal de consultas é controlado remotamente por um programa de computador, querecebe o nome de servidor. O terminal comunica todos os eventos que lhe ocorrem, como umproduto que lhe é passado em frente ao scanner, ou uma tecla pressionada, ou a leitura de um cartãomagnético, ao servidor através de uma conexão Ethernet usando um protocolo da camada aplicaçãodo TCP/IP. O programa servidor responde aos eventos ocorridos em um terminal de consulta, pelaconexão Ethernet, conforme o procedimento para o qual foi projetado.

O TC504 lê o código de barras do produto através de um scanner a laser omnidirecional de1000 varreduras por segundo e envia essa informação através de uma rede Ethernet usando oprotocolo TCP/IP ao programa servidor. O servidor consulta o banco de dados e retorna ao cliente(TC504) informações sobre o produto consultado, como o nome do produto, preço do produto, fotodo produto e até mesmo anúncio comercial de um outro produto que pode ser associado ao produtoconsultado (propaganda casada). Se o servidor não encontrar o produto no banco de dados, enviapara o terminal a informação de produto não cadastrado.

As quatro teclas do terminal de consulta podem ser usadas para funções especiais ao critériodo estabelecimento comercial. Por exemplo, uma das teclas pode ser usada para que o usuárioconsulte seus pontos do programa de fidelidade. Quando a tecla for pressionada, o servidor recebeessa informação e envia uma mensagem, que aparece na tela do TC504, pedindo ao usuário que passeo seu cartão magnético na leitora para consultar os pontos no programa de fidelidade. Ao passar ocartão na leitora de cartão magnético, o conteúdo do cartão é transmitido ao servidor que consulta nobanco de dados os pontos do usuário e retorna ao TC504 para que este mostre na tela.

Quando o terminal não está sendo usado para consulta de preços, ou fidelidade, o terminalfica continuamente mostrando na tela uma seqüência de imagens, predefinidas pelo servidor, cujoobjetivo é fazer anúncios comerciais de produtos e serviços do estabelecimento. Essas imagenspodem ser estáticas ou pequenas animações.

��

A seguir são apresentados fotos do terminal de consulta. Na vista frontal temos o displaycolorido de 6 polegadas (150mm), o leitor de cartão magnético, o scanner e o quatro botões defunção. Na vista lateral vemos o conector mini-din para teclado. Na vista traseira temos o conectordo cabo de alimentação e o conector de rede RJ45, no detalhe.


4

Vista Frontal Vista Lateral

Vista traseira Detalhe do conector de rede .


5

��

(Especificação sujeita a mudança sem aviso prévio)

Geral:Dimensões: 216 x 312 x 98 mm (LxAxP)Peso: 1,7KgTensão de trabalho: 85~264 VAC (47 ~ 63Hz)Consumo: 170mA @ 120VACPotência: 21W

Display:Diagonal: 6 polegadas (150mm)Resolução: 320 x 240 pixel (1/4 VGA)Paleta: 256 cores (8bpp) de 4096 possibilidades de cores diferentes.Luminância: 550 Cd/m2

Vida Útil: 10000 horas.

Scanner:Metrologic Cubit IS6520Scan Speed: 1000 scan lines per secondScan Pattern: 5 fields 4 parallel lines omnidirecional


6

Menor espessura de barra: 0,145mm

Leitor de Cartão Magnético: trilha 1 e 2Interface de teclado: Mini-dinInterface de rede: Ethernet 10BaseTConector de rede: RJ45

Lógica:Processador: Compatível a 386SX 40MHzMemória estendida: 8MBMemória da Unidade C: 8MBSistema Operacional: FreeDOS

Software:Permite a exibição de imagens do tipo Bitmap sem compressão com 256 cores (8bpp) etamanho de até 320 x 240.Exibe arquivos tipo GIF estático e GIF animado (GIF89a).Possui suporte aos protocolos FTP e HTTP para atualização de software e aquisição deimagens na internet.Protocolo de comunicação aberto e disponibilidade de rotinas compiladas (LIBs para BorlandC) para desenvolvimento de programas personalizados.

Temperatura de operação: −10 oC a +40 oCTemperatura de armazenagem: −20 oC a +60 oC

��

O terminal deve ser instalado em uma parede ou plataforma vertical através de seus furos defixação localizados no gabinete traseiro. Próximo ao local de instalação deve haver uma tomada AC eum ponto de rede Ethernet.

1) Conecte o cabo de força conforme a foto abaixo.


7

2) Conecte o cabo de rede com conector RJ45, conforme a foto abaixo.

3) Instale no local usando os furos de fixação


8

4) Ligue o terminal conectando o cabo de força na tomada AC

O scanner deverá ligar e emitir um duplo bipe. O display irá acender e mostrar uma imagemconforme a figura acima.

��

Ao ser ligado, o terminal pode ser configurado, em seu local, conectando um teclado decomputador no conector mini-din na sua lateral esquerda. Uma vez configurado, de forma que oterminal funcione com as características da rede Ethernet onde estiver instalado, ele irá se comunicarpela rede e poderá ser re-configurado remotamente.

Veja o procedimento a seguir:1) Conecte um teclado de computador no conector mini-din na lateral esquerda do terminal de

consulta TC504.


9

2) Ligue o terminal conectando o cabo de força na tomada AC.

Ao ser ligado, o terminal de consultas TC504 apresenta no display a seguinte imagem, com umabarra de progresso deslocando da esquerda para direita na parte inferior do display.

Enquanto essa barra de progresso desloca na tela, é possível chamar uma de três aplicativosespeciais do terminal de consulta pressionando uma determinada tecla no teclado de computador. Senenhuma tecla for pressionada, o terminal começa o aplicativo principal, que é a de terminal deconsultas de preço.

Enquanto a barra estiver deslocando, se for pressionada a tecla “P”, o terminal inicia oaplicativo de “Configuração do Terminal”. Se for pressionada a tecla “F”, inicia-se o aplicativo“Servidor de FTP” do TC504. Se for pressionada a tecla “U”, inicia-se o aplicativo “Atualização doTerminal TC504”. A seguir é descrito o funcionamento do aplicativo de configuração. Os outrosaplicativos existentes no terminal serão descritos depois.

Após pressionar a tecla “P” ao iniciar o terminal, deverá aparecer no display a seguinte tela:

Utilizando as teclas “seta para cima” (ArrUp) e “seta para baixo” (ArrDn) é possível navegarnos itens do menu de configuração. O círculo preenchido na cor verde indica o item selecionado. Ositens são os seguintes:


10

• Idioma (English, Português, Deutsche). Permite escolher o idioma do menu de configuração(use as setas para direita e para esquerda “ArrLeft” e "ArrRight”).

• Brilho: Permite ajustar o nível de brilho e contraste do display (use as setas para direita epara esquerda “ArrLeft” e “ArrRight”).

• Rede: Permite alterar a configuração de Rede. Pressione a tecla “Enter” para entrar no sub-menu da configuração de rede:

� IP Cliente: Pressione “Enter” nesse item para alterar o endereço IP. Esse é o endereçodo terminal de consulta. O endereço IP é formado por quatro números que podem variarde 0 a 255. Esses números não podem ser aleatórios, pois eles obedecem a uma regradeterminada pelo protocolo TCP/IP. Via de regra, não pode haver mais de um dispositivode rede com o mesmo endereço IP na mesma rede local. Os quatro números do endereçoIP identificam a rede e o terminal, dependendo do valor da máscara de rede. Por exemplo,para uma máscara de rede de valor 255.255.255.0, os três primeiros números são 255 eisso indica que os três primeiros números dos endereços IP de todos os dispositivos derede da rede local identificam a rede e por isso devem ser todos iguais para que osdispositivos troquem pacotes entre si. No nosso exemplo, o último número da máscarade rede é zero, isso significa que o último número de todos os endereços IP dosdispositivos de rede ligados na rede local irá identificar o dispositivo e não deve ser iguala nenhum outro para não haver conflito de IP na rede. O número que identifica odispositivo na rede não pode ser zero nem 255, pois o endereço zero é a própria rede e oendereço 255 é um endereço de broadcast. Para o nosso exemplo: máscara de rede =255.255.255.0. IP do cliente = 192.168.0.150. IP do servidor = 192.168.0.36. Faixa deIPs válidos para essa rede: de 192.168.0.1 até 192.168.0.254. Endereço de broadcast192.168.0.255. Endereço da rede 192.168.0.0.

� IP Servidor: É o endereço IP do dispositivo de rede (um computador por exemplo) ondeestá rodando o aplicativo servidor do terminal de consulta. Na arquitetura cliente-servidordo protocolo TCP/IP, vários dispositivos clientes pedem serviços ao um únicodispositivo servidor. O serviço pode ser, no caso, consultar no banco de dados o preçodo produto passado no scanner.

� Máscara: Permite alterar a máscara de rede (ou sub-rede). Esse valor depende da redelocal onde o terminal está conectado. A máscara de rede define a classe do endereço IP


11

(Veja na tabela abaixo). Existem ainda os valores de máscara de sub-rede que limitam aquantidade de dispositivos de rede de uma determinada classe de endereço IP:

Classe Máscara de Rede Faixa de Endereços IPNo Máximo

de redesNo máximo de

dispositivosde rede

A 255.0.0.0 0.1.0.0 a 126.0.0.0 128 16777214B 255.255.0.0 128.0.0.0 a 191.255.0.0 16384 65534C 255.255.255.0 192.0.1.0 a 223.255.255.0 2097152 254

� Gateway: Endereço IP do dispositivo de rede (roteador) responsável por conectar a redelocal à internet. Se não existir pode ser configurado com o endereço 0.0.0.0.

� Serv. De Nomes: Nome do dispositivo de rede (Name Server) responsável por resolvernomes, isso é, obter o número do endereço IP a partir do nome em formato texto. Muitasvezes coincide com o endereço do Gateway.

� Nome: Nome do terminal de consultas. Serve para identificar o terminal de outra formaalém do endereço IP.

� IP Dinâmico: Com a tecla “Enter”, marque ou desmarque essa opção. Quando o terminalé configurado para IP dinâmico, ao iniciar-se, ele tenta conseguir um endereço IP atravésdo servidor de DHCP/BOOTP. Se esse procedimento falhar, é utilizado o endereço IP docampo “IP Cliente”. Desmarque essa opção para trabalhar com endereço IP fixo.

� Busca Servidor: Com a tecla “Enter”, marque ou desmarque essa opção. Quando a buscaautomática é habilitada, o terminal procura pelo programa servidor pela rede. Isso é feitode duas formas, por broadcast ou por IP-por-IP (na versão 2.0 não é realizada a busca deIP-por-IP). Para isso é utilizado o “Protocolo Gertec de Configuração Remota” (veja odocumento PGCR.pdf). Desmarque essa opção para que o terminal só procure o servidorno endereço indicado por “IP Servidor”.

� OK: Selecione esse item e pressione a tecla “Enter” para salvar a configuração de rede.� Cancelar: Selecione esse item e pressione a tecla “Enter” para sair sem salvar do menu

de configuração de rede. É o mesmo que pressionar a tecla “ESC”.

• Atualização: Permite alterar a configuração do aplicativo de atualização do terminal. O terminalde consultas TC504 pode baixar da internet versões atualizadas que são colocadas na internet àdisposição dos usuários sempre que uma atualização for necessária. Selecione esse item epressione a tecla “Enter” para entrar no sub-menu de atualização.


12

� Servidor: Endereço onde se encontra as novas versões de atualização. O TC504 podebaixar atualizações por HTTP ou FTP. As primeiras letras do endereço indicam oprotocolo a ser utilizado (http:// ou ftp://). A Gertec® Tecnologia poderá dispor de umendereço na internet para atualização do terminal. Consulte o departamento de suporte daGertec (e-mail: [email protected]) sobre a necessidade ou disponibilidade deatualizações e o endereço para esse fim.

� Usuário:� Senha: No caso de atualização por FTP é necessário fornecer o nome do usuário e senha.

Em acesso público, usuário é anonymous e a senha é o endereço de e-mail.� OK: Selecione esse item e pressione a tecla “Enter” para salvar a configuração de

atualização.� Cancelar: Selecione esse item e pressione a tecla “Enter” para sair sem salvar do menu

de atualização. É o mesmo que pressionar a tecla “ESC”.• Config Padrão: Retorna o terminal para a configuração de fábrica.• Salvar e Sair: Selecione esse item e pressione a tecla “Enter” para salvar toda a alteração que foi

feita.• Sair: Selecione esse item e pressione a tecla “Enter” para sair sem salvar do menu de atualização.

É o mesmo que pressionar a tecla “ESC”.

��

Conecte um teclado de computador no conector mini-din na lateral esquerda do TC504 eligue o terminal de consulta. Enquanto a barra de progresso estiver deslocando, pressione no tecla“F” no teclado de computador para executar o aplicativo “Servidor de FTP”. Irá aparecer no displaydo TC504 a seguinte tela:


13

O terminal de consulta passa a funcionar como um servidor de FTP (File Transfer Protocol).Ou seja, você poderá manipular os arquivos internos do terminal de consulta (enviar, receber, listar,apagar, ...). Esse é um procedimento que deve ser feito com muito cuidado, para não apagar arquivosessenciais ao bom funcionamento do terminal de consulta. O uso errado desse aplicativo podeinterferir na garantia do produto. Não apague arquivos de sistema (COMMAND.COM,AUTOEXEC.BAT, KERNEL.SYS, e os arquivos da pasta XDOS), drivers de rede (E2000.COM) eos programa servidores de FTP (FTP504.EXE , FTP.EXE).

Na tela do servidor de FTP (veja foto acima) aparece o endereço IP do terminal. Use umcomputador com cliente de FTP ligado na mesma rede local do terminal para acessar o seu servidorde FTP. Por exemplo, em um computador com sistema operacional Windows® 98, execute oprompt do MS-DOS e digite ftp mais o endereço que aparece no terminal. Para o nosso exemplotemos:

C:\>ftp 192.168.0.150Conectado a 192.168.0.150.220 ALTEST FTP Server ready.Usuário (192.168.0.150:(none)):331 Password required for .Senha:230 User logged in.ftp>

Não é necessário fornecer o nome do usuário e a senha. Pode ser qualquer palavra.O servidor de FTP só permite conexão de um cliente e só funciona por um intervalo de

tempo de 60 segundos após a conexão, por motivo de segurança. Para mais informações sobre oprotocolo FTP, consulte algum livro ou tutorial sobre o assunto, ou leia do documento RFC354,RFC454, RFC959.

�� !"#

Conecte um teclado de computador no conector mini-din na lateral esquerda do TC504 eligue o terminal de consulta. Enquanto a barra de progresso estiver deslocando, pressione no tecla“U” no teclado de computador para executar o aplicativo “Atualização do Terminal TC504”. Iráaparecer no display do TC504 a seguinte mensagem:

TC504 – Remote Update Program. This program will update the software installed in thisterminal. The updated version will be downloaded by FTP or HTTP from a remote server. Olderfiles can be erased. You must be aware about this procedure. Do you want to continue?… (Y/N)

TC504 – Programa de atualização remota. Este programa irá atualizar o software instalado nesteterminal. A versão atualizada será baixada por FTP ou http de um servidor remoto. Arquivos antigospoderão ser apagados. Você deve ter certeza sobre esse procedimento. Você quer continua?... (Y/N)


14

Se for pressionada a tecla “Y”, o programa irá baixar uma versão atualizada do servidor. Sefor pressionada qualquer outra tecla, o programa irá sair sem se atualizar.

Para que o programa de atualização funcione de forma correta, é necessário ter uma conexãocom a internet. Para isso é necessário ter a configuração de Gateway e Servidor de Nomes correta.

A primeira tarefa que o aplicativo de atualização faz é baixar o arquivo “update.cmd” quetraz uma série de instruções de atualização do terminal. Os comandos do arquivo “update.cmd” sãoparecidos com os comandos de ftp, e funcionam do lado do terminal, ou seja, é como se o terminalestivesse executando esses comandos num aplicativo de ftp. Os comandos são:

• bye: Desconecta-se do servidor.• cd <Nome do diretório>: Vai para o diretório <Nome do diretório> do servidor• dir: Lista os arquivos e diretórios do diretório atual do servidor.• get <Nome do Arquivo> Faz o download de <Nome do Arquivo> do servidor.• lcd <Nome do Diretório> Vai para o diretório local <Nome do diretório>.• ldel <Nome do Arquivo> Apaga o arquivo local <Nome do Arquivo>.• ldelall Apaga todos os arquivos locais do diretório corrente.• lmkdir <Nome do Diretório> Cria um diretório local chamado <Nome do Diretório>• lrdir <Nome do Diretório> Apaga o diretório local <Nome do diretório> (se estiver vazio)• ls Lista os arquivos e diretórios do diretório atual do servidor além de trazer informações

adicionais sobre os mesmos.• pwd Informa o nome do diretório atual do servidor.• send <Nome do Arquivo> Envia para o servidor o arquivo local <Nome do arquivo>

Por exemplo, o seguinte arquivo update.cmd:

lcd ..lcd appspwdget TC504.EXEbye

irá baixar o baixar o arquivo TC504.EXE. Na tela do terminal irá aparecer as seguintes mensagens:

Starting the program update...Getting update.cmd

Local cd ..Local cd appsGetting TC504.EXE…………………………..Update completed successfullyRemote Update Program finishesPress any key to exit


15

��$�� !"#

O principal aplicativo do TC504 é o verificador de preços. Ele é executado automaticamente,sem a necessidade de pressionar tecla. Não é necessário conectar teclado no conector mini-din paraque esse aplicativo seja executado.

Ao iniciar o programa verificador de preços do terminal TC504, o aplicativo configura aporta serial do scanner, inicia o controlador de rede e o display. Durante esse processo, o terminalmostra no display informações sobre a configuração de rede (seu endereço IP, endereço MAC,máscara de rede,...) e sobre a serial (taxa, número de data bits, número de stop bits, paridade...).

Ao terminar este processo, o terminal começa a ler suas imagens pre-definidas, que ficamarmazenados próprio TC504 e são configuradas pelo servidor. Essas imagens não fazem parte do“slide show” (veja aseguir), portanto, para serem exibidas, o servidor deve enviar um comando parao terminal. O arquivo de configuração destas imagens é o c:\apps\preimg.cfg, segue abaixo, umexemplo deste arquivo:

<produto.bmpcartao.bmptecla.bmp>

Após esse processo, o terminal começa a abrir os arquivos de imagem que irão serapresentados em “loop”, como um “slide show”. Essas imagens são preferencialmente anúncios deprodutos e serviços ou informativos que o estabelecimento deseja apresentar aos seus clientesenquanto não é feito uma consulta de preço. Essas imagens ficam armazenadas na unidade C doTC504, ou podem estar armazenadas num servidor de HTTP, e podem ser do tipo bitmap (semcompressão) de 320x240 pixel e 256 cores ou GIF (animado ou estático). A seqüência das imagensque serão apresentadas fica registrada no arquivo “images.cfg”. Em cada linha desse arquivo tem-setambém o tempo de exibição dessas imagens e a quantidade de vezes que uma animação (GIFanimado) irá ser mostrada. Veja um exemplo desse arquivo abaixo:

<|colorb2.bmp|2|0||mega.bmp|2|0||airpla~2.gif|2|0||card.gif|2|3||http://www.gertec.com.br/tc504.gif|5|0|>

Quando uma imagem estiver armazenada num servidor de HTTP, o terminal faz, primeiro, odownload da imagem para o diretório "c:\images".

O terminal abre os arquivos de imagem e guarda as suas telas na memória estendida paramaior velocidade na sua apresentação no display. Observe que leva mais tempo para abrir um


16

arquivo GIF, pois além da compressão da imagem, podemos ter ainda várias telas para um únicoarquivo GIF animado. A quantidade máxima de telas que a memória estendida comporta (8MB) é deaproximadamente 93 telas. Cada tela ocupa 77568 bytes, ou seja 320 x 240 bytes correspondenteaos pixels mais 256 x 3 bytes da paleta de cores.

Após carregar todas as imagens para a memória estendida, o terminal tenta se conectar aoservidor. Se a busca automática do servidor NÃO estiver habilitada, o terminal irá tentar se conectarao servidor num único endereço IP que foi configurado previamente. Mas se a busca automáticaestiver habilitada, o terminal tenta procurar por si próprio o endereço do servidor. Para isso sãoutilizados dois métodos: Broadcast e IP-por-IP.

No método Broadcast, o terminal TC504 envia um pacote broadcast pela rede. Os pacotesbroadcast são recebidos por todos os dispositivos da rede local, e portanto, o computador queestiver executando o programa servidor irá receber esse pacote e irá responder para o terminal o seuendereço IP. Esse método utiliza o protocolo PGCR (Protocolo Gertec de Configuração Remota).Mais detalhes no arquivo PGCR.PDF.

No método IP-por-IP, o terminal testa cada endereço IP permitido pela rede, a partir doendereço IP configurado para o servidor ou a partir do último endereço IP que o terminal conseguiuse conectar com sucesso. O TC504 incrementa o endereço IP e tenta se conectar. Se não conseguir,incrementa de novo, e continua até que se chegue ao endereço IP do servidor e se consiga conectar. Oterminal alterna os dois métodos e apresenta no display os valores de endereço IP.

�� !"#

Quando o terminal se conecta ao servidor, começa a mostrar no display a seqüência deimagens programada. Nesse momento o terminal está pronto para enviar e receber mensagens com oservidor. Essas mensagens obedecem uma regra chamada de Protocolo do TC504. Algumasmensagens têm origem no terminal de consulta, como um código de barras lido no scanner ou dadosde um cartão magnético. Outras mensagens têm origem no servidor, como uma tela que deve sermostrada no display ou um comando de configuração do terminal.

Esse protocolo é executado na camada aplicação do TCP/IP, utilizando para isso um socketbinário TCP na porta 16510. Essa porta pode ser re-configurada.

Basicamente as mensagens trocadas pelo TC504 e servidor são uma seqüência de bytes epossuem a seguinte estrutura:

O primeiro byte é sempre STX (0x02), e serve para sincronizar a comunicação. A seguir doisbytes que representam uma Word que identifica a mensagem. Para cada mensagem um ID diferente.Depois vem uma DWord (4 bytes) que representa o tamanho do argumento. Esses três primeiroscampos sempre existem em qualquer mensagem trocada entre TC504 e servidor e chama-se header(cabeçalho) da mensagem. Uma mensagem é então composta de header e argumento, sendo que oargumento pode existir ou não, dependendo do tipo de mensagem.

O header é sempre obrigatório e deve ser transmitido num mesmo pacote TCP. Se oArgumento não existir, o conteúdo do campo “Tam Arg” deve ser zero. O argumento pode serenviado e um ou mais pacotes TCP diferentes.


17

A seguir temos a relação das mensagens trocadas entre cliente (terminal TC504) e servidorpara esse protocolo. As mensagens têm uma origem, que pode ser no cliente ou no servidor. Odispositivo que recebe a mensagem, responde essa mensagem com uma outra mensagemincrementando o ID. Por essa razão, os IDs da mensagem original são todos impares e os IDs daresposta são pares. O argumento da resposta pode ser de um tipo diferente do argumento damensagem original.

ID da Mensagem Tipo de Argumento Argumento da Resposta O rigem// Configurações gerais

#define IDvLive 0x11 //none none Server

#define IDwGetIdentify 0x13 //none DWORD Server

#define IDContinue 0x15 //DWORD none Server

#define IDvSetSetupTCP 0x17 //ARG_SETUP_TCP DWORD Server

#define IDvGetSetupTCP 0x19 //none ARG_SETUP_TCP Server

#define IDvGetUID 0x1B //none ARG_UID Server (V2.0)

#define IDvAlwaysLive 0x1D //DWORD none Server

// Display de LCD

#define IDvDispClear 0x21 //WORD DWORD Server

#define IDvShowText 0x23 //ARG_DISPALY_TEXT DWORD Server

#define IDvShowIMG 0x25 //stream DWORD Server

#define IDbSetTimeExhib 0x27 //WORD DWORD Server

#define IDvGetTimeExhib 0x29 //none WORD Server

#define IDGoAdv 0x2B //none DWORD Server

#define IDStopAdv 0x2D //none DWORD Server

// Teclado

#define IDvSetEnableKey 0x31 //DWORD DWORD Server

#define IDbGetEnableKey 0x33 //none DWORD Server

#define IDcGetCharTerm 0x35 //BYTE none Client

// LEC

#define IDvSetLEC 0x41 //DWORD DWORD Server

#define IDbGetLEC 0x43 //none DWORD Server

#define IDbReadBuffLEC 0x45 //none ARG_CARD_LEC Client

// Porta Serial

#define IDvConfigSerialA 0x51 //ARG_SERIAL_CFG DWORD Server

#define IDvReadSerialA 0x53 //none ARG_SERIAL_DATA Client

#define IDvWriteSerialA 0x55 //ARG_SERIAL_DATA DWORD Server

#define IDvConfigSerialB 0x57 //ARG_SERIAL_CFG DWORD Server

#define IDvReadSerialB 0x59 //none ARG_SERIAL_DATA Client

#define IDvWriteSerialB 0x5B //ARG_SERIAL_DATA DWORD Server

// IO de Arquivos

#define IDvRecvFile 0x61 //ARG_FILENAME stream Server (V2.0)

#define IDvSendFile 0x63 //stream DWORD Server

#define IDvDeleteAdv 0x65 //none DWORD Server

#define IDvDeletePreImg 0x67 //none DWORD Server (V2.0)

// Comandos de Atualizacão

#define IDUpdateSoft 0x71 //DWORD DWORD Server

#define IDUpdateAdv 0x73 //ARG_UPDATE DWORD Server

#define IDReloadAdv 0x75 //DWORD DWORD Server

#define IDReloadPreImg 0x77 //DWORD DWORD Server (V2.0)

#define IDRestart 0x79 //DWORD DWORD Server (V2.0)

#define IDSecretCode 0x7B //none ARG_SECRETCODE Server (V2.0)

// Display de LCD

#define IDShowFrame 0x7B //DWORD none Server (V2.0)

#define IDvShowImageBlock 0x7B //stream DWORD Server (V2.0)

#define IDvSendPalette 0x7B //stream DWORD Server (V2.0)


18

// Atualização de Imagens

#define IDSetConfigAdvServer 0x91 //ARG_IMGUPD DWORD Server (V2.0)

#define IDGetConfigAdvServer 0x93 //none ARG_IMGUPD Server (V2.0)

#define IDConnectAdvServer 0x95 //none none Server (V2.0)

// Serial ++

#define IDvGetStatus 0x91 //BYTE ARG_SERIAL_STS Server (V2.1)

#define IDvSetStatus 0x93 //ARG_SERIAL_STS none Server (V2.1)

Tipos de Argumentos:

typedef struct {

char FileName[128];

}ARG_FILENAME;

typedef struct {

unsigned char aserial;

unsigned char status;

}ARG_GETFILENAME;

typedef struct {

char FileName[128] ;

unsigned long dwStatus;

}ARG_GETFILENAME;

typedef struct {

DWORD dwMY_IP_ADD;

DWORD dwServer_IP;

DWORD dwNetMask;

DWORD dwGateway;

DWORD dwNameServer;

char TCName[32];

WORD wPortsv;

char FTPs[100];

char FTPu[30];

char FTPp[30];

DWORD dwDHCP;

DWORD dwSearchServer;

}ARG_SETUP_TCP;

typedef struct {

BYTE sMacADD[6];

char sMyName[32];

}ARG_UID;

typedef struct {

WORD wPosX;

WORD wPosY;

char sText[128];

char sFont[32];

WORD wSize;

WORD wColor;

WORD wBGColor;

}ARG_DISPLAY_TEXT;

typedef struct {

char sTrack1[128];


19

char sTrack2[128];

char sTrack3[128];

DWORD dwStatus;

}ARG_CARD_LEC; // Argumento do Cartao

typedef struct {

DWORD dwOpen;

DWORD dwBaud;

BYTE bParity;

BYTE bDataBits;

WORD wTimeOut;

}ARG_SERIAL_CFG;

typedef struct {

WORD wTamBuff;

BYTE sBuffer[256];

}ARG_SERIAL_DATA;

typedef struct {

char sServer[128];

char sUser[32];

char sPasswd[32];

WORD wPort;

DWORD dwValidate;

}ARG_UPDATE;

typedef struct {

unsigned short wPosX;

unsigned short wPosY;

unsigned short wWidth;

unsigned short wHeight;

}ARG_IMGBLOCK;

typedef struct {

char sc[8];

}ARG_SECRETCODE;

typedef struct

{

long imgupdenable; // 0 = desabilita, 1 = habilita

char imgupdserver[100]; // endereço do servidor de atualização de imagens

long imgupddeftime; // tempo padrão de atualização

long imgupdcurtime; // tempo atual de atualiação

} ARG_IMGUPD;

Mensagens de Configurações Gerais

Mensagem Original ID (Hex) ID (dec) Origem Tipo do ArgumentoTamanho doArgumento

IDv Liv e 0x11 17 Servidor nenhum 0Mensagem de RespostaRIDv Liv e 0x12 18 Cliente nenhum 0

Para verificar se o terminal está em funcionamento, envia-se a mensagem IDvLive para oterminal, que responde com a mensagem RIDvLive. Na versão 1.0 do terminal, é obrigatório o envia


20

desde comando a cada 2 minutos, para que o terminal não realize uma desconexão forçada (caso nãoseja enviado o comando alwayslive).


Idv AlwaysLiv e 0x1D 29 Servidor DWORD 4Mensagem de RespostaRIDv AlwaysLiv e 0x1E 30 Cliente nenhum 0

Enviando a mensagem IDvAlwaysLive para o terminal, habilitar (argumento=1) oudesabilitar (argumento=1) pings que o terminal efetua se não receber nenhuma mensagem do servidorpor mais de 30 segundos. Na versão 1.0 do terminal, este comando desabilita a desconexão forçadacaso não receba a mensagem IDvLive por mais de 2 minutos.


IDwGetIdentify 0x13 19 Servidor Nenhum 0Mensagem de RespostaRIDwGetIdentify 0x14 20 Cliente DWORD 4

Quando um terminal se conecta no servidor, a primeira mensagem que o servidor envia para oterminal é IDwGetIdentify, ou seja, o servidor pede que o terminal envie a sua identificação parasaber se o cliente é mesmo um terminal de consultas TC504, e se o servidor poderá responder aoterminal com esse protocolo. O terminal responde com o seguinte argumento (Dword) 0x3101F821,em que 31 representa o tipo de identificador (“1” em ASCII), 01F8 representa 504 em decimal e 21representa a versão 2.1.


IDContinue 0x15 21 Servidor DWORD 4Mensagem de RespostaRIDContinue 0x16 22 Cliente nenhum 0

Se a identificação do terminal, retornada da mensagem IDwGetIdentify corresponder a de umterminal TC504 na versão de protocolo no qual o servidor pode se comunicar, então o servidor enviapara o terminal a mensagem IDContinue com o argumento (DWord) = 0x00000001 = 1, para que oterminal prossiga na troca de mensagens nessa conexão. Se o terminal não receber IDContinue oureceber IDContinue com um argumento diferente de 1, ele irá se desconectar. Portanto a primeiramensagem que o servidor envia ao terminal TC504 logo após ele se conectar é IDwGetIdentify, edependendo da resposta do terminal, a segunda mensagem deverá ser IDContinue com argumentoigual a 1 para o prosseguimento da comunicação entre TC504 e servidor.


IDv SetSetupTCP 0x17 23 Servidor ARG_SETUP_TCP 222Mensagem de Resposta


21

RIDv SetSetupTCP 0x18 24 Cliente DWORD 4

O servidor envia a mensagem IDvSetSetupTCP para configurar os parâmetros de rede doterminal de consulta. O terminal responde com um DWord que pode ser 0x00000001 ou0x00000000, conforme o terminal tenha aceito ou não a configuração. O tipo ARG_SETUP_TCP éuma estrutura formada por vários campos:

typedef struct {

DWORD dwMY_IP_ADD; // Endereço IP do terminal

DWORD dwServer_IP; // Endereço IP do servidor

DWORD dwNetMask; // Máscara de rede

DWORD dwGateway; // Endereço do Gateway

DWORD dwNameServer; // Endereço do servidor de nomes

char TCName[32]; // Nome do terminal (string terminada em caracter nulo usada na

// linguagem C)

WORD wPortsv; // Porta de comunicação com o servidor

char FTPs[100]; // String com o endereço do servidor de atualização

// ("http://..." ou "ftp://....")

char FTPu[30]; // Nome do usuário para o servidor de FTP (atualização)

char FTPp[30]; // Senha do usuário para o servidor de FTP

DWORD dwDHCP; // Se o terminal usar IP Dinâmico, esse valor será 1. Se não 0.

DWORD dwSearchServer; // Se a busco do servidor for automática, esse valor será 1.

}ARG_SETUP_TCP;

O argumento da mensagem fica da seguinte forma:

4 by tes 4 by tes 4 by tes 4 by tes 4 by tes 32 by tes 2 by tes 100 by tes 30 by tes 30 by tes 4 by tes 4 by tesMY_IP_AD

DServer_I

PNetMask Gateway NameServe

rTCName[32

]Portsv FTPs FTPu FTPp DHCP SearchServe

r


IDv GetSetupTCP 0x19 25 Servidor nenhum 0Mensagem de RespostaRIDv GetSetupTCP 0x1A 26 Cliente ARG_SETUP_TCP 222

O servidor pede que o terminal de consulta retorne a sua configuração de rede. O terminalresponde com o argumento ARG_SETUP_TCP, composto por 222 bytes.

typedef struct {

DWORD dwMY_IP_ADD; // Endereço IP do terminal

DWORD dwServer_IP; // Endereço IP do servidor

DWORD dwNetMask; // Máscara de rede

DWORD dwGateway; // Endereço do Gateway

DWORD dwNameServer; // Endereço do servidor de nomes

char TCName[32]; // Nome do terminal (string terminada em caracter nulo usada na

// linguagem C)

WORD wPortsv; // Porta de comunicação com o servidor

char FTPs[100]; // String com o endereço do servidor de atualização

// ("http://..." ou "ftp://....")

char FTPu[30]; // Nome do usuário para o servidor de FTP (atualização)


22

char FTPp[30]; // Senha do usuário para o servidor de FTP

DWORD dwDHCP; // Se o terminal usar IP Dinâmico, esse valor será 1. Se não 0.

DWORD dwSearchServer; // Se a busco do servidor for automática, esse valor será 1.

}ARG_SETUP_TCP;


Idv GetUID 0x1B 27 Servidor nenhum 0Mensagem de RespostaRIDv GetUID 0x1C 28 Cliente ARG_UID 38

O servidor pede que o terminal retorne o seu Universal IDentifier, que corresponde aoendereço Ethernet (MAC address) que é único para cada dispositivo de rede no mundo. O terminalresponde com o argumento ARG_UID (versão 2.0 em diante).

typedef struct {

BYTE sMacADD[6]; // Endereço Ethernet do terminal de consulta (MAC Address)

char sMyName[32]; // Nome do terminal (string terminada em caracter nulo usada na

// linguagem C)

}ARG_UID;

Mensagens do Display de LCD


IDv DispClear 0x21 33 Servidor WORD 2Mensagem de RespostaRIDv DispClear 0x22 34 Cliente DWORD 4

Apaga o display. O terminal, ao receber esse comando apaga o display preenchendo a cor defundo com o valor do argumento WORD. O terminal responde com o argumento DWORD comvalor igual a um se reconheceu o comando e zero se não.


Idv ShowText 0x23 35 Servidor ARG_DISPALY_TEXT 170Mensagem de RespostaRIDv ShowText 0x24 36 Cliente DWORD 4

Mostra no display o texto sText na posição wPosX e wPosY com a fonte sFont, tamanhowSize, cor wColor e cor de fundo wBGColor. A posição X e Y se referem ao canto superioresquerdo do display (posição 0,0). X pode variar de 0 a 320 e Y variar de 0 a 240 e a posição320,240 é o canto inferior direito do display. A estrutura do tipo ARG_DISPLAY_TEXT pode servista abaixo:


23

typedef struct {

WORD wPosX;

WORD wPosY;

char sText[128];

char sFont[32];

WORD wSize;

WORD wColor;

WORD wBGColor;

}ARG_DISPLAY_TEXT;

O tipo da fonte é sFont e corresponde ao nome do arquivo bitmap que contém todos oscaracteres da fonte. Esse arquivo fica no diretório "c:\fonts\" do TC504. Se sFont for igual a umcaractere vazio, então o terminal usa a última fonte aberta. Veja abaixo alguns tipos de fontes doTC504.

CAR8X8.BMP COURN8.BMP COURNB12.BMP


24

LUCIDA12.BMP LUCIDA16.BMP SMALL.BMP

CAR6x8.BMP

wSize é um multiplicador do tamanho do caractere, sendo que 1 é o tamanho normal.wColor é a cor do texto e wBGColor é a cor de fundo. Esse valor representa uma das cores

da paleta quando o seu valor está entre 0 e 255. Entretanto, o TC504 procura na paleta as cores maispróximas de determinadas cores padrão. Essas cores padrão recebem os seguintes valores:#define clBlack 0x100 // Preto

#define clMaroon 0x101 // Marrom

#define clGreen 0x102 // Verde Escuro

#define clOlive 0x103 // Verde Oliva

#define clNavy 0x104 // Azul Marinho

#define clPurple 0x105 // Púrpura

#define clTeal 0x106 // verde fosco

#define clGray 0x107 // Cinza escuro

#define clSilver 0x108 // Cinza claro

#define clRed 0x109 // Vermelho

#define clLime 0x10A // Verde Claro

#define clYellow 0x10B // Amarelo

#define clBlue 0x10C // Azul


25

#define clFuchsia 0x10D // Magenta

#define clAqua 0x10E // Ciano

#define clWhite 0x10F // Branco

#define clTransp 0xFFFF // Transparente (a partir da versão 2.0)


IDv ShowIMG 0x25 37 Servidor stream VariávelMensagem de RespostaRIDv ShowIMG 0x26 38 Cliente DWORD 4

O servidor envia essa mensagem para o terminal para que esse mostre no display,imediatamente, uma imagem que é enviada como argumento. O terminal recebe a mensagem eresponde com um argumento tipo DWord que equivale a 0x00000001 se o terminal conseguiureceber e mostrar a imagem no display e 0x00000000 se houver alguma falha.

O argumento de IDvShowIMG tem tamanho variável, porém o seu tamanho deve ser enviadono campo "TamArg" do Header. O argumento é uma imagem formada por sua paleta de cores e ospixels.

A paleta é enviada primeiro e correspondem a 768 bytes. Cada cor da paleta possui 3 bytesque correspondem aos componentes Vermelho, Verde e Azul da cor. Como são 256 cores, temosportanto 768 bytes. O primeiro byte é o componente vermelho (R) da primeira cor da paleta. Osegundo byte é o componente verde (G) da primeira cor da paleta. O terceiro byte é o componenteazul (B) da primeira cor da paleta. O quarto byte é o componente vermelho da segunda cor da paleta,e assim segue até o componente azul da última cor da paleta.

R1, G1, B1, R2, G2, B2, R3, . . . B255, R256, G256, B256

Depois são transmitidos os pixels que compõem a imagem. Cada byte corresponde a umpixel e seu valor é um índice de cor da paleta. Se o byte valer 0x00, corresponde a primeira cor dapaleta, se valer 0xFF é a última cor da paleta.

A imagem possui 320 pixel na horizontal e até 240 pixel na vertical totalizando no máximo76800 pixels ou bytes. Cada byte que chega é representado no display como um pixel. Os bytes vãopreenchendo a tela da esquerda para a direita e de cima para baixo conforme a tabela abaixo:

Y \ X 0 1 2 317 318 3190 Px1 Px2 Px3 ... Px318 Px319 Px320

1 Px321 Px322 Px323 ... Px638 Px639 Px640

2 Px641 Px642 Px643 ... Px958 Px959 Px960

... ... ... ... ... ... ...

237 Px75841 Px75842 Px75843 ... Px76158 Px76159 Px76160

238 Px76161 Px76162 Px76163 ... Px76478 Px76479 Px76480

239 Px76481 Px76481 Px76481 ... Px76798 Px76799 Px76800


26


IDbSetTimeExhib 0x27 39 Servidor WORD 2Mensagem de RespostaRIDbSetTimeExhib 0x28 40 Cliente DWORD 4

O servidor envia o comando IDbSetTimeExhib para informar quanto tempo uma imagemenviada pelo comando IDvShowIMG deve ficar exposta no display. O argumento é uma WORD quecorresponde ao tempo em segundos. Toda imagem que for enviada pelo comando IDvShowIMGficará exposta no display pelo tempo definido por esse comando ou até que outra imagem sejarecebida por outro comando IDvShowIMG, o que vier primeiro.

O terminal responde 1 se executou o comando e zero se não.


IDv GetTimeExhib 0x29 41 Servidor nenhum 0Mensagem de RespostaRIDv GetTimeExhib 0x2A 42 Cliente WORD 2

Esse comando serve para requisitar ao terminal que envie o valor de tempo de exibição queestá ajustado no terminal. A resposta volta no argumento WORD do cliente e corresponde ao tempoem segundos.


IDGoAdv 0x2B 43 Servidor nenhum 0Mensagem de RespostaRIDGoAdv 0x2C 44 Cliente DWORD 4

Esse comando faz que o terminal volte ao modo loop de imagens (slide show). Algunscomandos (ou eventos) como IDStopAdv, IDReloadAdv, fazem com que o terminal pare de exibir oloop de imagens. A resposta do terminal é a confirmação da mensagem recebida.


IDStopAdv 0x2D 45 Servidor nenhum 0Mensagem de RespostaRIDStopAdv 0x2E 46 Cliente DWORD 4

Esse comando faz que o terminal pare de exibir o loop de imagens (slide show). A respostado terminal é a confirmação da mensagem recebida.



27

IDShowFrame 0x81 129 Servidor DWORD 4Mensagem de RespostaRIDShowFrame 0x82 130 Cliente Nenhum 0

Este comando é utilizado para mostrar um frame armazenado no terminal, em seu display.Uma boa idéia é enviar as imagens de pre-armazenamento (versão 2.0 em diante).


IDv ShowImageBlock 0x83 131 Servidor stream VariávelMensagem de RespostaRIDv ShowImageBlock 0x84 132 Cliente DWORD 4

Este comando é utilizado para uma região de imagem para o terminal. Deve-se enviar o“ARG_IMGBLOCK” e em seguida o numero de bytes correspondestes aos pixels do bloco deimagem (largura x altura), portanto para enviar uma imagem de 20 de largura por 10 de altura, 200bytes devem ser enviados após o “ARG_IMGBLOCK” (versão 2.0 em diante).

typedef struct {

unsigned short wPosX; // Posição inicial x

unsigned short wPosY; // Posição inicial y

unsigned short wWidth; // Largura

unsigned short wHeight; // Altura

}ARG_IMGBLOCK;


IDv SendPalette 0x85 133 Servidor Stream 768Mensagem de RespostaRIDv SendPalette 0x86 134 Cliente DWORD 4

Este comando serve para enviar uma paleta de cores para o terminal. Cada cor da paleta éformada por 3 bytes, 1 byte para o vermelho, 1 byte para o verde e 1 byte para o azul. Como oterminal utiliza 256 combinações diferentes de cores, são necessários 768 bytes (256 x 3) paraformar a paleta (versão 2.0 em diante).

Se o comando for aceito, o terminal responde com o argumento igual a um.

Mensagens do Teclado


IDv SetEnableKey 0x31 49 Servidor DWORD 4Mensagem de RespostaRIDv SetEnableKey 0x32 50 Cliente DWORD 4

Quando o servidor envia o comando IDvSetEnableKey para o terminal com o argumento(DWord) = 0x00000001, faz com que toda a tecla pressionada, do teclado de função ou teclado


28

externo conectado no mini-din do terminal, seja transmitida para o servidor. Se o argumento for zero,as teclas pressionadas não serão informadas ao servidor.

A resposta do terminal é a confirmação da mensagem recebida.


IDbGetEnableKey 0x33 51 Servidor nenhum 0Mensagem de RespostaRIDbGetEnableKey 0x34 52 Cliente DWORD 4

Esse comando serve para requisitar ao terminal que informe ao servidor se está habilitado ounão a enviar as teclas pressionadas ao servidor. O terminal retorna 1 se o teclado estiver habilitado ezero se não.


IdcGetCharTerm 0x35 53 Cliente BYTE 1Mensagem de RespostaRIDcGetCharTerm 0x36 54 Servidor nenhum 0

Se alguma tecla do teclado de função for pressionada, o terminal de consulta envia o valor datecla pressionada através desse comando IDcGetCharTerm. O argumento é a tecla pressionada comvalor em ASCII. As quatro teclas de função do TC504 equivalem, da esquerda para direita aoscaracteres "a", "b", "c", "d".

Mensagens do Leitor de Cartão Magnético


IDv SetLEC 0x41 65 Servidor DWORD 4Mensagem de RespostaRIDv SetLEC 0x42 66 Cliente DWORD 4

Esse comando serve para habilitar e desabilitar o leitor de cartão magnético. Se o argumento(DWord) for 1, o leitor de cartão magnético será habilitado. Se for zero, o leitor será desabilitado.

O terminal confirma o comando do servidor enviando a resposta RIDvSetLEC com oargumento DWord igual a 1 se foi possível obedecer ao comando e zero se não.


IDbGetLEC 0x43 67 Servidor nenhum 0Mensagem de RespostaRIDbGetLEC 0x44 68 Cliente DWORD 4


29

O servidor envia esse comando para se informar se o terminal de consulta está com o leitor decartão magnético habilitado ou não. A resposta do terminal de consulta segue no argumentoDWORD que vale 1 se o leitor está habilitado e zero se não.


IDbReadBuffLEC 0x45 69 Cliente ARG_CARD_LEC 388Mensagem de RespostaRIDbReadBuffLEC 0x46 70 Servidor DWORD 4

Se o leitor de cartão magnético está habilitado e um cartão é passado no leitor, o conteúdo dastrilhas do cartão é transmitido do terminal de consulta para o servidor pelo comandoIDbReadBuffLEC. O argumento é do tipo ARG_CARD_LEC. Os dados das trilhas sãotransmitidos em formato ASCII em uma string terminada com caractere nulo. O campo dwStatusvale:

0 = Nenhuma trilha lida1 = Trilha 1 lida2 = Trilha 2 lida3 = Trilha 1 e 2 lidas4 = Trilha 3 lida5 = Trilha 1 e 3 lidas6 = Trilha 2 e 3 lidas7 = Trilha 1, 2 e 3 lidas

Se houver erro de leitura o conteúdo da trilha errada vale "e".

typedef struct {

char sTrack1[128];

char sTrack2[128];

char sTrack3[128];

DWORD dwStatus;

}ARG_CARD_LEC; // Argumento do Cartao

A resposta do servidor é a confirmação da mensagem recebida.

Mensagens da Porta Serial

O terminal de consultas TC504 possui internamente duas portas seriais. A porta serial B(COM 2) está ligada ao scanner Metrologic. A porta serial A (COM 1) está desconectada no interiordo terminal.

O servidor pode configurar a serial, enviar e receber dados. As mensagens a seguir são usadaspara esse fim.


IDv ConfigSerialA 0x51 81 Servidor ARG_SERIAL_CFG 12


30

Mensagem de RespostaRIDv ConfigSerialA 0x52 82 Cliente DWORD 4


Dv ConfigSerialB 0x57 87 Servidor ARG_SERIAL_CFG 12Mensagem de RespostaRIDv ConfigSerialB 0x58 88 Cliente DWORD 4

Esse comando serve para configurar as portas seriais do terminal de consulta. O argumento édo tipo ARG_SERIAL_CFG. O campo dwOpen do tipo DWORD serve para abrir e fechar a portaserial. Quando dwOpen é igual a 1 a porta serial é aberta. Se dwOpen for igual a zero a porta serial éfechada.

dwBaud é a taxa de comunicação da porta serial. Por exemplo, se dwBaud = 9600 =0x00002580, a taxa de comunicação será 9600bps.

bParity é a Paridade. 0 = PARITY_NONE.

1 = PARITY_ODD. 2 = PARITY_EVEN. 3 = PARITY_MARK. 4 = PARITY_SPACE.

bDataBits é a quantidade de data bits. Pode ser 7 ou 8.wTimeOut é o time out da serial em milisegundos.

typedef struct {

DWORD dwOpen;

DWORD dwBaud;

BYTE bParity;

BYTE bDataBits;

WORD wTimeOut;

}ARG_SERIAL_CFG;

O terminal responde ao servidor com o argumento DWORD que será 1 ser for possível abrira configurar a porta serial e zero se não.


IDv ReadSerialA 0x53 83 Cliente ARG_SERIAL_DATA 258Mensagem de RespostaRIDv ReadSerialA 0x54 84 Servidor nenhum 0


IDv ReadSerialB 0x59 89 Cliente ARG_SERIAL_DATA 258Mensagem de RespostaRIDv ReadSerialB 0x5A 90 Servidor nenhum 0


31

Quando algum dado chega pela porta serial, por exemplo, quando um produto é passado nafrente do scanner, o terminal envia os dados pelo comando IDvReadSerial. Particularmente, no casodo scanner, os dados são transmitidos quando chega o caractere 0x0A (Line Feed) pela serial B.

Os dados da serial são transmitidos dentro do buffer sBuffer que tem capacidade para até256 bytes. Se chegarem mais que 256 bytes na serial será necessário enviar outro comandoIDvReadSerial.

wTamBuff informa quantos bytes no buffer chegaram pela serial. Portanto wTamBuffdeverá ter um valor entre 1 e 256.

typedef struct {

WORD wTamBuff;

BYTE sBuffer[256];

}ARG_SERIAL_DATA;


IDv WriteSerialA 0x55 85 Servidor ARG_SERIAL_DATA 258Mensagem de RespostaRIDv WriteSerialA 0x56 86 Cliente DWORD 4


IDv WriteSerialB 0x5B 91 Servidor ARG_SERIAL_DATA 258Mensagem de RespostaRIDv WriteSerialB 0x5C 92 Cliente DWORD 4

O servidor também pode enviar dados para serial. No terminal de consultas TC504, oscanner Metrologic está ligado na serial B (COM 2). Isso significa que é possível configurar oscanner, de acordo com o manual do Scanner Metrologic Cubit IS6520, enviando comandos deprogramação pela serial.

O formato do comando IDvWriteSerialX é semelhante ao IDvReadSerialX, somente a origeme o destino mudam, e no caso de IDvWriteSerial, o terminal responde ao servidor se recebeu eexecutou o comando.

typedef struct {

WORD wTamBuff;

BYTE sBuffer[256];

}ARG_SERIAL_DATA;


Idv GetStatus 0xA1 161 Servidor BYTE 1Mensagem de RespostaRIDv GetStatus 0xA2 162 Cliente ARG_SERIAL_STS 2


32

Este comando é utilizado para ler o estado da porta serial do terminal. O argumento que oservidor deve enviar para o terminal é um BYTE, tendo o valor 0 = COM1 e 1 = COM2.

A resposta é formada por 2 BYTEs, o primeiro é a porta serial a qual foram lidos os estados(é o mesmo valor do BYTE que foi enviado) e o outro BYTE é formado da seguinte forma:

Bit0: indefinido;Bit1: DCD;Bit2: DSR;Bit3: CTS.

typedef struct {



}ARG_SERIAL_DATA;


Idv SetStatus 0xA3 163 Servidor ARG_SERIAL_STS 2Mensagem de RespostaRIDv SetStatus 0xA4 164 Cliente nenhum 0

Este comando é utilizado para escrever o estado da porta serial do terminal. O argumento queo servidor deve enviar para o terminal é um BYTE, tendo o valor 0 = COM1 e 1 = COM2. O outroBYTE é formado da seguinte forma:

Bit0: RTS;Bit1: DTR;A resposta a este comando não tem argumento.

typedef struct {



}ARG_SERIAL_DATA;

Mensagens de IO de Arquivos


IDv Recv File 0x61 97 Servidor ARG_FILENAME 0Mensagem de RespostaRIDv Recv File 0x62 98 Cliente Stream Variável

IDvRecvFile é usado quando o servidor precisa receber arquivos do terminal de consulta. Porexemplo, o arquivo de configuração do loop de imagens "IMAGES.CFG". Para receber cada arquivodo terminal é necessário enviar um comando IDvRecvFile. Esse comando possui argumento do tipoARG_FILENAME, que devem ser preenchidos com o caminho e nome do arquivo que se desejareceber. O terminal, então, retorna o argumento ARG_GETFILENAME. O campo “FileName” com


33

o nome do arquivo requisitado, e o campo “dwStatus” que é igual a um se o arquivo requisitado foilocalizado, ou igual a zero se não foi localizado (versão 2.0 em diante).

Se o arquivo foi localizado, o terminal enviará os dados do arquivo requisitado.

typedef struct {

char FileName[128] ;

unsigned long dwStatus;

}ARG_GETFILENAME;


Idv SendFile 0x63 99 Servidor Stream VariávelMensagem de RespostaRIDv SendFile 0x64 100 Cliente DWORD 4

IDvSendFile é usado quando o servidor precisa mandar arquivos para o terminal de consulta.Por exemplo, as imagens e o arquivo de configuração do loop de imagens "IMAGES.CFG". Paracada arquivo que é enviado para o terminal é necessário enviar um comando IDvSendFile. Essecomando possui um argumento de tamanho variável, que é informado no campo "Tam_Arg".

Os primeiros 128 bytes do argumento são usados para enviar o nome do arquivo quecorresponde a uma string terminada em caractere nulo (ARG_FILENAME). Essa string é o "path"onde o arquivo será gravado no TC504 mais o nome do arquivo. Por exemplo, para gravar a imagem"promo.gif" no diretório de imagens do TC504, para que essa imagem apareça no "slide show", astring em ARG_FILENAME será "\images\promo.gif".

O primeiro byte do arquivo é o 129o byte, e o tamanho do argumento será o tamanho doarquivo + 128 bytes.

O terminal responde a esse comando com um argumento tipo DWORD que é igual a 1 se oarquivo tiver sido recebido e gravado com sucesso e zero se houver alguma falha.

typedef struct {

char FileName[128];

}ARG_FILENAME;


IDv DeleteAdv 0x65 101 Servidor nenhum 0Mensagem de RespostaRIDv DeleteAdv 0x66 102 Cliente DWORD 4

Esse comando é enviado pelo servidor para apagar todas as imagens do "slide show" que seencontram no diretório "c:\images" no TC504. Portanto, quando é necessário atualizar as imagens do"slide show" do TC504, primeiro é necessário apagar as imagens anteriores enviando esse comando,para evitar que o terminal fique sem espaços para o seu funcionamento (versão 2.0 em diante).


IDv DeletePreImg 0x67 103 Servidor nenhum 0


34

Mensagem de RespostaRIDv DeletePreImg 0x68 104 Cliente DWORD 4

Esse comando é enviado pelo servidor para apagar todas as imagens de pre-armazenamento,que se encontram no diretório "c:\preimg" no TC504. Portanto, quando é necessário atualizar asimagens de pre-armazenamento do TC504, primeiro é necessário apagar as imagens anterioresenviando esse comando, para evitar que o terminal fique sem espaços para o seu funcionamento. Asimagens de pre-armazenamento são carregadas na inicialização do terminal e não fazem parte do“slide show”. Estas imagens só são mostradas no terminal, ao receber o comando “IDShowFrame”.

Mensagens de Atualização


IDUpdateSoft 0x71 113 Servidor DWORD 4Mensagem de RespostaRIDUpdateSoft 0x72 114 Cliente DWORD 4

O terminal de consultas TC504 pode ter o seu software interno atualizado. Uma das formasé plugando um teclado no conector mini-din e pressionando a tecla "U" quando o terminal se inicia(veja em "Aplicativo Atualização do Terminal TC504"). Outra forma do terminal atualizar o seusoftware é remotamente, usando o comando IDUpdateSoft.

Esse comando irá sair do programa verificador de preços e chamar o aplicativo deAtualização do Terminal TC504.

O argumento desse comando é do tipo DWORD e equivale a uma senha para evitar que oterminal seja re-atualizado por um comando aleatório. O valor dessa senha deve ser 0x5A33A5CC.

O terminal confirma o recebimento da mensagem e executa o aplicativo de Atualização doTerminal TC504. Veja mais sobre esse procedimento no capítulo "Aplicativo Atualização doTerminal TC504".


IDUpdateAdv 0x73 115 Servidor ARG_UPDATE 198Mensagem de RespostaRIDUpdateAdv 0x74 116 Cliente DWORD 4

Esse comando está reservado para uso futuro. Não está implementado atualmente noterminal TC504 Vs.1.0.


IDReloadAdv 0x75 117 Servidor DWORD 4Mensagem de RespostaRIDReloadAdv 0x76 118 Cliente DWORD 4


35

O servidor envia para o terminal de consulta o comando IDReloadAdv para que o terminalrecarregue os arquivos de imagem (BMP e GIF) do loop de imagens (slide show) que se encontramna pasta "c:\images" conforme o arquivo de configuração "c:\apps\images.cfg".

Esse comando é usado no procedimento de atualização das imagens do slide show. Primeiro énecessário apagar as imagens anteriores usando o comando "IDv DeleteAdv " então é necessário enviaros arquivos de novas imagens e o arquivo de configuração "images.cfg", usando o comando"IDv SendFile" (uma vez para cada arquivo). Então é necessário pedir ao terminal que recarregue asimagens para a memória estendida usando o comando "IDReloadAdv ". O terminal (a partir da versão2.0) ao receber este comando, se desconecta do servidor e inicializa o processo de carga de imagens.Na versão 1.0 deve-se enviar o comando “IDGoAdv ” para o terminal voltar a mostrar o “slide show”.


IDReloadPreImg 0x77 119 Servidor DWORD 4Mensagem de RespostaRIDReloadPreImg 0x78 120 Cliente DWORD 4

O servidor envia para o terminal de consulta o comando IDReloadPreImg para que o terminalrecarregue os arquivos de imagem (BMP e GIF) do seu pre-armazenamento, que se encontram napasta "c:\preimg" conforme o arquivo de configuração "c:\apps\preimg.cfg".

Esse comando é usado no procedimento de atualização das imagens do slide show. Primeiro énecessário apagar as imagens anteriores usando o comando " IDv DeletePreImg" então é necessárioenviar os arquivos de novas imagens e o arquivo de configuração "images.cfg", usando o comando"IDv SendFile" (uma vez para cada arquivo). Então é necessário pedir ao terminal que recarregue asimagens para a memória estendida usando o comando " IDReloadPreImg " (versão 2.0 em diante).


IDRestart 0x79 121 Servidor DWORD 4Mensagem de RespostaRIDRestart 0x7A 122 Cliente DWORD 4

Este comando realiza a reinicialização do terminal. O argumento desse comando é do tipoDWORD e equivale a uma senha para evitar que o terminal seja reiniciado por um comandoaleatório. O valor dessa senha deve ser 0x5A33A5CC (versão 2.0 em diante).


IDSecretCode 0x7B 123 Servidor Nenhum 0Mensagem de RespostaRIDSecretCode 0x7C 124 Cliente ARG_SECRETCODE 4

Ao enviar este comando, o terminal responde com 8 bytes que corresponde à identificação desegurança (versão 2.0 em diante).

typedef struct {


36

char sc[8];

}ARG_SECRETCODE;


IDSetConfigAdv Serv er 0x91 145 Servidor ARG_IMGUPD 112Mensagem de RespostaRIDSetConfigAdv Serv er 0x92 146 Cliente DWORD 4

Com este comando, o servidor consegue configurar os parâmetros de atualização de imagens(versão 2.0 em diante). O terminal responde com um DWord que pode ser 0x00000001 ou0x00000000, conforme o terminal tenha aceito ou não a configuração.

typedef struct

{





} ARG_IMGUPD;


IDGetConfigAdv Serv er 0x93 147 Servidor Nenhum 4Mensagem de RespostaRIDGetConfigAdv Serv er 0x94 148 Cliente ARG_IMGUPD 112

Com este comando, o servidor recebe as configurações dos parâmetros de atualização deimagens (versão 2.0 em diante).

typedef struct

{





} ARG_IMGUPD;


IDConnectAdv Serv er 0x95 149 Servidor Nenhum 0Mensagem de RespostaRIDConnectAdv Serv er 0x96 150 Cliente Nenhum 0

Com este comando, o terminal executa a atualização de imagens no endereço pre-configurado(versão 2.0 em diante).


37

�� !"#��

Para que se possa construir o programa servidor adaptado ao banco de dados doestabelecimento, a Gertec fornece o programa servidor de demonstração SC504.exe, com o seucódigo fonte, escrito em Borland C Builder totalmente aberto e usando a API do Windows Winsock.

Para facilitar ainda mais, a Gertec fornece a DLL SC504.DLL que realiza todas as funções doprotocolo TCP/IP do terminal de consulta TC504.

Veja na documentação sobre o programa servidor e no seu código fonte maiores informaçõessobre os procedimentos para implementar um servidor utilizando o protocolo do TC504.

Para permitir que o terminal de consulta encontre o programa servidor no método broadcastda busca automática, a Gertec fornece o programa "SPGCRtray.exe" e a DLL "pgcr.dll" com os seuscódigos fontes, que implementam o Protocolo Gertec de Configuração Remota (PGCR).

Para debugar o programa servidor ou para entender melhor o protocolo do TC504 é bom terum analisador de protocolos de rede. É possível baixar um bom analisador protocolos de rede pelainternet no endereço http://www.ethereal.com/.

Veja abaixo alguns pacotes capturados na rede da comunicação entre terminal e servidor:

O servidor está sendo executado num PC com endereço IP = 192.168.0.18. O terminal deconsulta (IP 192.168.0.150) se conecta ao servidor.

Frame 6 (61 on wire, 61 captured)Ethernet II Destination: 44:4d:50:00:06:1c (44:4d:50:00:06:1c) Source: 00:20:35:b2:69:1f (IBM_b2:69:1f) Type: IP (0x0800)Internet Protocol, Src Addr: SERVIDOR (192.168.0.18), Dst Addr: TC504 (192.168.0.150) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 47 Identification: 0xcf4f Flags: 0x04 Fragment offset: 0 Time to live: 128 Protocol: TCP (0x06) Header checksum: 0xa980 (correct) Source: SERVIDOR (192.168.0.18) Destination: TC504 (192.168.0.150)Transmission Control Protocol, Src Port: 16510 (16510), Dst Port: 6510 (6510), Seq: 27197924,Ack: 793509889 Source port: 16510 (16510) Destination port: 6510 (6510) Sequence number: 27197924 Next sequence number: 27197931 Acknowledgement number: 793509889 Header length: 20 bytes Flags: 0x0018 (PSH, ACK) Window size: 8576 Checksum: 0x7d7d (correct)Data (7 bytes)0000 02 13 00 00 00 00 00 .......

O servidor envia o pacote 02 13 00 00 00 00 00 que corresponde a:STX: 0x02ID: 0x0013 (IDwGetIdentify)Tam Arg: 0x00000000

Frame 8 (65 on wire, 65 captured)Ethernet II Destination: 00:20:35:b2:69:1f (IBM_b2:69:1f) Source: 44:4d:50:00:06:1c (44:4d:50:00:06:1c)


38

Type: IP (0x0800)Internet Protocol, Src Addr: TC504 (192.168.0.150), Dst Addr: SERVIDOR (192.168.0.18) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 51 Identification: 0x0042 Flags: 0x00 Fragment offset: 0 Time to live: 254 Protocol: TCP (0x06) Header checksum: 0x3a8a (correct) Source: TC504 (192.168.0.150) Destination: SERVIDOR (192.168.0.18)Transmission Control Protocol, Src Port: 6510 (6510), Dst Port: 16510 (16510), Seq: 793509889,Ack: 27197931 Source port: 6510 (6510) Destination port: 16510 (16510) Sequence number: 793509889 Next sequence number: 793509900 Acknowledgement number: 27197931 Header length: 20 bytes Flags: 0x0010 (ACK) Window size: 2048 Checksum: 0x6de3 (correct)Data (11 bytes)0000 02 14 00 04 00 00 00 10 f8 01 31 ..........1

O terminal de consulta responde ao servidor com sua identificação.STX: 0x02ID: 0x0014 (RIDwGetIdentify)Tam Arg: 0x00000004 (tamanho do argumento = 4 bytes)Argumento (DWORD) = 0x3101F810 (TC504 Vs.1.0)

Frame 10 (65 on wire, 65 captured)Ethernet II Destination: 44:4d:50:00:06:1c (44:4d:50:00:06:1c) Source: 00:20:35:b2:69:1f (IBM_b2:69:1f) Type: IP (0x0800)Internet Protocol, Src Addr: SERVIDOR (192.168.0.18), Dst Addr: TC504 (192.168.0.150) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 51 Identification: 0xd14f Flags: 0x04 Fragment offset: 0 Time to live: 128 Protocol: TCP (0x06) Header checksum: 0xa77c (correct) Source: SERVIDOR (192.168.0.18) Destination: TC504 (192.168.0.150)Transmission Control Protocol, Src Port: 16510 (16510), Dst Port: 6510 (6510), Seq: 27197931,Ack: 793509900 Source port: 16510 (16510) Destination port: 6510 (6510) Sequence number: 27197931 Next sequence number: 27197942 Acknowledgement number: 793509900 Header length: 20 bytes Flags: 0x0018 (PSH, ACK) Window size: 8565 Checksum: 0x7d6b (correct)Data (11 bytes)0000 02 15 00 04 00 00 00 01 00 00 00 ...........

O servidor aceita o terminal e manda uma mensagem para o terminal continuar.STX: 0x02ID: 0x0015 (IDContinue)Tam Arg: 0x00000004 (tamanho do argumento = 4 bytes)Argumento (DWORD) = 0x00000001 (Sim, continue)


39

Frame 12 (61 on wire, 61 captured)Ethernet II Destination: 00:20:35:b2:69:1f (IBM_b2:69:1f) Source: 44:4d:50:00:06:1c (44:4d:50:00:06:1c) Type: IP (0x0800)Internet Protocol, Src Addr: TC504 (192.168.0.150), Dst Addr: SERVIDOR (192.168.0.18) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 47 Identification: 0x0044 Flags: 0x00 Fragment offset: 0 Time to live: 254 Protocol: TCP (0x06) Header checksum: 0x3a8c (correct) Source: TC504 (192.168.0.150) Destination: SERVIDOR (192.168.0.18)Transmission Control Protocol, Src Port: 6510 (6510), Dst Port: 16510 (16510), Seq: 793509900,Ack: 27197942 Source port: 6510 (6510) Destination port: 16510 (16510) Sequence number: 793509900 Next sequence number: 793509907 Acknowledgement number: 27197942 Header length: 20 bytes Flags: 0x0010 (ACK) Window size: 2048 Checksum: 0x96e5 (correct)Data (7 bytes)0000 02 16 00 00 00 00 00 .......

O terminal responde ao servidorSTX: 0x02ID: 0x0016 (RIDContinue)Tam Arg: 0x00000000 (sem argumento)

Frame 14 (61 on wire, 61 captured)Ethernet II Destination: 44:4d:50:00:06:1c (44:4d:50:00:06:1c) Source: 00:20:35:b2:69:1f (IBM_b2:69:1f) Type: IP (0x0800)Internet Protocol, Src Addr: SERVIDOR (192.168.0.18), Dst Addr: TC504 (192.168.0.150) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 47 Identification: 0xd34f Flags: 0x04 Fragment offset: 0 Time to live: 128 Protocol: TCP (0x06) Header checksum: 0xa580 (correct) Source: SERVIDOR (192.168.0.18) Destination: TC504 (192.168.0.150)Transmission Control Protocol, Src Port: 16510 (16510), Dst Port: 6510 (6510), Seq: 27197942,Ack: 793509907 Source port: 16510 (16510) Destination port: 6510 (6510) Sequence number: 27197942 Next sequence number: 27197949 Acknowledgement number: 793509907 Header length: 20 bytes Flags: 0x0018 (PSH, ACK) Window size: 8558 Checksum: 0x7d6d (correct)Data (7 bytes)0000 02 11 00 00 00 00 00 .......

O servidor manda uma mensagem de Live para verificar a conexão.STX: 0x02ID: 0x0011 (IDvLive)Tam Arg: 0x00000000 (sem argumento)


40

Frame 16 (61 on wire, 61 captured)Ethernet II Destination: 00:20:35:b2:69:1f (IBM_b2:69:1f) Source: 44:4d:50:00:06:1c (44:4d:50:00:06:1c) Type: IP (0x0800)Internet Protocol, Src Addr: TC504 (192.168.0.150), Dst Addr: SERVIDOR (192.168.0.18) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 47 Identification: 0x0046 Flags: 0x00 Fragment offset: 0 Time to live: 254 Protocol: TCP (0x06) Header checksum: 0x3a8a (correct) Source: TC504 (192.168.0.150) Destination: SERVIDOR (192.168.0.18)Transmission Control Protocol, Src Port: 6510 (6510), Dst Port: 16510 (16510), Seq: 793509907,Ack: 27197949 Source port: 6510 (6510) Destination port: 16510 (16510) Sequence number: 793509907 Next sequence number: 793509914 Acknowledgement number: 27197949 Header length: 20 bytes Flags: 0x0010 (ACK) Window size: 2048 Checksum: 0x96db (correct)Data (7 bytes)0000 02 12 00 00 00 00 00 .......

O terminal responde ao Live.STX: 0x02ID: 0x0012 (RIDvLive)Tam Arg: 0x00000000 (sem argumento)

Frame 18 (61 on wire, 61 captured)Ethernet II Destination: 00:20:35:b2:69:1f (IBM_b2:69:1f) Source: 44:4d:50:00:06:1c (44:4d:50:00:06:1c) Type: IP (0x0800)Internet Protocol, Src Addr: TC504 (192.168.0.150), Dst Addr: SERVIDOR (192.168.0.18) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 47 Identification: 0x0047 Flags: 0x00 Fragment offset: 0 Time to live: 254 Protocol: TCP (0x06) Header checksum: 0x3a89 (correct) Source: TC504 (192.168.0.150) Destination: SERVIDOR (192.168.0.18)Transmission Control Protocol, Src Port: 6510 (6510), Dst Port: 16510 (16510), Seq: 793509914,Ack: 27197949 Source port: 6510 (6510) Destination port: 16510 (16510) Sequence number: 793509914 Next sequence number: 793509921 Acknowledgement number: 27197949 Header length: 20 bytes Flags: 0x0010 (ACK) Window size: 2048 Checksum: 0x958b (correct)Data (7 bytes)0000 02 59 00 02 01 00 00 .Y.....

Um produto é passado na frente do scanner do TC504 e o terminal envia os dados recebidospela serial (o código de barras do produto).

STX: 0x02ID: 0x0059 (IDvReadSerialB)


41

Tam Arg: 0x00000102 (tamanho do argumento: 258 bytes)

Frame 20 (312 on wire, 312 captured)Ethernet II Destination: 00:20:35:b2:69:1f (IBM_b2:69:1f) Source: 44:4d:50:00:06:1c (44:4d:50:00:06:1c) Type: IP (0x0800)Internet Protocol, Src Addr: TC504 (192.168.0.150), Dst Addr: SERVIDOR (192.168.0.18) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 298 Identification: 0x0048 Flags: 0x00 Fragment offset: 0 Time to live: 254 Protocol: TCP (0x06) Header checksum: 0x398d (correct) Source: TC504 (192.168.0.150) Destination: SERVIDOR (192.168.0.18)Transmission Control Protocol, Src Port: 6510 (6510), Dst Port: 16510 (16510), Seq: 793509921,Ack: 27197949 Source port: 6510 (6510) Destination port: 16510 (16510) Sequence number: 793509921 Next sequence number: 793510179 Acknowledgement number: 27197949 Header length: 20 bytes Flags: 0x0010 (ACK) Window size: 2048 Checksum: 0x1b9b (correct)Data (258 bytes)0000 0e 00 39 33 31 33 38 38 38 30 30 36 33 37 30 0d ..9313888006370.0010 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................0020 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................0030 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................0040 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................0050 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................0060 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................0070 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................0080 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................0090 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................00a0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................00b0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................00c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................00d0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................00e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................00f0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................0100 00 00 ..

Argumento de IDvReadSerialB é do tipo ARG_SERIAL_DATA (tamanho = 258 bytes)wTamBuff (WORD) = 0x000E (14 bytes)sBuffer[256] = 0x39, 0x33, 0x31 . . . = "9313888006370\r"

Frame 22 (63 on wire, 63 captured)Ethernet II Destination: 44:4d:50:00:06:1c (44:4d:50:00:06:1c) Source: 00:20:35:b2:69:1f (IBM_b2:69:1f) Type: IP (0x0800)Internet Protocol, Src Addr: SERVIDOR (192.168.0.18), Dst Addr: TC504 (192.168.0.150) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 49 Identification: 0xd74f Flags: 0x04 Fragment offset: 0 Time to live: 128 Protocol: TCP (0x06) Header checksum: 0xa17e (correct) Source: SERVIDOR (192.168.0.18) Destination: TC504 (192.168.0.150)Transmission Control Protocol, Src Port: 16510 (16510), Dst Port: 6510 (6510), Seq: 27197949,Ack: 793510179 Source port: 16510 (16510) Destination port: 6510 (6510) Sequence number: 27197949 Next sequence number: 27197958 Acknowledgement number: 793510179 Header length: 20 bytes


42

Flags: 0x0018 (PSH, ACK) Window size: 8286 Checksum: 0x7d52 (correct)Data (9 bytes)0000 02 21 00 02 00 00 00 00 00 .!.......

O servidor faz a consulta no banco de dados e não encontrou o produto. Então irá enviar amensagem de produto não encontrado para o terminal. Primeiro o servidor manda um comando paralimpar o display do terminal.

STX: 0x02ID: 0x0021 (IDvDispClear)Tam Arg: 0x00000002 (tamanho do argumento: 2 bytes)Argumento tipo WORD = 0x0000 (Índice zero da paleta de cores)

Frame 24 (231 on wire, 231 captured)Ethernet II Destination: 44:4d:50:00:06:1c (44:4d:50:00:06:1c) Source: 00:20:35:b2:69:1f (IBM_b2:69:1f) Type: IP (0x0800)Internet Protocol, Src Addr: SERVIDOR (192.168.0.18), Dst Addr: TC504 (192.168.0.150) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 217 Identification: 0xd84f Flags: 0x04 Fragment offset: 0 Time to live: 128 Protocol: TCP (0x06) Header checksum: 0x9fd6 (correct) Source: SERVIDOR (192.168.0.18) Destination: TC504 (192.168.0.150)Transmission Control Protocol, Src Port: 16510 (16510), Dst Port: 6510 (6510), Seq: 27197958,Ack: 793510179 Source port: 16510 (16510) Destination port: 6510 (6510) Sequence number: 27197958 Next sequence number: 27198135 Acknowledgement number: 793510179 Header length: 20 bytes Flags: 0x0018 (PSH, ACK) Window size: 8286 Checksum: 0x4ee8 (correct)Data (177 bytes)0000 02 23 00 aa 00 00 00 18 00 50 00 50 72 6f 64 75 .#.......P.Produ0010 63 74 20 4e 6f 74 20 46 6f 75 6e 64 00 63 fa bf ct Not Found.c..0020 09 00 00 00 b0 9c 02 d2 09 00 00 00 80 f4 75 00 ..............u.0030 93 8a e9 75 c5 b9 f7 bf b4 58 77 81 80 0a d9 00 ...u.....Xw.....0040 97 39 e9 75 04 e4 e9 75 7d 39 e9 75 e8 1a 2a 01 .9.u...u}9.u..*.0050 00 00 00 00 9d 8a e9 75 0c 00 00 00 d0 05 d9 00 .......u........0060 e0 07 d9 00 80 0a d9 00 00 00 00 00 ac f4 75 00 ..............u.0070 d9 89 e9 75 2c 00 00 00 a4 f4 75 00 01 00 00 00 ...u,.....u.....0080 bc f4 75 00 00 00 00 00 00 00 00 5c 66 6f 6e 74 ..u........\font0090 73 5c 6c 75 63 69 64 61 31 36 2e 62 6d 70 00 00 s\lucida16.bmp..00a0 e8 f4 75 00 0e 3a 46 00 16 3a 46 01 00 09 01 0c ..u..:F..:F.....00b0 01 .

Em seguida o servidor manda uma mensagem com o texto "Product Not Found" para serapresentado no display do terminal.

STX: 0x02ID: 0x0023 (IDvShowText)Tam Arg: 0x000000AA (tamanho do argumento 170 bytes)Argumento tipo ARG_DISPALY_TEXT (170 bytes)

WORD wPosX = 0x0018 (24)WORD wPosY = 0x0050 (80)char sText[128] = "Product Not Found"char sFont[32] = "\fonts\lucida16.bmp"


43

WORD wSize = 0x0001 (1x)WORD wColor = 0x0109 (clRed = Vermelho)WORD wBGColor = 0x010C (clBlue = Azul)

Frame 25 (61 on wire, 61 captured)Ethernet II Destination: 00:20:35:b2:69:1f (IBM_b2:69:1f) Source: 44:4d:50:00:06:1c (44:4d:50:00:06:1c) Type: IP (0x0800)Internet Protocol, Src Addr: TC504 (192.168.0.150), Dst Addr: SERVIDOR (192.168.0.18) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 47 Identification: 0x004a Flags: 0x00 Fragment offset: 0 Time to live: 254 Protocol: TCP (0x06) Header checksum: 0x3a86 (correct) Source: TC504 (192.168.0.150) Destination: SERVIDOR (192.168.0.18)Transmission Control Protocol, Src Port: 6510 (6510), Dst Port: 16510 (16510), Seq: 793510179,Ack: 27198135 Source port: 6510 (6510) Destination port: 16510 (16510) Sequence number: 793510179 Next sequence number: 793510186 Acknowledgement number: 27198135 Header length: 20 bytes Flags: 0x0010 (ACK) Window size: 1871 Checksum: 0x95b2 (correct)Data (7 bytes)0000 02 22 00 00 00 00 00 .".....

O terminal confirma o recebimento e execução do comando IDvDispClear.STX: 0x02ID: 0x0022 (RIDvDispClear)Tam Arg: 0x00000000 (sem argumento)

Frame 28 (65 on wire, 65 captured)Ethernet II Destination: 00:20:35:b2:69:1f (IBM_b2:69:1f) Source: 44:4d:50:00:06:1c (44:4d:50:00:06:1c) Type: IP (0x0800)Internet Protocol, Src Addr: TC504 (192.168.0.150), Dst Addr: SERVIDOR (192.168.0.18) Version: 4 Header length: 20 bytes Differentiated Services Field: 0x00 (DSCP 0x00: Default; ECN: 0x00) Total Length: 51 Identification: 0x004c Flags: 0x00 Fragment offset: 0 Time to live: 254 Protocol: TCP (0x06) Header checksum: 0x3a80 (correct) Source: TC504 (192.168.0.150) Destination: SERVIDOR (192.168.0.18)Transmission Control Protocol, Src Port: 6510 (6510), Dst Port: 16510 (16510), Seq: 793510186,Ack: 27198135 Source port: 6510 (6510) Destination port: 16510 (16510) Sequence number: 793510186 Next sequence number: 793510197 Acknowledgement number: 27198135 Header length: 20 bytes Flags: 0x0010 (ACK) Window size: 2048 Checksum: 0x94ef (correct)Data (11 bytes)0000 02 24 00 04 00 00 00 01 00 00 00 .$.........

E finalmente o terminal confirma o recebimento e execução do comando IDvShowText.STX: 0x02


44

ID: 0x0024 (RIDvShowText)Tam Arg: 0x00000004 (tamanho do argumento = 4 bytes)Argumento tipo DWORD = 0x00000001 (Ok!)


45

%�� &�� !"#

A unidade de disco (C:\) do TC504 é um DiskOnChip de 8MBytes. Internamente temos aseguinte estrutura de arquivos.

C:\ AUTOEXEC.BAT COMMAND.COM CONFIG.SYS E2000.COM KERNEL.SYS START.BAT WATTCP.CFG APPS\ IMAGES.CFG PREIMG.CFG TC504.EXE TC504.INI FONTS\ CAR8X8.BMP COURN8.BMP COURNB12.BMP LUCIDA12.BMP LUCIDA16.BMP SMALL.BMP FTP504\ CONFIG.BMP FTP.EXE FTP504.BMP FTP504.EXE MAIN.BMP RING.BMP UPDATE.CFG CONFIG.EXE IMAGES\ COLORB2.BMP GERANI.GIF PBAIANA.BMP PBANANA.BMP PREIMG\ BONUS.BMP XDOS\ COMMAND.COM FDXMS.SYS FORMAT.EXE HIMEM.SYS KERNEL.SYS MEM.EXE SYS.COM

O arquivo AUTOEXEC.BAT contém os procedimentos de inicialização do terminal deconsulta. Seu conteúdo é o seguinte:


46

E2000 0x68SET PATH=C:\FTP504;C:\APPS;C:\FONTScd\ftp504start.bat

Não apague nem edite esse arquivo, sob pena de perder a garantia do produto. Se fornecessário alterar a seqüência dos procedimentos de inicialização do terminal de consulta, alteresomente o arquivo "start.bat".

O arquivo "START.BAT" dá continuidade ao procedimento de inicialização do terminal:

:tc504tc504goto tc504

O programa FTP504.EXE, na pasta "ftp504\" é responsável pelos aplicativos "Configuraçãodo Terminal", "Servidor de FTP" e "Aplicativo de Atualização do Terminal TC504". Não apagueesse arquivo. É a única porta que existe para poder entrar no terminal e fazer suas configurações,atualizações e manutenções necessárias. Esse programa utiliza o arquivo de configuração"c:\ftp504\UPDATE.CFG" para acessar o servidor de atualização de software. O seu conteúdo defábrica é:

[FTP]server=http://www.gertec.com.br/link/tc504user=gertecpass=gertec

O arquivo "WATTCP.CFG" contém configurações de rede. Não apague esse arquivo.

[TCP/IP]my_ip=192.168.0.150netmask=255.255.255.0gateway=192.168.0.2nameserver=192.168.0.2

O arquivo "c:\apps\TC504.EXE" é o aplicativo do verificador de preços do TC504. Esseprograma utiliza as configurações armazenadas no arquivo "c:\apps\TC504.INI" que pode ser vistoabaixo:

[ETHERNET]my_autip=192.168.0.60server_ip=192.168.0.2find_server=1

[COM 1]c1baud=9600c1bits=8c1parity=0c1stops=1


47

c1handshaking=0c1timeout=0c1buffersize=0

[COM 2]c2baud=9600c2bits=8c2parity=0c2stops=1c2handshaking=0c2timeout=0c2buffersize=0

No diretório "Images" são armazenados os arquivos tipo BMP e GIF do loop de imagens"slide show". A seqüência em que as imagens são apresentadas estão no arquivo"c:\apps\IMAGES.CFG":

<|colorb2.bmp|5|0||pbanana.bmp|5|0||gerani.gif|0|2||pbaiana.bmp|5|0|>

No diretório "preimg" são armazenados os arquivos tipo BMP e GIF das pre-imagens. Aseqüência em que as imagens são apresentadas estão no arquivo "c:\apps\PREIMG.CFG":

<produto.bmpcartao.bmpteclado.bmp>

No diretório "fonts" estão arquivos tipo BMP, preto e branco (1bpp) que contém oscaracteres dos textos que são apresentados no display do terminal.

No diretório "xdos" estão arquivos de sistema do sistema operacional Free DOS. Não apagueesses arquivos nem esse diretório.

O arquivo "E2000.COM" é o driver de rede. Não apague esse arquivo.

��'��

A GERTEC oferece serviço gratuito de suporte técnico para todos os seus clientes,orientando a seus usuários quanto ao uso correto de seus produtos e serviços. Este serviço pode serobtido ou solicitado através da Internet, no e-mail [email protected].

Informações adicionais sobre o Kit de Desenvolvimento de Software do TC504 devem serrequisitadas ao suporte. O fornecimento do SDK depende da verificação do número de série doproduto e da assinatura de um "Acordo mútuo de confidencialidade" (NDA).


48

��(��

Versão 2.0:- Adicionado os comandos:• IDvShowImageBlock• IDvRecvFile• IDvGetUID• IDvSendPalette• IDvShowFrame• IDvDeletePreImg• IDReloadPreImg• IDSecretCode• IDRestart• IDSetConfigAdvServer• IDGetConfigAdvServer• IDConnectAdvServer

- Corrigido bug na recepção de IDs não implementados- Filtro e incremento de IP desabilitado (mesmo se busca servidor estiver habilitada)- Ping- Texto Transparente- Corrigido bugs no software de atualização- Nova fonte (car6x8.bmp)- Abertura de Gif 30% mais rápido

)��

GERTEC é marca registrada da GERTEC Telecomunicações Ltda.

IBM PC/XT/AT são marcas registradas da International Business Machines Corporation.

MS-Windows 98, Me, 2000, e NT são marcas registradas da Microsoft Corporation.As demais marcas citadas são de propriedade de seus respectivos donos.

Documents

Manual Do Usuario