Skip to content

Commodore updates #1128

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fpscan merged 1 commit into from
Mar 21, 2026
Merged

Commodore updates #1128

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 17 additions & 9 deletions docs/library/puae.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,8 @@ Amiga Forever and TOSEC filenames are also accepted.

| Filename | Amiga Forever | Description | md5sum |
|--------------------|---------------------------|------------------------------------|----------------------------------|
| kick31034.A1000 | amiga-os-110-ntsc.rom | Kickstart v1.1 rev 31.034 NTSC | 0b8442c311caa54fb12ec88eaaa9facf |
| kick32034.A1000 | amiga-os-110-pal.rom | Kickstart v1.1 rev 32.034 PAL | 1fa1f93d3d7b51271dd1356b8b2b45a9 |
| kick33180.A500 | amiga-os-120.rom | Kickstart v1.2 rev 33.180 | 85ad74194e87c08904327de1a9443b7a |
| kick34005.A500 | amiga-os-130.rom | Kickstart v1.3 rev 34.005 | 82a21c1890cae844b3df741f2762d48d |
| kick37175.A500 | amiga-os-204.rom | Kickstart v2.04 rev 37.175 | dc10d7bdd1b6f450773dfb558477c230 |
Expand Down Expand Up @@ -435,9 +437,7 @@ If you are using RDB HDF files, please use `0,0,0,512` instead of geometry numbe

## Core options

The PUAE core has the following option(s) that can be tweaked from the core options menu. The default setting is bolded.

Settings with (Restart) means that core has to be closed for the new setting to be applied on next launch.
The PUAE core has the following option(s) that can be tweaked from the core options menu. The default setting is in bold.

- **Model** [puae_model] (**auto**|A500OG|A500|A500PLUS|A600|A1200OG|A1200|A2000OG|A2000|A4030|A4040|CDTV|CD32|CD32FR)

Expand All @@ -461,7 +461,9 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **Show Automatic Model Options** [puae_model_options_display] (**disabled**|enabled)

Show/hide default model options (Floppy/HD/CD) for 'Automatic' model. Page refresh by menu toggle required!
Show/hide default model options (Floppy/HD/CD) for 'Automatic' model.

Available only when frontend 'Core Option Categories' is disabled.

- **Automatic Floppy** [puae_model_fd] (A500OG|**A500**|A500PLUS|A600|A1200OG|A1200|A2000OG|A2000|A4030|A4040)

Expand All @@ -475,9 +477,11 @@ Settings with (Restart) means that core has to be closed for the new setting to

Default model when compact discs are launched with 'Automatic' model. Core restart required.

- **Kickstart ROM** [puae_kickstart] (**auto**|aros|kick33180.A500|kick34005.A500|kick37175.A500|kick37350.A600|kick40063.A600|kick39106.A1200|kick40068.A1200|kick39106.A4000|kick40068.A4000)
- **Kickstart ROM** [puae_kickstart] (**auto**|aros|...)

'Automatic' defaults to the most compatible version for the model. 'AROS' is a built-in replacement with fair compatibility.

'Automatic' defaults to the most compatible version for the model. 'AROS' is a built-in replacement with fair compatibility. Core restart required.
Kickstart ROMs are searched from 'system'. Core restart required.

- **Chip RAM** [puae_chipmem_size] (**auto**|1|2|3|4)

Expand Down Expand Up @@ -644,6 +648,10 @@ Settings with (Restart) means that core has to be closed for the new setting to
| splash | Splash (Show briefly) |
| both | Config + Splash (Wait for user input) |

- **WHDLoad ButtonWait** [puae_use_whdload_buttonwait] (disabled|**enabled**)

Wait for a button press on internal loading sections if the slave supports it. Core restart required.

- **WHDLoad NoWriteCache** [puae_use_whdload_nowritecache] (**disabled**|enabled)

Write cache requires running the core a few frames after closing content to trigger WHDLoad quit and flush cache to disk.
Expand All @@ -661,7 +669,7 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **Show Video Options** [puae_video_options_display] (**disabled**|enabled)

Page refresh by menu toggle required!
Available only when frontend 'Core Option Categories' is disabled.

- **Allow PAL/NTSC Hz Change** [puae_video_allow_hz_change] (disabled|enabled|**locked**)

Expand Down Expand Up @@ -777,7 +785,7 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **Show Audio Options** [puae_audio_options_display] (**disabled**|enabled)

Page refresh by menu toggle required!
Available only when frontend 'Core Option Categories' is disabled.

- **Stereo Separation** [puae_sound_stereo_separation] (0%|10%|20%|30%|40%|50%|60%|70%|80%|90%|**100%**)

Expand Down Expand Up @@ -899,7 +907,7 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **Show Mapping Options** [puae_mapping_options_display] (disabled|**enabled**)

Page refresh by menu toggle required!
Available only when frontend 'Core Option Categories' is disabled.

- **Toggle Virtual Keyboard** [puae_mapper_vkbd] (**---**)

Expand Down
45 changes: 34 additions & 11 deletions docs/library/vice.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -262,6 +262,8 @@ Save disks generated by the `#SAVEDISK:` keyword are automatically assigned the
- Alternative label for the next entry
- `<disk>.d64:<prg>`
- Load a program instead of `"*"`
- `<tape>.tap:<prg>:,1,1`
- Force non-basic tape load
- `<disk>.d64|<label>`
- Set a friendly name (shown in "Disc Control")
- `<disks>.zip#<disk>.d64`
Expand Down Expand Up @@ -361,9 +363,7 @@ Older C64 games tend to use joystick port 1 and newer ones tend to use port 2 fo

## Core options

The VICE cores have the following option(s) that can be tweaked from the core options menu. The default setting is bolded.

Settings with (Restart) means that core has to be closed for the new setting to be applied on next launch.
The VICE cores have the following option(s) that can be tweaked from the core options menu. The default setting is in bold.

#### C64 (fast/accurate/SuperCPU) specific

Expand Down Expand Up @@ -395,6 +395,8 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **SuperCPU Speed Switch** [vice_supercpu_speed_switch] (disabled|**enabled**)

Normal or Turbo 20MHz.

- **SuperCPU Kernal** [vice_supercpu_kernal] (**0**|1|2)

JiffyDOS does not work with the internal kernal!
Expand All @@ -407,28 +409,34 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **Model** [vice_c64dtv_model] (DTV2 PAL|DTV2 NTSC|**DTV3 PAL**|DTV3 NTSC|HUMMER NTSC)

Changing while running resets the system!

#### C128 specific

- **Model** [vice_c128_model] (**C128 PAL auto**|C128 NTSC auto|C128 D PAL auto|C128 D NTSC auto|C128 DCR PAL auto|C128 DCR NTSC auto|C128 PAL|C128 NTSC|C128 D PAL|C128 D NTSC|C128 DCR PAL|C128 DCR NTSC)

'Automatic' switches region per file path tags.
'Automatic' switches region per file path tags. Changing while running resets the system!

- **RAM Expansion Unit** [vice_c128_ram_expansion_unit] (**none**|128kB|256kB|512kB|1024kB|2048kB|4096kB|16384kB)

Not allowed with cartridges. Changing while running resets the system!

- **Video Output** [vice_c128_video_output] (**VICII**|VDC)

Can be toggled with the '40/80 DISPLAY' key (F7).

- **VDC Video RAM** [vice_c128_vdc_ram] (**default**|64)

VDC memory size.

| Value | Label |
|---------|-----------------------|
| default | 16kB |
| 64 | 64kB |

- **GO64 (Restart)** [vice_c128_go64] (**disabled**|enabled)
- **GO64** [vice_c128_go64] (**disabled**|enabled)

Start in C64 compatibility mode.
Start in C64 compatibility mode. Changing while running resets the system!

- **JiffyDOS** [vice_jiffydos] (**disabled**|enabled)

Expand Down Expand Up @@ -457,18 +465,26 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **Model** [vice_plus4_model] (C16 PAL|C16 NTSC|**PLUS4 PAL**|PLUS4 NTSC|V364 NTSC|232 NTSC)

Changing while running resets the system!

#### CBM-II specific

- **Model** [vice_cbm2_model] (**610 PAL**|610 NTSC|620 PAL|620 NTSC|620PLUS PAL|620PLUS NTSC|710 NTSC|720 NTSC|720PLUS NTSC)

Changing while running resets the system!

#### CBM-II 5x0 specific

- **Model** [vice_cbm5x0_model] (**510 PAL**|510 NTSC)

Changing while running resets the system!

#### PET specific

- **Model** [vice_pet_model] (2001|3008|3016|3032|3032B|4016|4032|4032B|**8032**|8096|8296|SUPERPET)

Changing while running resets the system!

#### Common

- **Printer** [vice_printer] (**disabled**|enabled)
Expand Down Expand Up @@ -501,7 +517,7 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **Warp Boost** [vice_warp_boost] (**disabled**|enabled)

Make warp mode much faster by changing SID emulation to 'FastSID' while warping.
Warp mode speedup by changing SID engine to 'FastSID' while warping. Affects audio detection during warp.

- **Autostart** [vice_autostart] (disabled|**enabled**|warp)

Expand Down Expand Up @@ -545,7 +561,7 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **Show Video Options** [vice_video_options_display] (**disabled**|enabled)

Page refresh by menu toggle required!
Available only when frontend 'Core Option Categories' is disabled.

- **Pixel Aspect Ratio** [vice_aspect_ratio] (**auto**|pal|ntsc|raw)

Expand Down Expand Up @@ -573,6 +589,8 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **Color Depth** [vice_gfx_colors] (16bit|**24bit**)

Full restart required.

#### Color palette options

##### VIC-II (C64, C128, CBM-II 5x0)
Expand Down Expand Up @@ -697,8 +715,12 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **CRTC Color Palette** [vice_cbm2_external_palette] (**default**|green|amber|white)

Native default is green.

- **CRTC Color Palette** [vice_pet_external_palette] (**default**|green|amber|white)

Native default is green.

### On-Screen Display options

- **Virtual KBD Theme** [vice_vkbd_theme] (**auto**|auto_outline|brown|brown_outline|beige|beige_outline|dark|dark_outline|light|light_outline)
Expand Down Expand Up @@ -735,7 +757,7 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **Show Audio Options** [vice_audio_options_display] (**disabled**|enabled)

Page refresh by menu toggle required!
Available only when frontend 'Core Option Categories' is disabled.

- **Drive Sound Emulation** [vice_drive_sound_emulation] (disabled|5%|10%|15%|**20%**|25%|30%|35%|40%|45%|50%|55%|60%|65%|70%|75%|80%|85%|90%|95%|100%)

Expand Down Expand Up @@ -861,7 +883,8 @@ Settings with (Restart) means that core has to be closed for the new setting to
| Value | Label |
|-------|---------------------------------|
| 1 | Joystick |
| 2 | Paddles |
| 2 | Paddles (Split) |
| 2R | Paddles (Raw) |
| 3 | Mouse (1351) |
| 4 | Mouse (NEOS) |
| 5 | Mouse (Amiga) |
Expand Down Expand Up @@ -890,7 +913,7 @@ Settings with (Restart) means that core has to be closed for the new setting to

- **Show Mapping Options** [vice_mapping_options_display] (disabled|**enabled**)

Page refresh by menu toggle required!
Available only when frontend 'Core Option Categories' is disabled.

- **Toggle Virtual Keyboard** [vice_mapper_vkbd] (**---**)

Expand Down
Loading