Set Up - issinoho/veetee GitHub Wiki
Set-Up is the terminal's own configuration, as on the hardware. Press F3 (or choose Set-Up in the window menu). What you see depends on the model:
- VT100 to VT420 show the VT420's Set-Up screens (Installing and Using the VT420 Video Terminal, chapter 5), described first below.
- VT510, VT520 and VT525 show the VT500 series' pull-right menus (EK-VT520-RM chapter 2); see VT500 menus.
While Set-Up is open the host is held, so nothing it sends is lost, and the status line stays at the bottom of the screen.
| Key | Does |
|---|---|
| Arrow keys | Move the reverse-video field cursor; up and down keep to the same part of the screen |
| Return or Enter | Perform an action field, go to a screen, or step a feature to its next setting |
| Tab | Next field; on the Tab screen, the next tab stop |
| F3 | Leave Set-Up — changed settings take effect now |
Every screen has To Next Set-Up and To Directory fields.
| Field | Does |
|---|---|
| Global, Display, General, Comm, Printer, Keyboard, Tab | Open that screen |
| Clear Display | Clears the page when you leave Set-Up |
| Clear Comm | Abandons any control sequence being received and unlocks the keyboard |
| Reset Session | A soft reset (DECSTR) of this session |
| Recall | Returns every setting to the saved settings and clears the screen |
| Save | Keeps the current settings as the power-up settings |
| Set-Up=English | Set-Up is shown in English only |
| North American Keyboard | The keyboard dialect; Return steps through the national keyboards |
| Default | Replaces the saved settings with the factory settings |
| Exit | Leaves Set-Up |
| Screen Align | Shows the alignment pattern until a key is pressed |
| Enable Sessions, Disable Sessions | Not available (session management over one line, SSU) |
Save writes the settings for this model and session to your configuration directory:
- Linux:
~/.config/veetee/setup-vt420-session1.conf - Windows:
%LOCALAPPDATA%\veetee\setup-vt420-session1.conf
They are the terminal's power-up settings: veetee starts with them, and a host reset (RIS) or Recall returns to them. Default deletes the file and goes back to the factory settings. Each session (S1 to S4) has its own file.
Global — On Line or Local (Local holds the host and echoes what you type), the session arrangement, CRT Saver, the Comm1 connector, refresh rate and printer assignment.
Display — 80 or 132 columns, Interpret or Display Controls, Auto Wrap, Smooth-2, Smooth-4 or Jump Scroll, Dark or Light Screen, Cursor and cursor style (block or underline), the status display (none, indicator or host-writable), cursor blink, page arrangement (for example 6x24 pages), lines per screen, vertical and page coupling, Auto Resize Screen.
General — terminal mode (VT400 mode with 7-bit or 8-bit controls, VT300, VT200, VT100 or VT52 mode), user-defined keys locked, user features locked, 8-bit or 7-bit NRCS characters, numeric or application keypad, normal or application cursor keys, New Line, the user-preferred supplemental set (DEC Supplemental or ISO Latin-1), the terminal ID reported to the host, and the inactive session update method.
Communications — transmit and receive speed, XOFF point, data bits and parity, stop bits, local echo, modem control, disconnect delay, transmit rate limit, auto answerback, the answerback message (typed on the bottom line, up to 30 characters; F3 cancels) and whether it is concealed. On a serial line, or a terminal server's line asked for with RFC 2217, the transmit speed, data format, stop bits and XOFF set the line when you leave Set-Up, from 1.6.0 — see Connections.
Printer — Print Mode (normal, auto print or controller), Print Extent (the full page or the scrolling region) and Print Terminator (a form feed after each print, or none), from 1.6.0. Where print jobs go is chosen in the window menu: see Printing.
Keyboard — typewriter or data processing keys, Caps or Shift Lock, auto repeat, keyclick,
margin bell and warning bell volumes (high, low or off), character or key position mode, the
<X] key (Delete or Backspace), the compose and Alt keys, what F1–F5 do (their own function,
a function key code, or nothing), and the ,< .>, <> and `~ key options.
Tab — Clear all tabs, Set 8 column tabs, and a ruler: move along it and press Return to set or clear a tab stop (there is never a tab in column 1).
Most settings change the terminal when you leave Set-Up. Some are kept, saved and restored but do
not change veetee's behaviour yet: the receive speed and XOFF threshold, modem speeds, refresh
rate, printer assignment, user features lock, and the compose, Alt, F5 and ,< <> `~ key
options, which veetee's keymap decides instead.
From 1.9.0 these act, as on the VT500 series:
- Zero font (DECSZS): an oval zero, the default, a slashed zero, or a zero with a dot. The VT420 and earlier keep the slashed zero veetee's fonts draw.
- Transmit rate limit (DECSTRL, with Limited transmit, DECXRLM): what veetee sends goes at 150, 50 or 30 characters a second, keys that send sequences at the function-key rate; Kermit transfers are not limited.
- Modem control (DECMCM) and the disconnect delay (DECSDDT), on a serial line: nothing is sent or received while DSR is off, with Waiting for DSR in the subtitle; DSR going off ends the session, and carrier going off after 2 seconds, 60 ms or never. Some USB adapters' cables loop DTR back to DSR, so DSR is always on and the session never ends by it.
- Overscan (DECOSCNM, VT510 and VT520): the page's background fills the window.
- Host wake-up (DECHWUM, on from the factory): host output wakes the screen from the CRT saver; off, only a key does.
- Energy saver (DECSEST): once the CRT saver has run its time, veetee stops drawing until woken. The compatibility matrix lists the details.
The VT100 and VT220 had Set-Up screens of their own; veetee shows the VT420 layout for them.
On a VT510, VT520 or VT525 Set-Up opens on the main menu, with the submenu of the highlighted item shown beside it:
| Key | Does |
|---|---|
| Up, Down | Move through the current menu (dimmed items are skipped) |
| Right | Open the highlighted submenu |
| Left | Back to the menu before |
| Return or Enter | Open a submenu, tick a check box, choose a radio button (and close its menu), or perform an action |
| F3 | Leave Set-Up — changed settings take effect now |
☒ and ☐ are check boxes; ◆ marks the chosen setting of a radio group and ◇ the others. The
bottom line is the Set-Up summary line — session and port, speed with parity, data bits and
stop bits (such as 9600N81), the default character set, the keyboard, the emulation and the
version. A message such as Done takes its place until the next key.
| Menu | Holds |
|---|---|
| Actions | Clear display, Clear communications, Reset this session, Restore factory defaults |
| Session | Select session (the current one), Update session (only when active, when available, at regular intervals) |
| Display | Lines per screen and Auto resize, Lines per page, Columns per page and Clear on change, Status display, Scrolling mode (slow smooth, fast smooth, jump), Screen background, Cursor display, Cursor coupling, Zero font, Auto wrap, New line mode, Lock user preferences, Show control characters, CRT saver (never, 5–60 minutes) and Host wake-up, Energy saver, Overscan, Framed windows (title bars and session icons, Sessions), Screen alignment |
| Terminal type | Emulation mode (VT520 to VT52 mode), Terminal ID to host, VT default character set, 7-bit NRCS characters, Transmit 7-bit controls |
| Keyboard | VT keyboard language, Lock key definitions, Caps lock function, keyclick, warning bell and margin bell volumes, Keyboard encoding, Auto repeat, Data processing keys, Application cursor keys, Application keypad mode |
| Communication | Word size, Parity (including unchecked parities), Stop bits, Transmit and Receive speed (300 to 115.2K), transmit and receive flow control and threshold, transmit and function key rate limits, Ignore Null character, Local echo, Half duplex, Auto answerback, Answerback message..., Answerback concealed |
| Modem | Enable modem control, Disconnect delay, Modem high and low speed |
| Tabs... | The Tab Set-Up dialog: arrows move along the ruler, Return sets or clears a stop; OK, Cancel, Set 8 column tabs, Clear all tabs |
| On-line, Save settings, Restore settings, Exit Set-Up | Below the line in the main menu |
Answerback message... opens a dialog: type the message (Return enters a CR), press Down to reach OK or Cancel, and Return. Pressing F3 in a dialog accepts it and leaves Set-Up.
Dimmed items are features veetee does not have: the clock, calculator and character set display, banner message, session names and page allocation, colour assignment, the ASCII emulations, the printer's port, cable and character sets, key definition, PC keyboards, and Set-Up in languages other than English.
Display Controls (VT420 Display Set-Up) or Show control characters (VT500 Display menu) turns on control representation mode, for seeing exactly what a host sends. Every character is shown instead of performed: control characters appear as their names in small letters stacked in one cell (ESC, CSI, BEL…; two letters on 36- and 48-line screens). LF, VT and FF are shown and then start a new line, and lines always wrap. A secure reset from the host (DECSR) ends the mode; otherwise turn it off in Set-Up.