mirror of
https://github.com/torvalds/linux
synced 2024-11-05 18:23:50 +00:00
0ea6e61122
Below you will find an updated version from the original series bunching all patches into one big patch updating broken web addresses that are located in Documentation/* Some of the addresses date as far far back as 1995 etc... so searching became a bit difficult, the best way to deal with these is to use web.archive.org to locate these addresses that are outdated. Now there are also some addresses pointing to .spec files some are located, but some(after searching on the companies site)where still no where to be found. In this case I just changed the address to the company site this way the users can contact the company and they can locate them for the users. Signed-off-by: Justin P. Mattock <justinmattock@gmail.com> Signed-off-by: Thomas Weber <weber@corscience.de> Signed-off-by: Mike Frysinger <vapier.adi@gmail.com> Cc: Paulo Marques <pmarques@grupopie.com> Cc: Randy Dunlap <rdunlap@xenotime.net> Cc: Michael Neuling <mikey@neuling.org> Signed-off-by: Jiri Kosina <jkosina@suse.cz>
158 lines
6.2 KiB
Text
158 lines
6.2 KiB
Text
|
|
READ ME FISRT
|
|
ATM (i)Chip IA Linux Driver Source
|
|
--------------------------------------------------------------------------------
|
|
Read This Before You Begin!
|
|
--------------------------------------------------------------------------------
|
|
|
|
Description
|
|
-----------
|
|
|
|
This is the README file for the Interphase PCI ATM (i)Chip IA Linux driver
|
|
source release.
|
|
|
|
The features and limitations of this driver are as follows:
|
|
- A single VPI (VPI value of 0) is supported.
|
|
- Supports 4K VCs for the server board (with 512K control memory) and 1K
|
|
VCs for the client board (with 128K control memory).
|
|
- UBR, ABR and CBR service categories are supported.
|
|
- Only AAL5 is supported.
|
|
- Supports setting of PCR on the VCs.
|
|
- Multiple adapters in a system are supported.
|
|
- All variants of Interphase ATM PCI (i)Chip adapter cards are supported,
|
|
including x575 (OC3, control memory 128K , 512K and packet memory 128K,
|
|
512K and 1M), x525 (UTP25) and x531 (DS3 and E3). See
|
|
http://www.iphase.com/
|
|
for details.
|
|
- Only x86 platforms are supported.
|
|
- SMP is supported.
|
|
|
|
|
|
Before You Start
|
|
----------------
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
1. Installing the adapters in the system
|
|
To install the ATM adapters in the system, follow the steps below.
|
|
a. Login as root.
|
|
b. Shut down the system and power off the system.
|
|
c. Install one or more ATM adapters in the system.
|
|
d. Connect each adapter to a port on an ATM switch. The green 'Link'
|
|
LED on the front panel of the adapter will be on if the adapter is
|
|
connected to the switch properly when the system is powered up.
|
|
e. Power on and boot the system.
|
|
|
|
2. [ Removed ]
|
|
|
|
3. Rebuild kernel with ABR support
|
|
[ a. and b. removed ]
|
|
c. Reconfigure the kernel, choose the Interphase ia driver through "make
|
|
menuconfig" or "make xconfig".
|
|
d. Rebuild the kernel, loadable modules and the atm tools.
|
|
e. Install the new built kernel and modules and reboot.
|
|
|
|
4. Load the adapter hardware driver (ia driver) if it is built as a module
|
|
a. Login as root.
|
|
b. Change directory to /lib/modules/<kernel-version>/atm.
|
|
c. Run "insmod suni.o;insmod iphase.o"
|
|
The yellow 'status' LED on the front panel of the adapter will blink
|
|
while the driver is loaded in the system.
|
|
d. To verify that the 'ia' driver is loaded successfully, run the
|
|
following command:
|
|
|
|
cat /proc/atm/devices
|
|
|
|
If the driver is loaded successfully, the output of the command will
|
|
be similar to the following lines:
|
|
|
|
Itf Type ESI/"MAC"addr AAL(TX,err,RX,err,drop) ...
|
|
0 ia xxxxxxxxx 0 ( 0 0 0 0 0 ) 5 ( 0 0 0 0 0 )
|
|
|
|
You can also check the system log file /var/log/messages for messages
|
|
related to the ATM driver.
|
|
|
|
5. Ia Driver Configuration
|
|
|
|
5.1 Configuration of adapter buffers
|
|
The (i)Chip boards have 3 different packet RAM size variants: 128K, 512K and
|
|
1M. The RAM size decides the number of buffers and buffer size. The default
|
|
size and number of buffers are set as following:
|
|
|
|
Total Rx RAM Tx RAM Rx Buf Tx Buf Rx buf Tx buf
|
|
RAM size size size size size cnt cnt
|
|
-------- ------ ------ ------ ------ ------ ------
|
|
128K 64K 64K 10K 10K 6 6
|
|
512K 256K 256K 10K 10K 25 25
|
|
1M 512K 512K 10K 10K 51 51
|
|
|
|
These setting should work well in most environments, but can be
|
|
changed by typing the following command:
|
|
|
|
insmod <IA_DIR>/ia.o IA_RX_BUF=<RX_CNT> IA_RX_BUF_SZ=<RX_SIZE> \
|
|
IA_TX_BUF=<TX_CNT> IA_TX_BUF_SZ=<TX_SIZE>
|
|
Where:
|
|
RX_CNT = number of receive buffers in the range (1-128)
|
|
RX_SIZE = size of receive buffers in the range (48-64K)
|
|
TX_CNT = number of transmit buffers in the range (1-128)
|
|
TX_SIZE = size of transmit buffers in the range (48-64K)
|
|
|
|
1. Transmit and receive buffer size must be a multiple of 4.
|
|
2. Care should be taken so that the memory required for the
|
|
transmit and receive buffers is less than or equal to the
|
|
total adapter packet memory.
|
|
|
|
5.2 Turn on ia debug trace
|
|
|
|
When the ia driver is built with the CONFIG_ATM_IA_DEBUG flag, the driver
|
|
can provide more debug trace if needed. There is a bit mask variable,
|
|
IADebugFlag, which controls the output of the traces. You can find the bit
|
|
map of the IADebugFlag in iphase.h.
|
|
The debug trace can be turn on through the insmod command line option, for
|
|
example, "insmod iphase.o IADebugFlag=0xffffffff" can turn on all the debug
|
|
traces together with loading the driver.
|
|
|
|
6. Ia Driver Test Using ttcp_atm and PVC
|
|
|
|
For the PVC setup, the test machines can either be connected back-to-back or
|
|
through a switch. If connected through the switch, the switch must be
|
|
configured for the PVC(s).
|
|
|
|
a. For UBR test:
|
|
At the test machine intended to receive data, type:
|
|
ttcp_atm -r -a -s 0.100
|
|
At the other test machine, type:
|
|
ttcp_atm -t -a -s 0.100 -n 10000
|
|
Run "ttcp_atm -h" to display more options of the ttcp_atm tool.
|
|
b. For ABR test:
|
|
It is the same as the UBR testing, but with an extra command option:
|
|
-Pabr:max_pcr=<xxx>
|
|
where:
|
|
xxx = the maximum peak cell rate, from 170 - 353207.
|
|
This option must be set on both the machines.
|
|
c. For CBR test:
|
|
It is the same as the UBR testing, but with an extra command option:
|
|
-Pcbr:max_pcr=<xxx>
|
|
where:
|
|
xxx = the maximum peak cell rate, from 170 - 353207.
|
|
This option may only be set on the transmit machine.
|
|
|
|
|
|
OUTSTANDING ISSUES
|
|
------------------
|
|
|
|
|
|
|
|
Contact Information
|
|
-------------------
|
|
|
|
Customer Support:
|
|
United States: Telephone: (214) 654-5555
|
|
Fax: (214) 654-5500
|
|
E-Mail: intouch@iphase.com
|
|
Europe: Telephone: 33 (0)1 41 15 44 00
|
|
Fax: 33 (0)1 41 15 12 13
|
|
World Wide Web: http://www.iphase.com
|
|
Anonymous FTP: ftp.iphase.com
|