Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Update for PDF export

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

...

Table of Contents
excludeTable of Contents

Div
classpagebreak


General Description

Configuration of CHARON-VAX serial lines is performed in 3 steps:

...

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
  • "On" - always reports DSR signal asserted
  • "Off" - always reports DSR signal deasserted
  • "DSR" - 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.


...

Device nameModule name
DHV11DHV11
DHQ11DHV11
CXY08DHV11
CXA16DHV11
CXB16DHV11
DHW42AADHV11
DHW42BADHV11
DHW42CADHV11
DZV11, DZ11DZ11
DZQ11DZ11
DL11, DLV11DL11


Div
classpagebreak



The following example loads an instance of an asynchronous serial line multiplexer:

...

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

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.


...

Parameterbreak_on
TypeText string
Value

Specifies what byte sequences received over virtual serial line must trigger HALT command.

(warning) 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: "Ctrl-P", "Break" or "none" to disable triggering HALT condition.

Example:

set OPA0 break_on="Ctrl-P"

The default value is "Break" for line 3 of QUART and "none" for other lines.

...

...

classpagebreak


stop_on

Parameterstop_on
TypeText string
Value

Specifies what byte sequences received over the virtual serial line will trigger a STOP condition. The STOP condition causes CHARON-VAX to exit.

(warning) 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 value as the following: “F6” or “none” ("none" disables triggering STOP condition).

Example:

set OPA0 stop_on="F6"

The default value is "none".Setting "F6" triggers the STOP condition upon receipt of the "<ESC>[17~" sequence.

...

Parameterlog_file_size
TypeText string
Value

If log rotation is enabled, the log_file_size parameter determines the log file size threshold at which the log is automatically rotated.

  • "unlimited" or "0" (default) - the feature is disabled
  • "default" - default size is used (4Mb)
  • <size>[KMG] - size of the current log file in bytes with additional multipliers:
    • K - Kilobyte - multiply by 1024

    • M - Megabyte - multiply by 1024*1024

    • G - Gigabyte - multiply by 1024*1024*1024

Example 1:

set OPA0 log_file_size="default"

Example 2:

set OPA0 log_file_size=10M

(warning) Minimum log file size is 64K, maximum is 1G. Setting size less then 64K effectively makes the log file unlimited.


Div
classpagebreak


log_flush_period


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

...

classpagebreak

...

Parameterlog_flush_period
TypeNumeric
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
classpagebreak


Example of mapping a console line to an onboard serial line

...