Contents / Appendix E

APPENDIX F KBDMACRO KEYBOARD MACROS

F.I KbdMacro File 

KbdMacro.txt file is a text file containing the set of macros available to run in the terminal.

This file may contain one or more macros. Each macro MUST have a different name.
Each macro is composed by a header ([MACRO_XX]) and a sequence of actions.
An action is composed by an action and a value (if needed by the action). The action and the value are separated by an equal "=".

F.I.1 Header

[MACRO_XX]
"XX" is the macro name (a 2 digit number). Actions are invoked by their name name.
Names must be unique in the file.

F.I.2 Actions

"KEY"
A complete keyboard keystroke is simulated by 2 actions: a key down message and a key up message.
The value is a keyboard code (0 to 255 or "well-known" key).

"KEYDOWN"
A keyboard key down message is generated.
The value is a keyboard code (0 to 255 or "well-known" key).

"KEYUP"
A keyboard key up message is generated
The value is a keyboard code (0 to 255 or "well-known" key).

"PAUSE"
A specific pause is performed (in milliseconds).
The value is the time to wait in milliseconds.

"PACING"
The standard sleep time between keystrokes is modified.
The value is the pacing time to sleep in milliseconds.

"END"
End of keyboard macro.

"TEXT"
A string of characters to send to keyboard.
The value is a text string.

F.I.3 Values

Keyboard numeric codes may be written in:

Keyboard codes may have well-known values:

Well-known name Keystroke value
BACK 0x08
TAB 0x09
ENTER 0x0D
SHIFT 0x10
CONTROL 0x11
ESCAPE 0x1B
SPACE 0x20
PRIOR 0x21
NEXT 0x22
END 0x23
HOME 0x24
LEFT 0x25
UP 0x26
RIGHT 0x27
DOWN 0x28
F01 0x70
F02 0x71
F03 0x72
F04 0x73
... ...
F24 0x87

F.I.4 Sample

// Here macro 00 we send TST<tab>TST<enter>
[MACRO_00]
TEXT=TST
KEY=TAB
TEXT=TST
KEY=ENTER
END
// Here macro 01 we send <PF12>
[MACRO_01]
KEY=F12
END

 Contents / Appendix E