Anchor

	TOC
	TOC

Include Page

	KBCOMMON:KB-CSSstyle
	KBCOMMON:KB-CSSstyle

...

Include Page

	KBCOMMON:DOC-GoToToc
	KBCOMMON:DOC-GoToToc

Div

class	pagebreak

Console

CHARON-VAX offers a one- or four-port serial console depending on the specified VAX model. The one line serial line controller is identified in CHARON-VAX with the name UART. The four serial lines controller is identified in CHARON-VAX with the name QUART.

...

CHARON-VAX console ports can be configured to connect to an external terminal via the host system COM/TTY port or can be connected via TCP/IP.

alias

This applies to new syntax only, not if "load ..." is used.

Parameterrts

Parameter alias

Type Identifier

Value

The main purpose of this parameter is migration from old CHARON systems (which do not have the described implementation of consoles) to the current design, since it allows retaining the original name used for parametrization, since the rest of the parameters stay the same in both implementations.

Note
If the "alias" parameter is not specified CHARON log file will miss the name for the given console, for example " : Connected. Remote 127.0.0.1:63516" will be displayed instead of "OPA0 : Connected. Remote 127.0.0.1:63516". So it is always recommended to specify the "alias" parameter.

Example:

set UART alias=OPA0

This parameter is optional as Charon-VAX presets UART's alias to OPA0

rts

Example:

set UART alias=OPA0

This parameter is optional as Charon-VAX presets UART's alias to OPA0

rts

Parameter	rts[<line>]
Type	Text string
Value	"On" - assert RTS (Request To Send) signal "Off" - clear RTS signal (default) "DTR" - assert RTS signal as soon as DTR signal is asserted ( Applicable only for QUART )

Div

class	pagebreak

dsr

Value
Parameter	dsr[<line>]
Type	Text string

dsr

Parameter	dsr[<line>]
Type	Text string
Value	"On" - assert RTS (Request To Send) signal always reports DSR signal asserted "Off" - clear RTS signal (default) always reports DSR signal deasserted " DTR DSR" - assert RTS signal as soon as DTR signal is asserted ( Applicable only for QUART )

...

class	pagebreak

"On" - always reports DSR signal asserted
"Off" - always reports DSR signal deasserted
"DSR" - use DSR signal of physical serial line (if configured)
"CD", "use DSR signal of physical serial line (if configured)
"CD", "DCD", "RLSD" - use CD (carrier detect) signal of physical serial line (if configured)

Info
This parameter is applicable only for line "2" of QUART. UART has no such parameter.

...

Parameter line

Type Text string

Value

A defined TTY port on host system:

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

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

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

...

Parameter log_flush_period

Type Numeric

Value

<period-in-seconds>

Defines a period of flushing log to disk.

Default period is 60 seconds (it means that every minute log file is flushed to disk)

Example:

set OPA0 log_flush_period=30

Div

class	pagebreak

connection_override

Parameter	connection_override
Type	text string
Value	"enable" Allows new connection to override existing connection, if any. Enabled connection override on OPA0 allows to intercept virtual serial console. When emulator detects new connection request on the port (10003 for the below example), it closes old connection, if any, and switches to the new one. Example: `set OPA0 port = 10003 connection_override = enable` This is implemented only for serial lines using the new syntax, not for lines using the legacy syntax (`load virtual_serial_line ...`).

access_control

Available only since build 204-13

Parameter	access_control
Type	text string
Value	"disable" Since build 204-14, Incoming connection requests are by default filtered for virtual serial lines and then allowed only for the localhost. This is to avoid security scanners that can block the port. Example: `set OPA0 port = 10003set OPA0 access_control = disable` This is implemented only for serial lines using the new syntax, not for lines using the legacy syntax (`load virtual_serial_line ...`).

Div

class	pagebreak

...

Linking serial controller port to host connection

Example:

...

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:

...

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:

...

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

Div

class	pagebreak

OPA0 console configuration examples

Using legacy syntax (not recommended)

This example, using a MicroVAX 4000-106, maps OPA0 to port 10003, enable F6 key (emulator stop) and logs the console input/output to a rotating log file in /charon/myvax/logs folder:

load virtual_serial_line OPA0

set OPA0 port=10003

set quart line[3]=OPA0

set OPA0 stop_on="F6"

set OPA0 log="/charon/myvax/logs"

Using new syntax (recommended)

This example, using a MicroVAX 4000-106, maps OPA0 to port 10003, enable F6 key (emulator stop), logs the console input/output to a rotating log file in /charon/myvax/logs folder and enables the connection_override feature:

set QUART alias[3]=OPA0 (optional starting with build 204-13)

set OPA0 port=10003

set OPA0 stop_on="F6"

set OPA0 log="/charon/myvax/logs"

set OPA0 connection_override=enable

Include Page

	KBCOMMON:DOC-GoToToc
	KBCOMMON:DOC-GoToToc

Versions Compared

Old Version 26

New Version Current

Key

Console

alias

rts

rts

dsr

dsr

connection_override

access_control

Linking serial controller port to host connection

OPA0 console configuration examples

Using legacy syntax (not recommended)

Using new syntax (recommended)

Page Comparison

Versions Compared

Old Version 26

New Version Current

Key

Console

alias

rts

rts

dsr

dsr

connection_override

access_control

Linking serial controller port to host connection

OPA0 console configuration examples

Using legacy syntax (not recommended)

Using new syntax (recommended)