improvements support

- vic20
- nes-action53
- fds
- bininfo: add disasm & hexdump

Author: kassane

.github/workflows/ci.yml

@@ -61,52 +61,35 @@ jobs:
         run: zig build sdk-build --summary all
 
       - name: Build NES examples and generate Mesen label files
-        run: zig build nes-hello1 nes-hello2 nes-hello3 nes-zig-logo nes-fade nes-sprites nes-random nes-pads nes-color-cycle nes-fullbg nes-mappers nes-cnrom-hello nes-unrom-hello nes-unrom-512-hello nes-mmc1-hello nes-mmc3-hello nes-gtrom-hello gen-labels --summary all
+        run: zig build nes-hello1 nes-hello2 nes-hello3 nes-zig-logo nes-fade nes-sprites nes-random nes-pads nes-color-cycle nes-fullbg nes-mappers nes-cnrom-hello nes-unrom-hello nes-unrom-512-hello nes-mmc1-hello nes-mmc3-hello nes-gtrom-hello nes-action53-hello fds-hello gen-labels --summary all
 
-      - name: Build C64 examples
-        run: zig build c64-hello c64-fibonacci c64-plasma --summary all
+      - name: Build Commodore examples (C64, VIC-20, CX16, GEOS)
+        run: zig build c64-hello c64-fibonacci c64-plasma vic20-hello cx16-hello cx16-k-console-test geos-hello --summary all
 
-      - name: Build Commander X16 examples
-        run: zig build cx16-hello cx16-k-console-test --summary all
+      - name: Build Atari examples (Lynx, 2600, 8-bit)
+        run: zig build lynx-hello atari2600-colorbar atari2600-3e-colorbar atari8dos-hello atari8-cart-hello --summary all
 
-      - name: Build Atari Lynx example
-        run: zig build lynx-hello --summary all
-
-      - name: Build Atari 2600 examples
-        run: zig build atari2600-colorbar atari2600-3e-colorbar --summary all
-
-      - name: Build Atari 8-bit examples
-        run: zig build atari8dos-hello atari8-cart-hello --summary all
-
-      - name: Build PC Engine examples
-        run: zig build pce-color-cycle pce-color-cycle-banked --summary all
-
-      - name: Build MEGA65 examples
-        run: zig build mega65-hello mega65-plasma mega65-viciv --summary all
-
-      - name: Build Neo6502 example
-        run: zig build neo6502-graphics --summary all
+      - name: Build PC Engine, MEGA65, Neo6502 examples
+        run: zig build pce-color-cycle pce-color-cycle-banked mega65-hello mega65-plasma mega65-viciv neo6502-graphics --summary all
 
       - name: Build SNES examples
         run: zig build snes-hello snes-color-cycle snes-zig-logo snes-pi-test snes-pi-fastrom snes-hirom-hello snes-pads --summary all
 
-      - name: Build Apple IIe example
-        run: zig build apple2-hello --summary all
-
-      - name: Build mos-sim from source and run sim-hello benchmark
-        run: zig build run-sim-hello --summary all
-
-      - name: Check all outputs with bininfo
-        run: zig build check-outputs --summary all
+      - name: Build Apple IIe and mos-sim examples
+        run: zig build apple2-hello run-sim-hello --summary all
 
       - name: Verify outputs
         run: |
+          zig build check-outputs --summary all
           ls -la zig-out/bin/
           for f in \
             hello1.nes hello2.nes hello3.nes zig-logo.nes fade.nes sprites.nes random.nes pads.nes color-cycle.nes \
             fullbg.nes mappers.nes cnrom-hello.nes unrom-hello.nes unrom-512-hello.nes mmc1-hello.nes mmc3-hello.nes gtrom-hello.nes \
+            action53-hello.nes fds-hello.fds \
             c64-hello.prg fibonacci.prg plasma.prg \
+            vic20-hello.prg \
             cx16-hello.prg cx16-k-console-test.prg \
+            geos-hello.cvt \
             lynx-hello.bll \
             colorbar.a26 colorbar-3e.a26 \
             atari8dos-hello.xex atari8-cart-hello.rom \
@@ -249,7 +232,7 @@ jobs:
       - name: Make emutest executable
         run: chmod +x tt/emutest/emutest
 
-      - name: NES screenshot tests (Mesen-X)
+      - name: NES and Atari 2600 screenshot tests
         run: |
           run_emutest() {
             local f=$1 core=$2 rc=0
@@ -266,18 +249,6 @@ jobs:
                    gtrom-hello.nes; do
             run_emutest "$f" mesen_libretro.so
           done
-
-      - name: Atari 2600 screenshot tests (Stella2014)
-        run: |
-          run_emutest() {
-            local f=$1 core=$2 rc=0
-            tt/emutest/emutest -T \
-              -L "tt/libretro/${core}" \
-              -r "zig-out/bin/$f" \
-              -t tools/emutest.lua || rc=$?
-            if [ $rc -eq 1 ]; then echo "FAIL: $f"; exit 1; fi
-            echo "OK: $f (rc=$rc)"
-          }
           for f in colorbar.a26 colorbar-3e.a26; do
             run_emutest "$f" stella2014_libretro.so
           done

README.md

@@ -167,8 +167,11 @@ Output files land in `zig-out/bin/`.
 | `nes-mmc3-hello` | NES MMC3 | mos6502 | `.nes` |
 | `nes-gtrom-hello` | NES GTROM | mos6502 | `.nes` |
 | `nes-unrom-512-hello` | NES UNROM-512 | mos6502 | `.nes` |
+| `nes-action53-hello` | NES Action53 (mapper 28) | mos6502 | `.nes` |
+| `fds-hello` | Famicom Disk System | mos6502 | `.fds` |
 | `c64-hello`, `c64-fibonacci` | Commodore 64 | mos6502 | `.prg` |
 | `c64-plasma` | Commodore 64 | mos6502 | `.prg` |
+| `vic20-hello` | Commodore VIC-20 (24K) | mos6502 | `.prg` |
 | `cx16-hello` | Commander X16 | mosw65c02 | `.prg` |
 | `cx16-k-console-test` | Commander X16 | mosw65c02 | `.prg` |
 | `lynx-hello` | Atari Lynx | mos6502 | `.bll` |
@@ -225,6 +228,9 @@ sieve<127>: 31 primes  (6905 cycles)
 - **NES MMC3 hello** — uses translated `mapper.h`; calls `set_prg_bank(0)` to initialise MMC3 PRG bank. ROM: 512 KB PRG + 256 KB CHR ROM.
 - **NES GTROM hello** — uses translated `mapper.h`; GTROM (Codemasters) flash mapper. ROM: 512 KB PRG flash.
 - **NES UNROM-512 hello** — uses translated `mapper.h`; calls `set_prg_bank(0)` and `set_chr_bank(0)` to initialise mapper 30 registers. ROM: 512 KB PRG + 32 KB CHR RAM.
+- **NES Action53 hello** — uses translated `mapper.h`; mapper 28 (Action53 multicart). ROM: 128 KB PRG + 8 KB CHR RAM.
+- **FDS hello** — Famicom Disk System; uses raw PPU register writes via `nes/hardware.zig` (no neslib — FDS has no CHR ROM, raw PPU only). Writes dark-green backdrop (`$1A`) to palette `$3F00`.
+- **VIC-20 hello** — uses CBM KERNAL `cbm_k_chrout` to print "HELLO VIC20!", then cycles VIC chip background/border colour register (`$900F`). Targets 24K memory expansion, loads at `$1201`.
 - **C64 hello** — uses translated `c64.h` (VIC-II typed struct) via `b.addTranslateC`; cycles VIC-II border colour register.
 - **CX16 hello** — uses CBM KERNAL `cbm_k_chrout` to print "HELLO X16!", then cycles the border colour register.
 - **Lynx hello** — uses translated `_mikey.h` (MIKEY typed struct) via `b.addTranslateC`; animates all 32 palette entries.