About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Documentation / networking / iphase.txt




Custom Search

Based on kernel version 3.16. Page generated on 2014-08-06 21:40 EST.

1	
2	                              READ ME FISRT
3			  ATM (i)Chip IA Linux Driver Source
4	--------------------------------------------------------------------------------
5	                     Read This Before You Begin!
6	--------------------------------------------------------------------------------
7	
8	Description
9	-----------
10	
11	This is the README file for the Interphase PCI ATM (i)Chip IA Linux driver 
12	source release.
13	
14	The features and limitations of this driver are as follows:
15	    - A single VPI (VPI value of 0) is supported.
16	    - Supports 4K VCs for the server board (with 512K control memory) and 1K 
17	      VCs for the client board (with 128K control memory).
18	    - UBR, ABR and CBR service categories are supported.
19	    - Only AAL5 is supported. 
20	    - Supports setting of PCR on the VCs. 
21	    - Multiple adapters in a system are supported.
22	    - All variants of Interphase ATM PCI (i)Chip adapter cards are supported, 
23	      including x575 (OC3, control memory 128K , 512K and packet memory 128K, 
24	      512K and 1M), x525 (UTP25) and x531 (DS3 and E3). See 
25	      http://www.iphase.com/
26	      for details.
27	    - Only x86 platforms are supported.
28	    - SMP is supported.
29	
30	
31	Before You Start
32	---------------- 
33	
34	
35	Installation
36	------------
37	
38	1. Installing the adapters in the system
39	   To install the ATM adapters in the system, follow the steps below.
40	       a. Login as root.
41	       b. Shut down the system and power off the system.
42	       c. Install one or more ATM adapters in the system.
43	       d. Connect each adapter to a port on an ATM switch. The green 'Link' 
44	          LED on the front panel of the adapter will be on if the adapter is 
45	          connected to the switch properly when the system is powered up.
46	       e. Power on and boot the system.
47	
48	2. [ Removed ]
49	
50	3. Rebuild kernel with ABR support
51	   [ a. and b. removed ]
52	    c. Reconfigure the kernel, choose the Interphase ia driver through "make 
53	       menuconfig" or "make xconfig".
54	    d. Rebuild the kernel, loadable modules and the atm tools. 
55	    e. Install the new built kernel and modules and reboot.
56	
57	4. Load the adapter hardware driver (ia driver) if it is built as a module
58	       a. Login as root.
59	       b. Change directory to /lib/modules/<kernel-version>/atm.
60	       c. Run "insmod suni.o;insmod iphase.o"
61		  The yellow 'status' LED on the front panel of the adapter will blink 
62	          while the driver is loaded in the system.
63	       d. To verify that the 'ia' driver is loaded successfully, run the 
64	          following command:
65	
66	              cat /proc/atm/devices
67	
68	          If the driver is loaded successfully, the output of the command will 
69	          be similar to the following lines:
70	
71	              Itf Type    ESI/"MAC"addr AAL(TX,err,RX,err,drop) ...
72	              0   ia      xxxxxxxxx  0 ( 0 0 0 0 0 )  5 ( 0 0 0 0 0 )
73	
74	          You can also check the system log file /var/log/messages for messages
75	          related to the ATM driver.
76	
77	5. Ia Driver Configuration 
78	
79	5.1 Configuration of adapter buffers
80	    The (i)Chip boards have 3 different packet RAM size variants: 128K, 512K and
81	    1M. The RAM size decides the number of buffers and buffer size. The default 
82	    size and number of buffers are set as following: 
83	
84	          Total    Rx RAM   Tx RAM   Rx Buf   Tx Buf   Rx buf   Tx buf
85	         RAM size   size     size     size     size      cnt      cnt
86	         --------  ------   ------   ------   ------   ------   ------
87	           128K      64K      64K      10K      10K       6        6
88	           512K     256K     256K      10K      10K      25       25
89	             1M     512K     512K      10K      10K      51       51
90	
91	       These setting should work well in most environments, but can be
92	       changed by typing the following command: 
93	 
94	           insmod <IA_DIR>/ia.o IA_RX_BUF=<RX_CNT> IA_RX_BUF_SZ=<RX_SIZE> \
95	                   IA_TX_BUF=<TX_CNT> IA_TX_BUF_SZ=<TX_SIZE> 
96	       Where:
97	            RX_CNT = number of receive buffers in the range (1-128)
98	            RX_SIZE = size of receive buffers in the range (48-64K)
99	            TX_CNT = number of transmit buffers in the range (1-128)
100	            TX_SIZE = size of transmit buffers in the range (48-64K)
101	
102	            1. Transmit and receive buffer size must be a multiple of 4.
103	            2. Care should be taken so that the memory required for the
104	               transmit and receive buffers is less than or equal to the
105	               total adapter packet memory.   
106	
107	5.2 Turn on ia debug trace
108	
109	    When the ia driver is built with the CONFIG_ATM_IA_DEBUG flag, the driver 
110	    can provide more debug trace if needed. There is a bit mask variable, 
111	    IADebugFlag, which controls the output of the traces. You can find the bit 
112	    map of the IADebugFlag in iphase.h. 
113	    The debug trace can be turn on through the insmod command line option, for 
114	    example, "insmod iphase.o IADebugFlag=0xffffffff" can turn on all the debug 
115	    traces together with loading the driver.
116	
117	6. Ia Driver Test Using ttcp_atm and PVC
118	
119	   For the PVC setup, the test machines can either be connected back-to-back or 
120	   through a switch. If connected through the switch, the switch must be 
121	   configured for the PVC(s).
122	
123	   a. For UBR test:
124	      At the test machine intended to receive data, type:
125	         ttcp_atm -r -a -s 0.100 
126	      At the other test machine, type:
127	         ttcp_atm -t -a -s 0.100 -n 10000
128	      Run "ttcp_atm -h" to display more options of the ttcp_atm tool.
129	   b. For ABR test:
130	      It is the same as the UBR testing, but with an extra command option:
131	         -Pabr:max_pcr=<xxx>
132	         where:
133	             xxx = the maximum peak cell rate, from 170 - 353207.
134	         This option must be set on both the machines.
135	   c. For CBR test:
136	      It is the same as the UBR testing, but with an extra command option:
137	         -Pcbr:max_pcr=<xxx>
138	         where:
139	             xxx = the maximum peak cell rate, from 170 - 353207.
140	         This option may only be set on the transmit machine.
141	
142	
143	OUTSTANDING ISSUES
144	------------------
145	
146	
147	
148	Contact Information
149	-------------------
150	
151	     Customer Support:
152	         United States:	Telephone:	(214) 654-5555
153	     			Fax:		(214) 654-5500
154				E-Mail:		intouch@iphase.com
155		 Europe:	Telephone:	33 (0)1 41 15 44 00
156				Fax:		33 (0)1 41 15 12 13
157	     World Wide Web:	http://www.iphase.com
158	     Anonymous FTP:	ftp.iphase.com
Hide Line Numbers
About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Information is copyright its respective author. All material is available from the Linux Kernel Source distributed under a GPL License. This page is provided as a free service by mjmwired.net.