Element: debugger
Debugger definition.
| Child Element | Attribute | Value | Description |
|---|---|---|---|
| scrt | mode | child elements | Set SCRT values in the Debugger tab. With mode="on", the SCRT function will be enabled in the GUI. |
| assembler | - | child elements | Set default program configuration values in the Direct Assembler tab. |
| read_value | value | address(es) (16 bit) | Force a memory address to return a specific value on every read. The value attribute (8 bit) specifies the byte to return. The element content specifies one or more addresses (comma-separated). This overrides all other memory at the specified address(es). |
| pseudo | - | forth | Select a pseudo language variant for the Debugger tab. Currently only forth is supported, which switches the debugger to the *_forth.syntax file of the detected pseudo language (e.g. PTC701_R1.7_forth.syntax) and appends " (Forth)" to the language name. If no *_forth.syntax file exists for the detected language, the standard file is used. |
Element: scrt
Set SCRT values in the Debugger tab. With mode="on", the SCRT function will be enabled in the GUI.
| Child Element | Attribute | Value | Description |
|---|---|---|---|
| call | reg | address (16 bit) | Set CALL address. The reg attribute changes the register from the default R4. |
| return | reg | address (16 bit) | Set RETURN address. The reg attribute changes the register from the default R5. |
Element: assembler
Set default program configuration values in the Direct Assembler tab.
| Child Element | Attribute | Value | Description |
|---|---|---|---|
| code_start | - | address (16 bit) | Default code start address. |
| code_end | - | address (16 bit) | Default code end address. |
| dirname | - | directory name (text) | Location of assembler file; defined as a subdirectory of the main Emma 02 data directory. If not specified, the dirname specified in system will be used (see also XML - System). |
| end | - | address (16 bit) | Default program end address. |
| filename | - | file name (text) | Initial assembler filename. |
Element: read_value
Force a memory address to return a specific value on every read. This overrides all other memory (ROM, RAM, memory-mapped I/O) at the specified address(es). Useful for testing hardware that is not yet emulated, such as counters or status registers.
| Child Element | Attribute | Value | Description |
|---|---|---|---|
| - | value | address(es) (16 bit) | The value attribute (8 bit) specifies the byte returned on every read at the address(es) specified in the element content (comma-separated). |
Example:
<debugger>
<read_value value="0x00">0x600A, 0x600B</read_value>
<read_value value="0xFF">0x8000</read_value>
</debugger>
Element: pseudo
Select a pseudo language variant for the Debugger tab. When set to forth, the debugger uses the *_forth.syntax file of the detected pseudo language (e.g. PTC701_R1.7_forth.syntax, MSI88_forth.syntax), so the disassembler and assembler show Forth-style mnemonics (DUP, SWAP, @, !, etc.) instead of the standard ones. The pseudo language type itself (e.g. "PTC") is unchanged, so all debugger functionality tied to the language keeps working.
| Child Element | Attribute | Value | Description |
|---|---|---|---|
| - | - | forth | Switch the pseudo language disassembly/assembly to the *_forth.syntax variant. The element content is the variant name; currently only forth is supported. If no *_forth.syntax file exists for the detected language, the standard file is used. |
Example:
<debugger>
<pseudo>forth</pseudo>
</debugger>