Puts the carrier into loopback mode or forces it to transmit an alarm indication.
S16 TxT1E1CtrlCarrier ( S16 handle, U8 carrier, U8 loopback, U8 alarmState)
Argument |
Description |
handle |
Handle returned from a previous call to TxT1E1Open for the desired board. |
carrier |
Network interface (carrier trunk number). Valid values: NET_T1A through NET_T1D for PCI and PCI Express TX boards NET_T1A through NET_T1H for CompactPCI TX boards |
loopback |
Loopback mode. Refer to Details for valid values. |
alarmState |
Forces the TX board to start generating or stop generating an alarm on this carrier. Refer to Details for valid values. |
Return value |
Description |
T1E1_DEVICE_ERROR |
Invalid adapter. |
T1E1_INVALID_CARRIER |
Invalid network interface. |
T1E1_INVALID_HANDLE |
Invalid handle. |
T1E1_INVALID_LOOPBACK |
Invalid loopback mode. |
T1E1_NO_RESOURCES |
T1/E1 adapter is not present on the communications processor. |
The following table lists the valid values for loopback:
Value |
Description |
LOOPBACK_NONE |
Normal operating mode (no loopback). |
LOOPBACK_LOCAL |
Local data transmitted is looped back to the receive side. |
LOOPBACK_REMOTE |
Data received from the line is transmitted back onto the line. |
The following table lists the valid values for alarmState:
Value |
Description |
NO_ALARM |
Stop generating all alarms. |
YELLOW_ALARM |
Generate yellow (or distant/far end) alarm. |
BLUE_ALARM |
Generate blue (also called AIS) alarm. |
TS16AIS_ALARM |
Generate timeslot 16 alarm indication signal (E1 only). |
DISTANTMF_ALARM |
Generate distant multiframe alarm (E1 only). |
Refer to T1/E1 carrier alarms for more information.