...
| Parameter | Type | Description | ||
|---|---|---|---|---|
| line | Text string | A defined TTY port on host system:
| ||
| baud | Numeric | Forces the baud rate of the corresponding TTY port to a specified value.The variety of supported values depends on the underlying physical communication resource (TTY port). The most widely used values are: 300, 1200, 9600, 19200, 38400.Example:
| ||
| break_on | Text string | Specifies what byte sequences received over the physical serial line will trigger a HALT command.This parameter works only for the console line (for the one UART line and "line[3]" of QUART).Specify the following values: "Crtl-P", "Break" or "none" ("none" disables triggering HALT condition).Example:
| ||
| stop_on | Text string | Specifies what byte sequences received over the physical serial line will trigger a STOP condition. The STOP condition causes CHARON-VAX to exit.Specify the value as the following: “F6” or “none” ("none" disables triggering STOP condition).Example:
<ESC>[17~" sequence. Terminals usually send these sequences on pressing F6 button | ||
| log | Text string | A string specifying a file name to store content of console sessions or a directory where log files for each individual session will be stored.If an existing directory is specified, CHARON-VAX automatically enables creation of individual log files for each session. If the "log" parameter is omitted, CHARON-VAX does not create a console log.Examples:
|
load physical_serial_line OPA0 |
virtual_serial_line
| Parameter | Type | Description | ||
|---|---|---|---|---|
| host | Text string | A remote host’s IP address or a host name (and optional remote TCP/IP port number) for the virtual serial line connection. If omitted, the virtual serial line does not initiate a connection to the remote host and will listen for incoming connection requests.Specify the value in the following form:
If "<port-no>" is not specified, the virtual serial line uses the TCP/IP port number specified by the "port" parameter (see below). | ||
| port | Numeric | TCP/IP port number for the virtual serial line. A virtual serial line always listens on this port for incoming connection requests. | ||
| break_on | Text string | Specifies what byte sequences received over virtual serial line must trigger HALT command.This parameter works only for console line (for CHARON-VAX it is the only line of UART and the "line[3]" of QUART).Specify the following values: "Crtl-P", "Break" or "none" to disable triggering HALT condition.Example:
| ||
| stop_on | Text string | Specifies what byte sequences received over the virtual serial line will trigger a STOP condition. The STOP condition causes CHARON-VAX to exit.Specify the value as the following: “F6” or “none” ("none" disables triggering STOP condition).Example:
| ||
| log | Text string | A string specifying a file name to store content of console sessions or a directory where log files for each individual session will be stored.If an existing directory is specified, CHARON-VAX automatically enables creation of individual log file for each session. If the "log" parameter is omitted CHARON-VAX does not create any console log.Examples:
|
load virtual_serial_line OPA0 |
Use the combination of "port" and "host" parameters as follows to connect a 3rd party terminal emulator or similar program.
load virtual_serial_line/chserial TTA0 host="192.168.1.1" port=10000In this example CHARON-VAX connects to port 10000 of a host with TCP/IP address "192.168.1.1" and at the same time it accepts connections on local port 10000.It is possible to specify a port on a remote host (note that CHARON always acts as a server). The syntax is:
load virtual_serial_line/chserial TTA0 host="192.168.1.1:20000" port=10000
load virtual_serial_line/chserial TXA0 port=5500 host="B" |
load virtual_serial_line/chserial TXA0 port=5500 host="A" |
operator_console
| Parameter | Type | Description | |
|---|---|---|---|
| break_on, stop_on | Text string | These two parameters are hardcoded to the following values and cannot be changed:
|
Example:
load operator_console OPA0 |
"ttyY" notation specifics
Note that the "ttyY" notation can have different forms depending on the nature of the device used:
- Linux virtual tty (switchable by alt+F1-atl+F12 on a text console) – are represented as "/dev/ttyN" where N is from 0 to 11. Those tty devices must be free from the Linux "getty/mgetty" and similar programs (specified in "/etc/inittab")
Onboard serial lines are represented as "/dev/ttySN" where N is a number. For example "/dev/ttyS1"
Proprietary (depending on a driver) devices are represented as "/dev/ttyXXX" where XXX is a complex letter/number notation. For example "/dev/ttyR01" is the first port of a MOXA card and "/dev/ttyaa" stands for the first port of a DIGI card.
Linking serial controller port to host connection
The final step of CHARON-VAX serial line configuration is the association of each loaded serial port with a CHARON-VAX host connection instance as follows:
set <serial controller instance name> line[<line number>]=<serial line instance name> |
Example:
set quart line[0]=TTA0 |
This command connects the first serial line ("line[0]") of a "QUART" serial line controller to a CHARON-VAX connection instance named "TTA0". As explained earlier, TTA0 may be a virtual serial line connected to port, or a physical serial line connected to host serial port or virtual terminal. In an example below, the command connects the sixth serial line of a previously loaded controller (named "TXA") to "TTA1". "TTA1" could be defined, for example, as a physical serial line connected to COM/TTY port:
set TXA line[5]=TTA1 |