PBXDA PCI serial lines adapter

Table of Contents

General description

PBXDA is a PCI serial lines adapter based on the AccelePort 2R 920, 4R 920, 8R 920 and Xem DIGI adapters.

Loading PBXDA serial lines adapter

Syntax for loading PBXDA (AccelePort 2r 920) serial lines adapter:

load PBXDA/DIGI <name>

Syntax for loading PBXDA_BA (AccelePort 4r 920)  serial lines adapter:

load PBXDA_BA/DIGI <name>

Syntax for loading PBXDA_BB (AccelePort 8r 920) serial lines adapter:

load PBXDA_BB/DIGI <name>

Syntax for loading PBXDA_AC (AccelePort Xem) serial lines adapter:

load PBXDA_AC/DIGI <name>

Example:

load PBXDA/DIGI TXA

The adapter instance name ("TXA" in the example above) is used then for parametrization, for example:

set TXA line[2]="/dev/tty0"

The numbers in the square brackets represent line number on the virtual PBXDA adapter starting from 0.

Controller typeMaximum number of lines
PBXDA 2
PBXDA_BA4
PBXDA_BB8
PBXDA_AC16

All the parameters described in the "Placement of peripheral devices on PCI bus", such as "bus", "device", "function", "irq", "irq_bus" are applicable for PBXDA controller.


DIGI drivers for OpenVMS and Tru64 are sensitive to PBXDA location on PCI, therefore it is recommended to fix PBXDA location with explcit configuration.

Example:

load PBXDA TXA bus=pci_1 device=4 function=0



Configuration parameters

The PBXDA serial lines adapter emulation has the following configuration parameters:

port

Parameterport
TypeText String
Value

Specifies a local port for incoming telnet connections

By default the "port" configuration option is not specified.

Syntax:

port[line-number]=<local port>

Example:

set TXA port[2]=17060


line

Parameterline
TypeText string
Value

A defined TTY port on host system:

  • "/dev/tty<N>" for virtual console
  • "/dev/ttyS<N>" for onboard serial lines
  • "/dev/ttyUSB<N>" for modem or USB serial lines adapters
  • "/dev/tty<XXX>" for proprietary (depending on a driver) devices such as DIGI or MOXA cards

Example:

set TXA line[2]="/dev/ttyS1"

If a virtual console "/dev/tty<N>" is going to be used, it must be freed from all the processes running on it at first. Refer to your OS documentation for details, also some description on how to do it is available here.

A specific account for running CHARON ("charon") does not allow usage of physical consoles "/dev/tty<N>" as CHARON consoles. If you plan to map CHARON console to "/dev/tty<N>" use only "root" account for CHARON running.


log

Parameterlog
TypeText string
Value

The optional log file or directory name is where the log file for the serial line is stored.

Example:

set TXA log[0]="/charon/logs/txa0.log"

"ttyY" notation specifics

Note that the "ttyY" notation can have different forms depending on the nature of the device used:

MappingTypeCommentary

"/dev/tty<N>"

where N is from 0 to 11

Linux virtual tty

Those tty devices must be free from the Linux "getty/mgetty" and similar programs (specified in "/etc/inittab")

Example:

"/dev/tty1"

"/dev/ttyS<N>"

where N is a number

Onboard serial lines

Example:

"/dev/ttyS1"

"/dev/tty<XXX>"

where XXX is a complex letter/number notation

Proprietary (depending on a driver) devices 

Example for a first port of a MOXA card:

"/dev/ttyR01"

Example for a first port of a DIGI card:

"/dev/ttyaa"

"/dev/ttyUSB<N>"

where N is a number

Modem or USB serial lines adapters

Example:

"/dev/ttyUSB1"



© Stromasys, 1999-2024  - All the information is provided on the best effort basis, and might be changed anytime without notice. Information provided does not mean Stromasys commitment to any features described.