Driver Dial-Up

Arquivo: DIALUP32.DLL
Fabricante: Elipse
Release: 10/08/2001
O driver Dial-Up implementa o protocolo de conexo remota Cliente/Servidor do Elipse Windows
atravs de uma linha discada. Nas aplicaes remotas no Elipse, necessrio que se defina qual
das estaes ser a cliente e qual ser a servidora.

1) Configurao do Servidor (ou simplesmente do driver)

Na aplicao servidora, deve-se adicionar o driver Dial-Up no item drivers e chamar a opo
configurar, como mostrado a seguir:

Neste dilogo so setados os seguintes parmetros de funcionamento geral do driver:

Client/ Server: Define se esta aplicao ser Cliente ou Servidora.
Modem: Seleciona qual modem deve ser usado na conexo.
Modem Settings: D acesso ao dilogo de parametrizao do Modem.
Time-Out (ms): Permite a setagem do Time-Out em milsimos de segundo.
Number of Rings: Permite setar o nmero de rings usados para que o modem aceite a chamada.
Pulse Dial: Permite setar a discagem para Pulse ou Tone (default).

As opes de "DEBUG" so as seguintes:

No LOG/ Create new/ Append data: Nesta opo ser decidido se o driver vai criar um arquivo de
LOG novo a cada inicializao (Create new), vai adicionar os dados de "DEBUG" no final do
arquivo j existente (Append data), ou simplesmente no vai criar arquivo de LOG (No LOG).
File path: Neste campo, entre com o caminho completo do arquivo de LOG.
Standard error output: Esta opo permite, se setada, o uso do chamado "Standard error output",
que , normalmente, uma janela do ambiente de programao. Esta opo se destina ao usurio
avanado que esteja desenvolvendo drivers.
Starts with DEBUG Window: Esta opo permite que a aplicao Elipse inicie com uma janela de
DEBUG aberta. Nesta janela estaro diversas informaes importantes para a correta depurao
da comunicao atravs do modem.
Message Filters: Nesta opo o usurio pode decidir que tipo de informao ser escrita no
arquivo de LOG e na DEBUG Window. Selecione aqueles dados que forem mais importantes para
a depurao do seu aplicativo.
DW Font: Esta opo permite-se selecionar a fonte usada na Janela de DEBUG.

2) Configurao do Cliente
Na aplicao cliente, deve-se adicionar o driver Dial-Up no item drivers e configur-lo de acordo
(ver item Configurao do Servidor ou simplesmente do driver). Deve-se ento inserir uma nova
Aplicao Remota, usando-se para isto o Application Organizer, e deve-se configurar esta nova
Aplicao usando-se o boto Configurar:

Surge ento a seguinte caixa de dilogo, que servir para se configurar a aplicao Cliente:

Number: deve conter o nmero do telefone do servidor. Se estiver ligando a partir de uma central
PABX, e precisar discar um nmero antes para acessar linha externa, coloque o nmero de acesso
a linha externa antes do nmero, separado por uma vrgula (Ex.: 0,222-1122)

3) Registradores
Neste driver esto disponveis uma srie de registradores que sero teis na implementao da
aplicao Elipse. Estes registradores so atributos do item "RemoteDriver"; para acess-los, use o
App-Browser.
reg0 - Nmero de bytes enviados desde a inicializao do driver
reg1 - Nmero de bytes recebidos desde a inicializao do driver
reg2 - Nmero de telegramas enviados desde a inicializao do driver
reg3 - Nmero de telegramas recebidos desde a inicializao do driver
reg4 - Nmero de telegramas de dados enviados desde a inicializao do driver
reg5 - Nmero de telegramas de dados recebidos desde a inicializao do driver
reg6 - Baud-Rate efetivo, aps a conexo, em bits por segundo
reg7 - Taxa de transferncia real, depois do treinamento, em bytes por segundo
reg8 - Nmero de telegramas na fila de espera para serem transmitidos
reg9 - Sinal de portadora (0=sem portadora, 1=com portadora)
regA - Status atual da conexo (ver lista a seguir)
regB - Liga/Desliga DEBUG Window (0=DW desligada, 1=DW ligada)
Os prximos registradores so usados para a discagem a partir de um servidor:
regC - Forca discagem a partir do servidor (1=forca discagem)
regD - Usa central PABX (0=no usa, 1=usa)
regE - Nmero do DDD (sem o zero)
regF - Nmero do telefone do cliente (destino)
Ateno: a conexo a partir de um servidor possvel, mas exige uma pequena participao
da aplicao cliente. A aplicao cliente deve detectar a presena de portadora (gerada por
iniciativa do servidor) e ento solicitar a conexo lgica atravs do comando
"RemoteApp.Connect()", do contrrio a conexo no se estabelecer por completo, e a linha
cair aps alguns segundos. Segue um exemplo de "script" que realiza esta tarefa
(WhileRunning):
if tmpCarrier==0
if RemoteDriver1.reg9==1
tmpCarrier=1
if RemoteApp1.isConnected<>1
if RemoteApp1.isConnecting<>1
RemoteApp1.Connect()
endif
endif
endif
else
if RemoteDriver1.reg9<>1
tmpCarrier=0
endif
endif

4) Lista de Status da Conexo (regA):

00 - Sem Status
01 - Modem inicializado OK
02 - Erro de inicializao do Modem (porta ocupada)
03 - Erro de inicializao do Modem (erro no modem)
04 - Erro de conexo (Servidor)
05 - Erro de conexo (Discagem)
06 - Conectando
07 - Fazendo Hand-Shake com parceiro
08 - Conectado
09 - Desconectando
10 - Erro de desconexo (Server)
11 - Erro de desconexo (Hang-Up)
12 - Desconexo OK
13 - Desconectado por erro no Hand-Shake
14 - Desconectado por falta de portadora
15 - Desconectado por erro de CRC
16 - Desconectado por erro de Time-Out
17 - Desconectado por recebimento de NAK
18 - Desconectado por falta de Dial-Tone
19 - Desconectado por telefone ocupado
20 - Desconectado por no responde
21 - Desconectado por erro de memria
22 - Desconectado por erro de buffer
23 - Desconectado por erro de conflito
24 - Desconectado por erro de rudo
25 - Desconectado por erro desconhecido

5) Observaes:
a) Se voc estiver usando um ramal de central telefnica, certifique-se de que a opo "Aguardar o
sinal antes de discar" ("Wait for dial tone" em ingls) no dilogo de configurao do Modem est
DESABILITADA. Do contrrio, em muitas centrais telefnicas, o modem no ir reconhecer o tom
de discagem e no processar a discagem. Veja a figura a seguir: