------------------------------------------------------------------------------
 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 funes de comunicao 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 distribuio 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 atravs
 do comando "insmod".

 exemplo: root_shell# insmod pcbit [irq=X mem=0x?????]

 A PCBIT utiliza por defeito o endereo de memoria 0xD0000 e o irq 5.
 Caso os parametros de irq e memria base no sejam fornecidos o
 driver tentar utilizar os valores por defeito.

 A PCBIT necessita, na sua verso 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 no  distribuido com o
 driver podendo encontrar-se nas disquetes que vm com a placa ou em
 ftp://puma.inesc.pt/. 
 So necessrios os ficheiros:
	- stpd.1 
 	- stpd.2
	- bitd.hex

 Aviso: Estes ficheiros so 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. encapsulao PPP sobre tramas HDLC no
 canal B). Como tal  necessrio utilizar devices de rede isdn com
 encapsulao "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 conexo 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 ligao]


 BUGS:
 - o driver no permite um reload do firmware aps o firmware ter sido
 carregado.
 - existem erros de comunicao driver/placa que se exibem em
 situaes de trfego intenso. (alguns deste problemas podem mesmo ser
 provocados por bugs no firmware da placa)


 Mailing lists:
 isdn4linux - isdn4linux@hub-wue.franken.de    (majordomo)

 enviar:
 - informao sobre bugs, comentrios, sujestes e patchs ao cdigo p/
   roque@di.fc.ul.pt.

 - flames p/
   /dev/null



						Pedro.

