Solos-PCI Linux Howto
=====================

Last modified : 1/Sep/2008

Introduction
------------

This document will eventually describe how to install, compile and configure the Solos PCI ADSL2+ GPL Linux drivers.
We are currently testing with 2.6.24.4 and recommend this kernel.
Other 2.6 kernels may require some driver tweaks.

1. Kernel preparation
---------------------

Fortunately the 2.6 kernels include ATM support so normally no kernel patching is required. 
However you may need to recompile your kernel if you don't have ATM support enabled. 
If you are not sure, check your kernel .config file for the following...

CONFIG_ATM=y
# CONFIG_ATM_CLIP is not set
# CONFIG_ATM_LANE is not set
CONFIG_ATM_BR2684=y

If not run make menuconfig and set the following under 
Networking Options...

[M] Asynchronous Transfer Mode (ATM) (EXPERIMENTAL)
[ ]   Classical IP over ATM                           
< >   LAN Emulation (LANE) support                       
<M>   RFC1483/2684 Bridged protocols  

For PPPoA (RFC2364) you must also have the following set in your .config file...

CONFIG_PPPOATM=m

If not run make menuconfig and set the following under 
Network device support...

<M> PPP (point-to-point protocol) support 
[*]   PPP multilink support (EXPERIMENTAL)
[*]   PPP filtering
<M>   PPP support for async serial ports
<M>   PPP support for sync tty ports
<M>   PPP Deflate compression
<M>   PPP BSD-Compress compression
<M>   PPP over Ethernet (EXPERIMENTAL)
<M>   PPP over ATM (EXPERIMENTAL)

If the required options are not set you will need to set them and recompile your kernel. 
If you don't know how to do this please read the Kernel Rebuild Guide at...

http://www.digitalhermit.com/linux/Kernel-Build-HOWTO.html


2. ATM utilities and libraries
------------------------------

Fedora : install the linux-atm package

Debian : install the libatm1-dev package

Source : linux-atm-2.5.0.tar.gz from http://sourceforge.net/projects/linux-atm


3. Bridging (RFC1483 / RFC2684) Utility for Bridged Ethernet
------------------------------------------------------------

If you plan to use RFC1483 you will need br2684ctl. 

Fedora : supplied with the linux-atm package

Debian : install the br2684ctl package

Source : supplied with linux-atm-2.5.0.tar.gz 


4. PPPoA
--------

Fedora : install the ppp package
Debian : install the ppp package
Source : ppp-2.4.4.tar.gz from ftp://ftp.samba.org/pub/ppp/

5. PPPoE
--------

Download rp-pppoe-3.10.tar.gz from http://www.roaringpenguin.com/products/pppoe


5.1 Install

  $ tar -xvzf rp-pppoe-3.10.tar.gz 
  $ cd rp-pppoe-3.10
  $ ./confiure --enable-plugin=$PPPDIR
  $ make
  $ make install

Note $PPPDIR is the ppp directory on your system, eg. /usr/local/lib/pppd/2.4.4

6. Untar and Compile the driver
-------------------------------

6.1 Untar the driver

  $ tar -xvzf solos-pci-x.xx.tar.gz
  $ cd solos-pci-x.xx

6.2 Compile 

  $ make clean
  $ make


7. Showtime
-----------

IMPORTANT : The following examples use Vpi = 0, Vci = 38 which are the common PVC values for the UK.
Other countries & providers are different, so check with your provider first.

For Bridged Ethernet (RFC1483)...

  $ modprobe atm 
  $ insmod solos-pci.ko
  $ br2684ctl -b -s 4000 -c 0 -a 0.0.38 
  $ ifconfig nas0 203.123.69.1 up 

and for the second port... 

  $ br2684ctl -b -s 4000 -c 0 -a 1.0.38 
  $ ifconfig nas1 203.123.69.2 up 


For PPPoA (RFC2364)...

  $ modprobe atm
  $ modprobe pppoatm
  $ insmod pulsar_atm.o
  $ pppd plugin pppoatm.so 0.0.38 user test password test noauth

and for the second port...

  $ pppd plugin pppoatm.so 1.0.38 user test2 password test2 noauth


For PPPoE...
  $ modprobe atm 
  $ insmod solos-pci.ko
  $ br2684ctl -b -s 4000 -c 0 -a 0.0.38 
  $ ifconfig nas0 up
  $ pppd plugin rp-pppoe.so nic-nas0 user test password test noauth
   
and for the second port...

  $ br2684ctl -b -s 4000 -c 0 -a 1.0.38 
  $ ifconfig nas1 up
  $ pppd plugin rp-pppoe.so nic-nas1 user test2 password test2 noauth


8. References and further reading
---------------------------------

Linux-ATM homepage... 
http://linux-atm.sourceforge.net/

Linux-ATM project on sourceforge... 
http://sourceforge.net/projects/linux-atm/

Eric Leblond's ATM Bridging Howto... 
http://home.regit.org/br2684.html

The official ATM Howto... 
http://www.tldp.org/HOWTO/ATM-Linux-HOWTO/index.html 

ATM Technical Overview - IBM Redbooks
http://www.redbooks.ibm.com/redbooks/pdfs/sg244625.pdf

RFC1483 (IPoATM)

RFC2364 (PPPoA)