| Anchor | ||||
|---|---|---|---|---|
|
| Include Page | ||||
|---|---|---|---|---|
|
...
Example for OPA0 console ("COM1" port):
set COM1 alias=OPA0 |
Starting with Charon-AXP V4.11 build 204-14, the line above is optional. OPA0 is mapped by default to COM1.
Example when using the TTA0 console ("COM2" port):
set COM2 alias=TTA0 |
Refer to Mapping Serial line controllers to system resources for details of mapping.
| Note |
|---|
CHARON emulated console supports only 80 symbols in one line. |
| Include Page | ||||
|---|---|---|---|---|
|
| Div | ||
|---|---|---|
| ||
General parameters
CHARON-AXP console lines COM1 and COM2 have the following parameters:
All the values in the following tables are case insensitive.
alias
| Parameter | alias | |||||
|---|---|---|---|---|---|---|
| Type | Identifier | |||||
| Value | This parameter is used to set an useful name for COM1 or COM2 ports. It can be any name, for example "Console1", but usually it is "OPA0" for COM1 and "TTA0" for COM2. This name is logged in CHARON log file, it can also be used for parametrization in CHARON configuration file along with "COM1" and "COM2" identifiers. 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.
Example:
|
| Div | ||
|---|---|---|
| ||
communication
| Parameter | communication |
|---|---|
| Type | Text string |
| Value |
|
...
| Parameter | application | ||
|---|---|---|---|
| Type | Text string | ||
| Value | An application (a terminal emulator is assumed in most cases) to be started on initialization of this serial line emulation. The specified application startup string may contain all required parameters Example:
In this example the terminal emulator application "putty" is started with the parameters:
The "application" parameter is often combined with a "port" parameter:
|
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 COM1 alias = OPA0set 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-14
| Parameter | access_control |
|---|---|
| Type | text string |
| Value | "disable" Since build 204-13, 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:
|
Mapping Serial line controllers to system resources
...
| Parameter | line |
|---|---|
| Type | Text string |
| Value | A defined COM port on a host system in the form of "\\.\COMn" (or "COM<n>:") Example:
|
OPA0 console configuration examples
Using legacy syntax (not recommended)
This example maps OPA0 to port 10003, enable F6 key (emulator stop) and logs the console input/output to a rotating log file in its home directory:
|
Using new syntax (recommended)
This example maps OPA0 to port 10003, enable F6 key (emulator stop), logs the console input/output to a rotating log file in its home directory and enables the connection_override feature:
|
| Include Page | ||||
|---|---|---|---|---|
|