TxT1E1CtrlCarrier

Puts the carrier into loopback mode or forces it to transmit an alarm indication.

Prototype

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 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.


Details

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.