Man Mopapi LNX

MANUAL DA INTERFACE LINUX
MOPAPI
(AUTOMAÇÃO COMERCIAL - SOFTWARE BÁSICO)
Itautec S. A.
1 - Informações para utilização da interface.......................................................................1-3
1.1 - Arquivos gerados...............................................................................................................1-3
1.2 - Sistema operacional...........................................................................................................1-3
1.3 - Descrição e Utilização das Interfaces.................................................................................1-4
1.3.1 - Descrição da interface................................................................................................................. 1-4
1.3.2 - Arquitetura MopApi.................................................................................................................... 1-5
2 - Procedimento de instalação e teste.................................................................................2-6
2.1 - Requisitos...........................................................................................................................2-6
2.2 - Bibliotecas..........................................................................................................................2-6
2.2.1 - libMopApi.so............................................................................................................................... 2-6
2.2.2 - libMrDtorre.so............................................................................................................................. 2-6
2.3 - Configuração......................................................................................................................2-7
2.3.1 - itautec.conf.................................................................................................................................. 2-7
2.4 - Programa de Testes............................................................................................................2-8
2.4.1 - tstMopApi................................................................................................................................... 2-8
3 - Descrição das funções da interface................................................................................3-9
3.1 - Função MopOpen..............................................................................................................3-9
3.2 - Função MopClose.............................................................................................................3-10
3.3 - Função MopEquipamento...............................................................................................3-11
3.4 - Função MopTipoCursor..................................................................................................3-13
3.5 - Função MopAtributoDisplay...........................................................................................3-14
3.6 - Função MopCursor..........................................................................................................3-15
3.7 - Função MopPosicaoCursor..............................................................................................3-16
3.8 - Função MopLimpaDisplay..............................................................................................3-17
3.9 - Função MopLeDisplay.....................................................................................................3-18
3.10 - Função MopEscreveCaracter.........................................................................................3-19
3.11 - Função MopEscreveString.............................................................................................3-20
3.12 - Função MopHabilitaTorre.............................................................................................3-21
3.13 - Função MopDesabilitaTorre..........................................................................................3-22
3.14 - Função MopModoEntrada.............................................................................................3-23
3.15 - Função MopStatusDisplay.............................................................................................3-24
3.16 - Função MopLeTecla.......................................................................................................3-25
3.17 - Função MopVerifTecla..................................................................................................3-26
2 Device Driver Operador e biblioteca MopApi
3.18 - Função MopLimpaTecla................................................................................................3-27
3.19 - Função MopLeCartao....................................................................................................3-28
3.20 - Função MopVerifCartao................................................................................................3-29
3.21 - Função MopLimpaCartao.............................................................................................3-30
3.22 - Função MopSelecionaTrilha..........................................................................................3-31
3.23 - Função MopLeCaneta....................................................................................................3-32
3.24 - Função MopVerifCaneta................................................................................................3-33
3.25 - Função MopLimpaCaneta.............................................................................................3-34
3.26 - Função MopSelecionaCodigo.........................................................................................3-35
3.27 - Função MopAbreGaveta................................................................................................3-36
3.28 - Função MopStatusGaveta..............................................................................................3-37
3.29 - Função MopLeds............................................................................................................3-38
3.30 - Função MopAcendeLeds................................................................................................3-39
3.31 - Função MopPiscaLeds...................................................................................................3-40
3.32 - Função MopApagaLeds.................................................................................................3-41
3.33 - Função MopStatusLeds..................................................................................................3-42
3.34 - Função MopAtivaBeep...................................................................................................3-43
3.35 - Função MopDesativaBeep..............................................................................................3-44

1 - INFORMAÇÕES PARA UTILIZAÇÃO DA INTERFACE
1.1 - Arquivos gerados
Nome
libMopApi.so
libMrDtorre.so
MopApi.h
MrDtorre.h
1.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: kernel 2.4.20-18.9– Arquitetura i386
 - LINUX - versão: kernel 2.6.15-r11– Arquitetura i386
1.3 - Descrição e Utilização das Interfaces
1.3.1 - Descriçã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.
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 a
biblioteca.
Poderá ser comandado também, pela biblioteca MopApi.so, o display Torre POS4000. Opcionalmente,
para utilização do display torre Gertec no lugar do display Torre POS4000, deve ser instalada a biblioteca
MrDtorre.so.

1.3.2 - Arquitetura MopApi

2 - PROCEDIMENTO DE INSTALAÇÃO E TESTE
2.1 - Requisitos
 Linux - Kernel versão 2.4.20-18.9, Librix – Kernel 2.6.15 e 2.6.24-7
 libMopApi.so
 libMrDtorre.so
 tstMopApi
 itautec.conf
2.2 - Bibliotecas
2.2.1 - libMopApi.so
São necessários 2 arquivos para a utilização da Biblioteca:

MopApi.h - Protótipo das funções
libMopApi.so.x.y - Biblioteca
1) Extrair os arquivos.
Obs: Podemos extrair a lib no diretório padrão do Linux (/usr/lib)
2) Criar links simbólicos para a biblioteca:
[root@localhost /usr/lib]# ln -s libMopApi.so.x.y libMopApi.so.x

[root@localhost /usr/lib]# ln -s libMopApi.so.x libMopApi.so
onde: x e y representam a versao da biblioteca.
2.2.2 - libMrDtorre.so
São necessários 2 arquivos para a utilização da Biblioteca:
MrDtorre.h - Protótipo das funções

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

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

2.3 - Configuração
2.3.1 - itautec.conf
É possivel configurar 3 dispositivos para esta biblioteca. Verificar o arquivo de configurações

itautec.conf, conforme o exemplo abaixo:
Para a configuração do dispositivo Módulo Operador:
[ItautecPOS\ModuloOperador]
Device=/dev/itOperador1
CommSettings=itCom05:9600,e,8,1
CheckDSR=0
Trace=1
TipoPeriferico=Mod_Operador
TipoDLL=Mop
PVID=7720:9710
Para a configuração do dispositivo Display Torre Itautec:
[ItautecPOS\DisplayTorre]
CheckDSR=0
Trace=1
TipoPeriferico=Disp_Torre
TipoDLL=Mop
Para a configuração do dispositivo MiniPOS:
[ItautecPOS\MINIPOS]
CheckDSR=0
Trace=1
TipoPeriferico=Mod_Operador
TipoDLL=Mop
Para a configuração do dispositivo Display Torre Gertec:
[ItautecPOS\DisplayGertec]
Device=/dev/itDtorre1
CommSettings=itCom01:9600,n,8,1
CheckDSR=0
Trace=1
TipoPeriferico=Disp_Torre
TipoDLL=Mop
IMPORTANTE: Ao utilizar MiniPOS sem o display Gertec, a configuração do dispositivo Display Torre
Gertec deve ser retirada do arquivo itautec.conf. A chave PVID deve ser utilizada para configurar o product e o
vendor ID do device USB, respectivamente, ela deverá ser configurada quando a chave CommSetings contiver
a opção “itUSB” ao invés de “itCom05”.

2.4 - Programa de Testes
2.4.1 - tstMopApi
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:
tstMopApi - Executável
itautec.conf - Arquivo de configurações
1) Extrair os arquivos em qualquer diretório.

2) Caso as bibliotecas libMop.so e libMrDtorre 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) Configurar o arquivo itautec.conf de acordo com o item 1.5.1 deste manual.
4) Agora podemos executar o programa de testes
[root@localhost /home/teste_mop]# ./tstMopApi

3 - DESCRIÇÃO DAS FUNÇÕES DA INTERFACE
3.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/TorreGertec) 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 executada com
sucesso.
Protótipo:
 em C:
int WINAPI 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 Aplicativo Ações do Operador

0H OK Inicialização realizada com ------ ------
0D sucesso.
4H ERRO_SERIAL_TORRE Erro na comunicação com o ------ Verificar se o periférico
4D display torre. foi conectado na porta
serial corretamente.
8H ERRO_CONFIG_MOP Erro no arquivo de ------ Verificar se o conteúdo
8D configurações do arquivo itautec.conf
“itautec.conf”, ou Erro de está correto. Verificar se o
comunicação com o periférico está conectado.
dispositivo.

3.2 - Função MopClose
O que faz:
Esta função fecha a comunicação e indisponibiliza o uso de todas as funções desta API exceto da função
MopOpen.
Protótipo:
 em C:
int WINAPI MopClose (void);
Entradas:
Não existem.
Saídas:
Não existem.

0H OK Função executada com ------ ------
0D sucesso.
1H ERRO_CLOSE ------ Verificar se a função ------
1D MopOpen foi executada
corretamente.

3.3 - Função MopEquipamento
O que faz:
Esta função retorna como parâmetro de saída a configuração dos equipamentos encontrados.
Protótipo:
 em C:
int WINAPI 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 OPERADOR instalado
00 = não instalado (inválido)
01 = OPERADOR 2x16
10 = OPERADOR 2x40
11 = livre
bit 5 - caneta leitora instalada
0 = não instalado
1 = instalado
bits 7,6 - leitora de cartão instalada
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. Este valor é lido na CMOS da placa PDV Periféricos.


0D sucesso.
2H ERRO_SERIAL_MOP Erro na comunicação com o ------ Verificar se o periférico
2D módulo operador. foi conectado na porta
6H ERRO_SERIAL_TORRE_M Erro na comunicação com o ------ Verificar se o periférico
6D OP módulo operador e display foi conectado na porta
torre. serial corretamente.

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

0D sucesso.
1H ERRO_PARAM Parâmetros da função Verificar se os parâmetros ------
1D inválida. da função foram passados
corretamente.
8H ERRO_CONFIG_MOP Erro ao executar a função. Verificar se a função ------
com sucesso.

3.5 - Função MopAtributoDisplay
O que faz:
Esta função altera o atributo do display OPERADOR, onde pode ser normal, invisível ou piscante.
OBS: Comando válido apenas para display OPERADOR.
Protótipo:
 em C:
int WINAPI MopAtributoDisplay (int nTipo);
Entradas:
nTipo:- Tipo do cursor:
0 - cursor normal
1 - cursor invisível (tem o mesmo efeito da opção 0)
2 - piscante
Saídas:
Não existem.

0D sucesso.
corretamente.
com sucesso.

3.6 - Função MopCursor
O que faz:
Esta função atualiza o posicionamento do cursor de acordo com o display selecionado.
Protótipo:
 em C:
int WINAPI MopCursor (int nTipo, int lin, int col);
Entradas:
nTipo:- Display a ser selecionado:
1 - display OPERADOR
2 - display CLIENTE
3 - display OPERADOR e CLIENTE
lin:- Linha do display selecionado.

0 a 2 – linhas válidas.
col:- Coluna do display selecionado.
0 a 40 – colunas válidas.
Saídas:
Não existem.
Valor Nome Descrição Ações do Ações do Operador

Aplicativo
00D sucesso.
corretamente.
AH ERRO_SERIAL_CONFIG_M Erro de configuração do ------ Checar o arquivo de
10D OP equipamento. Erro na configurações
comunicação com o módulo (itautec.conf). Verificar se
operador. o periférico foi conectado
na porta serial
corretamente.
10H ERRO_CONFIG_TORRE Erro ao executar a função. Verificar se a função ------
com sucesso.
14H ERRO_SERIAL_CONFIG_T Erro de configuração do ------ Checar o arquivo de
20D ORRE equipamento. Erro na configurações
comunicação com o display (itautec.conf). Verificar se
torre. o periférico foi conectado
na porta serial
corretamente.

3.7 - Função MopPosicaoCursor
O que faz:
Esta função faz a leitura de posicionamento do cursor e retorna como parâmetro de saída a linha e
coluna atual do display selecionado.
Protótipo:
 em C:
int WINAPI MopPosicaoCursor (int nTipo, int *lin, int *col);
Entradas:
2 - display CLIENTE
Saídas:
lin:- Linha atual do display selecionado
col:- Coluna atual do display selecionado

0D sucesso.
corretamente.
com sucesso.
com sucesso.

3.8 - Função MopLimpaDisplay
O que faz:
Esta função limpa o conteúdo do display selecionado retorna o cursor para a posição inicial (linha 0
coluna 0).
Protótipo:
 em C:
int WINAPI MopLimpaDisplay (int nTipo);
Entradas:
2 - display CLIENTE
Saídas:
Não existem.

0D sucesso.
corretamente.
na porta serial
corretamente.
com sucesso.
na porta serial
corretamente.

3.9 - Função MopLeDisplay
O que faz:
Esta função retorna como parâmetro de saída o conteúdo do display selecionado devendo especificar a
linha, coluna e tamanho a ser lido.
Protótipo:
 em C:
int WINAPI MopLeDisplay (int nTipo, int lin, int col, unsigned char *str, int nTm);
Entradas:
2 - display CLIENTE
lin:- Linha do display selecionado, que pode variar de acordo com o tamanho do display:
0 a 1 – linhas válidas
0 a 2 – linhas válidas
col:- Coluna do display selecionado, que pode variar de acordo com o tamanho do display:
0 a 16 – colunas válidas
nTm:- Tamanho da string lida.
O tamanho válido tem o limite da coluna do display selecionado.
Saídas:
str:- string lida.

0D sucesso.
corretamente.
com sucesso.
com sucesso.

3.10 - Função MopEscreveCaracter
O que faz:
Esta função escreve um caracter a partir da posição do cursor atual do display selecionado. O parâmetro
“nTam” define a quantidade de vezes que o caracter especificado no parâmetro “c” será repetido.
Protótipo:
 em C:
int WINAPI MopEscreveCaracter (int nTipo, unsigned char c, int nTam);
Entradas:
2 - display CLIENTE
c:- Caracter a ser escrito.
nTam:- Número de repetições do cartacter.
Saídas:
Não existem.

0D sucesso.
corretamente.
na porta serial
corretamente.
com sucesso.
na porta serial
corretamente.

3.11 - Função MopEscreveString
O que faz:
Esta função escreve uma string apartir da posição atual do cursor na área de memória compartilhada do
display selecionado.
Protótipo:
 em C:
int WINAPI MopEscreveString (int nTipo, unsigned char *str, int nTam);
Entradas:
2 - display CLIENTE
str:- String a ser escrita.
nTam:- Tamanho da string.
Saídas:
Não existem.

0D sucesso.
corretamente.
na porta serial
corretamente.
com sucesso.
na porta serial
corretamente.

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

0D sucesso.
com sucesso.

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

0D sucesso.
com sucesso.

3.14 - Função MopModoEntrada
O que faz:
Esta função seleciona o tipo de deslocamento do display.
Protótipo:
 em C:
int WINAPI MopModoEntrada (int nTipo, int nDesloca);
Entradas:
2 - display CLIENTE
nDesloca:- Tipo do deslocamento do display:
0 - Direita para esquerda sem deslocamento do display.
1 - Direita para esquerda com deslocamento do display (só para display OPERADOR).
2 - Esquerda para direita sem deslocamento do display.
3 - Esquerda para direita com deslocamento do display (só para display OPERADOR).
Saídas:
Não existem.

0D sucesso.
corretamente.
na porta serial
corretamente.
com sucesso.
na porta serial
corretamente.

3.15 - Função MopStatusDisplay
O que faz:
Esta função devolve como parâmetro de saída o tipo do deslocamento atual no parâmetro “lpDesloca” e
o parâmetro “lpTipoCursor” define o tipo do cursor, o parâmetro “lpDisplay” não é utilizado para esta
biblioteca, portanto é definido com o valor 0 decimal.
Protótipo:
 em C:
int WINAPI MopStatusDisplay (int nTipo, int *lpDesloca, int *lpDisplay, int *lpTipoCursor);
Entradas:
2 - display CLIENTE
Saídas:
lpDesloca:- Parâmetro que contém o tipo do deslocamento do display:
0 - Direita para esquerda sem deslocamento do display.
1 - Direita para esquerda com deslocamento do display (só para display OPERADOR).
2 - Esquerda para direita sem deslocamento do display.
3 - Esquerda para direita com deslocamento do display (só para display OPERADOR).
lpDisplay:- Este parâmetro de saída não é utilizado por esta biblioteca, portanto está definido como
valor 0 decimal.
lpTipoCursor:- Tipo do cursor
0 - cursor normal
1 - cursor invisível
2 - piscante

0D sucesso.
corretamente.
com sucesso.
com sucesso.

3.16 - Função MopLeTecla
O que faz:
Esta função faz a leitura de teclas do módulo operador retornando como parâmetro de saída o código
scancode e a quantidade de teclas lidas.
Protótipo:
 em C:
int WINAPI MopLeTecla (unsigned char *nScanCode, int *nTam);
Entradas:
Não existem.
Saídas:
nScanCode:- Código scancode da tecla.
nTam:- Quantidade de teclas lidas.

0D sucesso.
com sucesso.

3.17 - Função MopVerifTecla
O que faz:
Esta função verifica se há teclas pressionadas no módulo operador para leitura.
Protótipo:
 em C:
int WINAPI MopVerifTecla (void);
Entradas:
Não existem.
Saídas:
Não existem.

1H TRUE Há teclas a serem lidas. ------ ------
1D
0H FALSE Não existe teclas a serem ------ ------
0D lidas.

3.18 - Função MopLimpaTecla
O que faz:
Esta função limpa todas as teclas disponíveis na fila de teclas do módulo operador.
Protótipo:
 em C:
int WINAPI MopLimpaTecla (void);
Entradas:
Não existem.
Saídas:
Não existem.

0D sucesso.

3.19 - Função MopLeCartao
O que faz:
Esta função faz interface com a leitora de cartão magnético, que faz parte do módulo operador. Ela
retorna como parâmetro de saída o conteúdo e tamanho da trilha do cartão selecionado pela função
“MopSelecionaTrilha”.
Protótipo:
 em C:
int WINAPI MopLeCartao (unsigned char *str, int *nTam);
Entradas:
Não existem.
Saídas:
str:- conteúdo da trilha de cartão lida.
nTam:- tamanho da trilha de cartão lida.

0D sucesso.

com sucesso.

3.20 - Função MopVerifCartao
O que faz:
Esta função verifica se há trilhas de cartão disponíveis a serem lidas.
Protótipo:
 em C:
int WINAPI MopVerifCartao (void);
Entradas:
Não existem.
Saídas:
Não existem.

1H TRUE Existem trilhas a serem ------ ------
1D lidas.
0H FALSE Não existem trilhas a serem ------ ------

0D lidas.

3.21 - Função MopLimpaCartao
O que faz:
Esta função limpa todo o conteúdo armazenado no periférico de cartão magnético, limpando as trilhas
de cartão.
Protótipo:
 em C:
int WINAPI MopLimpaCartao (void);
Entradas:
Não existem.
Saídas:
Não existem.

0H OK Função realizada com ------ ------
0D sucesso.

3.22 - Função MopSelecionaTrilha
O que faz:
Esta função seleciona a trilha que será lida do periférico de cartão magnético.
Protótipo:
 em C:
int WINAPI MopSelecionaTrilha (int nTrilhas);
Entradas:
nTrilhas:- Número correspondente a trilha a ser utilizada.
1 decimal - seleciona trilha 1
11 decimal - seleciona trilhas 1 e 2
110 decimal - seleciona trilhas 2 e 3
Saídas:
Não existem.

0H OK Trilha selecionada com ------ ------
0D sucesso.
corretamente.
com sucesso.

3.23 - Função MopLeCaneta
O que faz:
Esta função retorna como parâmetro de saída um buffer retornado pelo periférico de caneta, que é
acoplado ao módulo operador opcionalmente.
Protótipo:
 em C:
int WINAPI MopLeCaneta (unsigned char *str, int *nTam);
Entradas:
Não existem.
Saídas:
str:- string lida.
nTam:- tamanho da string lida.

0D sucesso.
com sucesso.

3.24 - Função MopVerifCaneta
O que faz:
Esta função verifica se há buffer do periférico caneta a serem lidas.
Protótipo:
 em C:
int WINAPI MopVerifCaneta (void);
Entradas:
Não existem.
Saídas:
Não existem.

1H TRUE Existe buffer a ser lido. ------ ------
1D
0H FALSE Não existe buffer a ser lido. ------ ------

0D

3.25 - Função MopLimpaCaneta
O que faz:
Esta função limpa todos os buffers de caneta disponíveis.
Protótipo:
 em C:
int WINAPI MopLimpaCaneta (void);
Entradas:
Não existem.
Saídas:
Não existem.

0D sucesso.

3.26 - Função MopSelecionaCodigo
O que faz:
Esta função seleciona o tipo de código de barras que será lido pelo dispositivo caneta.
OBS: O uso dela só será válido para o dispositivo Modulo Operador e MiniPos, caso contrário será
ignorada e retornará sucesso.
Protótipo:
 em C:
int WINAPI MopSelecionaCodigo (int nTipo);
Entradas:
nTipo:- Tipo do código de barras:
1 - EAN-13
2 - EAN-8
4 - Code39
8 - Interleaved 2 de 5
Saídas:
Não existem.

0D sucesso.
com sucesso.

3.27 - Função MopAbreGaveta
O que faz:
Esta função faz a abertura do gaveteiro que está conectado na placa PDV periféricos.
Protótipo:
 em C:
int WINAPI MopAbreGaveta (void);
Entradas:
Não existem.
Saídas:
Não existem.

0D sucesso.
com sucesso.
40H ERRO_GAVETA Erro de comunicação com o ------ Verificar se o gaveteiro
64D gaveteiro. está corretamente
conectado na placa PDV
Periféricos.

3.28 - Função MopStatusGaveta
O que faz:
Esta função retorna como parâmetro de saída o status da gaveta conectada à placa PDV Periféricos.
Protótipo:
 em C:
int WINAPI MopStatusGaveta (int *nStatus);
Entradas:
Não existem.
Saídas:
nStatus:- Devolve o status da gaveta:
0 – Gaveta fechada
1 – Gaveta aberta para interface Linux
128 – Gaveta aberta para interface Windows

0D sucesso.
com sucesso.
40H ERRO_GAVETA Erro de comunicação com o ------ Verificar se o gaveteiro
64D gaveteiro. está corretamente
conectado na placa PDV
Periféricos.

3.29 - Função MopLeds
O que faz:
Esta função altera o estado do led do módulo operador selecionado no parâmetro nLeds, e indica a o
estado no parâmetro acao.
OBS: Esta função é suportada somente para o periférico Modulo Operador e MiniPos, caso contrário
será ignorada e retornará sucesso.
Protótipo:
 em C:
int WINAPI 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.

0D sucesso.
com sucesso.

3.30 - Função MopAcendeLeds
O que faz:
Esta função acende o led indicado.
Protótipo:
 em C:
int WINAPI MopAcendeLeds (int nLeds);
Entradas:
1 - Led 1
2 - Led 2
4 - Led 3
Saídas:
Não existem.

0D sucesso.
com sucesso.

3.31 - Função MopPiscaLeds
O que faz:
Esta função muda o estado do led indicado para piscante.
Protótipo:
 em C:
int WINAPI MopPiscaLeds (int nLeds);
Entradas:
1 - Led 1
2 - Led 2
4 - Led 3
Saídas:
Não existem.

0D sucesso.
com sucesso.

3.32 - Função MopApagaLeds
O que faz:
Esta função muda o estado do led indicado para apagado.
Protótipo:
 em C:
int WINAPI MopApagaLeds (int nLeds);
Entradas:
1 - Led 1
2 - Led 2
4 - Led 3
Saídas:
Não existem.

0D sucesso.
com sucesso.

3.33 - Função MopStatusLeds
O que faz:
Esta função retorna como parâmetro de saída o status do led indicado.
Protótipo:
 em C:
int WINAPI MopStatusLeds (int nLeds, int *Status);
Entradas:
1 - Led 1
2 - Led 2
4 - Led 3
Saídas:
nStatus:- Número inteiro retornado que devolve o status do Led selecionado.
bits 1,0 = status do Led 1

0D sucesso.
com sucesso.

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

0D sucesso.
com sucesso.

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

0D sucesso.
com sucesso.
HISTÓRICO DE REVISÕES
Revisão Data Responsável Histórico

01 03/09/2010 Emerson Martinez Peppinelli Elaboração Inicial
Inclusão da WINAPI no protótipo das
02 02/02/2011 Emerson Martinez Peppinelli
funções.

Man Mopapi 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 Mopapi LNX

Enviado por

Direitos autorais:

Formatos disponíveis

MANUAL DA INTERFACE LINUX

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

3 Device Driver Operador e biblioteca MopApi

1.2 - Sistema operacional

 - DOS - versão: 6.22

1.3 - Descrição e Utilização das Interfaces

1.3.1 - Descrição da interface

Com a função “MopOpen” em processo, todas as outras funções serão disponibilizadas.

4 Device Driver Operador e biblioteca MopApi

5 Device Driver Operador e biblioteca MopApi

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

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

onde: x e y representam a versao da biblioteca.

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

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

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

onde: x e y representam a versao da biblioteca.

6 Device Driver Operador e biblioteca MopApi

É possivel configurar 3 dispositivos para esta biblioteca. Verificar o arquivo de configurações

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

Para a configuração do dispositivo Display Torre Itautec:

Para a configuração do dispositivo MiniPOS:

Para a configuração do dispositivo Display Torre Gertec:

7 Device Driver Operador e biblioteca MopApi

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

1) Extrair os arquivos em qualquer diretório.

3) Configurar o arquivo itautec.conf de acordo com o item 1.5.1 deste manual.

4) Agora podemos executar o programa de testes

[root@localhost /home/teste_mop]# ./tstMopApi

8 Device Driver Operador e biblioteca MopApi

3.1 - Função MopOpen

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

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

9 Device Driver Operador e biblioteca MopApi

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

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

10 Device Driver Operador e biblioteca MopApi

confTorre:- configuração do Display Torre.

11 Device Driver Operador e biblioteca MopApi

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

12 Device Driver Operador e biblioteca MopApi

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

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

13 Device Driver Operador e biblioteca MopApi

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

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

14 Device Driver Operador e biblioteca MopApi

lin:- Linha do display selecionado.

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 e biblioteca MopApi

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

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

16 Device Driver Operador e biblioteca MopApi

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

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

17 Device Driver Operador e biblioteca MopApi

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

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

18 Device Driver Operador e biblioteca MopApi

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

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

19 Device Driver Operador e biblioteca MopApi