Swedanix

Manual do desenvolvedor

Este manual tem caráter técnico- informativo, sendo propriedade da SWEDA INFORMÁTICA LTDA ( SWEDA).

É Permitida a reprodução deste documento, desde que preservada a integridade do seu conteúdo, com autorização da SWEDA.

Todos os cuidados foram tomados no preparo deste manual.

Entretanto a SWEDA não assume nenhuma responsabilidade por erros, imprecisões ou omissões em seu conteúdo, assim como por quaisquer tipos de danos, perdas ou lucros cessantes decorrentes do uso da informação aqui contida.

As informações contidas neste manual estão sujeitas a alteração sem aviso prévio.

Outubro - 2001

OBJETIVOS

Este documento descreve os procedimentos de configuração e operação da biblioteca
SWEDANIX. Esta biblioteca objetiva a interligação entre um Emissor de Cupom Fiscal
(ECF) SWEDA e um computador em ambiente UNIX ou Linux.

CONEXÃO

A interligação entre ECF e o computador é feita e através de um dos canais de
comunicação de uma placa multiserial ou através da própria porta de comunicação do
computador.
Para a versão SCO do Unix, a comunicação só poderá ser feita através da placa
multiserial.
Os parâmetros de configuração do dispositivo (velocidade de comunicação, paridade
etc) são fixos e definidos internamente na biblioteca.

Velocidade	9600
Sem Paridade
Data Bits	8
Stop Bits	1

ESPECIFICAÇÃO DO CABO DE COMUNICAÇÃO

DB9
IMPRESSORA		COMPUTADOR

2 – RX	------------------------------	TX – 3
3 – TX	------------------------------	RX – 2
4 – DTR	------------------------------	CTS – 8
6 – DSR	------------------------------	RTS – 7
5 – GND	------------------------------	GND – 5

DB25
IMPRESSORA		COMPUTADOR

2 – RX	------------------------------	TX – 2
3 – TX	------------------------------	RX – 3
4 – DTR	------------------------------	CTS – 5
6 – DSR	------------------------------	RTS – 4
5 – GND	------------------------------	GND – 7

ARQUIVO

SWEDANIX – interface de comunicação

COMPATIBILIDADE

A comunicação ocorre com o envio de comandos e o recebimento das respostas
utilizando arquivos no formato texto, compatibilizando a utilização da SWEDANIX em
qualquer plataforma Unix.

CONFIGURAÇÃO

As opções para configuração pela linha de comando são as seguintes:

OPÇÃO	DESCRIÇÃO	VALOR PADRÃO

-d <device>	Dispositivo de comunicação	"/dev/ttS1"
-m <msgfile>	Arquivo de mensagem a enviar	"eq.MSG"
-p <path_cfg>	Parte inicial do diretório de configuração	"/home/usuarios/ECF"
-r <responsefile>	Arquivo final de resposta	"eq.RSP"
-s <subpath_cfg>	Subdiretório de configuração deste processo	"ttyS1"
-T <timeout>	Valor do time-out em segundos	15
-h	Mensagem de ajuda

FUNCIONAMENTO

O processo de envio e captura de mensagens para o ECF verifica a existência de um
"arquivo de mensagem a enviar" , conforme tópico CONFIGURAÇÃO e grava a
mensagem no "dispositivo de comunicação" configurado. A interface espera a resposta
vinda do ECF e coloca no "arquivo final de resposta", que pode ser lido pelo processo
usuário.

Tanto o "arquivo de mensagem a enviar" como o "arquivo final de resposta" são
acessados no "diretório de configuração".

A parte final deste diretório é criada à partir do nome do "dispositivo de comunicação".
Esse diretório varia de acordo com o dispositivo especificado.

Como exemplo, o valor padrão desse diretório, segundo as opções mostradas no
tópico CONFIGURAÇÃO (em que o dispositivo é "/dev/tty1a") é:

"/home/usuarios/ECF/tty1a"

Caso não se queira que o subdiretório final esteja associado ao dispositivo, deve-se
usar a opção "-s" para especificar o nome desejado.

EXEMPLO:

./swedanix –p /tmp/ecf –d /dev/ptt/t1

Este exemplo resultará na criação, caso não exista, do diretório de configuração
"tmp/ecf/t1".

./swedanix –p /tmp/ecf –d /dev/ptt/t1 -s configuracao_1

Este exemplo resultará na criação, caso não exista, do diretório de configuração
"tmp/ecf/configuracao_1".

. NOTA:

Para todos os comandos enviados ao ECF obrigatoriamente deve ser
capturada e tratada a resposta.
A conexão de periféricos entre o computador e o ECF pode ocasionar em
perda de comandos. Para evitar essa perda deve-se conectar um BUFFER
SERIAL na porta de comunicação do ECF.

ENVIANDO OS COMANDOS

O software aplicativo deverá seguir a sequência abaixo, para enviar os comandos ao
ECF:

Criar um arquivo temporário com o comando a ser enviado;
Renomear este arquivo para o nome utilizado no arquivo de envio ( O valor
padrão é eq.MSG) ;
Aguardar a existência do arquivo de retorno do ECF (O valor padrão é eq.RSP) ;
Ler o conteúdo do arquivo, que corresponde à resposta do comando enviado e
removê-lo.
Fazer o tratamento da resposta, para verificar se o comando foi bem sucedido
ou não.

LEITURA EM MEIO MAGNÉTICO

A captura da Leitura da Memória Fiscal em meio magnético, deve ocorrer utilizando o
protocolo tipo 1 descrito no manual de programação do ECF. O "arquivo de resposta"
será gerado somente após o recebimento completo da leitura.