Digital PDFs

EK-VT125-RC-001

September 1981

16 pages

Original

0.4MB

Document:	VT125 Programming Reference Card
Order Number:	EK-VT125-RC
Revision:	001
Pages:	16
Original Filename:	http://bitsavers.org/pdf/dec/terminal/vt125/EK-VT125-RC-001_VT125_Programming_Reference_Card_Sep81.pdf

OCR Text

~DmDD~D

EK-VT125-RC-001

VT125 PROGRAMMING

REFERENCE CARD
CONTROL CHARACTERS RECEIVED

Name

Character
Mnemonic

Octal
Code

Null

NUL

000

Ignored when received and
used as a fill character.

Enquire

ENQ

005

Transmits the answerback
message.

Bell

BEL

007

Generates a bell tone.

Backspace

010

Function

Moves the cursor to the left
one character position.

Horizontal
Tab

011

Moves the cursor to the
next tab stop.

Line Feed

012

Causes a line feed or a new
line operation. (Refer to
Linefeed/ New Line mode.)

Vertical
Tab

'VT

013

Processed as LF.

Form Feed

014

Processed as LF.

Carriage
Return

015

Moves the cursor to left
margin on the current line.

Shift Out

016

Selects the G1 character
set, as designated by a
Select Character Set
sequence.

Shift In

017

Selects the GO character
set, as designated by a
Select Character Set
sequence.

Device
Control 1

DC1

021

Processed as XON. Causes
the terminal to continue
transmitting characters.

Name

Character
Mnemonic

Octal
Code

Device

DC3

023

Control 3

Function

Processed as XOFF. Causes
terminal to stop transmit-

ting all characters except
XOFF and XON.
Cancel

CAN

030

If received during an
escape or control sequence, the sequence is

cancelled and substitution
character 1:;::1 is displayed.
Substitute

SUB

032

Processed as CAN.

Escape

ESC

033

Processed as a sequence
Introducer.

Delete

DEL

177

Ignored when received.

ANSI COMPATIBLE SEQUENCES
Set Mode
Name

Mnemonic

Mode

Sequence

Line feed/new line
Cursor key
ANSI/VT52
Column
Scrolling

LMN
DECCKM
DECANM
DECCOLM
DECSCLM
DECSCNM
DECOM
DECAWM
DECARM

New line
Application
ANSI
132 column
Smooth

ESC [ 20 h
ESC [ 7 1 h

Relative
On
On

N/A
ESC [ 7 3 h
ESC [ 7 4 h
ESC [ 7 5 h
ESC [ 7 6 h
ESC [ 7 7 h
ESC [ 7 B h

Name

Mnemonic

Mode

Sequence*

Line feed/new line
Cursor key
ANSI/VT52
Column
Scrolling
Screen
Origin
Auto wrap
Auto repeat

LMN
DECCKM
DECANM
DECCOLM
DECSCLM
DECSCNM
DECOM
DECAWM
DECARM

Line feed

ESC [ 20 I
ESC [71 I
ESC [ 7 2 I
ESC [ 7 3 I
ESC [ 7 4 I
ESC [ ? 5 I
ESC [ ? 6 I
ESC [ ? 7 I
ESC [ ? 8 I

Screen

Origin
Auto wrap
Auto repeat

Reverse

Reset Mode

Cursor

VT52
80 column
Jump
Normal
Absolute
Off
Off

* The last character of each sequence is lowercase L 115481

________________________________________ 3

Cursor Key Codes Generated

Cursor Key
(Arrow)

Reset
(Cursor)

Up
Down
Right

ESC [A
ESC [ B
ESC [ C
ESC [ D

Left

ANSI Codes
Set
(Application)
ESC 0 A
ESC 0 B
ESC 0 C
ESC 0 D

VT52 Codes

ESC A
ESC B
ESC C
ESC D

Keypad Character Selection
Name

Mnemonic

Sequence

Alternate
Numeric

DECKPAM
DECKPNM

ESC =
ESC>

Keypad Codes Generated

Key

ANSI Mode
Numeric
Alternate
Keypad
Keypad
Mode
Mode

1
2
3
4
5

2
3
4
5

8
9

-(minus)
, (comma)
. (period)
ENTERt
PF1
PF2
PF3
PF4

- (minus)
, (comma)
(period)
CR or CRLF
ESC 0 P
ESC 0 Q
ESC 0 R
ESC 0 S

ESC 0 p
ESC 0 q
ESC 0 r
ESC 0 s
ESC 0 t
ESC 0 u
ESC 0 v
ESC 0 w
ESC 0 x
ESC 0 y
ESC 0 m
ESC 0 1*
ESC 0 n
ESC 0 M
ESC 0 P
ESC 0 Q
ESC 0 R
ESC 0 S

VT52 Mode
Alternate
Keypad
Keypad
Mode
Mode
Numeric

°
1
2
3
4
5

6
7

8
9
- (minus) t
, (comma)t
(period)
CR or CRLF
ESC P
ESC Q
ESC R
ESC S t

ESC? P
ESC? q
ESC? r
ESC? S
ESC? t
ESC? U
ESC 7 v
ESC? w
ESC? x
ESC? y
ESC 7 m t
ESC 7 1* t
ESC? n
ESC? M
ESC? P
ESC? Q
ESC? R
ESC 7 S t

The last character of the sequence is lowercase L (154 8)
These sequences were not available In the VT52. Do not use the
PF4, "-" (minus), or "," (comma) keys with VT52 software.
Line feed/new line off causes ENTER to generate CR (015 8), On
causes ENTER to generate CRLF (01 58 012 8 ),

4 ____________________________________

Select Cheractar Sets SCS
Character Set

GO Designator

G 1 Designator

United Kingdom (UK)
United States (USASCII)
Special characters
and line drawing set
Alternate character ROM
Alternate character ROM special characters

ESC (A
ESC ( B
ESC (0

ESC) A
ESC) B
ESC) 0

ESC ( 1
ESC (2

ESC) 1
ESC) 2

Name

Mnemonic

Sequence

Single Shift 2
Single character shift
to G2 (ASCII)
Single Shift 3
Single character shift
to G3 (ASCII)

SS2

ESC N

SS3

ESC 0

NOTE: The VT125 generates the following control characters
differently from previous DIGITAL terminals.
Code

VT125 Keys

Previous Terminal Keys

NUL
RS
US

CTRL - Space bar

CTRL -@
CTRL _ ..

CTRL - CTRL -?

CTRL - _

Character Attributes
Name

Mnemonic

Select Graphic Rendition
No attributes
No attributes
Select bold attribute
Select underl ine attribute
Select blink attribute
Select reverse video
attribute

SGR

Sequence

ESC [ m
ESC [ 0 m
ESC [ 1 m
ESC [ 4 m
ESC [ 5 m
ESC [ 7 m

NOTE: Without advance video option (AVO). only underline or reverse
attribute is available.

_____________________________________ 5

US/UK Character Set

BITS

~~.--.

KEY

.~"C"'""H.EJJD" ewe
lJ

DECIMAL

HEX

f---

6 ____________________________________

Special Characters and Line Drawing Set

-- - t---'-- - 2

KEY
'''''''''''''''"Eill'' om,
21

DECIMAL

HEx

----"-r---r---- ---~
4

Scrolling Region
Name

Mnemonic

Sequence

Set top and bottom margins

DECSTBM

ESC [ Pt; Pb r

Name

Mnemonic

Sequence

Cursor up

CUU
CUD
CUF
CUB
CUP
CUP
HVP
HVP

ESC [ Pn A
ESC [ Pn B
ESC [ Pn C
ESC [ Pn D
ESC [ PI; Pc H

IND
RI
NEL
DECSC
DECRC

ESC D
ESC M
ESC E
ESC 7
ESC 8

Name

Mnemonic

. Sequence

Horizontal tab set
(at current column)
Tabulation clear
(at current col umn)
Tabulation clear
(at current column)
Tabulation clear (all tabs)

HTS

ESC H

TBC

ESC [ g

TBC

ESC [0 g

TBC

ESC [ 3 g

Name

Mnemonic

Sequence

Double-height top half
Double-height bottom half
Single-widlh single-height
Double-width single-height

DECDHL
DECDHL
DECSWL
DECDWL

ESC #
ESC #
ESC #
ESC #

Cursor Movement Commands

Cursor down
Cursor forward (right)
Cursor backward (left)
Cursor position

Cursor position (home)
Horizontal and vertical position
Horizontal and vertical position

(home)
Index
Reverse index

Next line
Save cursor (and attributes)
Restore cursor (and attributes)

ESC [ H
ESC [ PI; Pc f
ESC [ f

Tab Stops

Line Attributes

3
4
5
6

8 ________________________________________

Erasing
Name

Mnemonic

Erase in line
Cursor to end of line
Cursor to end of line

EL
ESC [ K
ESC [0 K
ESC [ 1 K
ESC [ 2 K

Beginning of line to cursor
Entire line containing cursor

Erase in display

Sequence

Cursor to end of screen

ESC [ J
ESC [0 J
ESC [ 1 J
ESC [ 2 J

Cursor to end of screen
Beginning of screen to cursor
Entire screen

Communication and Graphics Protocol Commands
Name

Mnemonic

Device control string
Enter ReGIS at previous
command level
Enter ReGIS at highest
command level
Enter ReGIS at previous

DCS

Sequence

ESC P p
ESC P 1 p
ESC P 2 p

command level with
commands to screen

Enter ReGIS at highest
command level with

ESC P 3 p

commands to screen

Enter DECwriter graphics
Enter VTl 05 emulator
String terminator

ESC P q
ESC P t
ST

Exit graphics
Media copy
Turn off computer to auxiliary
port
Turn on computer to auxiliary

ESC \
MC
ESC [4 i
ESC [5 i

port
Turn off computer to screen
Turn on computer to screen

Select auxiliary port for
ReGIS hardcopy output
Select computer port for
ReGIS hardcopy output

ESC [6 i
ESC [7 i
ESC [ ? 0 i
ESC [ ? 2 i

________________________________________ 9

Reports
Name

Mnemonic

Sequence

Device status report
(request status of VT125)
Response:
Terminal OK
Terminal not OK

DSR

ESC [ 5 n

DSR
DSR

ESC [ 0 n
ESC [ 3 n

Device status report'
(request cursor position)
Cursor position report

DSR

ESC [ 6 n

CPR

ESC [ PI; Pc R

Device attributes (what are you)
Device attributes (what are you)
Identify terminal (what are you)

OA
DA
DECID

ESC [ c
ESC [ 0 c
ESC Z

NOTE:

ESC Z i~ not recommended.

Device attributes

See Note.

response: VT1 25
NOTE: Format is ESC [ 7 12 ; <vt100> ; <vt1 25> ; <version> c

5 = no AVO, 7 = AVO
1
printer, 0
no printer
Graphics firmware

Reset
Name

Mnemonic

SeqUljnce

Reset to initial state

RIS

ESC c

10 _________________________________________

VT100 Tests and Adjustments
NOTE: Do not use VT100 loopback tests with the graphics processor
installed. Loopback tests require test connector. Continuous tests end
at failure or power-off.
Name

Mnemonic

Screen alignment display
Fill screen with "Es'

DECALN

Invoke confidence test

DECTST

Power-up test
DElta loopback test

Power- up and data loopback
tests
EIA modem control loopback

Sequence

ESC # 8

ESC [ 2; 1 Y
ESC [ 2 ; 2 y
ESC [ 2 ; 3 y
ESC [ 2 ; 4 y

test

Power-up and EIA loopback

ESC [ 2; 5 y

tests

Dilta loopback and EIA
loop back tests

ESC [ 2 ; 6 Y

Power-up, data loopback,

ESC [ 2 ; 7 y

"nd EIA loopback tests
Repeat power-up test

ESC [ 2; 9 y

continuously

Repeat data loopback test

ESC [ 2 ; 10 Y

continuously

Repeat power-up and data
loopback tests continuously
Repeat EIA test continuously

ESC [ 2; 11 y

Repeat power-up and EIA

ESC [ 2 ; 13 Y

ESC [ 2; 12 y

tests continuously

Repeat data loopback and EIA

ESC [ 2; 14 y

loop back tests continuously
Repeat power-up, data

ESC [ 2 ; 15 Y

loopback, and EIA loopback
tests continuously

11 _________________________________________

VT125 Tests and Adjustments
NOTE: All tests require loopback connector. Always include power-up
test for correct display of error indications.
Name

Mnemonic

Invoke confidence test
OECTST
VT125 power-up test
VT125 computer port
data loopback test
VT125 auxiliary port
data loopback test
VT125 display test
VT1 25 video bit map
memory test
Repeat any selected
tests continuously until
power-off or failure

Sequence
ESC [ 4 ; 1 ; Ps ... ; Ps y
Ps= 1
Ps= 2
Ps= 3
Ps= 4
Ps= 5
Ps= 9

Keyboard Indicators
Name

Mnemonic

Load LEOs
All off
L1 on
L2 on
L3 on
L4 on

OECLL

Sequence

ESC [q
ESC [1 q
ESC [2 q
ESC [3 q
ESC [4 q

VT52 COMPATIBLE MODE
Mode

Sequence

Enter ANSI mode

ESC <

Keypad Character Selection
Name

Sequence

Enter alternate keypad mode
Exit alternate keypad mode
(numeric keypad mode)

ESC=
ESC>

NOTE: VT52 alternate keypad and numeric keypad modes are different
from ANSI.

_______________________________________ 12

Character Sets
Name

Sequence

Special graphics character set
Select US/UK character set
(as determined by the US/UK
character SET-UP feature)

ESC F*
ESC G

Same as special character and line drawing set in ANSI mode.
Cursor Position
Name

Sequence

Cursor up·

Cursor to home
01 reet cursor address

ESC A
ESC B
ESC C
ESC D
ESC H
ESC Y PI Pct

Reverse line feed

ESC It

Cursor down*
Cursor right*

Cursor left*

Same when sent from the terminal.
Line and column numbers for direct cursor address are single
character codes whose values are the desired number plus 31 ,0 ,
Line and column numbers start at one.
The last character of the sequence is an uppercase i (111 8 ),
Erasing
Name

Sequence

Erase to end of line

ESC K
ESC J

Erase to end of screen

Reports
Name

Sequence

Identify (what are you)
Response: VT52

ESC Z
ESC / Z

_________________________________________ 13

ReGIS COMMAND SUMMARY
Position Command Summary
Command

Function

Reset pattern memory.
Move to <position>.
Move <multiplier> pixels in
<pv> direction.
Save current location.
Save dummy location.
Move to last saved location.
P (W (M<multiplier>)).

[]
[ <position>]
<pixel vector> or <pv>
(B)
(5)
(E)
(W «temp. writing controls»)

Vector Command Summary
Commend

Function

v []

Draw dot at current position.

[< pos ition>]
<pixel vector> or <pv>
(B)
(5)
(E)

Draw vector to <position>.
Draw <multiplier> pixels in
<pv> direction.
Save current position.

Save dummy position.
Draw to last saved position.

(W «temp. writing controls»)
Curve Command Summary
Command

Function

Circle with center at current
position, circumference at

[<position>]

<position>.
Circle with center at
<position>, circumference at
current position.

(A<degrees» [<position>]

(A<degrees>C) [<position>]

(B) [<pos.>] ... [<pos.>] (E)
(S) [] [<pos.>] ... [<pos.>] [] (E)
(W«temp. writing controls>))

Arc with center at current

position, starting at <position>
for <degrees>.
Arc with center at <position>,
starting at current position for
<degrees>.
Bounded (closed) curve
Unbounded (open) curve

14 __________________~----------------------

Text Command Summary

Command
T

(S <size number»

(H <height»
[<spacing»
(S [<width in pixels>,<height in plxels>1I
(M [<width pixel multlplier>,<height pixel multlpller>1I
(D <direction angle»
(D <string tilt> S <size> D <char tilt»
(T <Italic degrees»
(A <pattern s~t number»
((B) <temporary attributes block> (E))
(W( <temp. writing controls»)
Writing Controls Summary
Command

Function

W (C)

Complement

(E)
(R)
(V)

Overlay

(F <foreground planes»

o = no planes

Erase

Replace

1 = plane 1
2 = plane 2
3 = planes 1 and 2
Foreground intensity:
(I

0
1

or (D)
(R)

2
3

(G)
(B)

Dark
Dim grey
Light grey
White

Dark
Red
Green
Blue
Cyan
Yellow
Magenta
White

or
(I(H <hue angle>

L <lightness percent>
S <saturation percent»)
(M <multiplier»
(N 1)
(N 0)

Pixels per <pv>
Negative on
Negative off

(S 1)
(S 0)
(S [, shading reference])
(S 'shading character)
(P <binary pattern»
(P <pattern number»
(P (M <pattern multiplier»)
(W<i>(P<J>,N<k»)

Shading on
Shading off

Enter pattern.
Use VT125 pattern.

Custom writing control

Screen Controls Summary
Command

Function

Scroll.

<pixel vector>
[<position> ]
(A [<position>] [<position>])
(E)
(H [<position>] [<poSition>]

Hardcopy (corner positions

(H( P[<posltion>]))

optional)
Set hardcopy offset.

Display addressing.
Erase screen.

Background Intensity:

(D)

(R)
(G)

or
Dark
Dim grey
Light grey

(B)

White

(C)

Dark

Red
Green
Blue
Cyan
Yellow
Magenta
White

(Y)

(M)
(W)

or
(I (H <hue angle>
L <lightness percent>
S <saturation percent»)
S(M<n>«mono HLS»(A<color HLS») Output mapping
IS <scale»
(S (X<scale>Y<scale»
(T <ticks»

Time delay

Macrograph
Command

Function

Clear all macrographs,
keyletter character._string @;

Define macrograph.

keyletter

Invoke macrograph.

Character Cell Control Summary
Command

Summary

Select for loading,
Give name to set .

(A<integer»
(A"<name>')
.. <ASCII char>" <hex pair> ,
<hex pair>;

Load cell.

16 ______________________________________

Report Command Summary
Command

Function

Set selected for loading.
Contents of macrograph.
Use of storage.
Reply to use.
Cursor position.

(L)
(M «keyletter»)
(M(=))
"<free>.<total>"
(P)

1 st Edition. September 1981

Printed in U.S.A.