sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget8/translations/zh_CN/networking/device_drivers/atm/iphasemodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/zh_TW/networking/device_drivers/atm/iphasemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/it_IT/networking/device_drivers/atm/iphasemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/ja_JP/networking/device_drivers/atm/iphasemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/ko_KR/networking/device_drivers/atm/iphasemodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget8/translations/sp_SP/networking/device_drivers/atm/iphasemodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhR/var/lib/git/docbuild/linux/Documentation/networking/device_drivers/atm/iphase.rsthKubhsection)}(hhh](htitle)}(h"ATM (i)Chip IA Linux Driver Sourceh]h"ATM (i)Chip IA Linux Driver Source}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh block_quote)}(hREAD ME FIRST h]h paragraph)}(h READ ME FIRSTh]h READ ME FIRST}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh transition)}(hP--------------------------------------------------------------------------------h]h}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hRead This Before You Begin! h]h)}(hRead This Before You Begin!h]hRead This Before You Begin!}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hP--------------------------------------------------------------------------------h]h}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hhh](h)}(h Descriptionh]h Description}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhhhKubh)}(hZThis is the README file for the Interphase PCI ATM (i)Chip IA Linux driver source release.h]hZThis is the README file for the Interphase PCI ATM (i)Chip IA Linux driver source release.}(hj$hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(h;The features and limitations of this driver are as follows:h]h;The features and limitations of this driver are as follows:}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubh)}(hX- 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. h]h bullet_list)}(hhh](h list_item)}(h+A single VPI (VPI value of 0) is supported.h]h)}(hjMh]h+A single VPI (VPI value of 0) is supported.}(hjOhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjKubah}(h]h ]h"]h$]h&]uh1jIhjFubjJ)}(h{Supports 4K VCs for the server board (with 512K control memory) and 1K VCs for the client board (with 128K control memory).h]h)}(h{Supports 4K VCs for the server board (with 512K control memory) and 1K VCs for the client board (with 128K control memory).h]h{Supports 4K VCs for the server board (with 512K control memory) and 1K VCs for the client board (with 128K control memory).}(hjfhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjbubah}(h]h ]h"]h$]h&]uh1jIhjFubjJ)}(h2UBR, ABR and CBR service categories are supported.h]h)}(hj|h]h2UBR, ABR and CBR service categories are supported.}(hj~hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjzubah}(h]h ]h"]h$]h&]uh1jIhjFubjJ)}(hOnly AAL5 is supported.h]h)}(hjh]hOnly AAL5 is supported.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jIhjFubjJ)}(h#Supports setting of PCR on the VCs.h]h)}(hjh]h#Supports setting of PCR on the VCs.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jIhjFubjJ)}(h,Multiple adapters in a system are supported.h]h)}(hjh]h,Multiple adapters in a system are supported.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jIhjFubjJ)}(hAll 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.h]h)}(hAll 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.h](hAll 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 }(hjhhhNhNubh reference)}(hhttp://www.iphase.com/h]hhttp://www.iphase.com/}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurijuh1jhjubh for details.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jIhjFubjJ)}(h!Only x86 platforms are supported.h]h)}(hjh]h!Only x86 platforms are supported.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK#hjubah}(h]h ]h"]h$]h&]uh1jIhjFubjJ)}(hSMP is supported. h]h)}(hSMP is supported.h]hSMP is supported.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK$hjubah}(h]h ]h"]h$]h&]uh1jIhjFubeh}(h]h ]h"]h$]h&]bullet-uh1jDhhhKhj@ubah}(h]h ]h"]h$]h&]uh1hhhhKhjhhubeh}(h] descriptionah ]h"] descriptionah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hBefore You Starth]hBefore You Start}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjHhhhhhK(ubh)}(hhh](h)}(h Installationh]h Installation}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjYhhhhhK,ubhenumerated_list)}(hhh](jJ)}(hXInstalling 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. h](h)}(h%Installing the adapters in the systemh]h%Installing the adapters in the system}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hjoubh)}(hBTo install the ATM adapters in the system, follow the steps below.h]hBTo install the ATM adapters in the system, follow the steps below.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK0hjoubh)}(hXfa. 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. h]jk)}(hhh](jJ)}(hLogin as root.h]h)}(hjh]hLogin as root.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK2hjubah}(h]h ]h"]h$]h&]uh1jIhjubjJ)}(h.Shut down the system and power off the system.h]h)}(hjh]h.Shut down the system and power off the system.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjubah}(h]h ]h"]h$]h&]uh1jIhjubjJ)}(h/Install one or more ATM adapters in the system.h]h)}(hjh]h/Install one or more ATM adapters in the system.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK4hjubah}(h]h ]h"]h$]h&]uh1jIhjubjJ)}(hConnect 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.h]h)}(hConnect 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.h]hConnect 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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hjubah}(h]h ]h"]h$]h&]uh1jIhjubjJ)}(hPower on and boot the system. h]h)}(hPower on and boot the system.h]hPower on and boot the system.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjubah}(h]h ]h"]h$]h&]uh1jIhjubeh}(h]h ]h"]h$]h&]enumtype loweralphaprefixhsuffix.uh1jjhjubah}(h]h ]h"]h$]h&]uh1hhhhK2hjoubeh}(h]h ]h"]h$]h&]uh1jIhjlhhhhhNubjJ)}(h [ Removed ] h]h)}(h [ Removed ]h]h [ Removed ]}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK:hj"ubah}(h]h ]h"]h$]h&]uh1jIhjlhhhhhNubjJ)}(hXRebuild 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. h](h)}(hRebuild kernel with ABR supporth]hRebuild kernel with ABR support}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj:ubh)}(hc. 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. h]jk)}(hhh](jJ)}(hdReconfigure the kernel, choose the Interphase ia driver through "make menuconfig" or "make xconfig".h]h)}(hdReconfigure the kernel, choose the Interphase ia driver through "make menuconfig" or "make xconfig".h]hlReconfigure the kernel, choose the Interphase ia driver through “make menuconfig” or “make xconfig”.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK@hjaubah}(h]h ]h"]h$]h&]uh1jIhj^ubjJ)}(h7Rebuild the kernel, loadable modules and the atm tools.h]h)}(hj{h]h7Rebuild the kernel, loadable modules and the atm tools.}(hj}hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKBhjyubah}(h]h ]h"]h$]h&]uh1jIhj^ubjJ)}(h5Install the new built kernel and modules and reboot. h]h)}(h4Install the new built kernel and modules and reboot.h]h4Install the new built kernel and modules and reboot.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChjubah}(h]h ]h"]h$]h&]uh1jIhj^ubeh}(h]h ]h"]h$]h&]jjjhjjstartKuh1jjhjZubah}(h]h ]h"]h$]h&]uh1hhhhK@hj:ubeh}(h]h ]h"]h$]h&]uh1jIhjlhhhhhNubjJ)}(hX5Load the adapter hardware driver (ia driver) if it is built as a module a. Login as root. b. Change directory to /lib/modules//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. h](h)}(hGLoad the adapter hardware driver (ia driver) if it is built as a moduleh]hGLoad the adapter hardware driver (ia driver) if it is built as a module}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKEhjubh)}(hXa. Login as root. b. Change directory to /lib/modules//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. h]jk)}(hhh](jJ)}(hLogin as root.h]h)}(hjh]hLogin as root.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubah}(h]h ]h"]h$]h&]uh1jIhjubjJ)}(h6Change directory to /lib/modules//atm.h]h)}(hjh]h6Change directory to /lib/modules//atm.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKHhjubah}(h]h ]h"]h$]h&]uh1jIhjubjJ)}(hRun "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.h]h)}(hRun "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.h]hRun “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.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKIhjubah}(h]h ]h"]h$]h&]uh1jIhjubjJ)}(hXTo 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. h](h)}(hRTo verify that the 'ia' driver is loaded successfully, run the following command::h]hUTo verify that the ‘ia’ driver is loaded successfully, run the following command:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKLhjubh literal_block)}(hcat /proc/atm/devicesh]hcat /proc/atm/devices}hj.sbah}(h]h ]h"]h$]h&]hhuh1j,hhhKOhjubh)}(hhIf the driver is loaded successfully, the output of the command will be similar to the following lines::h]hgIf the driver is loaded successfully, the output of the command will be similar to the following lines:}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKQhjubj-)}(hmItf 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 )h]hmItf 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 )}hjJsbah}(h]h ]h"]h$]h&]hhuh1j,hhhKThjubh)}(h`You can also check the system log file /var/log/messages for messages related to the ATM driver.h]h`You can also check the system log file /var/log/messages for messages related to the ATM driver.}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhjubeh}(h]h ]h"]h$]h&]uh1jIhjubeh}(h]h ]h"]h$]h&]jjjhjjuh1jjhjubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubeh}(h]h ]h"]h$]h&]uh1jIhjlhhhhhNubjJ)}(hIa Driver Configuration h]h)}(hIa Driver Configurationh]hIa Driver Configuration}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKZhj~ubah}(h]h ]h"]h$]h&]uh1jIhjlhhhhhNubeh}(h]h ]h"]h$]h&]jarabicjhjjuh1jjhjYhhhhhK.ubhdefinition_list)}(hhh]hdefinition_list_item)}(hX5.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.o IA_RX_BUF= IA_RX_BUF_SZ= \ IA_TX_BUF= IA_TX_BUF_SZ= 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. h](hterm)}(h$5.1 Configuration of adapter buffersh]h$5.1 Configuration of adapter buffers}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhhhKzhjubh definition)}(hhh](h)}(hThe (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:h]hThe (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:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK]hjubh)}(hX ========= ======= ====== ====== ====== ====== ====== 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.o IA_RX_BUF= IA_RX_BUF_SZ= \ IA_TX_BUF= IA_TX_BUF_SZ= 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. h](h)}(hX========= ======= ====== ====== ====== ====== ====== 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 ========= ======= ====== ====== ====== ====== ====== h]htable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubhthead)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(hTotalh]hTotal}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhj1ubah}(h]h ]h"]h$]h&]uh1j/hj,ubj0)}(hhh]h)}(hRx RAMh]hRx RAM}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhjHubah}(h]h ]h"]h$]h&]uh1j/hj,ubj0)}(hhh]h)}(hTx RAMh]hTx RAM}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhj_ubah}(h]h ]h"]h$]h&]uh1j/hj,ubj0)}(hhh]h)}(hRx Bufh]hRx Buf}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhjvubah}(h]h ]h"]h$]h&]uh1j/hj,ubj0)}(hhh]h)}(hTx Bufh]hTx Buf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhjubah}(h]h ]h"]h$]h&]uh1j/hj,ubj0)}(hhh]h)}(hRx bufh]hRx buf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhjubah}(h]h ]h"]h$]h&]uh1j/hj,ubj0)}(hhh]h)}(hTx bufh]hTx buf}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKbhjubah}(h]h ]h"]h$]h&]uh1j/hj,ubeh}(h]h ]h"]h$]h&]uh1j*hj'ubj+)}(hhh](j0)}(hhh]h)}(hRAM sizeh]hRAM size}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchjubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(hsizeh]hsize}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchjubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(hsizeh]hsize}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchj ubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(hsizeh]hsize}(hj#hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchj ubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(hsizeh]hsize}(hj:hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchj7ubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(hcnth]hcnt}(hjQhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchjNubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(hcnth]hcnt}(hjhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchjeubah}(h]h ]h"]h$]h&]uh1j/hjubeh}(h]h ]h"]h$]h&]uh1j*hj'ubeh}(h]h ]h"]h$]h&]uh1j%hjubhtbody)}(hhh](j+)}(hhh](j0)}(hhh]h)}(h128Kh]h128K}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKehjubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(h64Kh]h64K}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKehjubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(h64Kh]h64K}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKehjubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(h10Kh]h10K}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKehjubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(h10Kh]h10K}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKehjubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(h6h]h6}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKehjubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(hjh]h6}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKehjubah}(h]h ]h"]h$]h&]uh1j/hjubeh}(h]h ]h"]h$]h&]uh1j*hjubj+)}(hhh](j0)}(hhh]h)}(h512Kh]h512K}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhj9ubah}(h]h ]h"]h$]h&]uh1j/hj6ubj0)}(hhh]h)}(h256Kh]h256K}(hjShhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhjPubah}(h]h ]h"]h$]h&]uh1j/hj6ubj0)}(hhh]h)}(h256Kh]h256K}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhjgubah}(h]h ]h"]h$]h&]uh1j/hj6ubj0)}(hhh]h)}(h10Kh]h10K}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhj~ubah}(h]h ]h"]h$]h&]uh1j/hj6ubj0)}(hhh]h)}(h10Kh]h10K}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhjubah}(h]h ]h"]h$]h&]uh1j/hj6ubj0)}(hhh]h)}(h25h]h25}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhjubah}(h]h ]h"]h$]h&]uh1j/hj6ubj0)}(hhh]h)}(h25h]h25}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhjubah}(h]h ]h"]h$]h&]uh1j/hj6ubeh}(h]h ]h"]h$]h&]uh1j*hjubj+)}(hhh](j0)}(hhh]h)}(h1Mh]h1M}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghjubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(h512Kh]h512K}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghjubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(h512Kh]h512K}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghjubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(h10Kh]h10K}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghj(ubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(h10Kh]h10K}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghj?ubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(h51h]h51}(hjYhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghjVubah}(h]h ]h"]h$]h&]uh1j/hjubj0)}(hhh]h)}(h51h]h51}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKghjmubah}(h]h ]h"]h$]h&]uh1j/hjubeh}(h]h ]h"]h$]h&]uh1j*hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]uh1hhhhKahjubh)}(hiThese setting should work well in most environments, but can be changed by typing the following command::h]hhThese setting should work well in most environments, but can be changed by typing the following command:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKjhjubj-)}(hrinsmod /ia.o IA_RX_BUF= IA_RX_BUF_SZ= \ IA_TX_BUF= IA_TX_BUF_SZ=h]hrinsmod /ia.o IA_RX_BUF= IA_RX_BUF_SZ= \ IA_TX_BUF= IA_TX_BUF_SZ=}hjsbah}(h]h ]h"]h$]h&]hhuh1j,hhhKmhjubh)}(hWhere:h]hWhere:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKphjubh)}(hX- 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. h](jE)}(hhh](jJ)}(h7RX_CNT = number of receive buffers in the range (1-128)h]h)}(hjh]h7RX_CNT = number of receive buffers in the range (1-128)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrhjubah}(h]h ]h"]h$]h&]uh1jIhjubjJ)}(h7RX_SIZE = size of receive buffers in the range (48-64K)h]h)}(hjh]h7RX_SIZE = size of receive buffers in the range (48-64K)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshjubah}(h]h ]h"]h$]h&]uh1jIhjubjJ)}(h8TX_CNT = number of transmit buffers in the range (1-128)h]h)}(hj h]h8TX_CNT = number of transmit buffers in the range (1-128)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKthj ubah}(h]h ]h"]h$]h&]uh1jIhjubjJ)}(h9TX_SIZE = size of transmit buffers in the range (48-64K) h]h)}(h8TX_SIZE = size of transmit buffers in the range (48-64K)h]h8TX_SIZE = size of transmit buffers in the range (48-64K)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKuhj ubah}(h]h ]h"]h$]h&]uh1jIhjubeh}(h]h ]h"]h$]h&]j8j9uh1jDhhhKrhjubjk)}(hhh](jJ)}(h9Transmit and receive buffer size must be a multiple of 4.h]h)}(hj< h]h9Transmit and receive buffer size must be a multiple of 4.}(hj> hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKwhj: ubah}(h]h ]h"]h$]h&]uh1jIhj7 ubjJ)}(hCare 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. h]h)}(hCare 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.h]hCare 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.}(hjU hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKxhjQ ubah}(h]h ]h"]h$]h&]uh1jIhj7 ubeh}(h]h ]h"]h$]h&]jjjhjjuh1jjhjubeh}(h]h ]h"]h$]h&]uh1hhhhKrhjubeh}(h]h ]h"]h$]h&]uh1hhhhKahjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1jhhhKzhjubah}(h]h ]h"]h$]h&]uh1jhjYhhhhhNubh)}(h5.2 Turn on ia debug traceh]h5.2 Turn on ia debug trace}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK|hjYhhubh)}(hXWhen 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. h]h)}(hXWhen 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.h]hXWhen 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.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK~hj ubah}(h]h ]h"]h$]h&]uh1hhhhK~hjYhhubjk)}(hhh]jJ)}(hXIa 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= 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= where: xxx = the maximum peak cell rate, from 170 - 353207. This option may only be set on the transmit machine. h](h)}(h%Ia Driver Test Using ttcp_atm and PVCh]h%Ia Driver Test Using ttcp_atm and PVC}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(hFor 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).h]hFor 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).}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubjk)}(hhh](jJ)}(hFor 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.h](h)}(h For UBR test:h]h For UBR test:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(h4At the test machine intended to receive data, type::h]h3At the test machine intended to receive data, type:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubj-)}(httcp_atm -r -a -s 0.100h]httcp_atm -r -a -s 0.100}hj sbah}(h]h ]h"]h$]h&]hhuh1j,hhhKhj ubh)}(h!At the other test machine, type::h]h At the other test machine, type:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubj-)}(h ttcp_atm -t -a -s 0.100 -n 10000h]h ttcp_atm -t -a -s 0.100 -n 10000}hj sbah}(h]h ]h"]h$]h&]hhuh1j,hhhKhj ubh)}(h?Run "ttcp_atm -h" to display more options of the ttcp_atm tool.h]hCRun “ttcp_atm -h” to display more options of the ttcp_atm tool.}(hj# hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubeh}(h]h ]h"]h$]h&]uh1jIhj ubjJ)}(hFor ABR test: It is the same as the UBR testing, but with an extra command option:: -Pabr:max_pcr= where: xxx = the maximum peak cell rate, from 170 - 353207. This option must be set on both the machines. h](h)}(h For ABR test:h]h For ABR test:}(hj; hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj7 ubh)}(hEIt is the same as the UBR testing, but with an extra command option::h]hDIt is the same as the UBR testing, but with an extra command option:}(hjI hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj7 ubj-)}(h-Pabr:max_pcr=h]h-Pabr:max_pcr=}hjW sbah}(h]h ]h"]h$]h&]hhuh1j,hhhKhj7 ubh)}(hwhere:h]hwhere:}(hje hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj7 ubh)}(h5xxx = the maximum peak cell rate, from 170 - 353207. h]h)}(h4xxx = the maximum peak cell rate, from 170 - 353207.h]h4xxx = the maximum peak cell rate, from 170 - 353207.}(hjw hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjs ubah}(h]h ]h"]h$]h&]uh1hhhhKhj7 ubh)}(h-This option must be set on both the machines.h]h-This option must be set on both the machines.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj7 ubeh}(h]h ]h"]h$]h&]uh1jIhj ubjJ)}(hFor CBR test: It is the same as the UBR testing, but with an extra command option:: -Pcbr:max_pcr= where: xxx = the maximum peak cell rate, from 170 - 353207. This option may only be set on the transmit machine. h](h)}(h For CBR test:h]h For CBR test:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(hEIt is the same as the UBR testing, but with an extra command option::h]hDIt is the same as the UBR testing, but with an extra command option:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubj-)}(h-Pcbr:max_pcr=h]h-Pcbr:max_pcr=}hj sbah}(h]h ]h"]h$]h&]hhuh1j,hhhKhj ubh)}(hwhere:h]hwhere:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(h5xxx = the maximum peak cell rate, from 170 - 353207. h]h)}(h4xxx = the maximum peak cell rate, from 170 - 353207.h]h4xxx = the maximum peak cell rate, from 170 - 353207.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubh)}(h4This option may only be set on the transmit machine.h]h4This option may only be set on the transmit machine.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubeh}(h]h ]h"]h$]h&]uh1jIhj ubeh}(h]h ]h"]h$]h&]jjjhjjuh1jjhj ubeh}(h]h ]h"]h$]h&]uh1jIhj hhhNhNubah}(h]h ]h"]h$]h&]jjjhjjjKuh1jjhjYhhhhhKubeh}(h] installationah ]h"] installationah$]h&]uh1hhjHhhhhhK,ubeh}(h]before-you-startah ]h"]before you startah$]h&]uh1hhhhhhhhK(ubh)}(hhh](h)}(hOutstanding Issuesh]hOutstanding Issues}(hj, hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj) hhhhhKubh)}(hhh](h)}(hContact Informationh]hContact Information}(hj= hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj: hhhhhKubj-)}(hXdCustomer 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.comh]hXdCustomer 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}hjK sbah}(h]h ]h"]h$]h&]hhuh1j,hhhKhj: hhubeh}(h]contact-informationah ]h"]contact informationah$]h&]uh1hhj) hhhhhKubeh}(h]outstanding-issuesah ]h"]outstanding issuesah$]h&]uh1hhhhhhhhKubeh}(h]!atm-i-chip-ia-linux-driver-sourceah ]h"]"atm (i)chip ia linux driver sourceah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj/footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(jn jk jEjBj& j# j j jf jc j^ j[ u nametypes}(jn jEj& j jf j^ uh}(jk hjBjj# jHj jYjc j) j[ j: u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages](hsystem_message)}(hhh]h)}(h:Enumerated list start value not ordinal-1: "c" (ordinal 3)h]h>Enumerated list start value not ordinal-1: “c” (ordinal 3)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKuh1j hjZubj )}(hhh]h)}(h:Enumerated list start value not ordinal-1: "6" (ordinal 6)h]h>Enumerated list start value not ordinal-1: “6” (ordinal 6)}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj ubah}(h]h ]h"]h$]h&]levelKtypej sourcehlineKuh1j hjYhhhhhKubetransform_messages] transformerN include_log] decorationNhhub.