Man Mop LNX

MANUAL DA INTERFACE LINUX
MOP
(AUTOMAÇÃO COMERCIAL - SOFTWARE BÁSICO)
Itautec Philco S. A.
Data de Emissão: 22/07/2004

1 - Procedimento de instalação e teste.................................................................................1-4
1.1 - Requisitos...........................................................................................................................1-4
1.2 - Drivers................................................................................................................................1-4
1.2.1 - T_Serial.o.................................................................................................................................... 1-4
1.2.2 - Operador.o................................................................................................................................... 1-5
1.2.3 - Elotouch.o................................................................................................................................... 1-6
1.3 - Bibliotecas..........................................................................................................................1-8
1.3.1 - libRotOpera.so............................................................................................................................. 1-8
1.3.2 - libMop.so.................................................................................................................................... 1-8
1.4 - Programa de Testes............................................................................................................1-9
1.4.1 - tstMop......................................................................................................................................... 1-9
1.4.2 - itautec.conf.................................................................................................................................. 1-9
2 - Descrição das funções da interface..............................................................................2-11
2.1 - Função MopOpen.............................................................................................................2-11
2.2 - Função MopClose.............................................................................................................2-12
2.3 - Função MopEquipamento...............................................................................................2-13
2.4 - Função MopMemoria.......................................................................................................2-15
2.5 - Função MopTipoCursor..................................................................................................2-16
2.6 - Função MopAtributoDisplay...........................................................................................2-17
2.7 - Função MopCursor..........................................................................................................2-18
2.8 - Função MopPosicaoCursor..............................................................................................2-19
2.9 - Função MopLimpaDisplay..............................................................................................2-20
2.10 - Função MopLeDisplay...................................................................................................2-21
2.11 - Função MopEscreveCaracter.........................................................................................2-22
2.12 - Função MopEscreveString.............................................................................................2-23
2.13 - Função MopHabilitaTorre.............................................................................................2-24
2.14 - Função MopDesabilitaTorre..........................................................................................2-25
2.15 - Função MopModoEntrada.............................................................................................2-26
2.16 - Função MopStatusDisplay.............................................................................................2-27
2.17 - Função MopLeTecla.......................................................................................................2-28
2.18 - Função MopVerifTecla..................................................................................................2-29
2.19 - Função MopLimpaTecla................................................................................................2-30
2.20 - Função MopLeCartao....................................................................................................2-31
2.21 - Função MopVerifCartao................................................................................................2-32
2.22 - Função MopLimpaCartao.............................................................................................2-33
2.23 - Função MopSelecionaTrilha..........................................................................................2-34
2 Device Driver Operador / Elotouch e biblioteca Mop
2.24 - Função MopLeCaneta....................................................................................................2-35
2.25 - Função MopVerifCaneta................................................................................................2-36
2.26 - Função MopLimpaCaneta.............................................................................................2-37
2.27 - Função MopSelecionaCodigo.........................................................................................2-38
2.28 - Função MopAbreGaveta................................................................................................2-39
2.29 - Função MopStatusGaveta..............................................................................................2-40
2.30 - Função MopLeds............................................................................................................2-41
2.31 - Função MopAcendeLeds................................................................................................2-42
2.32 - Função MopPiscaLeds...................................................................................................2-43
2.33 - Função MopApagaLeds.................................................................................................2-44
2.34 - Função MopStatusLeds..................................................................................................2-45
2.35 - Função MopAtivaBeep...................................................................................................2-46
2.36 - Função MopDesativaBeep..............................................................................................2-47
2.37 - Função MopLeRAM......................................................................................................2-48
2.38 - Função MopEscreveRAM..............................................................................................2-49
2.39 - Função MopMapeiaRAM..............................................................................................2-50
3 - Informações para utilização da interface.....................................................................3-51
3.1 - Arquivos gerados.............................................................................................................3-51
3.2 - Sistema operacional..........................................................................................................3-51
3.3 - Utilização da interface......................................................................................................3-51

1 - PROCEDIMENTO DE INSTALAÇÃO E TESTE
1.1 - Requisitos
 Linux Red Hat 9.0
 Kernel versão 2.4.20-18.9
 T_Serial.o
 Operador.o / Elotouch.o
 libRotOpera.so
 libMop.so
 tstMop
 itautec.conf
1.2 - Drivers
Para utilização dos drivers devemos carregar antes o driver T_Serial, para depois carregar o driver
Mop (Operador ou Elotouch), para utilizar a biblioteca Mop com o periférico Elotouch deve-se utilizar
o driver Elotouch e para utilizar a biblioteca Mop com o módulo operador deve-se utilizar o driver
Operador.
1.2.1 - T_Serial.o
Este driver trata toda a comunicação serial com o periférico.
São necessários 4 arquivos para a inicilização do T_Serial:
T_Serial.o - Driver
T_Serial.ini - Configurações das portas de comunicação
load_T_Serial - Script para inicialização do driver (insmod)
unload_T_Serial - Script para finalização do driver (rmmod)
1) Extrair os 4 arquivos em qualquer diretório, sendo que estejam no mesmo local.
2) Verificar se os arquivos load_T_Serial e unload_T_Serial está permitindo execução (rwx-r-xr-x),

caso contrário executar o comando:
[root@localhost /home/DIR]# chmod 775 <arquivo> (para os 2 arquivos)
3) Verificar o arquivo de configurações T_Serial.ini:

Este arquivo contém a configuração dos canais seriais. O arquivo T_Serial.ini é um arquivo texto
e seu formato é o seguinte:
itComxx="IO,IRQ"
opTrace=n
opDedicada=n
Onde xx indica o número da porta que será configurada

IO indica o endereço base de IO do respectivo canal serial
IRQ indica a IRQ que será usada pelo canal serial
n ativa/desativa (1 = TRUE / 0 = FALSE)
Segue um exemplo de uma configuração possível para o T_Serial.ini :
itCom01="3F8,4"
itCom02="2F8,3"
itCom03="3E8,5"
itCom04="2E8,15"
itCom05="278,10"
itCom06="268,11"
opTrace=1
opDedicada=0
4) Executar o script de inicialização do driver:

[root@localhost /home/DIR]# ./load_T_Serial
5) Para verificar se o driver entrou em funcionamento, executamos o comando:

[root@localhost /home/DIR]# lsmod
Saída do comando:
Module Size Used by Not tainted
T_Serial 23024 0 (unused)
smbfs 38064 1 (autoclean)
ide-cd 32512 0 (autoclean)
cdrom 30272 0 (autoclean) [ide-cd]
Podemos ver que a saída do comando, indica que o driver T_Serial foi carregado corretamente...
IMPORTANTE: Para consultar a versão do driver T_Serial, devemos carregá-lo e digitar o

comando:
[root@localhost /home/DIR]# cat /proc/itVersao
1.2.2 - Operador.o
Este driver trata os módulos operadores Itautec, funcionabilidades de gravação e leitura da CMOS e
acesso da abertura de gaveta para placas específicas, interface com o driver T_Serial.
São necessários 3 arquivos para a inicilização do Operador:
Operador.o - Driver
load_Operador - Script para inicialização do driver (insmod)
unload_Operador - Script para finalização do driver (rmmod)
2) Verificar se os arquivos load_Operador e unload_Operador está permitindo execução (rwx-r-xr-

x), caso contrário executar o comando:

[root@localhost /home/DIR]# ./load_Operador

Saída do comando:

Operador 18800 0 (unused)
T_Serial 23024 0 [Operador]
Podemos ver que a saída do comando, indica que o driver Operador foi carregado
corretamente, e está em uso pela T_Serial.
IMPORTANTE: Para consultar a versão do driver Operador, devemos carregá-lo e digitar o

comando:
1.2.3 - Elotouch.o
Este driver trata o periférico Elotouch (Elo Entuitive 1229L), funcionabilidades da leitora de cartão,
escrita/leitura da CMOS e acesso da abertura de gaveta para placas específicas, interface com o driver
T_Serial.
São necessários 3 arquivos para a inicilização do Elotouch:
Elotouch.o - Driver
load_ Elotouch - Script para inicialização do driver (insmod)
unload_ Elotouch - Script para finalização do driver (rmmod)
6) Verificar se os arquivos load_ Elotouch e unload_ Elotouch está permitindo execução (rwx-r-xr-
x), caso contrário executar o comando:

[root@localhost /home/DIR]# ./load_Elotouch

Saída do comando:

Elotouch 18800 0 (unused)
T_Serial 23024 0 [Elotouch]

Podemos ver que a saída do comando, indica que o driver Elotouch foi carregado
corretamente, e está em uso pela T_Serial.
IMPORTANTE: Para consultar a versão do driver Elotouch, devemos carregá-lo e digitar o

comando:

1.3 - Bibliotecas
1.3.1 - libRotOpera.so
Esta biblioteca deve ser utilizada para acesso as funções do driver Operador e Elotouch.
É necessário apenas 1arquivo para a utilização da Biblioteca:
libRotOpera.so.1.2 - Biblioteca
1) Extrair o arquivo.
Obs: Podemos extrair as libs no diretório padrão do Linux (/usr/lib)
2) Criar links simbólicos para a biblioteca:
[root@localhost /usr/lib]# ln -s libRotOpera.so.1.2 libRotOpera.so.1

[root@localhost /usr/lib]# ln -s libRotOpera.so.1 libRotOpera.so
1.3.2 - libMop.so
São necessários 2 arquivos para a utilização da Biblioteca:
Mop.h - Protótipo das funções

Mop.so.x.y - Biblioteca
1) Extrair os arquivos.
Obs: Podemos extrair as libs no diretório padrão do Linux (/usr/lib)
2) Criar links simbólicos para a biblioteca:
[root@localhost /usr/lib]# ln -s libMop.so.x.y Mop.so.x

[root@localhost /usr/lib]# ln -s libMop.so.x Mop.so
onde: x e y representam a versao da biblioteca.

1.4 - Programa de Testes
1.4.1 - tstMop
Programa de testes contendo menu de opções com todas as funções disponíveis pela API.
São necessários 2 arquivos para a utilização do Programa de testes:
tstMop - Executável
itautec.conf - Arquivo de configurações
1) Extrair os arquivos em qualquer diretório.

2) Caso as bibliotecas (libRotOpera.so - libMop.so) não estiverem no diretório padrão de bibliotecas
do linux (/usr/lib), devemos exportar a variável de ambiente do linux (LD_LIBRARY_PATH) que
indica o caminho onde as bibliotecas estão localizadas. Portanto neste caso executamos:
[root@localhost /home/teste_Mop]#
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/Diretorio_de_LIBS
3) Verificar o arquivo de configurações itautec.conf, conforme o exemplo abaixo:
[ItautecPOS\Elotouch]
Device=/dev/itElotouch1
CommSettings=itCom01:9600,e,8,1
CheckDSR=0
Trace=1
4) Agora podemos executar o programa de testes
[root@localhost /home/teste_ Mop]# ./tstMop
1.4.2 - itautec.conf
Abaixo temos alguns exemplos que podemos utilizar:
Para a configuração do dispositivo Elotouch:
[ItautecPOS\Elotouch]
Device=/dev/itElotouch1
CheckDSR=0
Trace=1
Para a configuração do dispositivo Módulo Operador:
[ItautecPOS\ModuloOperador]
Device=/dev/itOperador1
CheckDSR=0
Trace=1
TipoPeriferico=Mod_Operador

Para a configuração do dispositivo Display Torre:
[ItautecPOS\DisplayTorre]
CheckDSR=0
Trace=1
TipoPeriferico=Disp_Torre
Para a configuração do dispositivo MiniPOS:
[ItautecPOS\MINIPOS]
CheckDSR=0
Trace=1
TipoPeriferico=Mod_Operador
OBS: Os dispositivos: MINIPOS, ModOperador e Elotouch devem estar configurados separadamente.

2 - DESCRIÇÃO DAS FUNÇÕES DA INTERFACE
2.1 - Função MopOpen

O que faz:
Faz a leitura do arquivo de configurações ./itautec.conf, onde escolhe o equipamento que deverá ser
utilizado (ModOperador/MiniPOS/DisplayTorre/Elotouch) e abre comunicação com o periférico.
OBS: As funções disponibilizadas por esta API retornarão erro até que esta função seja ativada.
Protótipo:
 em C:
int MopOpen (void);
Entradas:
Não existem.
Saídas:
Não existem.
Retornos da Função: poderá conter um dos seguintes valores:
Valor Nome Descrição Ações do Ações do Operador

Aplicativo
00H – 00D OK Sucesso. ------ ------
02H – 02D ERRO_SERIAL_ Erro de comunicação com o Verificar se o dispositivo ------
MOP dispositivo. está corretamente
conectado no PC, checar
o arquivo de
configurações
(itautec.conf).
TORRE dispositivo. está corretamente
o arquivo de
configurações
(itautec.conf).
08H – 08D ERRO_CONFIG_ Erro de configuração do Checar o arquivo de ------
MOP equipamento. configurações
(itautec.conf).
TORRE equipamento. configurações
(itautec.conf).

2.2 - Função MopClose
O que faz:
Esta função bloqueia o uso das outras funções da API, de forma que para poder usá-las novamente, é
necessário executar a função de inicialização de comunicação com sucesso. Ela é chamada e só retorna quando
terminar a operação.
Protótipo:
 em C:
int MopClose (void);
Entradas:
Não existem.
Saídas:
Não existem.

Aplicativo
00H – 00D FALSE Erro na tentativa de Verificar se a função ------
finalização. MopOpen foi executada
com sucesso.
01H – 01D TRUE Sucesso. ------ ------

2.3 - Função MopEquipamento
O que faz:
Retorna a configuração dos equipamentos encontrados.
Protótipo:
 em C:
int MopEquipamento (char *confMop, char *confTorre, int *nFiscal)
Entradas:
Não existem.
Saídas:
confMop:- configuração do Módulo Operador:
bits 1,0 - teclado instalado
00 = não instalado (inválido)
01 = 55 teclas
10 = 100 teclas (inválido)
11 = livre
bit 2 - teclado PIN instalado
0 = não instalado
1 = instalado
bits 4,3 - display LCD instalado JP09 JP10
00 = não instalado (inválido)
01 = LCD 2x16
10 = LCD 2x40
11 = livre
bit 5 - caneta leitora instalada
0 = não instalado
1 = instalado
bits 7,6 - leitora de cartão instalada JP11 JP12
00 = não instalada
01 = trilhas 1 e 2
10 = trilhas 2 e 3
11 = trilha 2
confTorre:- configuração do Display Torre:

bits 2,1,0 - display torre instalado
000 = não instalado
001 = display 1x16
010 = display 1x20
011 = display 2x20
100 = display 1x40
bits 5,4,3 - reservado
bit 6 - reservado
bit 7 - livre
nFiscal:- número fiscal do equipamento (4 dígitos).

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
o arquivo de
configurações
(itautec.conf).

2.4 - Função MopMemoria
O que faz:
Retorna a configuração da RAM não volátil.
Protótipo:
 em C:
int MopMemoria (unsigned char **lpPointer, unsigned long *lpEndereco, unsigned *lpBytes,
unsigned *lpPagina, unsigned *lpOffset);
Entradas:
Não existem.
Saídas:
lpPointer:- endereço virtual da RAM não volátil mapeada (offset 0)
lpEndereco:- endereço físico da memória (modo real)
lpBytes:- total de RAM não volátil instalada
lpPagina:- tamanho da página de memória
lpOffset:- offset inicial para utilização é reservado 64 bytes de memória na página 0

Aplicativo
00H – 00D OK Sucesso. ------ ------
(itautec.conf).
20H – 32D ERRO_MEMO Placa não suportada para ------ ------
acesso à CMOS

2.5 - Função MopTipoCursor
O que faz:
Altera o tipo do cursor para o display LCD.
OBS: Comando válido apenas para display LCD.
Protótipo:
 em C:
int MopTipoCursor (int nTipo);
Entradas:
nTipo:- Tipo do cursor:
0 - cursor normal
1 - cursor invisível
2 - piscante
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
01H – 01D ERRO_PARAM Parâmetros da função inválida. Verificar se os parâmetros ------
da função foram passados
corretamente.
o arquivo de
configurações
(itautec.conf).
(itautec.conf).
(itautec.conf).

2.6 - Função MopAtributoDisplay
O que faz:
Seta o atributo do display.
OBS: Comando válido apenas para display LCD.
Protótipo:
 em C:
int MopAtributoDisplay (int nTipo);
Entradas:
0 - cursor normal
2 - piscante
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
corretamente.
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.7 - Função MopCursor
O que faz:
Posiciona o cursor.
Protótipo:
 em C:
int MopCursor (int nTipo, int lin, int col);
Entradas:
1 - display LCD
2 - display TORRE
3 - display LCD e TORRE
lin:- Linha:
1 a 2 – linhas válidas
col:- Coluna:
1 a 40 – colunas válidas
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
corretamente.
o arquivo de
configurações
(itautec.conf).
o arquivo de
configurações
(itautec.conf).
(itautec.conf).
(itautec.conf).

2.8 - Função MopPosicaoCursor
O que faz:
Retorna a posição atual do cursor.
Protótipo:
 em C:
int MopPosicaoCursor (int nTipo, int *lin, int *col);
Entradas:
1 - display LCD
2 - display TORRE
Saídas:
lin:- Linha:
col:- Coluna:

Aplicativo
00H – 00D OK Sucesso. ------ ------
corretamente.
o arquivo de
configurações
(itautec.conf).
o arquivo de
configurações
(itautec.conf).
(itautec.conf).
(itautec.conf).

2.9 - Função MopLimpaDisplay
O que faz:
Limpa o conteúdo do display.
Protótipo:
 em C:
int MopLimpaDisplay (int nTipo);
Entradas:
1 - display LCD
2 - display TORRE
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
corretamente.
o arquivo de
configurações
(itautec.conf).
o arquivo de
configurações
(itautec.conf).
(itautec.conf).
(itautec.conf).

2.10 - Função MopLeDisplay
O que faz:
Retorna o buffer e o número de caracteres escrito a partir da posição (linha,coluna) do display
selecionado.
Protótipo:
 em C:
int MopLeDisplay (int nTipo, int lin, int col, unsigned char *str, int nTm);
Entradas:
1 - display LCD
2 - display TORRE
lin:- Linha:
col:- Coluna:
Saídas:
str:- string lida.
nTm:- tamanho da string lida.

Aplicativo
00H – 00D OK Sucesso. ------ ------
corretamente.
o arquivo de
configurações
(itautec.conf).
o arquivo de
configurações
(itautec.conf).
(itautec.conf).
(itautec.conf).

2.11 - Função MopEscreveCaracter
O que faz:
Escreve um número de caracteres a partir da posição do cursor nos displays selecionados.
Protótipo:
 em C:
int MopEscreveCaracter (int nTipo, unsigned char c, int nTam);
Entradas:
1 - display LCD
2 - display TORRE
c:- Caracter a ser escrito.
nTam:- Quantidade de vezes a ser escrito.
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
corretamente.
o arquivo de
configurações
(itautec.conf).
o arquivo de
configurações
(itautec.conf).
(itautec.conf).
(itautec.conf).

2.12 - Função MopEscreveString
O que faz:
Escreve uma string no display selecionado.
Protótipo:
 em C:
int MopEscreveString (int nTipo, unsigned char *str, int nTam);
Entradas:
1 - display LCD
2 - display TORRE
str:- String a ser escrito.
nTam:- Tamanho da string.
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
corretamente.
o arquivo de
configurações
(itautec.conf).
o arquivo de
configurações
(itautec.conf).
(itautec.conf).
(itautec.conf).

2.13 - Função MopHabilitaTorre
O que faz:
Habilita o display Torre caso estiver presente.
Protótipo:
 em C:
int MopHabilitaTorre (void);
Entradas:
Não existem.
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.14 - Função MopDesabilitaTorre
O que faz:
Desabilita o display Torre caso estiver presente.
Protótipo:
 em C:
int MopDesabilitaTorre (void);
Entradas:
Não existem.
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.15 - Função MopModoEntrada
O que faz:
Seleciona o modo de entrada num determinado display.
Protótipo:
 em C:
int MopModoEntrada (int nTipo, int nDesloca);
Entradas:
1 - display LCD
2 - display TORRE
nDesloca:- Tipo do deslocamento do display:
0 - Esquerda sem deslocamento do display
1 - Esquerda com deslocamento do display (só para display LCD)
2 - Direita sem deslocamento do display
3 - Direita com deslocamento do display (só para display LCD)
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
corretamente.
o arquivo de
configurações
(itautec.conf).
o arquivo de
configurações
(itautec.conf).
(itautec.conf).
(itautec.conf).

2.16 - Função MopStatusDisplay
O que faz:
Devolve o status do display selecionado.
Protótipo:
 em C:
int MopStatusDisplay (int nTipo, int *lpDesloca, int *lpDisplay, int *lpTipoCursor);
Entradas:
1 - display LCD
2 - display TORRE
Saídas:
lpDesloca:- Tipo do deslocamento do display:
0 - Esquerda sem deslocamento do display
1 - Esquerda com deslocamento do display (só para display LCD)
2 - Direita sem deslocamento do display
3 - Direita com deslocamento do display (só para display LCD)
lpDisplay:- aponta variável inteira q. receberá status do display.
lpTipoCursor:- Tipo do cursor
0 - cursor normal
2 - piscante

Aplicativo
00H – 00D OK Sucesso. ------ ------
corretamente.
(itautec.conf).
(itautec.conf).

2.17 - Função MopLeTecla
O que faz:
Devolve um pacote de teclas retornado pelo periférico.
Protótipo:
 em C:
int MopLeTecla (unsigned char *nScanCode, int *nTam);
Entradas:
Não existem.
Saídas:
nScanCode:- Scancode da tecla.
nTam:- Tamanho do scancode devolvido.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.18 - Função MopVerifTecla
O que faz:
Verifica se tem pacote de teclas recebido pelo protocolo.
Protótipo:
 em C:
int MopVerifTecla (void);
Entradas:
Não existem.
Saídas:
Não existem.

Aplicativo
com sucesso.
01H – 01D TRUE Sucesso. ------ ------

2.19 - Função MopLimpaTecla
O que faz:
Limpa todos os pacotes de teclas recebidos pelo protocolo.
Protótipo:
 em C:
int MopLimpaTecla (void);
Entradas:
Não existem.
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.20 - Função MopLeCartao
O que faz:
Devolve um buffer de cartão retornado pelo periférico.
Protótipo:
 em C:
int MopLeCartao (unsigned char *str, int *nTam);
Entradas:
Não existem.
Saídas:
str:- string lida.
nTam:- tamanho da string lida.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.21 - Função MopVerifCartao
O que faz:
Verifica se tem buffer de cartão recebido pelo protocolo.
Protótipo:
 em C:
int MopLeCartao (void);
Entradas:
Não existem.
Saídas:
Não existem.

Aplicativo
com sucesso.
01H – 01D TRUE Sucesso. ------ ------

2.22 - Função MopLimpaCartao
O que faz:
Limpa todos os buffers de cartão recebidos pelo protocolo.
Protótipo:
 em C:
int MopLimpaCartao (void);
Entradas:
Não existem.
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.23 - Função MopSelecionaTrilha
O que faz:
Devolve um buffer de cartão retornado pelo periférico.
Protótipo:
 em C:
int MopSelecionaTrilha (int nTrilhas);
Entradas:
nTrilhas:- Número correspondente a trilha a ser utilizada.
000 - inválida
001 - trilha 1
010 - trilha 2
011 - trilhas 1 e 2
100 - trilha 3
101 - inválida
110 - trilhas 2 e 3
111 - inválida
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.24 - Função MopLeCaneta
O que faz:
Devolve um buffer de caneta retornado pelo módulo operador.
OBS: Esta função é suportada somente para o Modulo Operador / MiniPos, caso contrário será ignorada
e retornará sucesso.
Protótipo:
 em C:
int MopLeCaneta (unsigned char *str, int *nTam);
Entradas:
Não existem.
Saídas:
str:- string lida.
nTam:- tamanho da string lida.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.25 - Função MopVerifCaneta
O que faz:
Verifica se tem buffer de caneta recebido pelo protocolo.
Protótipo:
 em C:
int MopVerifCaneta (void);
Entradas:
Não existem.
Saídas:
Não existem.

Aplicativo
com sucesso.
01H – 01D TRUE Sucesso. ------ ------

2.26 - Função MopLimpaCaneta
O que faz:
Limpa todos os buffers de caneta recebidos pelo protocolo.
Protótipo:
 em C:
int MopLimpaCaneta (void);
Entradas:
Não existem.
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.27 - Função MopSelecionaCodigo
O que faz:
Seleciona o tipo de código de barras que será lido.
Protótipo:
 em C:
int MopSelecionaCodigo (int nTipo);
Entradas:
nTipo:- Tipo do código de barras:
1 - EAN-13
2 - EAN-8
4 - Code39
8 - Interleave 2 e 5
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.28 - Função MopAbreGaveta
O que faz:
Abertura de gaveta conectada à placa periféricos.
Protótipo:
 em C:
int MopAbreGaveta (void);
Entradas:
Não existem.
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
(itautec.conf).
40H – 64D ERRO_GAVETA Placa não suportada para ------ ------
acesso à gaveta

2.29 - Função MopStatusGaveta
O que faz:
Status de gaveta conectada à placa periféricos.
Protótipo:
 em C:
int MopStatusGaveta (int *nStatus);
Entradas:
Não existem.
Saídas:
nStatus:- Devolve o status da gaveta:
0 – Gaveta fechada
1 – Gaveta aberta

Aplicativo
00H – 00D OK Sucesso. ------ ------
(itautec.conf).
40H – 64D ERRO_GAVETA Placa não suportada para ------ ------
acesso à gaveta

2.30 - Função MopLeds
O que faz:
Altera o estado dos nLeds indicados para o estado acao.
Protótipo:
 em C:
int MopLeds (int nLeds, int acao);
Entradas:
nLeds:- Número do led a ser acionado:
1 - Led 1
2 - Led 2
4 - Led 3
acao:- Operação a ser efetuada com os leds:

0 - apaga
1 - acende
2 - pisca
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.31 - Função MopAcendeLeds
O que faz:
Acende os leds indicados.
Protótipo:
 em C:
int MopAcendeLeds (int nLeds);
Entradas:
1 - Led 1
2 - Led 2
4 - Led 3
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.32 - Função MopPiscaLeds
O que faz:
Pisca os leds indicados.
Protótipo:
 em C:
int MopPiscaLeds (int nLeds);
Entradas:
1 - Led 1
2 - Led 2
4 - Led 3
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.33 - Função MopApagaLeds
O que faz:
Apaga os leds indicados.
Protótipo:
 em C:
int MopApagaLeds (int nLeds);
Entradas:
1 - Led 1
2 - Led 2
4 - Led 3
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.34 - Função MopStatusLeds
O que faz:
Retorna o status dos leds indicados.
Protótipo:
 em C:
int MopStatusLeds (int nLeds, int *Status);
Entradas:
1 - Led 1
2 - Led 2
4 - Led 3
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.35 - Função MopAtivaBeep
O que faz:
Ativa beep do módulo operador pelo tempo especificado.
Se o tempo for 0 ativa o beep até que a função MopDesativaBeep seja executada .
Protótipo:
 em C:
int MopAtivaBeep (int nTempo);
Entradas:
nTempo:- tempo em mili-segundos.
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.36 - Função MopDesativaBeep
O que faz:
Desliga o beep do módulo operador.
Protótipo:
 em C:
int MopDesativaBeep (void);
Entradas:
Não existem.
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
o arquivo de
configurações
(itautec.conf).
(itautec.conf).

2.37 - Função MopLeRAM
O que faz:
Faz a leitura da CMOS a partir do offset.
Protótipo:
 em C:
int MopLeRAM (unsigned offset, unsigned char *str, unsigned tam);
Entradas:
offset:- Endereço inicial de memória.
tam:- Tamanho do buffer a ser lido.
Saídas:
str:- Ponteiro da string a ser lida.

Aplicativo
00H – 00D OK Sucesso. ------ ------
(itautec.conf).
acesso à CMOS

2.38 - Função MopEscreveRAM
O que faz:
Faz a escrita da CMOS a partir do offset.
Protótipo:
 em C:
int MopEscreveRAM (unsigned offset, unsigned char *str, unsigned tam);
Entradas:
str:- Ponteiro da string a ser escrita.
tam:- Tamanho do buffer a ser lido.
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
(itautec.conf).
acesso à CMOS

2.39 - Função MopMapeiaRAM
O que faz:
Faz a o mapeamento da CMOS a partir do offset.
Protótipo:
 em C:
int MopMapeiaRAM (unsigned offset);
Entradas:
Saídas:
Não existem.

Aplicativo
00H – 00D OK Sucesso. ------ ------
(itautec.conf).
acesso à CMOS

3 - INFORMAÇÕES PARA UTILIZAÇÃO DA INTERFACE
3.1 - Arquivos gerados
Nome
Operador.o / Elotouch.o
LibMop.so
Mop.h
3.2 - Sistema operacional
 - DOS - versão: 6.22

 - PC DOS - versão: 7.00
 - Windows - versão: NT ou 2000
 - Windows - versão: 95
 - Windows - versão: 98
 - LINUX - versão: Red Hat 9.0 – kernel 2.4.20-18.9 – Arquitetura i386
3.3 - Utilização da interface
A função MopOpen inicia a API lendo todas as configurações e parâmetros setados no arquivo de
configuração ./itautec.conf. Se alguns dos parâmetros não forem especificados ou inválidos, será retornado Erro
(EINVAL).
Com a função MopOpen em processo, todas as outras funções serão disponibilizadas.
Finalizado todos os processos, é executada a função MopClose, que finaliza toda a comunicação com o
periférico.

Man Mop LNX

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Man Mop LNX

Enviado por

Direitos autorais:

Formatos disponíveis

MANUAL DA INTERFACE LINUX

(AUTOMAÇÃO COMERCIAL - SOFTWARE BÁSICO)

Data de Emissão: 22/07/2004

3 Device Driver Operador / Elotouch e biblioteca Mop

São necessários 4 arquivos para a inicilização do T_Serial:

1) Extrair os 4 arquivos em qualquer diretório, sendo que estejam no mesmo local.

2) Verificar se os arquivos load_T_Serial e unload_T_Serial está permitindo execução (rwx-r-xr-x),

3) Verificar o arquivo de configurações T_Serial.ini:

Onde xx indica o número da porta que será configurada

Segue um exemplo de uma configuração possível para o T_Serial.ini :

4) Executar o script de inicialização do driver:

5) Para verificar se o driver entrou em funcionamento, executamos o comando:

IMPORTANTE: Para consultar a versão do driver T_Serial, devemos carregá-lo e digitar o

São necessários 3 arquivos para a inicilização do Operador:

1) Extrair os 3 arquivos em qualquer diretório, sendo que estejam no mesmo local.

2) Verificar se os arquivos load_Operador e unload_Operador está permitindo execução (rwx-r-xr-

3) Executar o script de inicialização do driver:

4) Para verificar se o driver entrou em funcionamento, executamos o comando:

Module Size Used by Not tainted

IMPORTANTE: Para consultar a versão do driver Operador, devemos carregá-lo e digitar o

São necessários 3 arquivos para a inicilização do Elotouch:

5) Extrair os 3 arquivos em qualquer diretório, sendo que estejam no mesmo local.

7) Executar o script de inicialização do driver:

8) Para verificar se o driver entrou em funcionamento, executamos o comando:

Module Size Used by Not tainted

6 Device Driver Operador / Elotouch e biblioteca Mop

IMPORTANTE: Para consultar a versão do driver Elotouch, devemos carregá-lo e digitar o

7 Device Driver Operador / Elotouch e biblioteca Mop

É necessário apenas 1arquivo para a utilização da Biblioteca:

[root@localhost /usr/lib]# ln -s libRotOpera.so.1.2 libRotOpera.so.1

São necessários 2 arquivos para a utilização da Biblioteca:

Mop.h - Protótipo das funções

[root@localhost /usr/lib]# ln -s libMop.so.x.y Mop.so.x

onde: x e y representam a versao da biblioteca.

8 Device Driver Operador / Elotouch e biblioteca Mop

São necessários 2 arquivos para a utilização do Programa de testes:

1) Extrair os arquivos em qualquer diretório.

3) Verificar o arquivo de configurações itautec.conf, conforme o exemplo abaixo:

4) Agora podemos executar o programa de testes

[root@localhost /home/teste_ Mop]# ./tstMop

Para a configuração do dispositivo Módulo Operador:

9 Device Driver Operador / Elotouch e biblioteca Mop

Para a configuração do dispositivo MiniPOS:

OBS: Os dispositivos: MINIPOS, ModOperador e Elotouch devem estar configurados separadamente.

10 Device Driver Operador / Elotouch e biblioteca Mop

2.1 - Função MopOpen

Retornos da Função: poderá conter um dos seguintes valores:

Valor Nome Descrição Ações do Ações do Operador

11 Device Driver Operador / Elotouch e biblioteca Mop

Retornos da Função: poderá conter um dos seguintes valores:

Valor Nome Descrição Ações do Ações do Operador

12 Device Driver Operador / Elotouch e biblioteca Mop

confTorre:- configuração do Display Torre:

nFiscal:- número fiscal do equipamento (4 dígitos).

Retornos da Função: poderá conter um dos seguintes valores:

13 Device Driver Operador / Elotouch e biblioteca Mop

14 Device Driver Operador / Elotouch e biblioteca Mop

Retornos da Função: poderá conter um dos seguintes valores:

Valor Nome Descrição Ações do Ações do Operador

15 Device Driver Operador / Elotouch e biblioteca Mop

Retornos da Função: poderá conter um dos seguintes valores:

Valor Nome Descrição Ações do Ações do Operador

16 Device Driver Operador / Elotouch e biblioteca Mop