Vintage Computing Carinthia

C64 | C128 | Amstrad CPC | CP/M | Amiga | Atari | Commander X16

Commodore 64 Starter Guide

VICE Emulator (Linux, Windows, Mac)
- Wil's Pick: Version 3.2 native für Windows WinVICE-3.2-x86.7z
  - Vorteile der Version 3.2: Filebrowser erlaubt Kopieren und Einfügen von Ordnernamen (in späteren Versionen entfernt)
  - Einzelschritt-Debugger mit Speicher- und Dissassembly-Ansicht (in späteren Versionen nicht verfügbar)
- oder neueste Version https://vice-emu.sourceforge.io/, der 64er-Emulator ist x64sc
  - Vorteile der neuesten Version: genauere Emulation bei Hardware-Tricks
  - Besser für Streaming geeignet
  - Empfehlung: Umstellen der Shortcuts:
    - Alt+O to open settings
    - Klicke auf Host -> Hotkeys -> Load from
    - auf bin klicken, dann in das Verzeichnis von VICE, dann auf C64
    - gtk3-winvice-legacy.vhk auswählen
    - Dann unter Settings auf Save Settings klicken
- VICE Keyboard Layout
Ein Spiel/Programm laden und starten
- die .PRG oder .D64 Datei auf VICE ziehen, diese wird dann geladen und automatisch gestartet
Programmieren
- BASIC: entweder direkt im (emulierten) C64 entwerfen oder etwas komfortabler mit CBM prg Studio
- für C wird der cc65-Cross-Compiler empfohlen, Programm wird mit normalem Texteditor erstellt
- Assembler: Viele verschiedene Programme, Wil's Pick: ca65 (Teil der cc65-Suite) gemeinsam mit LAMAlib
- Docker-Container mit Tools, darunter cc65 und LAMAlib: docker run --rm vintagecomputingcarinthia/c64build
Grafiken erstellen
- PETSCII: Marc's PETSCII Editor
- Sprites: OpenSprite
- Hires und Koala-Grafiken: Multipaint
- Tilemaps und Font-Editor: CharPad Pro ($9.99)
- DirArt: Editor in DirMaster
Musik und Sounds
- GoatTracker 2.76
  - [GoatTracker 2] (https://www.youtube.com/watch?v=dZyBP7bTKzc) Tutorial(uses older version of GoatTracker)
  - Sounds are implemented as GoatTracker instruments
Erstellen von virtuellen Disketten (Standardformat .d64)
- im VICE Alt+8 drücken, gewünschten Dateinamen eingeben und auf "Create Image" klicken, oder
- das Tool DirMaster installieren, damit können Disks, erstellt und Files per Drag-and-Drop zwischen Diskette und OS hin-und herkopiert werden, oder
- das Kommandozeilentool c1541 (wird bei VICE mitinstalliert) erlaubt das Erstellen von Disketten und deren Inhalten
Hardware
- Original-Netzteil fehleranfällig, möglicher Ersatz
  - Commodore C64 PSU, schlicht und günstig
  - Keelog, Strom- und Spannungsanzeige
- neuer Joystick: Arcadr, z.B. im SinTech Shop
- SD-Karten-Laufwerk SD2IEC, kein 1541er Emulator sondern ein IEC-Laufwerk für SD-Karten. Kann .d64, .d71, .d81 Images mappen
- Fehlerdiagnose mit der Pictorial C64 Fault Guide
Sonstiges
- C64-Tools Online Tools (in Entwicklung)

Commodore 128 Starter Guide

VICE C128 Emulator (Linux, Windows, Mac)
- Wil's Pick: Version 3.2 native für Windows WinVICE-3.2-x86.7z, Emulator ist x128
  - Vorteile der Version 3.2: Filebrowser erlaubt Kopieren und Einfügen von Ordnernamen (in späteren Versionen entfernt)
  - Einzelschritt-Debugger mit Speicher- und Dissassembly-Ansicht (in späteren Versionen nicht verfügbar)
  - Tastaturmapping von Wil in Verzeichnis WinVICE-3.2-x86-r34842/C128 speichern
- oder neueste Version https://vice-emu.sourceforge.io/, der 64er-Emulator ist x128
  - Vorteile der neuesten Version: genauere Emulation bei Hardware-Tricks
  - Besser für Streaming geeignet
  - Empfehlung: Umstellen der Shortcuts:
    - Alt+O to open settings
    - Klicke auf Host -> Hotkeys -> Load from
    - auf bin klicken, dann in das Verzeichnis von VICE, dann auf C128
    - gtk3-winvice-legacy.vhk auswählen
    - Dann unter Settings auf Save Settings klicken
- VICE Keyboard Layout
Ein Spiel/Programm laden und starten
- die .PRG oder .D64 Datei auf VICE ziehen, diese wird dann geladen und automatisch gestartet
Programmieren
- BASIC: entweder direkt im (emulierten) C128 entwerfen oder etwas komfortabler mit CBM prg Studio
  - Übersicht zu BASIC 7.0-Befehle
  - Blitz-BASIC-Compiler für C128-Programme
- für C wird der cc65-Cross-Compiler empfohlen, Programm wird mit normalem Texteditor erstellt
- Assembler: Viele verschiedene Programme, Wil's Pick: ca65 (Teil der cc65-Suite) gemeinsam mit LAMAlib
  - LAMAlib-Command zum Erzeugen eines C128-Programms: ass -128 file.s
  - Typischer Speicherbereich für kurze Assemblerprogramme: $1300-$17ff
  - Ausschalten der Sprite-Routinen im IRQ um direkt die Spritepositionen im VIC-Register zu setzen: POKE $0A04,0
  - Ausschalten der Shadow-VIC Routinen im Kernal: POKE $d8,$ff
  - nützliche VDC-Routinen
Grafiken erstellen
- PETSCII: Marc's PETSCII Editor
- Sprites:
  - interner Sprite-Editor SPRDEF
  - OpenSprite
  - SpritePad
- Hires und Koala-Grafiken: Multipaint
- Tilemaps und Font-Editor: CharPad Pro ($9.99)
- DirArt: Editor in DirMaster
Musik und Sounds
- ident zum C64
Erstellen von virtuellen Disketten (Standardformat .d64)
- im VICE Alt+8 drücken, gewünschten Dateinamen eingeben und auf "Create Image" klicken, oder
- das Tool DirMaster installieren, damit können Disks, erstellt und Files per Drag-and-Drop zwischen Diskette und OS hin-und herkopiert werden, oder
- das Kommandozeilentool c1541 (wird bei VICE mitinstalliert) erlaubt das Erstellen von Disketten und deren Inhalten
VC1571
- 1571er auf zweiseitigen Modus stellen: OPEN1,8,15,"U0>M1":CLOSE1

CPM Starter Guide

C128
- 40/80 Zeichen Modus umschalten:
  - mit utilities disk: DEVICE CONOUT = 40COL
  - mit utilities disk: DEVICE CONOUT = 80COL
  - oder neu booten mit 40/80 Zeichen Taste entsprechend gedrückt
- Terminal issues
  - "7" is displayed instead of carriage return: vt52 expected, but C128 has an ADM terminal
ctools Kommandozeilen-Tools für den Zugriff auf C64 und C128 CP/M Disketten-Images (*.D64)
- Inhaltsverzeichnis einer Diskette anzeigen: ctools diskfile.dsk d
- Datei auf Diskette hinzufügen (put): ctools diskfile.dsk p filename
- Datei von Diskette kopieren (get): ctools diskfile.dsk g filename
- Datei von Diskette löschen (erase): ctools diskfile.dsk e filename
CP/M applications are typical text applications
- there was a graphics standard, but the original Commodore CP/M did not have a driver for it
- Peter Dassow implemented a driver for C128 http://www.z80.eu/gsx.html

Amstrad CPC Starter Guide

Emulatoren
- WinApe2.0B1 Alle CPC Rechner. Mit Debugger (F7).
- CaPriCe Forever
- Ggf. Retro Virtual Machine Sehr bunt. Emulator für mehrere Systeme.
Ein Spiel/Programm laden und starten (Amstrad CPC 6128)
- Disketten-Image (dsk-Datei) einlegen
- cat für Inhaltsverzeichnis
- run "Dateiname" zum Staren
- eine detaillierte Anleitung dazu findet sich im Artikel How to play Amstrad CPC games on your PC using an emulator in 2021
Programmieren
- Übersicht: Amstrad CPC Programming Tutorials
- BASIC kann direkt im CPC programmiert werden (oder Programm in Texteditor schreiben und mit Ctrl+F11 in WinApe hineinpasten). Wichtige Befehle sind hierbei:
  - SAVE
  - LOAD
  - LIST
  - EDIT <Zeilennummer> Überschreiben wie beim C64 ist nicht möglich. Aber man hat einen zweiten Cursor (meist mittels Shift) und eine Copy-Taste (oft POS1 oder Einfg). Damit kann man dann kopieren.
- Assembler
  - In WinApe eingebaut. F3 drücken.
  - In CaPriCe Forever: Help! -> Show Expert Menu, dann unter Extra -> Code Explorer im Reiter den Pasmo Assembler aufrufen
  - Z80 Assembly programming for the Amstrad CPC with ChibiAkumas
- C
  - Mehrere Möglichkeiten. Z.b. IDE von CPCtelera
  - Programming in C on the CPC (Forum thread)
  - cpc-dev-tool-chain: a portable toolchain for C/ASM development targetting CPC
Grafiken erstellen
- Multipaint
- AMSCII mit Amstrad ASCII Exporter
Hardware
- Laufwerks-Emulation mit Gotek oder Lotarek
Arbeiten mit Disketten
- ManageDsk - CPCWiki bearbeiten der dsk-Dateien für den CPC
Weiterführendes

Amiga Starter Guide

Emulatoren
- WinUAE – Gold-Standard, Windows-only. Extrem konfigurierbar, Cycle-exact, eingebauter Debugger. Steilste Lernkurve.
- FS-UAE – Cross-Platform (Windows, Mac, Linux). Benutzerfreundlicher, OpenRetro-Spieldatenbank, basiert auf dem WinUAE-Kern.
- Amiberry – Optimiert für Raspberry Pi / ARM. Basiert ebenfalls auf WinUAE.
- Amiga Forever – Kommerzielles Paket mit lizenziertem Kickstart-ROMs und vorkonfiguriertem WinUAE. One-Click-Lösung.
- Alle Emulatoren benötigen Kickstart-ROMs (legal über Amiga Forever oder eigene Dumps von Originalhardware).
Modelle und Chipsets – Kurzüberblick
- OCS (Original Chip Set): A500, A1000, A2000 – 32 Farben aus 4096, 68000 CPU. Die Standard-Zielplattform.
- ECS (Enhanced Chip Set): A500+, A600, A3000 – Inkrementelle Verbesserungen (z. B. bis zu 2 MB Chip-RAM), neue Videomodi.
- AGA (Advanced Graphics Architecture): A1200, A4000, CD32 – 256 Farben aus 16,8 Mio. (bis zu 262.144 in HAM8), 68020/040 CPUs.
- Audio ist auf fast allen Modellen identisch: Paula-Chip, 4 Kanäle, 8-Bit PCM Samples. (A1000 ohne Software-Audio-Filter).
Ein Spiel/Programm laden und starten
- .ADF-Datei (Amiga Disk File) als Diskette einlegen, oder
- Verzeichnis als Festplatte mounten und Programm aus der Shell starten
Programmieren
- Assembler: vasm (vasmm68k_mot für Motorola-Syntax) gemeinsam mit vlink als Linker. Portabel, aktiv gepflegt, unterstützt 68000–68060. Kompatibel mit klassischen Devpac/ASM-One Quelltexten.
- C: vbcc – Optimierender Cross-Compiler von Volker Barthelmann (selber Autor wie vasm/vlink). Erzeugt kompakte Binaries, unterstützt Kickstart 1.3 bis AmigaOS 3.x. Oder Bebbo's GCC – GCC-basiert, größeres Ökosystem, erforderlich für ACE-Engine.
- BASIC: AMOS (anfängerfreundlich, spieleorientiert) oder Blitz Basic (schneller, Inline-Assembler, Open Source als AmiBlitz3).
- Game Engines: Scorpion Engine (visueller Editor, Windows IDE, erzeugt Games für OCS bis AGA), ACE (C-Bibliothek, benötigt Bebbo's GCC), Sevgi Engine (C-basiert, Tiled-Import, ptplayer integriert).
- VS Code Integration: Amiga Debug Extension – GCC 14.2, Source-Level-Debugging mit WinUAE, Grafik-Debugger mit Copper/Blitter-Visualisierung.
- Referenz: Amiga Hardware Reference Manual (online)
Grafiken erstellen
- Deluxe Paint – Das klassische Amiga-Grafikprogramm. Unter Emulation verwenden (DPaint IV AGA für AGA-Maschinen).
- DPaint.js – Moderner Browser-basierter DPaint-Klon. Liest/schreibt IFF ILBM, eingebauter Amiga-Emulator-Preview. Hervorragend für Cross-Development.
- GrafX2 – Freies Pixel-Art-Programm, inspiriert von DPaint und Brilliance.
- Multipaint – Multi-Plattform Retro-Pixel-Editor, unterstützt auch Amiga-Constraints.
Musik und Sounds
- ProTracker – Der legendäre 4-Kanal MOD-Tracker. Unter Emulation oder als Clone für moderne Plattformen.
- BassoonTracker – Browser-basierter ProTracker-Klon in JavaScript. Spielt und editiert .mod-Dateien.
- OctaMED – Erweiterter Tracker mit 4–8+ Kanälen und MIDI-Support.
- ptplayer von Frank Wille – ProTracker-Replay-Routine in 68000 Assembler, Public Domain, funktioniert mit vasm und vbcc/GCC. Standard für Musik-Einbindung in eigenen Programmen. Auf Aminet verfügbar.
Erstellen von virtuellen Disketten (Standardformat .adf)
- In WinUAE/FS-UAE können ADF-Dateien direkt erzeugt werden
- Alternativ: Verzeichnis als Amiga-Festplatte mounten (einfacher für Entwicklung)

Atari Starter Guide

Emulator
- Altirra Emulator
Books
- Das Atari ProfiBuch (2018)
- 6502 Assembler-Kurs für Beginner
Musik
- Raster Music Tracker
Videos
- Spielentwicklung in 6502 Assembler für 8-Bit Heimcomputer (2016) von Thomas Schulz (8bitjunkie)

Commander X16 Starter Guide

Der Commander X16 ist ein moderner 8-Bit-Hobby-Computer von David Murray (The 8-Bit Guy). WDC 65C02S CPU @ 8 MHz, VERA-FPGA für Grafik/Sound/SD-Karte, Yamaha YM2151 FM-Synthesizer. Läuft erweitertes Commodore BASIC V2. Kein C64-Klon – eigenes Memory-Layout, eigene I/O-Adressen, eigene Grafik-/Sound-Architektur. KERNAL-Aufrufkonventionen sind aber weitgehend Commodore-kompatibel.

Emulatoren
- x16emu – Offizieller Emulator (Windows, Mac, Linux). Aktuelle Version: R48.
  - Wichtige Kommandozeilenoptionen:
    - -prg file.prg -run – PRG laden und starten
    - -bas file.bas -run – BASIC-Programm (ASCII) laden und starten
    - -fsroot dir – Host-Verzeichnis als Dateisystem mounten (bevorzugte Methode seit R42). Dateinamen im Verzeichnis sollten dem 8.3-Standard entsprechen.
    - -sdcard image.img – SD-Karten-Image (FAT32) einbinden
    - -debug – Eingebauter Debugger (F12 zum Aktivieren)
    - -joy1 SNES – Tastatur als SNES-Gamepad mappen
  - Tipp: Seit R47/R48 wird oft ein kombiniertes rom.bin benötigt, das alle Banks enthält.
- Box16 – Alternativer Emulator (C++ Fork). ImGui-basierter Debugger mit Memory Inspector und VERA VRAM Viewer.
- Web-Emulator – Direkt im Browser ausprobieren.
Ein Spiel/Programm laden und starten
- LOAD "FILE.PRG" gefolgt von RUN (BASIC) oder SYS $0801 (Maschinensprache)
- Oder Emulator starten mit: x16emu -prg file.prg -run
Programmieren
- BASIC: Erweitertes Commodore BASIC V2 im ROM, mit vielen Ergänzungen (ab R42):
  - Grafik: SCREEN, LINE, RECT, CIRCLE, CHAR
  - Tiles: TILE, VLOAD, VPOKE/VPEEK für direkten VERA-Zugriff (Register bei $9F20–$9F29)
  - Sound: FMPLAY, FMINST, FMCHORD, PSGPLAY, PSGCHORD, PSGWAV
  - Tutorials: 8bitcoding.com – ausführliche X16 BASIC-Tutorials
- C: cc65 – Cross-Compiler mit vollem CX16-Target (-t cx16).
  - Headers cx16.h / cbm.h für VERA, Joystick, Maus, KERNAL.
  - Xist16 – Grafik-Bibliothek für cc65 CX16-Projekte.
- Assembler: WDC 65C02S mit vollständigem 65C02-Befehlssatz (PHX, PHY, BRA, STZ, etc.).
  - Wil's Pick: ca65, Kompilieren mit -t cx16.
  - CODEX – Eingebauter Assembler/Monitor im ROM (seit R41).
  - Zero Page: Virtuelle 16-Bit-Register r0–r15 liegen bei $02–$21.
- Prog8: prog8 – Strukturierte Sprache, kompiliert zu optimiertem Maschinencode.
Grafiken erstellen
- VERA-Fähigkeiten: 128 KB VRAM (Zugriff über Datenfenster), 2 Layer, 128 Sprites (bis 64×64), 256 Farben aus 4096 (frei definierbare Palette).
- VERA Graphics Converter (VGC) – Konvertiert Bilder in VERA-Binärdaten.
- GIMP + VERA Plugin – Export für Tilesets/Bitmaps.
- Tiled + tmx2vera – Map-Editor Integration.
- x16-tile-editor – Editor, der direkt auf dem X16 läuft.
Musik und Sound
- VERA PSG – 16-Kanal Stereo (Pulse, Sawtooth, Triangle, Noise).
- Yamaha YM2151 (OPM) – 8-Kanal 4-Operator FM-Synthesizer @ 3,579 MHz.
- VERA PCM – Sample-Wiedergabe bis 48 kHz, 16-Bit Stereo.
- Furnace Tracker – Empfohlener Tracker für FM + PSG mit ZSM-Export.
- ZSound – Standard-Library für Musik- und SFX-Wiedergabe in eigenen Programmen.
Hardware
- Commander X16 Developer Edition
  - 65C02S @ 8 MHz, 2 MB Banked RAM (Standard ab Dev Edition), 512 KB ROM.
  - VERA-Modul: 128 KB VRAM, VGA/Composite/S-Video/RGB Ausgänge.
  - 2 SNES-Controller-Ports, PS/2 Keyboard & Maus, SD-Karten-Slot (FAT32).
Wesentliche Unterschiede zum C64 (für Commodore-Umsteiger)
- CPU: 65C02S (8 MHz, keine illegalen Opcodes).
- Video: VERA (128 KB VRAM, freie Palette, Sprites bis 64x64).
- Sound: FM-Synthese + PSG + PCM.
- Speicher: 40 KB Low RAM + 2 MB Banked High RAM (Fenster bei $A000–$BFFF).
- Controller: SNES-Gamepads statt Atari-Joysticks.
- Zero Page: r0–r15 Register statt C64-Standardbelegung.
Weiterführendes
- Programmer's Reference Guide
- CX16 Community Forum