Versions Compared

Old Version 27

changes.mady.by.user Bruno Miretti (Deactivated)

Saved on

compared with

New Version Current

changes.mady.by.user Bruno Miretti (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
TOC
TOC
Include Page
KBCOMMON:KB-CSSstyle
KBCOMMON:KB-CSSstyle

...

Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc

Div
classpagebreak


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

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

Parameterrts
Parameteralias
TypeIdentifier
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

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

rts

Example:

set UART alias=OPA0

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


rts

Parameterrts[<line>]
TypeText 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 ( (warning) Applicable only for QUART )


Div
classpagebreak


dsr

Parameterdsr[<line>]
TypeText string
Value

dsr

Parameterdsr[<line>]
TypeText 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 ( (warning) Applicable only for QUART )

...

classpagebreak
  • "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.


...

Parameterline
TypeText 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.


...

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
classpagebreak


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