Element: system
This mandatory tag defines basic system settings and information for the emulated machine like, name, configuration, cpu type, clock speed etc.
| child element | attribute | value | description |
|---|---|---|---|
| boot | start, dma | Boot address (16 bit) | Atribute start="yes" (default) triggers the emulated machine to boot, start="no" will not trigger a boot until a run button is pressed (on the front panel). Attribute dma="out" triggers a dmaOut on booting (used for the Cosmac Game System), dma="zero" will do the same but only if address 0 contains byte 0 (used for the FRED 1.5). |
| clock | number / fraction (0 > value > 500) | System clock speed in MHz (mandatory). | |
| config | configuration description (text) | One line description of the xml configuration. This tag is used as description on the top line of the GUI when selected. | |
| cpu | system, 1801, 1802, 1804 or 1805 (alternatives: system00, cpu1801, cpu1802, cpu1804 or cpu1805, rca1801, rca1802, rca1804 or rca1805) | CPU type | |
| dirname | directory name (text) | Main machine directory (mandatory). This tag is used as default directory for all load or save actions unless a dedicated dirname tag is used within other main tags. | |
| dma | out | number of cpu cycles | Generate a dmaOut every specificed number of cpu cycles. When no attribute is specified dmaOut cycles are started on startup. When out="q" is specified it will start after the first Q pulse. When out="x" is specified it will start after the first OUT x (x=1 to 7). |
| dma_in | - | reset | Used to execute a dmaIn even when cpuMode is reset or pause (used in FRED machines) |
| f12 | - | stop | Change behavior of F12 to stop emulated machine instead of reseting it. |
| init | ef | 0 or 1 | Set initialization value of (unused) EF flags, ef="x" can be 1 to 4. |
| int | - | number of cpu cycles | After every specified number of cpu cycles generate an interrupt |
| monitor | - | EF flag (1 to 4) | Used for Oscom Nano monitor delay |
| name | name (text) | Machine name (mandatory). This tag is used as window title (during emulation) as well as in the GUI machine pull down menu. It is strongly recommended to use one directory per machine and within that directory use one and the same machine name for all files. | |
| statusbar | out | comx, diag, vip2 or cidelsa | Use statusbar on main video window. Out="x" value defines statusbar LED output number for the Cidelsa statusbar. |