ÍNDICE - Manual 3 _ Rede de microterminais TED com HUB Inteligente

Transcrição

1 ÍNDICE - Manual 3 _ Rede de microterminais TED com HUB Inteligente 1. Características da rede Instalação Biblioteca de gerenciamento DLL para Windows... 3 INITCOM - abre comunicação para 2 HUB's... 3 ENVTMSG - envia mensagem ao display... 4 GETCNT - lê mensagem do display... 4 ENVTIMP - envia mensagem para impressora do TED... 5 SETNCAN - seta o n. de canais ativos... 5 ENVBEEP - tocar n. "beeps"... 6 ENVCMBEEP - tocar "beep" de inicialização... 6 ENVLMTEC - limite de digitação... 6 ENVASENHA - modo senha... 6 ENVDSENHA - sai do modo senha... 7 LEENTRADA - lê status da entrada digital... 7 GETSERIAL - lê entrada serial secundária... 7 ENVDDIG - desliga saída digital... 8 ENVDELAY - pausa... 8 ENVCLDISP - apaga display... 9 CLOSECOM - finaliza comunicação Biblioteca de gerenciamento em CLIPPER / DOS Comandos INITCOM - abre comunicação / Endereçamento e Interrupção GETCNT - lê mensagem do display ENVTMSG - envia mensagem ao display / Demais comandos Fluxograma exemplo de controle... 13

2 _ Microterminais TED / 5000 em - conexão via HUB inteligente 1 - Características da rede - Conexão ao microcomputador do HUB ( cód. Colleter T.HUB ) em qualquer interface serial COM e ao ( s ) HUB ( s ) a conexão dos microterminais. - Existem dois modelos _ HUB com 8 interfaces ( cód. T.HUB1 ) e HUB com 16 interfaces ( cód. T.HUB2 ). Cada HUB conecta-se à uma interface COM sendo que um microcomputador poderá comportar até 4 ( quatro ) interfaces COM possibilitando o uso de até 4 ( quatro ) HUB's no mesmo microcomputador, ou melhor, até 64 microterminais em rede à um micro. - Topologia em " estrela " assegurando alta velocidade na comunicação dos dados, fácil intercâmbio por ausência de endereço físico ( estrapes ou jumpers ) nos microterminais, ausência de queda da rede por defeito localizado. - Padrão elétrico RS-485 utilizando cabo par trançado ( tipo telefônico ), permitindo distâncias de até metros. - O T.HUB é um hardware inteligente, realizando o gerenciamento da rede ( endereçamento, pooling, priorização e comunicação de dados entre todos os pontos ) de forma automática, propiciando um alto desempenho no intercâmbio das informações "aliviando" as Bibliotecas e o Software Aplicativo do Usuário destas tarefas. - Adaptação do T.HUB e a rede de microterminais TED / 5000 ao Software Aplicativo do Usuário é muito simples, através de Bibliotecas com funções prontas, bastando apenas algumas adaptações, conforme descrito adiante. 2 - Instalação A instalação de hardware do HUB COLLETER é bastante simples, não sendo necessárias configurações como endereçamento e interrupção, comuns na instalação de outros dispositivos como placas internas do PC. Para efetuá-la siga as seguintes instruções : a) Com o micro desligado, conecte o conector DB macho na porta serial COM do micro; b) Conecte o cabo de força da fonte de alimentação fornecida ao HUB e ligue à rede elétrica; c) Ligue o computador; d) Conecte cada terminal TED1000 em cada canal do HUB utilizando um conector RJ45 macho 8 vias (são utilizados apenas os pinos centrais 4 e 5 do RJ45 - vide figura HUB COLLETER ); Obs: a comunicação RS485 é polarizada, ou seja, os fios de telefone (par trançado) que ligam os TEDs ao HUB possuem uma ordem (polaridade) correta. Ligar os fios com polaridade invertida não danificará os terminais ou o HUB. Apenas não haverá comunicação. Caso um ou mais TEDs não estejam se comunicando com o micro, inverta a polaridade do par trançado do canal correspondente. 2

3 HUB COLLETER : RJ45 descrição / pinagem: Utilizar apenas os pinos centrais (4 e 5) do conector RJ Biblioteca DLL p/ gerenciamento de terminais TED1000 / HUB _ TEDHUB32.DLL Este manual contém as principais características da DLL 32bits TEDHUB32.DLL. A diferença entre o arquivo DLL do Delphi e o arquivo DLL do VB é que o primeiro é mais voltado para o DELPHI ou outras linguagens da Borland (passa os parâmetros da esquerda p/ a direita conforme o formato DELPHI - via registradores -com strings de comprimento máximo=255bytes, sendo o primeiro byte o indicador do comprimento da string) enquanto o segundo é mais voltado para as linguagens da Microsoft como o VB 5.0 ( passa parâmetros da direita p/ a esquerda, via stack com strings terminadas em nulo) Dois exemplos escritos em DELPHI 4.0 e VB 5.0 utilizando as funções abaixo podem ser encontrados na seção download do site Colleter em 3

4 3.1 _ Comandos da TEDHUB32.DLL : INITCOM ( IdPorta,End ) - abre comunicação com uma segunda porta serial ( necessária apenas para colocação de 2 HUBS no mesmo micro; para apenas 1 HUB na COM2, desconsidere esta função ) IdPorta -inteiro - Identificador da 2a porta ( 1=COM1, 3=COM3, 4=COM4 ) End -inteiro - endereço da porta em decimal ( ex: 3f8h = 1016 decimal ) function initcom ( idporta,end :integer ):integer; X:=INITCOM ( 1,1016 ) - abre comunicação com a porta COM1 no endereço 1016( ou seja, 3f8 em hexadecimal) RETORNO (X=1) Obs: A TEDHUB32.DLL utilizará a IRQ definida para cada porta na pasta Sistema / Gerenciador de Dispositivo / Portas do painel de controle do WINDOWS. Caso deseje alterar o valor da IRQ, lembre-se que o hardware também precisa ser alterado correspondentemente, seja pelo setup da máquina (porta COM onboard ) seja por jumpeamento de placas internas(como a placa IDE ou outra placa controladora de serial ). ENVTMSG ( conj, can, STRING ) - envia mensagem para o display do TED1000 Canal -inteiro - canal do HUB que receberá a mensagem STRING - variável string - dado a ser enviado para o display do TED1000 function envtmsg ( cnj,can :integer ; dado : shortstring ):integer; X:=envtmsg ( 0,0,'Teste de envio'); Se X=1, a mensagem chegou no display do TED1000 Se X=0, a mensagem não chegou no display do TED1000. Verificar : TED desligado, cabo rompido, etc. GETCNT ( ptstring, ptcan, conj ) - lê mensagem vinda de todos os TEDs. Esta função deve ser colocada em um TIMER, sugerindo-se 1 ms para o intervalo de chamada. ptcan -ponteiro para um inteiro - canal do HUB que recebeu a mensagem do TED. ptstring -ponteiro para variável string - dado enviado pelo TED1000. function getcnt ( var dado:shortstring ; var canal:integer ; conj : integer ): integer; if (getcnt ( recb,canal,0 )) = 1 then 4

5 begin... Se X=1, existe algum dado vindo de algum TED. A variável 'CANAL' receberá o valor do canal que enviou o dado. A string recebida será armazenada em 'RECB' Se X=0, não existe dado nenhum, vindo de nenhum TED. ENVTIMP ( conj, can, STRING ) - envia mensagem para a impressora serial ligada ao TED 1000 Canal -inteiro - canal do HUB que receberá a mensagem STRING - variável string - dado a ser enviado para a impressora serial ligada ao TED1000 function envtimp ( cnj,can :integer ; dado : shortstring ):integer; X:=envtimp ( 0,0,'Teste de Impressão'+chr(10)+chr(13)); Se X=0, não existe TED ligado no canal 'can'. Verificar cabo de comunicação, TED desligado, etc. Se X=1, o TED recebeu o comando e a impressora conseguiu imprimir - tudo OK. Se X=2, o TED recebeu o comando mas a impressora não pôde imprimir. Verificar impressora desligada, sem papel, cabo da impressora, etc. Obs: o TED pode perceber que a impressora não está pronta pelo estado do sinal RTS. SETNCAN ( Ncan) - seta o número de canais ativos de cada HUB ( NCAN=0 para ligar TED diretamente na COM2.) NCan -inteiro - número de canais ativos do HUB ( default = 8 ) function setncan ( Ncan :integer ):integer; X:=Setncan ( 16 ); - configura funcionamento de um HUB de 16 canais. RETORNO (X=número inteiro - sempre 1) Esta função é necessária para informar à DLL a quantidade total de canais do HUB (variável 'NCAN'). Para trabalhar-se com 1 TED ligado diretamente na COM2 deve-se configurar SETNCAN (0). Isto desativará o chaveamento de canais do HUB. OBS: esta função seta o No de canais ativos do primeiro HUB ( ligado na COM2). Para setar o número de canais de um segundo HUB ligado no mesmo micro, chamar a função setncan2 ( mesmos parâmetros do setncan. O número default de canais é 8 ). ENVBEEP ( conj, can, N ) - faz o TED1000 ligado ao canal 'CAN' do HUB tocar N beeps simples N -inteiro - número de beeps para o TED executar ( variando de 1 a 9 ) function envbeep ( cnj,can,n :integer ):integer; 5

6 X:=envbeep ( 0,3,5); { Ted ligado ao canal 3 do HUB tocará 5 beeps simples } Se X=1, TED executou comando do BEEP ENVCMBEEP ( conj, can ) faz o TED1000 ligado ao canal 'CAN' do HUB tocar o BEEP de inicialização function envcmbeep ( cnj,can : integer ):integer; X:=envcmbeep ( 0,2 ); { Ted ligado ao canal 2 do HUB tocará o beep de inicialização } Se X=1, TED executou comando do BEEP ENVLMTEC ( conj, can, N ) - limita quantidade de digitações que podem ser feitas no TED1000 N -inteiro - número máximo de limitação de digitações no teclado do TED. function envlmtec ( cnj,can,n :integer ):integer; X:=envlmtec ( 0,6,5); { Teclado do TED ligado ao canal 6 do HUB ficará limitado a 5 digitações } Se X=1, TED executou comando de limitação de digitação ENVASENHA ( conj, can ) - TED1000 entra no modo senha ( digitações não aparecem no display ) function envasenha ( cnj,can : integer ):integer; X:=envasenha ( 0,2 ); { Ted ligado ao canal 2 do HUB entra no modo senha - digitações não aparecem no display } Se X=1, TED executou comando desejado ENVDSENHA ( conj, can ) - TED1000 sai do modo senha ( digitações aparecem do display ) 6

7 function envdsenha ( cnj,can : integer ):integer; X:=envdsenha ( 0,2 ); { Ted ligado ao canal 2 do HUB sai do modo senha - digitações voltam a aparecer no display } Se X=1, TED executou comando desejado LEENTRADA ( conj, can ) - lê status da entrada digital do TED1000 function leentrada ( cnj,can : integer ):integer; X:=leentrada ( 0,4 ); { lê a entrada digital do TED ligado ao canal 4 do HUB } Se X=1, a entrada está em nível lógico 1 (=entrada em VCC ou em aberto - default da porta = VCC [5V] ) Se X=0, a entrada está em nível lógico 0 (=entrada fisicamente ligada ao GND) Se X=2, não foi encontrado TED ligado no canal em questão. Verificar TED ligado, cabos,etc. GETSERIAL ( conj, can ) - lê a entrada serial secundária do TED protocolo ENQ/STX direcionando o dado recebido para o próximo GETCNT ( o dado é capturado como se fosse uma digitação ). Usada para ler dispositivos seriais externos, como balanças, que utilizam este protocolo. Conj -inteiro - (0= porta COM2 ; 1 = porta secundária definida no INITCOM ) function getserial ( cnj,can : integer ):integer; X:=GETSERIAL ( 0,1 ); { lê a entrada serial auxiliar do TED ligado ao canal 1 do HUB } Se X=1, o TED recebeu o comando e enviará a leitura da porta serial auxiliar para o próximo GETCNT Se X=0, TED não foi encontrado no canal em questão. Verificar TED ligado, cabo de comunicação, etc. OBSERVAÇÕES (comando GETSERIAL) : 1) como o peso da balança é recebido também pelo GETCNT, o TED enviará este dado acrescido de um prefixo 'P' ( letra P maiúscula ) para não ser confundido com uma digitação normal do teclado. 7

8 2) para a ligação física com o dispositivo externo, o pino 3 do conector DB9 fêmea é utilizado ora como RX2 (para ler dispositivos externos com protocolo de software) ora como CTS ( para ligar ao RTS da impressora serial - protocolo de hardware ) 3) o protocolo de leitura é o seguinte: o TED envia um ENQ ( código asc 05 ) e espera o dado, sendo que. este dado deve chegar no seguinte formato : STX+leitura+ETX. ( onde STX = chr(02) e ETX = chr(03) ) BAUD 9600, 8 bits, sem paridade, 1 ou 2 stop bits. ENVLDIG ( conj, can ) - liga a saída digital do TED conectado ao canal CAN. Quando ligada, o pino 1 do conector DB9 fêmea do TED cai forçosamente para 0 Volts ( GND ). Quando desligada, este pino fica em aberto ( transistor c/ coletor em aberto ) function envldig ( cnj,can : integer ):integer; X:=envldig ( 0,3 ); {liga a saída digital do TED ligado ao canal 3 do HUB } Se X=1, TED executou comando desejado ENVDDIG ( conj, can ) - desliga a saída digital do TED conectado ao canal CAN. function envddig ( cnj,can : integer ):integer; X:=envddig ( 0,3 ); {desliga a saída digital do TED ligado ao canal 3 do HUB } Se X=1, TED executou comando desejado ENVDELAY ( conj, can, n ) - TED1000 executa uma pausa de N*20 ms Conj -inteiro - ( 0= porta COM2 ; 1 = porta secundária definida no INITCOM ) N -inteiro - valor da pausa executada pelo TED1000 function envdelay ( cnj,can,n : integer ):integer; X:=envdelay (0,0,30); Se X=1, TED executou comando desejado ENVCLDISP ( conj, can ) apaga o display do TED ligado ao canal CAN 8

9 function envcldisp ( cnj,can : integer ):integer; X:=envcldisp ( 0,3 ); { Apaga o display do Ted ligado ao canal 3 do HUB } Se X=1, TED executou comando do BEEP CLOSECOM ( conj ) - finaliza comunicação com a porta serial. Conj -inteiro - ( porta a ser finalizada COM2 ; 1 = porta secundária definida no INITCOM ) function closecom ( cnj : integer ):integer; x:=closecom ( 0 ); {finaliza comunicação com a porta serial COM2 } 4 - Biblioteca p/ gerenciamento de terminais TED HUB em CLIPPER / DOS LIB CLIPPER P/ TED HUB : TEDHUB.LIB Em linguagem CLIPPER, a sintaxe das funções da TEDHUB é semelhante à da DLL TEDHUB32, com algumas diferenças : a) Todos os comandos da biblioteca CLIPPER, com exceção do comando CLOSECOM, começam com o caractere underline ( _ ) inexistente na DLL. EX: _envtmsg (0,0, TESTE ) ; _envtimp (0,0, teste de impressão +chr(10)+chr(13)) b) A maioria dos comandos da lib CLIPPER são procedures, portanto não retornam valores. c) Os comandos INITCOM e CLOSECOM são sempre necessários para o funcionamento do aplicativo. d) A lib Clipper TEDHUB.LIB serve apenas para o funcionamento do aplicativo com o HUB externo enquanto a TEDLIB.LIB funciona apenas com a placa multiserial PL485 da COLLETER ( ou diretamente nas portas seriais COM1 e COM2 ) Estão incluídos no disquete CL-DLL / CL-LIB os exemplos 4TEDS.PRG e VENDA.PRG que podem ser utilizados como base no desenvolvimento de seu aplicativo. Após a implementação do programa meuprog.prg, a compilação e linkedição com a lib deve seguir a seguinte sintaxe: Para funcionar com a placa TL485 ou porta serial COM1 / COM2 : 9

10 CLIPPER meuprog.prg RTLINK FILE meuprog,prg LIB CLIPPER,EXTEND,TEDLIB Para funcionar com o HUB externo: CLIPPER meuprog.prg RTLINK FILE meuprog LIB CLIPPER,EXTEND,TEDHUB 4.1 _ Comandos das bibliotecas p/ Clipper TEDHUB -Comandos da LIB CLIPPER : INITCOM Inicializa comunicação com o HUB externo ( programa portas seriais ) _initcom(endbase,vetor,irq,tail,conj,ncon,bufrx,buftx) endbase - inteiro ( o endereço e vetor devem seguir os valores da tabela 1.0 abaixo - configurações de hardware ) vetor - inteiro ( vide tabela 1.0 ) IRQ - inteiro ( vide tabela 1.0 ) tail - inteiro ( terminador dos dados - colocar sempre tail=13 ) conj - inteiro ( No da placa ou No do HUB - com apenas 1 placa ou 1 HUB, conj=0 ) ncan - inteiro ( No total de canais da placa ou do HUB ) bufrx - inteiro buftx - inteiro ( Buffers de recepção e transmissão internos da lib. Adotar os valores 1000 e 1000 ) ENDEREÇAMENTO E INTERRUPÇÃO PARA A FUNÇÃO INITCOM: Os parâmetros ENDEREÇO / VETOR / INTERRUPÇÃO que devem ser colocados na função INITCOM variam conforme o hardware utilizado ( HUB - COM1,COM2 ). Para o HUB ligado nas portas COM1 e COM2, os parâmetros são os seguintes : COM1 / COM2/ HUB : Para se utilizar uma das COM's e para se comunicar com o HUB e com a lib Clipper TEDHUB.LIB utilize "0" para vetor, exemplo: Porta Endereço Vetor COM1 3F8H (1016) 0 (HUB na COM1) COM2 2F8H (760) 0 (HUB na COM2) GETCNT ( lê o dado vindo do microterminal ) _getcnt(ptstr,ptcon,conj) ptstr -ponteiro para uma string 10

11 ptcan conj -ponteiro para um inteiro -inteiro Na lib Clipper, a rotina _getcnt retorna sempre um valor booleano. Se houver algum dado para o conjunto ela retornará verdadeiro, caso contrário falso. Quando retornar verdadeiro ela modificará os valores apontados pelos ponteiros ptstr e ptcon. Os valores são o número do conector, em ptcon, e o dado em ptstr. do while str!= "." if(_getcnt(@str,@con,0) Verifica se há dado no conjunto 10,10 say str+"conjunto 0 "+"canal "+str(con) se hover mostra no vídeo endif if(_getcnt(@str,@con,1) Verifica se há dado no conjunto 10,10 say str+"conjunto 1 "+"canal "+str(con) se houver mostra no video endif enddo Obs: são inseridos automaticamente nas variáveis STR e CON, respectivamente, o dado que foi digitado no TED1000 e o canal que forneceu a informação. ENVTMSG ( envia dado para o display do microterminal ) _envtmsg (conj,canal,string) string -variável string que contém o dado a ser enviado para o display canal -inteiro : canal que receberá o dado conj -inteiro : identificador do HUB ( para apenas 1 HUB, colocar sempre 0 ) Na lib Clipper, a rotina _envtmsg Não retorna valores. Apenas envia a mensagem contida em STRING para o display do microterminal ligado no canal em questão. _INITCOM ( 760,0,3,13,0,1,1000,1000 ) inicializa HUB na COM2 do while lastkey() <> 27 inkey() ESPERA PELO ESCAPE PARA SAIR if(_getcnt(@str,@con,0) Verifica se há dado no conjunto 10,10 say str+"conjunto 0 "+"canal "+str(con) _envtmsg (0,con, DADO RECEBIDO ) _envcmbeep (0,con) endif se hover mostra no vídeo retorna mensagem ao microterminal faz o microterminal que enviou a mensagem tocar um BEEP 11

12 enddo closecom(0) finaliza a porta serial e libera memória para o sistema operacional. - Demais Comandos da lib CLIPPER: Os comandos a seguir são idênticos para as libs TEDHUB e TEDLIB. Lembre -se apenas que na LIB os comandos começam todos com o traço de underline ( _ ) sendo que a função CLOSECOM é a única que não o possui. Em todos estes comandos, as variáveis conjunto e canal são do tipo INTEIRO. Todas as variáveis aqui devem ser passadas por valor e não por referência. Por exemplo : _ENVBEEP (0, 2, 5 ) => faz o TED no canal 2 tocar 5 beeps _ENVTMSG (0,0, BOM DIA ) => faz o TED ligado ao canal 0 mostrar BOM DIA no display IMPORTANTE: Cada conjunto caracteriza um HUB instalado no micro. Assim, com apenas um HUB, o conjunto é sempre 0 (zero). Cada canal caracteriza o canal físico do HUB em que o TED está conectado. Num HUB de 8 canais a variável canal varia de 0 a 7. _ENVBEEP ( conjunto, canal, N ) - faz o TED tocar N beeps simples _ENVCMBEEP ( conjunto, canal ) - faz o TED tocar o BEEP de comando _ENVLDIG ( conjunto,canal ) - liga a saída digital do TED1000 _ENVDDIG ( conjunto, canal ) - desliga a saída digital do TED 1000 _ENVTIMP ( conjunto,canal, STRING+chr(10)+chr(13) ) imprime uma linha na impressora ligada ao TED _ENVDELAY ( conjunto,canal,n) faz o TED1000 executar uma pausa de N*50 ms. _ENVLMTEC (conjunto,canal,n)- limita o número de teclas que podem ser pressionadas no teclado do TED _ENVASENHA ( conjunto,canal ) - TED entra no modo senha ( digitações não aparecem no display ) _ENVDSENHA ( conjunto,canal ) - TED sai do modo senha _ENVCLDISP ( conjunto, canal ) - Apaga o display do TED 1000 _LEENTRADA ( conjunto, canal ) - Lê status da entrada digital. Esta função pode retornar os seguintes valores : a).v. ( verdadeiro ) = Entrada digital fisicamente ligada ao GND ( terra ) b).f. ( falso ) = Entrada digital ligada em VCC ou em aberto ( default ) c)nil ( nulo ) = TED não encontrado / não pronto _GETSERIAL (conjunto,canal) - Lê porta serial auxiliar ( vide OBS. do comando GETSERIAL no resumo de comandos da TEDHUB32.DLL ) CLOSECOM (conjunto) - Finaliza a comunicação e libera memória para o sistema operacional. 12

13 5 - APÊNDICE : FLUXOGRAMA EXEMPLO DE CONTROLE PARA VÁRIOS MICROTERMINAIS Este fluxograma tem o objetivo de auxiliar no desenvolvimento da lógica de programação de seu aplicativo voltado para os microterminais TED : Obs : Note que só é necessária uma instrução _GETCNT, mesmo para vários terminais e vários dados de entrada. Sugerimos que os contadores 1 e 2 do exemplo acima sejam elementos de uma matriz ( ou vetor ), indicando o status atual de cada terminal no sistema do usuário. 13