Versions Compared

Old Version 27

changes.mady.by.user Bruno Miretti

Saved on

compared with

New Version 28

changes.mady.by.user Bruno Miretti

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated with Waltraud's comments

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

...

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", "DCD", "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.


...


Div
classpagebreak



operator_console

break_on, stop_on

Parameterbreak_on,

...

These two parameters are hard-coded to the following values and cannot be changed:

stop_on="F6"

break_on="Ctrl-P,F5"

Example:

...

"ttyY" notation specifics

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

  1. Linux virtual tty (switchable by alt+F1 - atl+F12 on a text console) – are represented as "/dev/tty<N>" 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")
  2. Onboard serial lines are represented as "/dev/ttyS<N>" where N is a number. For example "/dev/ttyS1"
  3. Proprietary (depending on a driver) devices are represented as "/dev/tty<XXX>" 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:

...

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:

set TXA line[5]=TTA1stop_on
TypeText string
Value

These two parameters are hard-coded to the following values and cannot be changed:

stop_on="F6"

break_on="Ctrl-P,F5"



Example:

load operator_console OPA0
Include Page
KBCOMMON:DOC-GoToToc
KBCOMMON:DOC-GoToToc

"ttyY" notation specifics

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

  1. Linux virtual tty (switchable by alt+F1 - atl+F12 on a text console) – are represented as "/dev/tty<N>" 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")
  2. Onboard serial lines are represented as "/dev/ttyS<N>" where N is a number. For example "/dev/ttyS1"
  3. Proprietary (depending on a driver) devices are represented as "/dev/tty<XXX>" 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

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:

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