EMMA 02

XML CODE

Element: frontpanel

Front panel definition. Use init="on" to open the front panel on startup. The multi 7-segment TIL display (type="multitil") definitions are as used for the Cosmicos and Membership Card front panels rev L and later.

Child Element Attribute Value Description
cycle type cycle size Only used with type="multitil", definition of the multi 7 seg TIL display cycle size. Calculated as cycle_size = Hz / ( (1/cpu clock) * 8 )
dirname - directory name (text) Location of the multi 7 seg TIL display ROM file; defined as a subdirectory of the main Emma 02 data directory. Only used for the Membership Card front panels rev L and later. If not specified, the dirname in system will be used (see also XML - System).
ef pol, q, type ef flag (1 to 4) The type attribute indicates the EF flag function: ready = hex button pressed, in = in button pressed, in_elf = Cosmac Elf in button pressed, start = start button pressed, multitil = multi 7 seg TIL display start. For details about attribute and value usage, see XML - I/O
filename high, pol, wait file name (text) Multi 7 seg TIL display ROM filename. Only used for the Membership Card front panels rev L and later. When pol="rev", polarity of ROM data is reversed. Attribute 'high' defines which ROM address line is 1 and 'wait' sets the addressline that follows CPU wait value.
in mask, q, type port (1 to 7) Data input port definition for a hex keypad or a switch panel. When using type="multitil" a TIL input (reset) for a multi 7 seg TIL display will be defined. When using type="direct" data is sent to the input port directly (not linked to IN press or hex keypad). No type or type="onekey" will define a hex keypad, where onekey specifies input per key instead of two keys per input. Note that default="key definition" can be used to specify a default hex keypad definition as listed in the keydefinition.txt file, if not specified key definition "elfdefault" will be used. For details about attribute and value usage, see XML - I/O
int - CDP1877 PIC interrupt number Specify PIC interrupt number (if used).
item - child elements Front panel item, like a led, 7 segment display, button, switch etc.
iogroup - group number (8 bit) Front panel iogroup definition. For details about value usage, see XML - I/O
out mask, q, type port (1 to 7) Data TIL output port definition. When using type="multitil" a TIL output for a multi 7 seg TIL display will be defined. For details about attribute and value usage, see XML - I/O
pos type screen position (x, y) Front panel screen position. Default the values specified are calculated as relative values from top left of the main Emma 02 GUI window. When type="real" is used, the values specified are real window positions. When type="grid" is used, the values specified are grid values relative to the last defined front panel.
Grid example: when the first default front panel position is used (left aligned with the main Emma 02 GUI window) and the next front panel definition uses <pos type="grid">1, 0</pos> it will be next (x=1) to and top aligned (y=0) with the first front panel.
size - screen size (x, y) Front panel size.

Element: item

Front panel item, e.g., a led, 7 segment display, button, switch etc.

Child Element Attribute Value Description
dirname - directory name (text) Location of the front panel background image file; defined as a subdirectory of the main Emma 02 data directory. If not specified, the dirname in system will be used (see also XML - System).
filename high, pol, wait file name (text) Front panel background image filename (png).
function action, key, pol, type item function Buttons and switches:
  • in: IN push button used in combination with bit input buttons.
  • in_switch: IN push button used in combination with bit input switches.
  • am: Amend push button, stores hex key value at current address without advancing. The key attribute specifies the PC keyboard key code (default: 77 = M) that activates the AM function.
  • run: run push button or flip switch depending on child element type. The type attribute can specify button press behavior with values: boot (follow auto boot setting), reset (same as boot but first reset CPU, switch (flip switch), velf, uc1800 or microtutor.
  • run0: run push button, forcing start at address 0. The type attribute can specify button press behavior with values: boot (boot on address 0) or reset (same as boot but first reset CPU).
  • mp: memory protect push button or flip switch.
  • load: load push button or flip switch depending on child element type.
  • load_sys00: load flip switch for System 00 / FRED I direct hex-panel program load; when on, each digit pair (least significant digit first) is DMA'd into M(R(0)) and R(0) is incremented.
  • pause: pause push button or flip switch.
  • step: step push button or flip switch. The type attribute can specify value cosmicos to comply with behavior of the Cosmicos step button.
  • reset: reset push button. The type attribute can specify value full to do a complete computer reset (used in CDP18S020, FRED I and RCA COSMAC Microboard).
  • super_monitor: Quest Super Elf monitor push button.
  • super_mp: Quest Super Elf monitor memory protect push button.
  • power: power flip switch, not closing the running computer (like on the Infinite UC1800).
  • stop: power flip switch, closing the running computer.
  • card: FRED card buttons.
  • read: FRED read flip switch.
  • cardswitch: FRED card flip switch.
  • nano_monitor: Oscom Nano monitor push button.
  • wait: wait flip switch button.
  • st_sys00: start time pulses push button (like on the System 00 / FRED I).
  • rs_sys00: resume execution following idle push button (like on the System 00 / FRED I).
  • stop_sys00: stop time pulses push button (like on the System 00 / FRED I).
  • clear: clear push button.
  • clear_run: clear switch button (like on the Membership Card).
  • clear_reset: clear & reset push button (like on the Microtutor).
  • clear_sys00: clear to idle push button (like on the System 00 / FRED I).
  • nvram: nvram disable push button (like on the Cosmicos).
  • dipmp: four memory protect DIP switches.
  • ems: rotating EMS memory switch.
  • tmc_ad: TMC-600 A/DI and A/DS input.
  • bitswitch: one of the 8 data bit input switches.
  • inp_bitswitch: one of the 8 data bit input switches linked to a specific input port (specified via element: in).
  • efswitch: one of the 4 EF input switches.
  • velf: VELF / JVIP flip switch.
  • hex: one of the 16 hex input buttons.
  • ef: one of the 4 EF input switches.
  • thumb_minus: minus button on a thumb switch.
  • thumb_plus: plus button on a thumb switch.
Leds:
  • powerled.
  • stopled.
  • readyled.
  • errorled.
  • qled.
  • resetled.
  • pauseled.
  • runled.
  • loadled.
  • bitled: one of the 8 data leds. When attribute cycle="show" is used leds show data value on every CPU cycle, when attribute load="show" is used leds show data value on the LOAD function.
  • out_bitled: one of the 8 data leds linked to a specific output port (specified via element: out).
  • switchled: one of the 8 data leds linked to the corresponding input switch.
  • buttonled: one of the 8 data leds linked to the corresponding input button.
  • addressled: one of the 16 address leds. When attribute cycle="show" is used leds show address value on every CPU cycle.
  • nibbleled: one of the 2 nibble leds indicating which nibble is active (like on COSMAC Elf keypad).
  • fetchled: SC0 led.
  • executeled: SC1 led.
  • waitled.
  • clearled.
  • dmaled.
  • interruptled.
  • cpustateled: one of the 5 cpu state leds (SC0, SC1, WAIT, CLEAR, DMA or INTERRUPT same function as above 6 dedicated definitions above).
  • datatil: one of the 2 data TIL displays. When attribute cycle="show" is used the til shows the data value on every CPU cycle. When attribute dp="q" is used the dp led will be controlled by the Q flag.
  • addresstil: one of the 4 address TIL displays. When attribute cycle="show" is used the til shows the address value on every CPU cycle.
  • multitil: one of the 8 multi TIL displays.
  • mathled: one of the 2 WTB Board (MM57109) F leds.
Attribute action defines when a button triggers and action (press, release, both). Types switch, dipswitch and rot will default act on releae. Functions in, in_switch, ef and hex will default act on both release and press, Type push will default act on press. Attribute key specifies the PC keyboard key code for the am function (default: 77 = M). Attribute pol="rev" reverses the LED polarity for LED functions (e.g. clearled, waitled).
in - input port Input port used in function: inp_bitswitch.
init - up / down Initial siwtch button or flip switch position up or down.
label - item label (text) Iten label text.
out - output port Output port used in function: out_bitled.
pos - item position (x, y) Item position on the front panel.
range - range (low, high) Item range. Used for TNC-600 spin controls as well as EF button function
size - item size (x, y) Item size.
type color, direction, form, font, size type name Item type name:
  • dipswitch: blue dip switch with 4 switches.
  • led: color led. The attribute form can be: small (default), large, largegreen (red, green orange led), realred (COSMAC Elf 2000), realgreen, realorange, disable (disabled led).
  • png: background png image.
  • push: push button. The attribut 'size' can be small to define a small button. The attribute 'form' can be rectangle or round. Attribute 'color' can be: red, blue, orange, yellow or green. A round button can only be red or black.
  • rot: rotating switch with 16 positions.
  • spin_adi: TMC-600 A/DI input.
  • spin_adi_volt: TMC-600 A/DI mV input.
  • spin_ads: TMC-600 A/DS input.
  • spin_ads_volt: TMC-600 A/DS mV input.
  • switch: flip switch button. The attribute 'direction' can be vertical (default) or horizontal. The attribute 'form' can be elf2k_power to define a power switch fitting the COSMAC Elf 2000 background image. Attribute 'color' can be: red (regular vertical switch with a red top), blue, orange, yellow or green. Blue, orange, yellow and green colors will automatically be defined as rectangle buttons.
  • text: panel text. The attribute 'color' can be black (default) or grey. Adding '_fixed' to the color name (e.g. white_fixed) keeps the light mode color in dark mode instead of switching to the dark mode variant.
  • til: TIL display. Attribute form can be: 311 (default), 313, italic (313 italic)
  • thumb_minus: minus button on a thumb switch.
  • thumb_plus: plus button on a thumb switch.
  • thumb_text: text on a thumb switch, with color specifying white or grey text.
value - number Defines the value a specific item represents. Handling depends on the function element:
  • dipmp: 0 to 3 to identify one of the 4 memory protect dip swicthes
  • ems: 0 or 1 to identify one of the 2 rotating EMS memory swtiches
  • bitswitch: 0 to 7 to identify one of the data bit input switches
  • efswitch: 0 to 3 to identify one of the EF input switches
  • card: FRED card button value
  • bitled: 0 to 7 to identify data led number
  • addressled: 0 to 15 to identify address led number
  • cpustateled: 0 to 5 to identify cpu state led number (0=SC0, 1=SC1, 2=WAIT, 3=CLEAR, 4=DMA, 5=INTERRUPT)
  • datatil: 0 or 1 to identify one of the 2 data TIL displays.
  • addresstil: 0 to 3 to identify one of the 4 address TIL displays.
  • multitil: 0 to 7 to identify one of the 8 multi TIL displays. When attribute 'address' is specified the address value sets the specified addesss line.