EMMA 02

XML CODE

Element: keyboard

Keyboard definition. The type attribute defines one of the different keyboard HW configurations: ps2, ps2-interrupt, ps2-89C4051, ascii (VIP Ascii keyboard), 1871 (RCA 1871 as used in the COMX), latch (using a key latch) or matrix (using a matrix format).

Type: ps2/ps2-interrupt

Keyboard definition for the PS2 keyboard and PS2 keyboard with interrupt.

child element attribute value description
caps Force uppercase (do not specify for normal operation).
ef pol, q ef flag (1 to 4) PS2 keyboard EF flag definition for clock signal . For details about attribute and value usage see XML - I/O.
in mask, q port (1 to 7) PS2 keyboard input port definition to read data. For details about attribute and value usage see XML - I/O.
iogroup group number (8 bit) PS2 keyboard iogroup definition. For details about value usage see XML - I/O.
out mask, q port (1 to 7) PS2 keyboard output port definition. For details about attribute and value usage see XML - I/O.

Type: ps2-89C4051

Keyboard definition for the PS2 keyboard connected via a 89C4051 (Elf2K and VIS1802).

child element attribute value description
caps Force uppercase (do not specify for normal operation).
ef pol, q ef flag (1 to 4) PS2 keyboard EF flag definition for data ready signal. For details about attribute and value usage see XML - I/O.
frequency frequency Play beeper tone with specified frequency.
in mask, q port (1 to 7) PS2 keyboard input port definition to read data. For details about attribute and value usage see XML - I/O.
int CDP1877 PIC interrupt number Activate interrupt on data ready and specify PIC interrupt number (if used).
iogroup group number (8 bit) PS2 keyboard iogroup definition. For details about value usage see XML - I/O.
jp4 Activate numeric keypad.
out mask, q port (1 to 7) Sound output port definition. For details about attribute and value usage see XML - I/O.
startup SPecified the startup characters.

Type: ascii

Keyboard definition for the ASCII or HEX keyboard.

child element attribute value description
caps Force uppercase (do not specify for normal operation).
ef pol, q ef flag (1 to 4) ASCII or HEX keyboard EF flag definition for data ready signal. For details about attribute and value usage see XML - I/O.
in mask, q port (1 to 7) ASCII or HEX keyboard input port definition to read data. For details about attribute and value usage see XML - I/O.
iogroup group number (8 bit) ASCII or HEX keyboard iogroup definition. For details about value usage see XML - I/O.

Type: 1871

Keyboard definition for the RCA 1871 chip (as used in the COMX).

child element attribute value description
ef pol, q ef flag (1 to 4) RCA 1871 keyboard EF flag definition. With type="rpt" the port will be configured for the key repeat signal. With type="ready" (or "data") the port will be configured for the data ready signal. For details about attribute and value usage see XML - I/O..
in mask, q port (1 to 7) RCA 1871 keyboard input port definition to read data. For details about attribute and value usage see XML - I/O.
iogroup group number (8 bit) RCA 1871 keyboard iogroup definition. For details about value usage see XML - I/O.

Type: latch

Keyboard definition for a keyboard solution using a key latch.

child element attribute value description
ef pol, q ef flag (1 to 4) Latch keyboard EF flag, active when latched key is pressed definition. For details about attribute and value usage see XML - I/O.
keydef out, type raw ASCII key value / predefined key text When attribute out="x" represents the key latch to be mapped to the given raw (shift, ctrl keys are ignored) ASCII PC key value (assuming no type attribute is used). A type attribute can be used to activate the following options:
  • type="text": the key latch (in out="x") is mapped to the given predefined PC key (alt_right - option on Mac and alt on windows, ctrl_left - command on Mac and ctrl on windows, ctrl_right, alt_left, hift, caps, switch - switch alt and ctrl, used on TMC-600).
  • type="shift": the key latch (in out="x") is mapped to the given raw (shift, ctrl keys are ignored) ASCII PC key value but only if SHIFT is also pressed.
  • type="force": the key latch (in out="x") is mapped to the given raw (shift, ctrl keys are ignored) ASCII PC key value. Towards the emulated computer a shift press is forced.
  • type="force_noshift": the key latch (in out="x") is mapped to the given raw (shift, ctrl keys are ignored) ASCII PC key value. Towards the emulated computer a shift is forced off.
  • type="map": used for the CTRL V feature to map specified ASCII value to a raw key code. This can be used on its own or in combination with type="shift" and/or out="x".
iogroup group number (8 bit) Latch keyboard iogroup definition. For details about value usage see XML - I/O.
out mask, q port (1 to 7) Latch keyboard output port definition to set key latch. For details about attribute and value usage see XML - I/O. Note that the mask HAS TO be set to max value (0xFF) to be able to use keyfile, ctrl V and memeory access features.

Type: matrix

Keyboard definition for a keyboard solution using a key matrix.

child element attribute value description
efX/td> pol, q key text (ctrl, shift, caps or esc) Matrix keyboard EF flag, key text defines which key is connected to EFX (where X is EF flag 1 to 4).
keydef address, bit, mask, type raw ASCII key value / predefined key text Definition to map key row latch or input address (address="x") and bit number (bit="y") to the specified PC ASCII value. Instead of a bit value a mask (mask="z") can be used to define multiple bits. A type attribute can be used to activate the following options:
  • type="text": for predefined keys: return, end, home, esc, back, up, down, left or right.
  • type="shift": for ASCII values representing SHIFT keys on the emulated keyboard.
  • type="ctrl": for ASCII values representing CTRL keys on the emulated keyboard.
in mask, q port (1 to 7) Matrix keyboard input port definition to read latched key row or input address (type="useaddress"). Type="rev" reverses the input value. For details about attribute and value usage see XML - I/O.
iogroup group number (8 bit) Matrix keyboard iogroup definition. For details about value usage see XML - I/O.
out mask, q port (1 to 7) Matrix keyboard output port definition to set key row latch. For details about attribute and value usage see XML - I/O.