Você está na página 1de 9

Tecnologia em pesagem

API
INDICADOR.dll
MANUAL DE SOFTWARE
VERSÃO 1.2
Manual da API Indicador.dll

Sumário
INTRODUÇÃO ................................................................................................... 3
Arquitetura API ................................................................................................... 4
Flags .................................................................................................................. 5
Status_Balanca............................................................................................... 5
Status_Bateria ................................................................................................ 5
Nivel_Bateria .................................................................................................. 5
Status_Protocolo ............................................................................................ 5
IndicacaoPeso ................................................................................................ 5
API Indicador.dll funções .................................................................................... 6
1. openSerial( char*porta , int baudeRate ) :: bool .......................................... 6
2. openTcp( char*host , int porta ) :: bool ........................................................ 6
3. getPeso() :: char* ........................................................................................ 6
4. getTara() :: char* ......................................................................................... 6
5. getPesoBruto() :: char* ............................................................................... 6
6. close() :: bool .............................................................................................. 6
7. getIndicacaoPeso() :: int ............................................................................. 6
8. getStatusProtocolo ()::int ............................................................................ 6
9. isOpen()::bool ............................................................................................. 7
10. getStatusBalanca()::int.............................................................................. 7
11. waiting()::void ............................................................................................ 7
12. zerar()::void ............................................................................................... 7
13. isModoContadoraDePecas()::bool ............................................................ 7
14. tarar()::int .................................................................................................. 8
15. tararManual(uint32_t peso)::int ................................................................. 8
16. getStatusBateriaIndicador()::int ................................................................ 8
17. getNivelBateriaIndicador()::int ................................................................... 8
18. getNivelBateriaTransmissorTx1()::int ........................................................ 9
19. getNivelBateriaTransmissorTx2()::int ........................................................ 9

2
Manual da API Indicador.dll

INTRODUÇÃO
A API (Application Programming Interface ou Interface de Programação para
aplicações) é composta de um único arquivo tipo dll (indicador.dll), o qual pode ser
utilizado por desenvolvedores, para interagir com os terminais/indicadores da Líder
Balanças
Esta documentação oferece detalhes e informações sobre como utilizar as funções
contidas no arquivo da aplicação, com exemplos para as linguagens de programação
C#, Delphi, Java e C++, utilizando a tecnologia de API indicador.dll.

3
Manual da API Indicador.dll

Arquitetura API

getPeso

getPesoBruto
Indicador.dll
getTara

getStatusBalanca
openSerial openTcp
waiting

isOpen
Checa se
conexão via zerar
serial ou
mesmo tcp Conexão foi tarar
foi concluída concluída com Sim
com sucesso sucesso?
retorna
tararManual
“true” ou
“false” isModoContadoraDePecas
getIndicacaoPeso
Não
getStatusBateriaIndicador
getStatusProtocolo

getNivelBateriaIndicador

getNivelBateriaTransmissorTx1

getNivelBateriaTransmissorTx2

Término, aguarda até


a API subir novamente close

4
Manual da API Indicador.dll

Flags

Status_Balanca

1. Null = -1
2. Estavel = 0
3. Instavel = 1
4. Pico = 2
5. Medio = 3
6. Imprimir = 4
7. AGUARDANDO_RADIO_COMUNICAR = 5
8. ERRO_DE_COMUNICAO_COM_RADIO = 6

Status_Bateria

1. OFF = 0X00
2. CARREGANDO = 0X01
3. EM_BATERIA = 0X02
4. CARGA_COMPLETA = 0X03

Nivel_Bateria

1. NIVEL_OFF = 0X00
2. NIVEL_BAIXA = 0X01
3. NIVEL_REGULAR = 0X02
4. NIVEL_BOA = 0X03
5. NIVEL_COMPLETA = 0X04

Status_Protocolo

1. PROTOCOLO_NAO_DETECTADO = -1
2. PROTOCOLO_LIDER_1 = 1
3. PROTOCOLO_LIDER_2 = 2
4. PROTOCOLO_LIDER_3 = 3
5. PROTOCOLO_LIDER_4 = 4

IndicacaoPeso

1. kN = 0X00
2. lb = 0X01
3. kg = 0X02

5
Manual da API Indicador.dll

API Indicador.dll funções


1. openSerial( char*porta , int baudeRate ) :: bool
Abre a porta serial, retorna “true” ou “false”.
Exemplo C/C++:
bool status = openSerial(“COM1”,9600);

2. openTcp( char*host , int porta ) :: bool


Abre a comunicação rede Tcp, retorna “true” ou “false”.
Exemplo C/C++:
bool status = openTcp(“192.168.0.201”,3500);

3. getPeso() :: char*
Obtém o peso em tempo real.
Exemplo C/C++:
char * peso = getPeso();

4. getTara() :: char*
Obtém a tara do indicador.
Exemplo C/C++:
char * tara = getTara();

5. getPesoBruto() :: char*
Obtém o peso bruto em tempo real.
Exemplo C/C++:
char * pesoBruto = getPesoBruto();

6. close() :: bool
Fecha a comunicação da porta serial ou do Tcp, retorna “true” ou “false”.
Exemplo C/C++:
bool isClose = close();

7. getIndicacaoPeso() :: int
Obtém o flag IndicacaoPeso no qual o indicador esteja operando kg, lb, kN
Exemplo C/C++:
int unidadePeso = getIndicacaoPeso();

8. getStatusProtocolo ()::int
Obtém o flag Status_Protocolo no qual o indicador está sendo operado.
Exemplo C/C++:

6
Manual da API Indicador.dll

int protocolo = getStatusProtocolo();

9. isOpen()::bool
Verifica se a porta serial ou se a comunição Tcp estão abertas.
Exemplo C/C++:
If(isOpen()) { }
Ou
while(isOpen()){ }

10. getStatusBalanca()::int
Obtém o tipo de status da pesagem.
Exemplo C/C++:
int status = getStatus();

11. waiting()::void
Espera o buffer do indicador virtual até estar pronto para leitura de forma
sincronizada.
Obs. Está função só pode ser utilizada dentro de um loop.
Exemplo C/C++:

While(isOpen())
{
//algum código aqui.
std::cout << “Peso: ” << getPeso()

waiting(); // chamando waiting para esperar a comunicação de dados ser sincronizada.

12. zerar()::void
Executa a função de zerar o indicador.
Obs. Está função só funciona a partir da versão A8 do indicador.

13. isModoContadoraDePecas()::bool
Verifica se o indicador está com a contadora de peças ativada.
Exemplo C/C++:
bool status = isModoContadoraDePecas();

if(status)
char* pecas = getPeso()

else
char* peso = getPeso()

7
Manual da API Indicador.dll

14. tarar()::int
Executa a função tara do indicador.
Obs. Esta função somente estará disponível a partir da versão A8 do indicador.

flag 0 = (TARA SEMI AUTOMATICA OK)


1 = (LIMPESA MANUAL DE TARA)
2 = (SE TARA SUCESSIVA OK)
3 = (LIMPA VALOR DA TARA Tara = 0)
4 = (TARA MANUAL ON)
-1 = (ERRO TARA ENVIADA OU PESO SOBRE A CELULA > CAPACIDADE)
-2 = (ERRO TEM TARA ATIVA)
-3 = (ERRO TARA AUTOMATICA ESTA ON)
-4 = (ERRO PESO > 0 NÃO PODE TARAR)
-5 = (MODO VALOR DE PICO NÃO TEM TARA)
-6 = (PESO == O ENVIAR TARA COM VALOR NÃO ENVIAR SOLICITAÇÃO DE
TARA!!!)
-7 = (TARA SUCESSIVA ON, ENVIAR SOLICITAÇÃO DE TARA COMO PESO
SOBRE CELULA)
-8 = (INDICADOR NÃO ESTÁ RESPONDENDO)

15. tararManual(uint32_t peso)::int


Executa a função tara do indicador se o valor do peso for igual a zero.
Exemplo C/C++: tararManual(1000)
Obs. Esta função somente estará disponível a partir da versão A8 do indicador.

flag 4 = (TARA MANUAL ON)


-1 = (ERRO TARA ENVIADA OU PESO SOBRE A CELULA > CAPACIDADE)
-2 = (ERRO TEM TARA ATIVA)
-3 = (ERRO TARA AUTOMATICA ESTA ON)
-4 = (ERRO PESO > 0 NÃO PODE TARAR)
-5 = (MODO VALOR DE PICO NÃO TEM TARA)
-6 = (PESO == O ENVIAR TARA COM VALOR NÃO ENVIAR SOLICITAÇÃO DE
TARA!!!)
-7 = (TARA SUCESSIVA ON, ENVIAR SOLICITAÇÃO DE TARA COMO PESO
SOBRE CELULA)
-8 = (INDICADOR NÃO ESTÁ RESPONDENDO)

16. getStatusBateriaIndicador()::int
Obtém a flag Status_Bateria do indicador.
Exemplo C/C++:
int statusBateria = getStatusBateriaIndicador();

17. getNivelBateriaIndicador()::int
Obtém a flag Nivel_Bateria do indicador.
Exemplo C/C++:
int nivelBatInd = getNivelBateriaIndicador();

8
Manual da API Indicador.dll

18. getNivelBateriaTransmissorTx1()::int
Obtém a flag Nivel_Bateria do transmissor tx1.
Exemplo C/C++:
int nivelBatTx1 = getNivelBateriaTransmissorTx1();

19. getNivelBateriaTransmissorTx2()::int
Obtém a flag Nivel_Bateria do transmissor tx2.
Exemplo C/C++:
int nivelBatTx2 = getNivelBateriaTransmissorTx2();

Você também pode gostar