Ω
Element: frontpanel
Front panel definition, use init="on" to open the front panel on startup of the emulated machine. The multi 7 seg TIL display (type="multitil") definitions are as used for the Cosmicos and Membership Card frontpanels 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 sub-dir of the main Emma 02 data directory. Only used for the Membership Card frontpanels rev L and later. If not specified the dirname specified 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 frontpanels rev L and later. When pol="rev", polarity of ROM date is reveresed. 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. 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 sub-dir of the main Emma 02 data directory. If not specified the dirname specified in 'system' will be used (see also XML - system). | |
| filename | high, pol, wait | file name (text) | Front panel background image filename (png). |
| function | action, type | item function |
Buttons and switches:
|
| init | up / down | Initial siwtch button or flip switch position up or down. | |
| label | item label (text) | Iten label text. | |
| 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:
|
| value | number | Defines the value a specific item represents. Handling depends on the function element:
|