------------------------------------------------------------------------------
README file for the PCBIT-D Device Driver.
------------------------------------------------------------------------------
This README file is in portuguese since the board is manufactured and
used, to my knowledge, only in Portugal.
In case you are interessed in a translation just mail me.
------------------------------------------------------------------------------
O driver para a PCBIT implementa as funções de comunicação com a
placa e uma maquina de estados que controla o establecimento de
ligacoes. Destina-se a ser utilizado em conjunto com o modulo
"isdn4linux" (ftp://ftp.franken.de/pub/isdn4linux) que se espera que
integre futuramente a distribuição do kernel. Este modulo realiza o
interface entre o ISDN e os interfaces normais de um sistema Unix
(ttys e devices de rede).
O driver destina-se a ser instalado em "run-time" no kernel através
do comando "insmod".
exemplo: root_shell# insmod pcbit [irq=X mem=0x?????]
A PCBIT utiliza por defeito o endereço de memoria 0xD0000 e o irq 5.
Caso os parametros de irq e memória base não sejam fornecidos o
driver tentará utilizar os valores por defeito.
A PCBIT necessita, na sua versão mais comum, que seja feito o load do
firmware. O comando pcbitctl permite, apos a instalacao do driver,
carregar o firmware da placa. O firmware não é distribuido com o
driver podendo encontrar-se nas disquetes que vêm com a placa ou em
ftp://puma.inesc.pt/.
São necessários os ficheiros:
- stpd.1
- stpd.2
- bitd.hex
Aviso: Estes ficheiros são distribuidos em modo de ficheiro de texto
de DOS. O comando pcbitctl necessita desses ficheiros em modo binario
(i.e. um ficheiro normal sem os LF e Ctrl-Z).
Para os utilizadores da RCU:
A RCU utiliza routers cisco como pontos de entrada, configurados para
utilizar PPP sincrono (i.e. encapsulação PPP sobre tramas HDLC no
canal B). Como tal é necessário utilizar devices de rede isdn com
encapsulação "syncPPP".
um exemplo de um script de para iniciar um interface:
#!/bin/bash
PATH=$PATH:<PATH_TO_ISDN_STUFF>
isdnctrl addif ippp0
isdnctrl l2_prot ippp0 hdlc
isdnctrl l3_prot ippp0 trans
isdnctrl encap ippp0 syncppp
isdnctrl addphone ippp0 out <num_isdn_da_rcu>
ifconfig ippp0 <ip-atribuido-ao-utilizador> pointopoint <ip-do-router>
route add default ippp0
isdnctrl huptimeout ippp0 180
ipppd /dev/ippp0 /dev/ippp1 useifip \
-detach debug \
mru 1524 -ac -vj \
+ua /etc/ppp/isdn-auth
nota:
o ficheiro /etc/ppp/isdn-auth é um ficheiro da forma:
username
passwd
o interface de rede é activado (e a conexão isdn establecida) quando
o utilizador der algum comando que implique acesso á rede.
ex: ping -c 1 <hostname>.
[normalmente existe um delay de 3-4 segundos no establecimento da ligação]
BUGS:
- o driver não permite um reload do firmware após o firmware ter sido
carregado.
- existem erros de comunicação driver/placa que se exibem em
situações de tráfego intenso. (alguns deste problemas podem mesmo ser
provocados por bugs no firmware da placa)
Mailing lists:
isdn4linux - isdn4linux@hub-wue.franken.de (majordomo)
enviar:
- informação sobre bugs, comentários, sujestões e patchs ao código p/
roque@di.fc.ul.pt.
- flames p/
/dev/null
Pedro.
3cfc218cb5