Main Page Modules Alphabetical List Data Structures File List Data Fields Globals
IXP425 ATM Codelet (IxAtmCodelet) API
[IXP425 Codelets]
This codelet demonstrates an example implementation of a working Atm driver that makes use of the AtmdAcc component, as well as demonstrating how the lower layer IxAtmdAcc component can be used for configuration and control.
More...
Detailed Description
This codelet demonstrates an example implementation of a working Atm driver that makes use of the AtmdAcc component, as well as demonstrating how the lower layer IxAtmdAcc component can be used for configuration and control.
This codelet also demonstrates an example implementation of OAM F4 Segment, F4 End-To-End (ETE), F5 Segment and F5 ETE loopback that makes use of the AtmdAcc component, as well as demonstrating how the lower layer IxAtmdAcc component can be used for configuration and control.
Disclaimer Note: For Linux Platform
- When 'insmod' the ATM codelet object, it will begin to send AAL packets and display the transmit and receive statistics every 15 second
- Unable to 'rmmod'. User will not be able to type anything in the command line due to: a) the return carriage indicating that the task is sending AAL packets, and b) the failure to kill the thread which is used to transmit AAL packets
VxWorks User Guide
ixAtmCodeletMain() function is used as a single point of execution for Atm Codelet, which allows the user to enter selections for different type of modes and AAL type. The function also allows the user to execute OAM ping either in UTOPIA or Software Loopback mode. In all modes, the transmit and receive statistics will be displayed every 15secs.
Usage :
ixAtmCodeletMain (modeType, aalType)
modeType:
0 = Utopia Loopback Mode
1 = Software Loopback Mode
2 = Remote Loopback Mode
3 = F4 & F5 cells OAM Ping in UTOPIA Loopback mode
4 = F4 & F5 cells OAM Ping in Software Loopback mode
aalType:
1 = AAL5
2 = AAL0_48
3 = AAL0_52
Linux User Guide
The idea of using the ixAtmCodeletMain() as a single point of execution for ATM codelet is similar in VxWorks User Guide. It also allows user to execute OAM ping. Similarly, all modes will display the transmit and receive statistics every 15secs. This function will be executed when user issue'insmod' in command prompt
Usage :
# insmod ixp400_codelets_atm.o modeType= aalType=
Where x:
0 = Utopia Loopback Mode
1 = Software Loopback Mode
2 = Remote Loopback Mode
3 = F4 & F5 cells OAM Ping in UTOPIA Loopback mode
4 = F4 & F5 cells OAM Ping in Software Loopback mode
Where y:
1 = AAL5
2 = AAL0_48
3 = AAL0_52
Note for VxWorks and Unix Usage:
- IX_ATM_CODELET_SWLOOPBACK_PORT_RATE and IX_ATM_CODELET_REMOTELOOPBACK_PORT_RATE defined in this header file allows the user to change the port rate (in cells/sec) accordingly. The port rate works when using ADSL connection. The default port rate for both loopback is set to 1962cells/sec (~832kbps)
- IX_ATMCODELET_START_VPI and IX_ATMCODELET_START_VCI defined in this header file can be modified by the user. By default, VPI and VCI are set to 1 and 32 respectively
- IX_ATMCODELET_NUM_AAL5_CHANNELS, IX_ATMCODELET_NUM_AAL0_48_CHANNELS, and IX_ATMCODELET_NUM_AAL0_52_CHANNELS can be changed by the user. By default, they are set to 32 channels
- OAM Ping in UTOPIA Loopback mode will perform the following sequence in forever loop: i) Send AAL packets, ii) Display the transmit and receive statistics, and iii) Perform OAM Ping F4 and F5 (ETE and Segment) and display OAM statistics
- OAM Ping in Software Loopback will perform the following sequence in forever loop: i) Display the transmit and receive statistics, and ii) OAM Ping F4 and F5 (ETE and Segement) and display OAM Statistics
ATM Features
- An interface is provided to setup Aal5 or Aal0 (48 or 52 bytes) Transmit and Recieve VCs on one port. Only UBR VCs can be setup. When a channel is setup using this interface both a Transmit and a Recieve VC is created.
- An interface is provided to remove all registered Aal5/Aal0 VCs.
- Both remote and local loopback of Aal5 or Aal0 is provided by this codelet. Local loopback refers to loopback provided by the UTOPIA interface. In local loopback packets generated by the IXP425 are looped back to the Atm driver by the UTOPIA hardware. Software loopback refers to the software looping all packets received on the wire back out onto the wire. Remote loopback refers to where the far end is expected to performa a software loopback, i.e. any packets sent by the codelet are expected to be looped back by the far end into the codelet.
- Both interrupt and polled mode of operation is provided by this codelet.
- An interface is provided to send Aal5 SDUs specifying the sdu size and the number of Aal5 sdus to send.
- An interface is provided to send Aal0 packets specifying the packet size and the number of Aal0 packets to send.
- Both the Transmit port rate and the Recieve port rate can be modified. The Tx port rate is used by IxAtmSch in performing the shaping functions The Rx port rate is not used by any component.
- An interface is provided to allow the querying of the ATM ports and registered VCs.
IXP425 ATM Components used by this codelet
- IxAtmdAcc. This component is the low level interface by which AAL packets get transmitted to, and received from the UTOPIA bus.
IXP425 ATM Codelet components used by this codelet
- IxAtmSch. This component demonstrates an ATM Traffic Shaper implementation. IxAtmdAcc gets scheduling information from this component.
- IxAtmm. This component provides ATM port and VC management facilities. This component also manages the configuration of the UTOPIA co-processor
IxAtmCodelet modes of operation
This codelet can be initialised to operate in one of three configurations.
- IX_ATMCODELET_UTOPIA_LOOPBACK. In this mode the UTOPIA interface will loopback all traffic transmitted.
Buffer management In this mode a simple buffering mechanism is used; mbufs are allocated from the vxWorks pool as needed for RxFree replenishing/Tx and are returned to the vxWorks pool for TxDone/Rx
Interrupt/Task based processing In this mode of operation the IxQMgrDispatcher is hooked to interupts. This means that TxDone/RxLo will be perfomed from a task level and IxAtmdAcc Tx processing/RxHi and RxFree will be precessed from an interrupt level.
Sending Aal5 PDUs In this mode of operation an interface is available to send Aal5 PDUs of specified size in bytes.
Sending Aal0 Packets In this mode of operation an interface is available to send Aal0 packets of specified size in cells.
- IX_ATMCODELET_REMOTE_LOOPBACK. In this mode packets are sent and are expected to be looped back on the remote end.
- IX_ATMCODELET_SOFTWARE_LOOPBACK. In this mode of operation all traffic sent are looped back to receive in the IXP425 device.
Buffer management In this mode a more complex buffering mechanism is used; mbufs are allocated from the vxWorks pool and stored in a software queue. These mbufs are fetched from this software queue as needed for RxFree replenishing/Tx and are returned to the software queue for TxDone/Rx.
Interrupt/Task based processing In this mode of operation the IxQMgrDispatcher is called form a task every 1 msec. This means that TxDone/RxLo/IxAtmdAcc Tx processing/RxHi and RxFree will be processed from a task level.
Sending PDUs/Packets This mode of operation does not provide an interface for sending Aal5 PDUs/Aal0 Packets.
IxAtmCodelet sub-components
+--------------------+
| AtmCodelet |
+--------------------+
| |
,-----' `-----,
| |
V V
+------------+ +------------+
| RxTx | | SwLoopback |
+------------+ +------------+
AtmCodelet This implements the API functions.
RxTx This sub-component implements the IX_ATMCODELET_UTOPIA_LOOPBACK and IX_ATMCODELET_REMOTE_LOOPBACK modes of operation.
SwLoopback This sub-component implements the IX_ATMCODELET_SOFTWARE_LOOPBACK mode operation.
BufMan This sub-component implements the intefaces used internally for getting and returning vxWorks mbufs.
UTOPIA Recieve and Transmit PHY addresses In this codelet UTOPIA Phy Addresses are assigned numbers starting at UTOPIA_PHY_ADDR and are incremented for each port used. These addresses _WILL_ need to be changed depending on the hardware setup.
OAM Features
- An interface is provided to configure the access layer to enable OAM traffic.
- OAM Loopback responses are sent automatically on receipt of OAM F4 and F5 parent Segment and ETE loopback cells, i.e. externally initiated OAM Loopbacks.
- Interfaces are provided to initiate an OAM F4/F5 Segment or ETE Loopback, see ITU-610. One loopback can be initiated at a time, this is to keep the codelet simple, this is independant of sending responses to parent loopback cells received.
- An interface is provided to query OAM traffic statistics.
OAM uses the following IXP425 ATM Components
- IxAtmdAcc. This component is the low level interface by which OAM cells get transmitted to, and received from the UTOPIA bus.
- IxAtmm. This component provides ATM port and VC management facilities. This component also contains the configuration of the UTOPIA co-processor.
- AtmUtils. This codelet provides VC setup facilities using IxAtmdAcc.
IMPORTANT!!!
If validation board is used (instead of using IXDP425 development board), then uncomment VALIDATION_PLATFORM_USED flag in component.mk
Define Documentation
#define IX_ATM_CODELET_REMOTELOOPBACK_PORT_RATE
|
|
|
Port rate for Remote Looopback.
By default the port rate for remote loopback is set at PCR = 1962 cells/sec (832kbps)
Definition at line 348 of file IxAtmCodelet.h. |
#define IX_ATM_CODELET_SWLOOPBACK_PORT_RATE
|
|
|
Port rate for Software Loopback.
By default the port rate for software loopback is set at PCR = 1962 cells/sec (832kbps)
Definition at line 335 of file IxAtmCodelet.h. |
#define IX_ATMCODELET_NUM_AAL0_48_CHANNELS
|
|
#define IX_ATMCODELET_NUM_AAL0_52_CHANNELS
|
|
#define IX_ATMCODELET_NUM_AAL5_CHANNELS
|
|
#define IX_ATMCODELET_START_VCI
|
|
|
The first VCI value.
By default the VCI is set to 2
Definition at line 370 of file IxAtmCodelet.h. |
#define IX_ATMCODELET_START_VPI
|
|
|
The first VPI value.
By default the VPI is set to 1
Definition at line 359 of file IxAtmCodelet.h. |
Function Documentation
|
This function is used as a single point of execution for ATM codelet.
- Parameters:
-
IxAtmCodeletMode modeType | The type of mode use, either Utopia, Software or Remote loopback mode. It also consists of OAM Ping in Utopia or Software loopback mode. |
IxAtmCodeletAalType aalType | The type of AAL: AAL5 or AAL0 with 48- or 52-bytes cell |
- Returns:
- IX_SUCCESS Mode and AAL type successfully setup IX_FAIL Invalid AAL or mode type, or error in setting up the modes
|
|