SIMULADOR DE BOMBAS IDCODE

Transcrição

1 CESNA TECHNOLOGY SIMULADOR DE BOMBAS IDCODE Manual do Simulador de Bombas IDcode Versão do Manual Rua Irati, Santa Quitéria Curitiba/PR - CEP: TELEFONE/FAX: (41) (41)

2 ATENÇÃO... A empresa também dispõe de um conjunto de exemplos para integração direta com a DLL de manipulação do concentrador CESNA, para as seguintes linguagens de programação: Visual Basic; Delphi; C++. A CESNA TECHNOLOGY fornece este material no intuito de auxiliar aos desenvolvedores de sistemas de integração com o concentrador CESNA. Mudanças poderão ser efetuadas para o aprimoramento deste manual, a fim de se conseguir uma melhor explanação dos conteúdos e funcionalidades aqui apresentados, bem como alguma correção ortográfica ou algo do gênero. Quaisquer mudanças que sejam executadas neste material estarão sendo disponibilizadas no site na seção de downloads onde também estará a disposição dos integradores, o SIMULADOR DE BOMBAS IDCODE. Sempre que for desenvolver junto a este utilitário, procure a ultima versão deste documento no endereço acima citado. Estamos abertos a sugestões no intuito de alcançar excelência no atendimento de nossos clientes e parceiros, através do e- mail para contato engenharia@cesna.com.br.

3 SUMÁRIO 1 OBJETIVO DO SIMULADOR Configuração suportada INSTALAÇÃO O SIMULADOR DE BOMBAS IDCODE Configura Número de MABs Janela principal Modo de Operação Restaurar Configuração Padrão Janela da MAB FUNCIONAMETO Ligar MAB Abastecimento Inicio do abastecimento Fim do abastecimento Modo Off-Line Modo Rápido MODELO DAS BOMBAS Bomba Gilbarco Bomba Wayne... 19

4 LISTA DE FIGURAS Figura 1 - Substituindo IDcode.dll... 6 Figura 2 Configura Número de MABs... 7 Figura 3 - Janela Principal do Simulador de Bombas IDcode... 8 Figura 4 Definição do Modo de Operação da MAB... 9 Figura 5 - Exemplo de janela da MAB Figura 6 - MAB 1 configurada para 4 bombas Figura 7 - Ligar MAB Figura 8 - Estado da MAB Figura 9 - Exemplo do Bico 2 da Bomba 1 abastecendo Figura 10 Simulação de Leitura de Cartão do Frentista Figura 11 - Finalizar o abastecimento da Bomba 1 Bico Figura 12 - MAB 1 simulando um problema de comunicação Figura 13 - MAB 1 configurada para abastecimentos rápidos Figura 14 - Seleção do modelo das Bombas

5 NOTAÇÕES Concentrador IDcode: Conjunto Master IDcode, MAB IDcode, Fonte IDcode de Alimentação, Antenas IDcode e Cartões para Frentistas e Clientes, sendo esse opcional. MAB: Módulo de Automação de Bombas. Hardware que controla e gerencia as bombas de combustível. Master IDcode USB: Hardware de interface entre MAB e PC. Driver FTDI: Driver para Master IDcode USB. Instalador Gerenciador IDcode: Software que instala e registra o software Gerenciador IDcode. Gerenciador IDcode: Software de gerenciamento e teste do Concentrador IDcode. CesnaActiveX.dll: Biblioteca em ActiveX para interface com IDcode.dll. IDcode.dll: Biblioteca que gerencia a comunicação com o Concentrador IDcode. Firmware: Pequeno software dedicado e instalado no microcontrolador da MAB. Mab: Número que corresponde a MAB conectada ao Concentrador IDcode. Bo: Número que corresponde a Bomba de Combustível. Bi: Número que corresponde ao Bico da Bomba de Combustível. Tot: Totalizador de determinada Bomba e Bico. Ppl: Preço por Litro de determinada Bomba e Bico. Vol: Volume de determinada Bomba e do último bico abastecido. cd: Número de casas decimais. Software Integrador: Programa desenvolvido pela empresa que está efetuando a integração com o Concentrador IDcode. PC: Microcomputador onde está conectada a Master IDcode USB.

6 1 OBJETIVO DO SIMULADOR No intuito de auxiliar os desenvolvedores, a Cesna desenvolveu o Simulador de Bombas IDcode para uso em conjunto com a CesnaActiveX.DLL. O simulador tem como objetivo a simulação por software de todos os componentes de hardware utilizado na Automação IDcode, ou seja: Placa Master IDcode; Placa MAB; Bombas Eletrônicas; 1.1 Configuração suportada O Simulador de Bombas IDcode permite ser configurado para gerenciar até 16 placas MAB, sendo que cada MAB suporta até 4 bombas lógicas, cada bomba tendo 4 bicos de abastecimento. Ou seja, pode ser configurado para trabalhar com até 64 bombas, totalizando 256 bicos de abastecimento. O Simulador de Bombas IDcode pode ser configurado para 3 tipos de bomba física, sendo os modelos: Gilbarco Wayne 3G A configuração do modelo de bomba pode ser diferente em cada MAB, possibilitando a simulação de uma situação real dos postos de combustível. Em que temos modelos de bomba diferentes. A diferença entre cada modelo será descrita no Capítulo 5.

7 2 INSTALAÇÃO Após executar o instalador do Simulador de Bombas IDcode, deve ser substituído o arquivo IDcode.dll para a versão 3.x.x.x antes do inicio do programa. Este arquivo (IDcode.dll) encontra-se no diretório C:\Windows\System32 (para Windows 32 bits) ou C:\Windows\SysWOW64 (para Windows 64 bits). Para confirmarmos a alteração, quando apontamos o cursor para o arquivo IDcode.dll ele irá mostrar algumas informações, dentre elas a Versão do arquivo. Verifique se a versão mostrada é a 3.x.x.x (Ex.: , como mostrado na Figura 1). Figura 1 - Substituindo IDcode.dll A versão 3.x.x.x da IDcode.dll é específica para o uso do Simulador de Bombas IDcode, sendo que não irá funcionar quando for utilizada diretamente com o Concentrador IDcode. Após a substituição do arquivo IDcode.dll o Simulador de Bombas IDcode já está pronto para ser iniciado, não sendo necessária nenhuma outra configuração.

8 3 O SIMULADOR DE BOMBAS IDCODE Neste capítulo mostraremos uma visão geral das telas do Simulador de Bombas IDcode e uma breve descrição das suas opções. Mais Detalhes sobre cada uma das opções serão abordados no Capítulo Configura Número de MABs Logo ao iniciar o Simulador de Bombas IDcode será aberta uma janela pedindo para o usuário informar o número de MABs que serão abilitadas, como é demonstrado na figura 2. Figura 2 Configura Número de MABs A partir dessa configuração a janela principal será aberta contendo o número de MABs informado habilitadas. 3.2 Janela principal Na janela principal são definidas as configurações e exibidas algumas informações básicas de cada MAB. Na figura 3 é possível perceber que foram configuradas três MABs, sendo que a quarta está desabilitada.

9 Figura 3 - Janela Principal do Simulador de Bombas IDcode Cada MAB na janela principal possui os seguintes campos: Modelo: Responsável por escolher o modelo de bombas que a MAB irá gerenciar (mais detalhes no Capítulo 5); Número de Bombas: Quantidade de bombas que a MAB está gerenciando no momento; Modo de Operação: Modo de Operação da MAB com as Bombas (verificar os modos disponíveis no Manual de Desenvolvedores); Estado: Estado atual da MAB (mais detalhes no Capítulo 4.1); Off-Line: Campo responsável pela por indicar se a MAB está trabalhando em modo Off-Line (mais detalhes no Capítulo 4.3); Rápido: Quando assinalado faz com que o volume do abastecimento seja aumentado com maior velocidade, para simular abastecimentos maiores. Liga/Desliga: Botão responsável por ligar ou desligar a MAB (verificar Capítulo 4.1); Modo de Operação O campo Modo de Operação, da janela principal, permite que no momento de sua abertura se defina o modo em que a MAB irá operar (Figura 4).

10 Figura 4 Definição do Modo de Operação da MAB Os modos de operação possíveis são: Autorização Automática: Modo de Operação A. Autoriza o abastecimento assim que o bico é acionado. Autorização Pelo Software: Modo de Operação B. Quando o bico for acionado a bomba ficará aguardando o comando de autorização enviado pelo Gerenciador IDcode ou software integrador. Autorização Por Cartão: Modo de Operação C. Quando o bico for acionado aguardará a simulação de leitura de cartão para liberar o abastecimento. Mais detalhes no item 3.3. Ao iniciar a MAB o campo Modo de Operação será atualizado conforme o modo selecionado Restaurar Configuração Padrão No menu Ferramentas da janela principal temos a opção: Restaurar Configuração Padrão. No momento que o Simulador de Bombas IDcode é iniciado pela primeira vez, ele cria no diretório em que se encontra o executável SimuladorBombaIDcode.exe o arquivo de texto DadosBomba.txt. Nesse arquivo são armazenadas as informações (Preço Por Litro e Totalizador) de cada MAB/Bomba/Bico. Essas informações são salvas no arquivo

11 DadosBomba.txt sempre que o Simulador de Bombas IDcode é finalizado, e são lidas sempre que o simulador é iniciado. Isso permite que o simulador possa ser encerrado e iniciado sem ter que realizar a configuração de Preço Por Litro para cada bico novamente, e também que o Totalizador de cada bico seja sempre incrementado, nunca voltando a zero. Sempre que necessário reiniciar esses valores (PPL e Totalizador), pode ser utilizado a opção Restaurar Configuração Padrão, no menu Ferramentas. Sendo que todos os totalizadores terão seu valor alterado para 0 (zero) litros, e o PPL de todos os bicos será alterado para R$ 1,000 (valor padrão). 3.3 Janela da MAB Cada MAB terá uma janela própria (ver Figura 5), nesta tela serão exibidas as informações das bombas que estão configuradas para a respectiva MAB. Cada bomba exibe a informação dos seus 4 bicos, sendo que cada bico possui os seguintes campos 1 : Valor: Valor (em R$) do abastecimento atual; Volume: Volume (em litros) do abastecimento atual; Ppl: Preço por litro do bico (em R$); Tot: Totalizador/Encerrante (em litros) de cada bico; Figura 5 - Exemplo de janela da MAB 1 1 Os campos Valor e Volume são atualizados em tempo real, na medida em que o bico está acionado e o abastecimento em andamento.

12 A bomba também possui o s campos Frentista e Cliente que são utilizados somente quando a MAB estiver configurada para modo C, para simular a leitura de cartões do frentista e do cliente, e dessa forma autorizar o abastecimento. A janela da MAB será automaticamente redimensionada para comportar o número de bombas configuradas para o gerenciamento. Conforme já descrito, cada MAB pode gerenciar até quatro bombas (conforme mostra a Figura 6). Figura 6 - MAB 1 configurada para 4 bombas

13 4 FUNCIONAMETO 4.1 Ligar MAB Após iniciar o gerenciador e configurar o número de MABs para gerenciamento, como descrito do item 3.1, a janela Principal é aberta. A janela de cada MAB é aberta somente quando for clicado no seu respectivo botão Liga na janela principal (Figura 7). Porém antes de ligar uma MAB é necessário definir o modelo de Bombas que ela irá gerenciar 2. Isso é feito através do Combo Box Modelo. Essa escolha deve ser feita antes, pois enquanto a MAB está ligada esse Combo Box permanece desabilitado. Também é preciso escolher qual Modo de Operação que será operado. Este modo de operação poderá ser alterado através do comando IDcodeConfiguraMab 3. As diferenças entre os modelos de bombas suportados pelo simulador serão descritas no Capítulo 5. Figura 7 - Ligar MAB 1 Quando uma MAB é ligada, por padrão, ela é configurada para gerenciar quatro bombas. Essa configuração também poderá ser alterada através do comando IDcodeConfiguraMAB do componente ActiveX. 2 Por padrão cada MAB inicia configurada para gerenciar bombas do modelo Gilbarco. 3 Consultar Manual Desenvolvedores IDcode.

14 Ao ligar ou desligar uma MAB, o campo Estado, da janela principal é alterado para o respectivo estado: LIGADO ou DESLIGADO. Também é possível visualizar esse estado na barra de título da janela de cada MAB, como mostra a Figura 8. Figura 8 - Estado da MAB 4.2 Abastecimento A baixo será descrito como proceder para realizar abastecimentos pelo Simulador de Bombas IDcode Inicio do abastecimento Para iniciar o abastecimento de um bico, deve-se clicar no botão Liga que fica localizado do lado direito de cada Bico. Assim que um bico é acionado o botão Liga dos demais bicos da bomba ficam desabilitados. Isso ocorre pois somente 1 (um) bico pode abastecer por vez em uma bomba (Figura 9). Os campos Valor e Volume do bico que está abastecendo são atualizados em tempo real.

15 Figura 9 - Exemplo do Bico 2 da Bomba 1 abastecendo. Quando a MAB estiver desligada, nenhuma Bomba irá funcionar, sendo que se um bico for acionado nessa situação, o mesmo fica no estado AGUARDANDO LIBERAÇÃO até que a MAB seja ligada novamente Abastecimento em Modo C Quando a MAB estiver configurada para trabalhar em Modo de Operação C ela só liberará os abastecimentos depois que a Tag do frentista for lida. Neste modo os Campos Frentista e Cliente serão habilitados. Para realizar um abastecimento em modo C é preciso que, após o acionamento do bico, o campo frentista seja preenchido com 16 caracteres, entre numerais e letras de A à F, e o botão Ler seja clicado. Dessa forma é simulada a leitura da Tag do frentista e o abastecimento é liberado (Figura 10). Também é possível preencher o campo Cliente, da mesma forma que o campo Frentista, sendo que a Tag do cliente não liberará o abastecimento, mas será enviado junto aos demais dados do abastecimento ao software integrador. O preenchimento do Campo Cliente não é obrigatório para a realização do abastecimento.

16 Figura 10 Simulação de Leitura de Cartão do Frentista Fim do abastecimento Para finalizar o abastecimento basta clicar no botão Desl que fica ao lado direito do bico que está abastecendo (ver exemplo na Figura 11). Após o termino do abastecimento, os demais botões Liga dos bicos da bomba são habilitados novamente. Figura 11 - Finalizar o abastecimento da Bomba 1 Bico 1 O campo Tot do bico que abasteceu também é atualizado sendo o seu novo valor composto do valor anterior acrescido do volume do abastecimento que acabou de ocorrer. O Simulador de Bombas IDcode então enviará os dados do abastecimento ao software

17 integrador. Caso a MAB esteja operando em modo C, também enviará os valores das Tags do Frentista e do Cliente, do contrário esses valores serão enviados zerados. 4.3 Modo Off-Line Esta função permite simular um possível problema de comunicação entre o Concentrador IDcode e Computador. Na janela principal do programa cada MAB possui um Check Box chamado Off-Line (ver Figura 12). Quando esse Check Box estiver marcado a comunicação entre Concentrador e Computador é interrompida, sendo reestabelecida assim que o a opção Off-Line for desmarcada. No momento em que a MAB está trabalhando em modo Off-Line ela não receberá nenhum comando que seja enviado pelo componente ActiveX (CesnaActiveX). Todo abastecimento que ocorrer nesse período será salvo na sua memória 4 interna e enviado para o componente ActiveX (através do evento OnIDcodeAbasteceu) assim que a comunicação for reestabelecida. Figura 12 - MAB 1 simulando um problema de comunicação 4 Quando estiver trabalhando em modo Off-Line, cada MAB do Simulador de Bombas IDcode poderá armazenar até 50 abastecimentos.

18 4.4 Modo Rápido Esta função permite que abastecimentos de maior volume sejam realizados de forma mais rápida. Enquanto o check-box Rápido estiver marcado (figura 13) os abastecimentos realizados pelo Simulador de Bombas IDcode serão realizados com um aumento significativo do volume. Essa função é indicada para quando se quiser fazer testes de abastecimento que exijam grandes volumes, pois ela reduz o tempo do abastecimento. Figura 13 - MAB 1 configurada para abastecimentos rápidos

19 5 MODELO DAS BOMBAS Na janela principal (Figura 14), através do Combo Box Modelo, é possível escolher 3 modelos de bombas diferentes: GILBARCO e WAYNE. Cada MAB permite a configuração independente do modelo das bombas. Ou seja, podemos ter a MAB 1 controlando bombas do modelo Gilbarco e a MAB 2 bombas do modelo Wayne, etc. Esse Combo Box permanece desabilitado enquanto a MAB estiver ligada. Figura 14 - Seleção do modelo das Bombas. Cada bomba possui diferenças no seu funcionamento que serão mostradas nos próximos subcapítulos. 5.1 Bomba Gilbarco No processo de abastecimento a bomba do modelo Gilbarco não envia o número correto do bico até o momento que o abastecimento é finalizado. Por esse motivo o valor do Bico é sempre 1 (um) nos seguintes estados: MM_EVENTO_BOMBA_PEDE_AUTORIZACAO MM_EVENTO_BOMBA_LIBERADA MM_EVENTO_BOMBA_ABASTECENDO

20 Exemplo: Se for acionado o Bico 2 da Bomba 3 que está ligada na MAB 1: Para os três estados citados acima, o evento IDcodeMudancaDeEstado (do componente ActiveX CesnaActiveX) receberá os seguintes parâmetros: Mab = 1; Bo = 3; Bi = 1; Note que o Bico (Bi) chegará com o valor 1 e não com o valor correto 2. Somente quando receber o estado MM_EVENTO_BOMBA_ABASTECEU o valor correto do bico é descoberto. Diferentemente da bomba modelo Wayne que sempre envia o valor correto do bico em todos os estados. 5.2 Bomba Wayne Enquanto a bomba Wayne está efetuando o abastecimento (estado MM_EVENTO_BOMBA_ABASTECENDO) ela responde aos seguintes comandos do componente ActiveX: IDcodeObemVolume: na resposta a esse comando é obtido o volume do abastecimento atual em tempo real, ou seja, nesse modelo de bomba é possível acompanhar o volume do abastecimento em tempo real por software; IDcodeObtemTotalizador: a resposta a esse comando é o totalizador da bomba antes do inicio do abastecimento atual; IDcodeObtemPrecoPorLitro: a resposta é o Preço Por Litro do abastecimento atual; Isso não ocorre na bomba Gilbarco que, se estiver no processo de abastecimento (MM_EVENTO_BOMBA_ABASTECENDO) e for solicitado algum dos comandos acima, sempre retorna o estado atual da bomba (MM_EVENTO_BOMBA_ABASTECENDO) e não a retorna a resposta ao comando solicitado.