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.
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 Activate interrupt on data ready.
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.