Serial interface configuration commands

serial

Syntax

serial

Context

config>port

Description

This command enables the context to configure parameters for an RS-232 serial port on the node.

Default

n/a

rs232

Syntax

rs232

Context

config>port>serial

Description

This command enables the context to configure RS-232 parameters for a serial port.

Default

n/a

character-length

Syntax

character-length {6 | 7 | 8}

Context

config>port>serial>rs232

Description

This command configures the number of data bits used to transmit a character. The value for this command cannot be 8 if the value for parity is anything other than no parity (that is, anything other than none) and the value for stop-bits is 2.

Default

8

Parameters

6

specifies six bits in a character

7

specifies seven bits in a character

8

specifies eight bits in a character

control-lead

Syntax

control-lead {input | output}

Context

config>port>serial>rs232

Description

This command enables access to the context to configure the input and output leads that carry control signals. Control signals provide the handshaking for call setup, teardown, and synchronization.

Default

n/a

input

Syntax

input

Context

config>port>serial>rs232>control-lead

Description

This command enables access to the context to configure the input control leads.

Default

n/a

dtr-dsr

Syntax

dtr-dsr {high | low}

Context

config>port>serial>rs232>control-lead>input

Description

This command configures the Data Terminal Ready (DTR) or Data Set Ready (DSR) input control lead. For a DCE device, the input signal is DTR. For a DTE device, the input signal is DSR. This command is supported on the 7705 SAR-Hm only.

Default

high

Parameters

high

the input control lead is assumed to be on

low

the input control lead is assumed to be off

rts-dcd

Syntax

rts-dcd {high | low}

Context

config>port>serial>rs232>control-lead>input

Description

This command configures the Request To Send (RTS) or Data Carrier Detect (DCD) input control lead. For a DCE device, the input signal is RTS. For a DTE device, the input signal is DCD. This command is supported on the 7705 SAR-Hm only.

Default

high

Parameters

high

the input control lead is assumed to be on

monitor

Syntax

monitor

Context

config>port>serial>rs232>control-lead

Description

This command enables access to the context to monitor the input control leads. When monitoring is enabled on a control lead, the node polls the status of the control lead every second. Any change in state of the control lead causes an alarm to be raised. This functionality provides an indication to the operator of a problem in the DTE-to-DCE path; for example, it can indicate that the far-end device is disconnected.

Monitoring is enabled on a per-lead basis.

Default

n/a

dtr-dsr

Syntax

dtr-dsr off

Context

config>port>serial>rs232>control-lead>monitor

Description

This command enables monitoring on the Data Terminal Ready (DTR) or Data Set Ready (DSR) input control lead. For a DCE device, the input control lead is DTR. For a DTE device, the input control lead is DSR. This command is supported on the 7705 SAR-Hm only.

Default

off

Parameters

off

monitoring is disabled on the lead

rts-dcd

Syntax

rts-dcd off

Context

config>port>serial>rs232>control-lead>monitor

Description

This command enables monitoring on the Request To Send (RTS) or Data Carrier Detect (DCD) input control lead. For a DCE device, the input control lead is RTS. For a DTE device, the input control lead is DCD. This command is supported on the 7705 SAR-Hm only.

Default

off

Parameters

off

monitoring is disabled on the lead

output

Syntax

output

Context

config>port>serial>rs232>control-lead

Description

This command enables access to the context to configure the output control leads.

Default

n/a

cts-alb

Syntax

cts-alb {high | low}

Context

config>port>serial>rs232>control-lead>output

Description

This command configures the Clear To Send (CTS) or Analog Loopback (ALB) output control lead. For a DCE device, the output signal is CTS. For a DTE device, the output signal is ALB.

Default

high

Parameters

high

the output control lead is forced on

low

the output control lead is forced off

dcd-rts

Syntax

dcd-rts {high | low}

Context

config>port>serial>rs232>control-lead>output

Description

This command configures the Data Carrier Detect (DCD) or Request To Send (RTS) output control lead. For a DCE device, the output signal is DCD. For a DTE device, the output signal is RTS. This command is supported on the 7705 SAR-Hm only.

Default

high

Parameters

high

the output control lead is forced on

low

the output control lead is forced off

ri-rdl

Syntax

ri-rdl {high | low}

Context

config>port>serial>rs232>control-lead>output

Description

This command configures the Ring Indicator (RI) or Remote Digital Loopback (RDL) output control lead. For a DCE device, the output signal is RI. For a DTE device, the output signal is RDL. This command is supported on the 7705 SAR-Hm only.

Default

high

Parameters

high

the output control lead is forced on

low

the output control lead is forced off

hold-time

Syntax

hold-time {[up hold-time-up] [down hold-time-down]}

no hold-time

Context

config>port>serial>rs232

Description

This command configures the serial link dampening timers in 100s of milliseconds, which guards against reporting excessive interface transitions. When implemented, subsequent transitions of the interface from one state to another are not advertised to upper layer protocols until the configured timer has expired.

Default

no hold-time

Parameters

hold-time-up

the hold-timer for link-up event dampening. A value of zero (0) indicates that an up transition is reported immediately.

Values

0 to 100 (in 100s of milliseconds)

hold-time-down

the hold-timer for link-down event dampening. A value of zero (0) indicates that a down transition is reported immediately.

Values

0 to 100 (in 100s of milliseconds)

loopback

Syntax

loopback bidir-e

no loopback

Context

config>port>serial>rs232

Description

This command puts the specified interface into a loopback mode. The corresponding interface must be in a shutdown state in order for the loopback mode to be enabled.

In the serial context, it is possible to configure a a bidirectional loopback E. A bidirectional loopback is a circuit loopback that loops traffic from the line back to the line. Bidirectional loopback E takes place on the data device side of the adapter card, and is closer to the line.

This command is not saved in the system configuration between boots.

The no form of this command disables the loopback on the interface.

Default

no loopback

Parameters

bidir-e

configures a bidirectional loopback E

parity

Syntax

parity {odd | even | mark | space}

no parity

Context

config>port>serial>rs232

Description

This command configures the parity bit in a character. Parity is an error detection method that adds an extra bit to each character, based on the number of 0s or 1s in the character.

The value for this command must be no parity (that is, none) if the character-length value is 8 and the stop-bits value is 2.

The no form of this command disables the parity bit in a character.

Default

no parity

Parameters

odd

the parity bit is set to 0 or 1 to make the total number of 1s in the set of bits odd

even

the parity bit is set to 0 or 1 to make the total number of 1s in the set of bits even

mark

the parity bit is present but not used and is always set to 1

space

the parity bit is present but not used and is always set to 0

speed

Syntax

speed {600 | 1200 | 2400 | 4800 | 9600 | 19200 | 38400 | 57600 | 115200}

Context

config>port>serial>rs232

Description

This command configures the speed of the interface. The speed also determines the DS0 timeslots assigned to the channel group.

Default

9600

Parameters

600

sets the link speed to 600 b/s

1200

sets the link speed to 1200 b/s

2400

sets the link speed to 2400 b/s

4800

sets the link speed to 4800 b/s

9600

sets the link speed to 9600 b/s

19200

sets the link speed to 19 200 b/s

38400

sets the link speed to 38 400 b/s

57600

sets the link speed to 57 600 b/s

115200

sets the link speed to 115 200 b/s

stop-bits

Syntax

stop-bits {1 | 2}

Context

config>port>serial>rs232

Description

This command configures the number of stop bits used to signify the end of a character.

This command cannot have a value of 2 if the character-length value is 8 and the parity value is anything other than no parity (that is, anything other than none).

Default

1

Parameters

1

specifies one stop bit in a character

2

specifies two stop bits in a character