CHAPTER 18

Dual Basic Rate ISDN (DBRI) Chip (isdntest)

isdntest verifies the functionality of the ISDN portion of the Dual Basic Rate ISDN (DBRI) chip.

isdntest is actually a set of several subtests. Three main channels exist within an ISDN: D, B1 and B2. In each of the following subtests, unless otherwise indicated, the D channels are in Basic Rate HDLC data mode, the B1 channels are in 56 kbps HDLC data mode, and the B2 channels are in 64-kbps HDLC data mode. The D channel packet size is 256 bytes, and the B channel packet size is 1024 bytes. The packet count is 10 packets. Each channel runs as an independent thread.

TABLE 18-1 isdntest

isdntest Subtests	Description
Local Loopback Test	The local loopback test checks the initial activation state of the Network Termination (NT) and Terminal Equipment (TE) interfaces to make sure they are deactivated. Then it activates each interface using the "force activation" capability of DBRI. Each interface is put into local loopback mode (See FIGURE 18-1). Data residing in host memory is written to each interface, which loops the data back to itself. The data is then read back into host memory and verified. Each channel, D, B1 and B2 is tested (with the exception of the TE D channel, which cannot be tested in local loopback mode). The local loopback test runs internal to the DBRI chip and does not require an NT-to-TE external loopback connector.
Activation/ Deactivation Test	The activation/deactivation test runs through the activation/ deactivation sequence for the NT and then the activation sequence for the TE. The T101 and T103 timers are set to five seconds. This subtest requires an NT-to-TE external loopback connector.

TABLE 18-1 isdntest(Continued)

isdntest Subtests	Description
Remote Loopback Test	The remote loopback capability is tested next. The TE interface is put into remote loopback mode, and the NT transmits data to the TE on all three channels, D, B1 and B2 (See FIGURE 18-2). The TE loops all data back to the NT and reads a copy of it. Data is then verified. Next, the whole process is repeated with the TE transmitting to the NT, which is placed in remote loopback mode. This subtest requires an NT-to-TE external loopback connector.
Read/Write Test	Next, a read/write test is performed on all six ISDN channels: TE D, TE B1, TE B2, NT D, NT B1 and NT B2. The external loopback connector connects each channel on the TE interface to its corresponding channel on the NT (See FIGURE 18-3). A unique data pattern is used for each path. Packets read are compared against packets written. The test is repeated with the B1 channels placed in 64-kbps HDLC data mode and the B2 channels in 56-kbps HDLC data mode. This subtest requires an NT-to-TE external loopback connector.
Packet Size Test	The next subtest is a packet size test. A read/write test, similar to the previous one, is performed with a packet count of 100. Each packet transmitted and received is a unique size, computed randomly. This subtest requires an NT-to-TE external loopback connector.
Data Path Test	The last subtest is a data path test. Using the ISDN_SET_CHANNEL ioctl, data is routed through a series of short pipe interconnects within DBRI (See FIGURE 18-4). This subtest requires an NT-to-TE external loopback connector.

FIGURE 18-1 isdntest

FIGURE 18-2 isdntest

FIGURE 18-3 isdntest

FIGURE 18-4 isdntest

isdntest Options

FIGURE 18-5 isdntest

TABLE 18-2 isdntest

isdntest Options	Description
Packet Size	The byte size of the B channel packets. The default size is 1024 bytes for the B channels and 256 for the D channels. The maximum packet size is 8186 bytes for the B channels, and the minimum packet size is 1 byte. The D channel packet size is set to 256, except during the packet size test, when it is set to random values between 1 and 256
Packet Count	How many packets are to be transmitted and received for all channels. The default packet count is 10 packets. The maximum packet count is 100 packets

isdntest Test Modes

This test only supports Functional Test mode.

isdntest Command Line Syntax

/opt/SUNWvts/bin/isdntest standard_arguments -o size=packet_size,
count=packet_count

TABLE 18-3 isdntest

Argument	Explanation
size=packet_size	The byte size of the B channel packets. The B channel default size is 1024 bytes. The D channel default size is 256 bytes. The B channel maximum packet size is 8186 packets. The B channel minimum packet size is 1 packet. The D channel packet size is 256 (except during the packet size test, when it is set to random values between 1 and 256).
count=packet_count	How many packets are to be transmitted and received for all channels The default count is 10 packets. The Maximum packet count is 100 packets.

isdntest Error Messages

TABLE 18-4 isdntest

Error Message	Probable Cause(s)	Recommended Action
6000 ISDN_PARAM_SET ioctl failed for device_name. (error_message)
6001 ISDN_SET_LOOPBACK ioctl failed for device_name. (error_message)
6002 ISDN_RESET_LOOPBACK ioctl failed for device_name. (error_message)
6003 ISDN_SET_CHANNEL ioctl() failed for device_name. (error_message)
6004 Unable to open device_name. (error_message)
6005 poll() failed. (error_message)
6006 Invalid packet size: S=number. Max is number
6007 Invalid packet count: C=number. Max is number
6008 ISDN_SET_FORMAT, ioctl() failed for ISDN_CHAN_TE_D during device_name. (error_message)
6009 ISDN_SET_FORMAT, ioctl() failed for ISDN_CHAN_NT_D during device_name. (error_message)
6010 ISDN_SET_FORMAT, ioctl() failed for ISDN_CHAN_TE_B1 during device_name. (error_message)
6011 ISDN_SET_FORMAT, ioctl() failed for ISDN_CHAN_NT_B1 during device_name. (error_message)

TABLE 18-4 isdntest(Continued)

	Error Message	Probable Cause(s)	Recommended Action
6012	Mode is unknown: number
6013	ISDN_SET_FORMAT, ioctl() failed for ISDN_CHAN_TE_B2 during device_name. (error_message)
6014	ISDN_SET_FORMAT, ioctl() failed for ISDN_CHAN_NT_B2 during device_name. (error_message)
6015	Unable to open device_name during device_state. (error_message)
6016	Unable to close device_name during device_state. File descriptor = number (error_message)
6017	Initial state of string is ISDN_ACTIVATED
6018	Initial state of string is unknown: number
6019	ISDN_PARAM_SET ioctl() parameter failed for device_name. (error_message)
6020	ISDN_ACTIVATION_STATUS ioctl() failed for device_name. (error_message)
6021	getmsg() failed. (error_message)
6022	Invalid message returned from getmsg()
6023	string ioctl() failed for device_name. (error_message)
6024	\ndevice_name.\nTE state = string\tNT state = string
6025	shmget() failed.(error_message)
6026	Initial state unknown: number
6027	string