Systems¶
Regenerator 2000 ships with built-in definitions for 13 6502-based systems—supplying ROM entry points, hardware register labels, inline side comments, and excluded address ranges.
Switch the active target system in File → Document Settings (Alt+D or Ctrl+Shift+D).
Supported Systems¶
Enabled by Default¶
| System | Label Groups | Comments | Excludes |
|---|---|---|---|
| Commodore 64 | BASIC, KERNAL, Lower Page | ||
| Commodore 128 | KERNAL | ||
| Commodore VIC-20 | BASIC, KERNAL, Lower Page | ||
| Commodore Plus4 | KERNAL, Lower Page | ||
| Commodore PET 2.0 | BASIC, KERNAL, Lower Page | ||
| Commodore PET 4.0 | BASIC, KERNAL, Lower Page | ||
| Commodore 1541 | — | — | — |
Experimental (Disabled by Default)¶
These definitions ship with enabled = false—dump the built-in config files and flip enabled = true (see Custom Systems) to turn them on:
| System | Label Groups | Comments | Excludes |
|---|---|---|---|
| NES | SYSTEM | — | |
| Apple II | — | ||
| Atari 8bit | SYSTEM | ||
| BBC Micro | SYSTEM | ||
| Oric 1.0 | SYSTEM | ||
| Oric 1.1 | SYSTEM |
Label Groups¶
Each [labels.<GROUP>] table becomes an independent toggle checkbox under System Labels in Document Settings:
- KERNAL
- ROM entry points and operating system jump tables (enabled by default).
- BASIC
- BASIC interpreter routines, tokens, and internal tables.
- Lower Page
- Zero-page and page-one OS variables.
- SYSTEM
- Hardware registers and memory-mapped I/O addresses.
Custom Systems¶
Drop a system-*.toml file into your configuration directory to extend an existing machine or define a new 6502 target:
| Platform | Configuration Directory |
|---|---|
| macOS | ~/Library/Application Support/regenerator2000/ |
| Linux | ~/.config/regenerator2000/ |
| Windows | C:\Users\<User>\AppData\Roaming\regenerator2000\config\ |
Verify Your Path
Run regenerator2000 --help—the exact configuration directory path for your system prints near the bottom of the output.
Creating from Built-in Templates¶
-
Dump all built-in system files to inspect or override them:
-
Create or edit a
system-<name>.tomlfile—click the+pins below to inspect each field:system-acme_computer.tomlsystem_name = "Acme Computer" # (1)! enabled = true # (2)! excluded = ["9000-900F"] # (3)! [labels.VIDEO] # (4)! "9000" = "VID_CTRL" "9001" = "VID_STATUS" "900E" = "VID_BORDER_COLOR" "900F" = "VID_BG_COLOR" [comments] # (5)! "9000" = "Video Control Register" "9001" = "Video Status (read-only)" "900E" = "Border Color" "900F" = "Background Color"- Unique display name in the Target System selector. Reuse a built-in name (such as
"Commodore 64") to replace the built-in definition. - Set
falseto hide the system from the selector without deleting the file. - Optional uppercase
START-ENDhex ranges skipped during symbolic analysis (hides the Exclude well-known addresses checkbox if omitted). - Optional group table—keys are uppercase hex addresses without
$or0x. Each group gets a checkbox in Document Settings. - Optional side-comment table displayed when Show system comments is checked.
- Unique display name in the Target System selector. Reuse a built-in name (such as
-
Restart Regenerator 2000—Acme Computer appears in Document Settings automatically.
Complete TOML Schema Reference & Naming Rules
| Field | Type | Description |
|---|---|---|
system_name |
string |
Required. Unique display name in Document Settings → Target System. |
enabled |
bool |
Hides the system from the selector when false. |
labels |
table |
Nested [labels.GROUP_NAME] tables for toggleable symbol groups. |
labels.GROUP_NAME |
table |
Map of uppercase hex strings ("D020") to symbol identifiers. |
comments |
table |
Map of uppercase hex strings ("D020") to inline side-comment text. |
excluded |
array[string] |
Address ranges ("START-END") ignored during symbolic code analysis. |
- File names follow
system-<name>.toml(spaces replaced by underscores);system_namematching is case-sensitive. - Legacy
platform-*.tomlandplatform-*.jsonfiles remain supported for backward compatibility. - Regenerator 2000 logs TOML syntax errors and skips invalid files rather than crashing.
- Back up customized files before re-running
--dump-system-config-files.