MEGENCOM

Manual de Interface de Software MEGENCOM
IMPRESSORA
INTERFACE MEGENCOM PARA SISTEMA OPERACIONAL
WINDOWS
1a. Edição
 2017 Diebold Nixdorf.
Código Atual do Manual:
Revisão Técnica: Ricardo Quedas de Assis
Revisão Gráfica: Departamento de Hardware
Liberado p/: Eng. Produto
Editado p/: Documentação de Hardware
Este documento é de propriedade da DIEBOLD NIXDORF Tem caráter

técnico/informativo. Todos os direitos são reservados. Não pode, no todo ou em parte ser
copiado, fotocopiado, reproduzido, traduzido ou reduzido a qualquer meio eletrônico ou
forma legível por máquina, sem a autorização escrita da DIEBOLD NIXDORF. Esta se
reserva, por outro lado, o direito de alterar seu conteúdo e forma, sem qualquer aviso
prévio.
Manaus, 19 de setembro de 2016.
Impresso no Brasil
REPRODUÇÃO PROIBIDA
Sumário i
SUMÁRIO
1. - INTRODUÇÃO ....................................................................................................................................1-1
2. - DESCRIÇÃO DAS FUNÇÕES ...........................................................................................................2-1

2.1 - FUNÇÃO MEGENCOM32_ABRIRDISPOSITIVO ....................................................................................2-1
2.2 - FUNÇÃO MEGENCOM32_FECHARDISPOSITIVO .................................................................................2-4
2.3 - FUNÇÃO MEGENCOM32_CONFIGURARTIMEOUTSRXTX ..................................................................2-6
2.4 - FUNÇÃO MEGENCOM32_ESCREVERNODISPOSITIVO .........................................................................2-8
2.5 - FUNÇÃO MEGENCOM32_LERODISPOSITIVO....................................................................................2-10
2.6 - FUNÇÃO MEGENCOM32_PREPARAIMPRESSAO ................................................................................2-12
2.7 - FUNÇÃO MEGENCOM32_AGUARDAIMPRESSAO ..............................................................................2-14
2.8 - FUNÇÃO MEGENCOM32_AGUARDAIMPRESSAOSTR ........................................................................2-16
2.9 - FUNÇÃO MEGENCOM32_STATUSDODISPOSITIVO ...........................................................................2-18
2.10 - FUNÇÃO MEGENCOM32_ATIVARLOG ..........................................................................................2-21
2.11 - FUNÇÃO MEGENCOM32_DESATIVARLOG ....................................................................................2-23
3. - REQUISITOS PARA USO DA API ...................................................................................................3-1
3.1 - ARQUIVOS PARA USO EM AMBIENTE 32BITS ..........................................................................................3-1
3.2 - ARQUIVOS PARA USO EM AMBIENTE 64BITS ..........................................................................................3-1
3.3 - DRIVER PARA COMUNICAÇÃO USB .......................................................................................................3-1
3.4 - CONFIGURAÇÃO DA API MEGENCOM (VIA USB) ..............................................................................3-1
3.5 - O PRODUTO FOI CRIADO EM: ..................................................................................................................3-1
3.6 - INTERFACES DE HARDWARE QUE DEVEM ESTAR HABILITADAS: .............................................................3-2
3.7 - SISTEMAS OPERACIONAIS ......................................................................................................................3-2
4. - PROCEDIMENTO DE INSTALAÇÃO ............................................................................................4-1
5. - DIAGRAMA DE COMPONENTES ..................................................................................................5-1
6. - CÓDIGOS DE RETORNO .................................................................................................................6-1
Interface MEGENCOM para Impressora Diebold Nixdorf

Sumário ii
HISTÓRICO DO MANUAL
Versão Data Comentários

0 02/03/2017 Versão Preliminar.

Introdução 1-1
1. - INTRODUÇÃO
Este documento contém uma descrição detalhada sobre a biblioteca de carga dinâmica MEGENCOM. Esta
biblioteca está implementada na forma de um arquivo .DLL, ela permite que aplicativos utilizem os recursos
disponíveis nas impressoras Diebold Nixdorf sem necessidade de codificação de baixo nível.
A biblioteca foi desenvolvida em linguagem de programação “C” e está disponível nas versões 32 e 64 bits
para sistema operacional Windows (MEGENCOM32.DLL e MEGENCOM64.DLL).

Descrição das Funções 2-1
2. - DESCRIÇÃO DAS FUNÇÕES
2.1 - Função MEGENCOM32_AbrirDispositivo
O que faz:
A função MEGENCOM32_AbrirDispositivo é responsável por abrir e configurar a porta de comunicação.
Ela deve ser a primeira função a ser chamada pela aplicação.
Protótipo:
=> em ”C”:
int MEGENCOM32_AbrirDispositivo( char *Porta, DWORD Velocidade, char Paridade,
int NumBits, int NumStopbits ,int ControleDeFluxo );
=> em Visual Basic:
Declare Function MEGENCOM32_AbrirDispositivo Lib "MEGENCOM32.dll" (ByVal Porta
As String, ByVal Velocidade As Long, ByVal Paridade As Byte, ByVal NumBits As Long,
ByVal NumStopbits As Long, ByVal CtrlFluxo As Long) As Long
> em Delphi:
function MEGENCOM32_AbrirDispositivo( Porta: PChar; Velocidade: LongInt; Paridade:
Byte; NumBits, NumStopBits, ControleDeFluxo : LongInt): longInt; StdCall; External
'MEGENCOM32.DLL';
Entradas:
Porta: Nome da Porta de Comunicação.
Opções:
 Serial: “COM1” a “COM99”;
 Paralela: “LPT1”, “LPT2”;
 USB: utilizar sempre o valor “USB000”.
Velocidade: Velocidade (BaudRate) da comunicação serial(*).
Opções:
 110, 600, 1200, 2400, 4800, 9600, 14400, 19200, 38400, 56000, 57600, 115200,
128000, 256000, 230400, 460800 (bps).
Paridade: Paridade da comunicação serial (*).
Opções:
 P – Paridade par
 I – Paridade ímpar
 S – Sem paridade.
NumBits: Número de bits da comunicação serial (*).
Opções:
 7 – Sete Bits
 8 – Oito Bits

2-2 Descrição das Funções
NumStopBits: Número de Stop bits da comunicação serial (*).

Opções:
 1 – Um Bits
 2 – Dois Bits
Controle de Fluxo: Controle de Fluxo da comunicação serial (*).

Opções:
 0 – Nenhum
 1 – CTS/RTS (Hardware)
 2 – XOn/XOff (Software)
(*) Para interfaces Paralela e USB deve-se usar o valor 0 (zero) para esses parâmetros.
Saídas:
Código de Retorno da função: Veja item 6, Códigos de Retorno.
Comentários:
Esta função inicializa os recursos necessários para funcionamento da biblioteca e estabelece uma conexão
com a Impressora. É obrigatório o uso desta função antes das demais funções disponíveis na biblioteca. Caso a
função MEGENCOM32_AbrirDispositivo não retorne sucesso, fica impedido o uso das demais funções desta
biblioteca.
Exemplo de chamada em C:
int Connect()
{
int iRet;
iRet = MEGENCOM32_AbrirDispositivo( “COM1”, 9600, ‘S’, 8, 1 ,1 );
if( iRet != MECAFCOD_RET_SUCESSO )
{
// Tratamento em caso de Erro
return( iRet );
}
// Tratamento em caso de Sucesso
return( iRet );
}
Exemplo de chamada em Visual Basic:

Function Teste()
Dim iRet as Integer
iRet = MEGENCOM32_AbrirDispositivo( “LPT1” ,0 ,0 ,0 ,0 ,0 )
If iRet <> MECAFCOD_RET_SUCESSO Then
‘ Tratamento em caso de Erro
Exit Function
End If
‘ Tratamento em caso de Sucesso
Exit Funtion

Exemplo de chamada em Delphi:

Function AbrirPorta(): Boolean;
var
iRet: Integer;
begin
Result := false;
iRet := MEGENCOM32_AbrirDispositivo( “USB000” ,0 ,0 ,0 ,0 ,0 );
if iRet <> MECAFCOD_RET_SUCESSO then
begin
exit;
end;
Result := true;
End;

2.2 - Função MEGENCOM32_FecharDispositivo
O que faz:
Esta função fecha a porta de comunicação e libera os recursos utilizados pela API.
Protótipo:
=> em C:
int MEGENCOM32_FecharDispositivo( char *Porta );
=> em Visual Basic:
Declare Function MEGENCOM32_FecharDispositivo Lib "MEGENCOM32.dll" (ByVal
Porta As String) As Long
> em Delphi:
function MEGENCOM32_FecharDispositivo( Porta: PChar): Integer; StdCall; External
'MEGENCOM32.DLL';
Entradas:
Opções:
- Veja Porta da função MEGENCOM32_AbrirDispositivo()
Saídas:
Comentários:
Esta função libera todos os recursos em uso pela API. Ela deve ser chamada quando não houver mais
necessidade de uso desta biblioteca.
int iRet;
iRet = MEGENCOM32_FecharDispositivo( “COM1” );
{
return( iRet );
}
return( iRet );

Dim iRet as Integer
iRet = MEGENCOM32_FecharDispositivo( “LPT1” )
Exit Function
End If
Exit Funtion

Function FecharPorta(): Boolean;
var
iRet: Integer;
begin
Result := false;
iRet := MEGENCOM32_FecharDispositivo( “USB000” ,0 ,0 ,0 ,0 ,0 );
if iRet <> MECAFCOD_RET_SUCESSO then
begin
exit;
end;
Result := true;
end;

2.3 - Função MEGENCOM32_ConfigurarTimeoutsRXTX
O que faz:
Esta função permite configurar o tempo (em milisegundos) de intervalo máximo entre bytes nas operações
de escrita e leitura..
Protótipo:
=> em C:
int MEGENCOM32_ConfigurarTimeoutsRXTX( char *Porta, DWORD TimeOutRX,
DWORD TimeOutTX );
=> em Visual Basic:
Declare Function MEGENCOM32_ConfigurarTimeoutsRXTX Lib "MEGENCOM32.dll"
(ByVal Porta As String, ByVal TimeOutRX As Long, ByVal TimeOutTX As Long) As Long
> em Delphi:
function MEGENCOM32_ConfigurarTimeoutsRXTX( Porta: PChar; TimeOutRX,
iTimeOutTX: LongInt): Integer; StdCall; External 'MEGENCOM32.DLL';
Entradas:
Opções:
TimeOutRX: Tempo entre bytes para operação de leitura (em milisegundos).

TimeOutTX: Tempo entre bytes para operação de escrita (em milisegundos).
Saídas:
int iRet;
iRet = MEGENCOM32_ConfigurarTimeoutsRXTX ( “COM1”, 2000, 5000 );
{
return( iRet );
}
return( iRet );
Function Teste()
Dim iRet as Integer
iRet = MEGENCOM32_ConfigurarTimeoutsRXTX( “LPT1”, 2000, 5000 )
Exit Function
End If
End Function

Function Teste(): boolean;

var
iRet: Integer;
begin
Result := True;
iRet:= MEGENCOM32_ConfigurarTimeoutsRXTX(‘USB000’,2000, 5000 );
if (iRet <> MECAFCOD_RET_SUCESSO) Then
Begin
Result := False;
exit;
end;
End;

2.4 - Função MEGENCOM32_EscrevernoDispositivo
O que faz:
A função permite o envio de bytes para a impressora.
Protótipo:
=> em C:
int MEGENCOM32_EscrevernoDispositivo( char *Porta, BYTE *Buffer, DWORD
NumBytes, DWORD *BytesEscritos );
=> em Visual Basic:

Declare Function MEGENCOM32_EscrevernoDispositivo Lib "MEGENCOM32.dll" (ByVal
Porta As String, ByVal Buffer As String, ByVal NumBytes As Long, ByRef BytesEscritos As
Long) As Long
> em Delphi:
Function MEGENCOM32_EscrevernoDispositivo( Porta: PChar; Buffer: PChar; NumBytes:
LongInt; NumBytesEscritos: PLong ): Integer; StdCall; External 'MEGENCOM32.DLL';
Entradas:
Opções:
Buffer: Ponteiro para o Buffer a ser impresso ou enviado ao dispositivo.

NumBytes: Número de bytes a serem impressos ou enviados ao dispositivo.
BytesEscritos: Ponteiro para receber o número de bytes efetivamente enviados ao dispositivo.
OBS: Em caso de erro, somente a interface Paralela irá preencher BytesEscritos.
Saídas:
Comentários:
A MEGENCOM32_EscrevernoDispositivo realiza a impressão de um buffer contendo um texto com ou
sem formatação. O buffer também poderá conter qualquer sequência de ESC disponível na tabela de comandos do
dispositivo DIEBOLD NIXDORF, como por exemplo, comandos para controle de atributos de impressão, Modo
Gráfico, solicitação de status, etc...
int iRet;
DWORD BytesEscritos;
iRet = MEGENCOM32_EscrevernoDispositivo( “COM1”, “Texto a ser impresso.”, 21, &BytesEscritos
);
{

return( iRet );
}
return( iRet );}
}
Function Teste()
Dim iRet as Integer
Dim BytesEscritos As Long
Dim bBuffer As String
Dim cmdAtivaNegrito As String
Dim cmdDesativaNegrito As String
cmdAtivaNegrito = Chr(27) & "E"

cmdDesativaNegrito = Chr(27) & "F"
bBuffer = cmdAtivaNegrito & "Negrito (enfatizado)" & cmdDesativaNegrito & Chr(10)
iRet = MEGENCOM32_EscrevernoDispositivo( “LPT1”, bBuffer, 24, BytesEscritos )
Exit Function
End If
End Function

var
iRet: Integer;
NumBytesEscritos: LongInt;
begin
Result := True;
iRet:= MEGENCOM32_EscrevernoDispositivo(‘USB000’, ‘Texto a ser impresso.’,

21,@NumBytesEscritos);
Begin
Result := False;
Exit;
End;
End;

2.5 - Função MEGENCOM32_LeroDispositivo
O que faz:
Lê dados da Impressora. Poderá ser lido um único byte ou uma sequência de bytes
Protótipo:
=> em C:
int MEGENCOM32_LeroDispositivo( char *Porta, BYTE *Buffer, DWORD NumBytes,
DWORD *BytesLidos )
=> em Visual Basic:
Declare Function MEGENCOM32_LeroDispositivo Lib "MEGENCOM32.dll" (ByVal Porta
As String, ByVal Buffer As String, ByVal NumBytes As Long, ByRef BytesLidos As Long)
As Long
> em Delphi:
function MEGENCOM32_LeroDispositivo(Porta: PChar; Buffer: PChar; NumBytes: LongInt;
NumBytesLidos: PInteger ): Integer; StdCall; External 'MEGENCOM32.DLL';
Entradas:
Opções:
Buffer: Ponteiro para receber os dados lidos do dispositivo.
NumBytes: Número de bytes (tamanho) disponíveis para o Buffer de leitura.
BytesLidos: Ponteiro para receber o número de bytes efetivamente lidos do dispositivo.
.
Saídas:
Comentários:
Esta função permite leitura de informações retornadas pelo dispositivo, pode-se por exemplo ler
informações de resposta de solicitação de Status.
int iRet;
char bBuffer[5];
DWORD BytesLidos;
iRet = MEGENCOM32_LeroDispositivo( “COM1”, &bBuffer[0], 5, &BytesLidos);
{
return( iRet );
}

return( iRet );
Private Function Teste()

Dim iRet as Integer
Dim BytesLidos As Long
Dim bBuffer As String
iRet = MEGENCOM32_LeroDispositivo ( “LPT1”, bBuffer, 1, BytesLidos )
Exit Function
End If
End Function

var
iRet: Integer;
NumBytesLidos: LongInt;
bBuffer: array [0..1] of Char;
begin
Result := True;
iRet:= MEGENCOM32_LeroDispositivo (‘USB000’, bBuffer, 1, @NumBytesLidos );
Begin
Result := False;
exit;
end;
End;

2.6 - Função MEGENCOM32_PreparaImpressao
O que faz:
Esta função prepara controles internos da API para uma nova impressão.
Protótipo:
=> em C:
int MEGENCOM32_PreparaImpressao( char *Porta );
=> em Visual Basic:
Declare Function MEGENCOM32_PreparaImpressao Lib "MEGENCOM32.dll" (ByVal Porta
As String) As Long
> em Delphi:
function MEGENCOM32_PreparaImpressao( Porta: PChar): Integer; StdCall; External
'MEGENCOM32.DLL';
Entradas:
Opções:
Saídas:
Comentários:
Esta função é de uso opcional, ela prepara a API para funcionamento com mecanismo espera pela
finalização de impressões. Quando utilizada esta função, deve-se adotar a seguinte sequência de chamadas.
1º - MEGENCOM32_PreparaImpressao()
2º - MEGENCOM32_EscrevernoDispositivo()
3º - MEGENCOM32_AguardaImpressao()
Ou
3º - MEGENCOM32_AguardaImpressaoStr()
int iRet;
iRet = MEGENCOM32_PreparaImpressao ( “COM1” );
{
return( iRet );
}
return( iRet );

Function Teste()
Dim iRet as Integer
iRet = MEGENCOM32_PreparaImpressao ( “LPT1” )
Exit Function
End If
End Function
Function Prepara_Impressao (): boolean;

var
iRet: Integer;
begin
Result := True;
iRet:= MEGENCOM32_PreparaImpressao (‘USB000’);
Begin
Result := False;
exit;
end;
End;

2.7 - Função MEGENCOM32_AguardaImpressao
O que faz:
A função MEGENCOM32_AguardaImpressao pode ser usada para aguardar e confirmar se uma
impressão foi realizada com sucesso.
Protótipo:
=> em C:
int MEGENCOM32_AguardaImpressao( char *Porta , DWORD Timeout);
=> em Visual Basic:
Declare Function MEGENCOM32_AguardaImpressao Lib "MEGENCOM32.dll" (ByVal
Porta As String, ByVal Timeout As Long) As Long
> em Delphi:
function MEGENCOM32_AguardaImpressao(Porta: PChar; Timeout: LongInt): Integer;
StdCall; External 'MEGENCOM32.DLL';
Entradas:
Opções:
Timeout: Tempo de espera em milisegundos. Deve ser calculado em função do número de bytes enviados
através da função MEGENCOM32_EscrevernoDispositivo().
Saídas:
Comentários:
Esta função é de uso opcional, ela aguarda pela finalização de impressões. Quando utilizada esta função, deve-se
adotar a seguinte sequência de chamadas.
3º - MEGENCOM32_AguardaImpressao()
int iRet;
iRet = MEGENCOM32_AguardaImpressao ( “COM1”, 4000 );
{
return( iRet );
}
return( iRet );

Function Teste()
Dim iRet as Integer
iRet = MEGENCOM32_AguardaImpressao ( “LPT1”, 4000 )
Exit Function
End If
End Function
Function Aguarda_Impressao (): boolean;

var
iRet: Integer;
begin
Result := True;
iRet:= MEGENCOM32_AguardaImpressao (‘USB000’, 4000);
Begin
Result := False;
Exit;
End;
End;

2.8 - Função MEGENCOM32_AguardaImpressaoStr
O que faz:
Esta função tem o mesmo comportamento da MEGENCOM32_AguardaImpressao(). A única diferença
que existe entre as duas funções é no tipo do parâmetro Timeout..
Protótipo:
=> em C:
int MEGENCOM32_AguardaImpressaoStr( char *Porta ,char *Timeout);
=> em Visual Basic:
Declare Function MEGENCOM32_ AguardaImpressaoStr Lib "MEGENCOM32.dll" (ByVal
Porta As String, ByVal Timeout As String) As Long
> em Delphi:
function MEGENCOM32_ AguardaImpressaoStr(Porta: PChar; Timeout: PChar): Integer;
Entradas:
Opções:
Timeout: Tempo de espera em milisegundos. Deve ser calculado em função do número de bytes enviados
através da função MEGENCOM32_EscrevernoDispositivo().
Saídas:
Comentários:
Esta função é de uso opcional, ela aguarda pela finalização de impressões. Quando utilizada esta função, deve-se
adotar a seguinte sequência de chamadas.
3º - MEGENCOM32_AguardaImpressaoStr()
int iRet;
iRet = MEGENCOM32_AguardaImpressaoStr( “COM1”, “4000” );
{
return( iRet );
}
return( iRet );

Function Teste()
Dim iRet as Integer
iRet = MEGENCOM32_AguardaImpressaoStr( ‘LPT1’, ‘4000’ )
Exit Function
End If
End Function
Function Aguarda_Impressao (): boolean;

var
iRet: Integer;
begin
Result := True;
iRet:= MEGENCOM32_AguardaImpressaoStr(‘USB000’, ‘4000’);
Begin
Result := False;
Exit;
End;
End;

2.9 - Função MEGENCOM32_StatusDoDispositivo
O que faz:
Esta função permite verificar o estado do dispositivo.
Protótipo:
=> em C:
int MEGENCOM32_StatusDoDispositivo( char *Porta, BYTE *Status);
=> em Visual Basic:
Declare Function MEGENCOM32_StatusDoDispositivo Lib "MEGENCOM32.dll" (ByVal
Porta As String, ByRef Status As Byte) As Long
> em Delphi:
function MEGENCOM32_StatusDoDispositivo( Porta: PChar; Status : PChar): Integer;
Entradas:
Opções:
Saídas:
Status: Ponteiro para o buffer que receberá o valor do estado. Esse byte deverá ser validado somente se o
retorno dessa função for MECAFCOD_RET_SUCESSO:
Interface Serial:
• Bit 7: Em 1 indica que a impressora está Busy
• Bit 6: Reservado
• Bit 4: Em 1 indica que a impressora está Off Line
Interface Paralela:
• Bit 7: Em 1 indica que a impressora está Busy
• Bit 5: Em 1 indica que a impressora está Sem Papel
• Bit 4: Em 1 indica que a impressora está On Line
• Bit 3: Em 1 indica que a impressora está Sem Erro
Interface USB:

• Esta função não está implementada para Interface USB, portanto o retorno será sempre
MECAFCOD_RET_CMDNOTFOUND
• Não validar o retorno do parâmetro Status
Comentários:
Além desta função, existem outras maneiras de se obter o estado do dispositivo DIEBOLD NIXDORF,
por exemplo, através dos status imediato, bufferizado, cíclico e único em caso de erro. Para saber mais detalhes,
consulte o manual do firmware e os programas exemplos.
#define BIT0 0x01
#define BIT1 0x02
#define BIT2 0x04
#define BIT3 0x08
#define BIT4 0x10
#define BIT5 0x20
#define BIT6 0x40
#define BIT7 0x80
int iRet;
BYTE bStatus;
iRet = MEGENCOM32_StatusDoDispositivo ( “COM1”, &bStatus)
if( iRet == MECAFCOD_RET_SUCESSO )
{
if((bStatus & BIT7)!=0)
// Impressora Busy
else
// Impressora Not Busy
if((bStatus & BIT4) ==0)

// Impressora On Line
else
// Impressora Off Line
}
return( iRet )


Const BIT0 = 1 ' Mascara p/ Verificar Bit 0
Function Teste()
Dim iRet As Integer
Dim bStatus As Byte
iRet = MEGENCOM32_StatusDoDispositivo(PortaComunicacao, bStatus)
If iRet = 0 Then
If (bStatus And BIT3) = 0 Then
' Impressora com Erro
Else
' Impressora Sem Erro
End If

' Impressora Off Line
Else
' Impressora On Line
End If

' Impressora Com Papel
Else
' Impressora Sem Papel
End If

' Impressora Not Busy
Else
' Impressora Busy
End If
End If
End Function

var
iRet: Integer;
bStatus: Integer;
begin
Result := True;
iRet:= StatusDoDispositivo ( “USB000”, @bStatus)
Begin
Result := False;
exit;
end;
// Lembre-se que por enquanto esta função não está implementada na
// interface USB
End;

2.10 - Função MEGENCOM32_AtivarLOG
O que faz:
Esta função permite ativar a gravação de Log.
Protótipo:
=> em C:
int MEGENCOM32_AtivarLOG( int Camada ,int Nivel );
=> em Visual Basic:
Declare Function MEGENCOM32_AtivarLOG Lib "MEGENCOM32.dll" (ByVal Camada As
Integer, ByVal Nivel As Integer) As Long
> em Delphi:
function MEGENCOM32_AtivarLOG( Camada, Nivel: Integer ): Integer; StdCall; External
'MEGENCOM32.DLL';
Entradas:
Camada: Camada de log que deve ser ativada, opções:
0: Camada Genérica
1: Camada Serial
2: Camada Paralela
3: Todas as camadas
4: Camada USB
Nivel: Nivel de log que deve ser utilizado, opções:

1: Nível Básico
2: Nível Médio
3: Nível Avançado.
Saídas:
Código de Retorno da função: indica o resultado da operação e pode assumir um dos seguintes valores:
Comentários:
Esta função utiliza-se da infraestrutura Diebold Nixdorf para geração de arquivos de log, conforme a sessão.
“Requisitos para Implantação em Campo”.
int iRet;
iRet = MEGENCOM32_AtivarLOG ( 3, 2 );
{
return( iRet );
}
return( iRet );

Function Teste()
Dim iRet as Integer
iRet = MEGENCOM32_AtivarLOG ( 3, 2 )
Exit Function
End If
End Function
Function Ativar_Log (): boolean;

var
iRet: Integer;
begin
Result := True;
iRet:= MEGENCOM32_AtivarLOG ( 3, 2 );
Begin
Result := False;
Exit;
End;
End;

2.11 - Função MEGENCOM32_DesativarLOG
O que faz:
Esta função permite desativar a gravação de Log.
Protótipo:
=> em C:
int MEGENCOM32_DesativarLOG( int Camada );
=> em Visual Basic:
Declare Function MEGENCOM32_DesativarLOG Lib "MEGENCOM32.dll" (ByVal Camada
As Integer) As Long
> em Delphi:
MEGENCOM32_DesativarLOG( Camada: Integer ): Integer; StdCall; External
'MEGENCOM32.dll';
Entradas:
Camada: Camada de log que deve ser ativada, opções:
0: Camada Genérica
1: Camada Serial
2: Camada Paralela
3: Todas as camadas
4: Camada USB
Saídas:
Comentários:
Esta função desativa a geração de arquivo de log, veja MEGENCOM32_AtivarLOG.
int iRet;
iRet = MEGENCOM32_DesativarLOG ( 3 );
{
return( iRet );
}
return( iRet );
Function Teste()
Dim iRet as Integer
iRet = MEGENCOM32_DesativarLOG ( 3 )
Exit Function
End If
End Function

Function Desativar_Log (): boolean;

var
iRet: Integer;
begin
Result := True;
iRet:= MEGENCOM32_DesativarLOG ( 3 );
Begin
Result := False;
Exit;
End;
End;

3. - REQUISITOS PARA USO DA API
3.1 - Arquivos para uso em ambiente 32bits

Nome
MEGENCOM32.DLL
P32GRLOG.DLL
P32PROLOG.EXE
PROCOMP.INI
3.2 - Arquivos para uso em ambiente 64bits

Nome
MEGENCOM64.DLL
P64GRLOG.DLL
P64PROLOG.EXE
PROCOMP.INI
3.3 - Driver para comunicação USB

Nome
SetupDieboldPrinters.exe
O SetupDieboldPrinters.exe é o programa instalador de drivers de impressoras Diebold Nixdorf, ele é compatível

com sistema operacional Windows 32 e 64 bits. Este driver apenas deve ser instalado quando a comunicação com
a impressora for feita via porta USB do computador.
3.4 - Configuração da API MEGENCOM (via USB)

Para comunicação via USB, a API deve ser configurada via arquivo PROCOMP.INI, indicando o nome da
impressora Diebold Nixdorf que aparece no “Dispositivos e Impressoras” do Windows. Segue abaixo um
exemplo de configuração.
[MEGENCOM]
PRINTERNAME = “Mecaf Perfecta_A”
3.5 - O produto foi criado em:
 - MS C - versão:
 - Visual C++ - versão: 6.0 / 2005
 - Visual Basic - versão:
 - Android Studio - versão: 2.1.3
 - GCC - versão:

3-2 Diagrama de Componentes
 - Outro:
3.6 - Interfaces de hardware que devem estar habilitadas:

 - USB
 - Serial
 - Paralela
 - Outras:
3.7 - Sistemas operacionais

 - DOS - versão:
 - Windows - versão: 7 ou superior

4. - Procedimento de instalação
Segue abaixo um passo que descreve o procedimento de instalação da API MEGENCOM
1. Passo apenas para Comunicação via USB
Caso a comunicação seja via porta USB, deve-se primeiramente conectar a impressora na porta USB do
computador e liga-la. Em seguida executar o programa instalador de drivers de impressoras Diebold
Nixdorf SetupDieboldPrinters.exe e efetuar a instalação do driver.
Depois do processo de instalação de driver, deve-se verificar o no me da impressora no item

“Dispositivos e Impressoras” do Windows, utilizar o mesmo nome para configuração do arquivo
PROCOMP.INI, conforme o exemplo abaixo:
[MEGENCOM]
PRINTERNAME = “Mecaf Perfecta_A”
2. Copiar os arquivos para as pastas destino de acordo com o sistema operacional utilizado, conforme
tabelas abaixo:
Arquivo Windows 32 bits

MEGENCOM32.DLL C:\Windows\System32
P32GRLOG.DLL C:\Windows\System32
P32PROLOG.EXE C:\Windows
PROCOMP.INI C:\Wndows
Sistema operacional Windows 32 bits
Arquivo Windows 64 bits

MEGENCOM64.DLL C:\Windows\System32
P64GRLOG.DLL C:\Windows\System32
P64PROLOG.EXE C:\Windows
PROCOMP.INI C:\Wndows
Sistema operacional Windows 64 bits

5. - Diagrama de Componentes
APLICAÇÃO
MEGENCOM.
Procomp.ini
MEGENCOM32/64.DLL
Log
p32grlog.dll SIM
USB?
Diebold USB Driver

IPC NÃO
p32grlog.exe
Prolog.log
Impressora
Observação: Quando a comunicação com a impressora é feita via portas Serial e Paralela, não é necessário
nenhum driver adicional, a API faz uso dos recursos já existentes no sistema operacional.

6. - Códigos de Retorno
Constante Valor Descrição

MECAFCOD_RET_DLLNOTLOAD -1 DLL não está carregada. A DLL ou função não foi encontrada.
MECAFCOD_RET_SUCESSO 0 Operação realizada com sucesso.
MECAFCOD_RET_FALHA 1 Falha na operação.
MECAFCOD_RET_ARGINVAL 2 Argumentos inválidos.
MECAFCOD_RET_ERRALOCMEM 3 Falha na alocação de memória.
MECAFCOD_RET_ERRLOCKMEM 4 Não conseguiu restringir acesso a uma região de memória.
MECAFCOD_RET_TIMEOUT 5 Timeout durante realização da operação.
MECAFCOD_RET_ERRCOMUNICACAO 6 Erro durante o processo de comunicação
MECAFCOD_RET_CMDEXEC 7 Existe uma função, ou comando, em execução.
MECAFCOD_RET_ARQINIINVAL 8 Arquivo de configuração (.INI) inválido.
MECAFCOD_RET_DISPNOTOPEN 9 Dispositivo não foi aberto.
MECAFCOD_RET_ERROPENSER 10 Erro ao abrir dispositivo serial.
MECAFCOD_RET_ERRCONF 11 String de configuração do dispositivo inválido.
MECAFCOD_RET_PROGSER 12 Erro ao configurar a porta serial.
MECAFCOD_RET_DEFTAMBUF 13 Erro ao definir tamanho dos buffers de recepção e transmissão.
MECAFCOD_RET_PROGTIMEOUTS 14 Erro ao configurar os valores de timeout para operações de
envio e recepção.
MECAFCOD_RET_EVENTREAD 15 Erro na criação do evento de leitura.
MECAFCOD_RET_EVENTWRITE 16 Erro na criação do evento de escrita.
17 a 19 Reservado para uso futuro.
MECAFCOD_RET_ARGPORTA 20 Valor da porta inválido.
MECAFCOD_RET_ARGVELOC 21 Valor da velocidade de transmissão inválido.
MECAFCOD_RET_ARGPARID 22 Valor da paridade inválido.
MECAFCOD_RET_ARGNUMBITS 23 Valor do número de bits inválido.
MECAFCOD_RET_ARGSTOPBITS 24 Valor do número de stop bits inválido.
25 a 79 Reservado para uso futuro.
MECAFCOD_RET_DISPOPEN 80 Dispositivo já está aberto.
MECAFCOD_RET_NUMDISPINVAL 81 Número máximo de dispositivos foi excedido.
MECAFCOD_RET_CMDNOTFOUND 82 Comando inexistente.
MECAFCOD_RET_DRIVERBUSY 83 Existem JOBs pendentes.
MECAFCOD_RET_EOP 84 Ocorreu fim de papel durante a impressão.
MECAFCOD_RET_CABQUENTE 85 Temperatura da cabeça de impressão acima do limite
MECAFCOD_RET_TAMPAABERTA 86 Ocorreu tampa aberta durante a impressão

MEGENCOM

Enviado por

Dados do documento

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

MEGENCOM

Enviado por

Direitos autorais:

Formatos disponíveis

Manual de Interface de Software MEGENCOM

 2017 Diebold Nixdorf.

Código Atual do Manual:

Revisão Técnica: Ricardo Quedas de Assis

Revisão Gráfica: Departamento de Hardware

Liberado p/: Eng. Produto

Editado p/: Documentação de Hardware

Este documento é de propriedade da DIEBOLD NIXDORF Tem caráter

Manaus, 19 de setembro de 2016.

2. - DESCRIÇÃO DAS FUNÇÕES ...........................................................................................................2-1

5. - DIAGRAMA DE COMPONENTES ..................................................................................................5-1

6. - CÓDIGOS DE RETORNO .................................................................................................................6-1

Interface MEGENCOM para Impressora Diebold Nixdorf

Versão Data Comentários

Interface MEGENCOM para Impressora Diebold Nixdorf

Interface MEGENCOM para Impressora Diebold Nixdorf

2. - DESCRIÇÃO DAS FUNÇÕES

2.1 - Função MEGENCOM32_AbrirDispositivo

Interface MEGENCOM para Impressora Diebold Nixdorf

NumStopBits: Número de Stop bits da comunicação serial (*).

Controle de Fluxo: Controle de Fluxo da comunicação serial (*).

Exemplo de chamada em Visual Basic:

Interface MEGENCOM para Impressora Diebold Nixdorf

Exemplo de chamada em Delphi:

Interface MEGENCOM para Impressora Diebold Nixdorf

2.2 - Função MEGENCOM32_FecharDispositivo

Exemplo de chamada em Visual Basic:

Exemplo de chamada em Delphi:

Interface MEGENCOM para Impressora Diebold Nixdorf

Interface MEGENCOM para Impressora Diebold Nixdorf

2.3 - Função MEGENCOM32_ConfigurarTimeoutsRXTX

TimeOutRX: Tempo entre bytes para operação de leitura (em milisegundos).

Exemplo de chamada em Visual Basic:

Interface MEGENCOM para Impressora Diebold Nixdorf

Exemplo de chamada em Delphi:

Function Teste(): boolean;

Interface MEGENCOM para Impressora Diebold Nixdorf

2.4 - Função MEGENCOM32_EscrevernoDispositivo

=> em Visual Basic:

Buffer: Ponteiro para o Buffer a ser impresso ou enviado ao dispositivo.

OBS: Em caso de erro, somente a interface Paralela irá preencher BytesEscritos.

Interface MEGENCOM para Impressora Diebold Nixdorf

Exemplo de chamada em Visual Basic:

cmdAtivaNegrito = Chr(27) & "E"

Exemplo de chamada em Delphi:

Function Teste(): boolean;

iRet:= MEGENCOM32_EscrevernoDispositivo(‘USB000’, ‘Texto a ser impresso.’,

Interface MEGENCOM para Impressora Diebold Nixdorf

2.5 - Função MEGENCOM32_LeroDispositivo

Interface MEGENCOM para Impressora Diebold Nixdorf

Exemplo de chamada em Visual Basic:

Private Function Teste()

Exemplo de chamada em Delphi:

Function Teste(): boolean;

Interface MEGENCOM para Impressora Diebold Nixdorf

2.6 - Função MEGENCOM32_PreparaImpressao

Interface MEGENCOM para Impressora Diebold Nixdorf

Exemplo de chamada em Visual Basic:

Exemplo de chamada em Delphi:

Function Prepara_Impressao (): boolean;

Interface MEGENCOM para Impressora Diebold Nixdorf

2.7 - Função MEGENCOM32_AguardaImpressao

Interface MEGENCOM para Impressora Diebold Nixdorf

Exemplo de chamada em Visual Basic: