| Attachment | Size |
|---|---|
| 11.86 MB |
Hello everyone,
Some of you may remember the POM1 thread from earlier this year. Its big brother has reached a version I am willing to call 1.0: **POM2**, an emulator for the Apple ][, ][+, //e (unenhanced and enhanced), //c and //c Plus, with PAL variants of the //e and //c. It is free software (GPL-3.0) and runs on Linux, macOS, Windows, Raspberry Pi and in a web browser.
- Browser version (opens a PAL //c with French Touch's DIX demo): https://habib256.github.io/pom2/wasm/
- Downloads: https://github.com/habib256/pom2/releases/latest- Source: https://github.com/habib256/pom2
**How it was made**
I want to be upfront about this, because I know it matters to people here: POM2 was written with help from AI coding assistants, mostly Anthropic's Claude.
My part was to be the architect, and to build the framework the AI works inside: the design of the emulator, the rules it has to follow (every hardware port must name its source and come with a test), the reference documents it reads before touching anything, and the test suite that refuses a change that breaks something. That framework is what keeps the AI pointed in the right direction. I also decided what to build, tested it, and booted a lot of disks.
The AI did not know how an Apple II works on its own. What it got right came from the published work of the people listed below: their emulators, their dumps, their manuals and their measurements. Their work is credited in the source and in THIRD-PARTY.md. If you find your work used without proper credit, please tell me and I will fix it.
**What it does**
- Floppies (including copy-protected WOZ images), 3.5" disks and hard disk images.
- Sound: Mockingboard, Phasor and the speech cards.
- Composite colour, and RGB through the French Le Chat Mauve cards.
- CP/M on the Microsoft SoftCard and the ALS CP/M Card.
- Serial, Ethernet, FujiNet and printers (the ImageWriter II prints to PDF).
- A debugger, rewind, and sessions you can save and resume.
**Included disks**
Five disks come with POM2 and are listed in File > Disk Library, so there is something to try right away:
- **A2 File Cmd XL 1.0**, a ProDOS file manager on a 32 MB hard disk image (//e with 128 KB).
- **Dirtbike 1.1**, a motocross time trial across 30 tracks (][+ or later).
- **ChromaBreak 1.1**, a colourful brick-breaking game (enhnced //e or //c, 128 KB).
- **Micro-Sokoban 1.3**, a small crate-pushing puzzle (][+ or later).
- **DIX**, French Touch's demo anthology (PAL machine, 128 KB, Mockingboard).
A2 File Cmd and the three games are my own programs, also free software: https://github.com/habib256/a2filecmd and https://github.com/habib256/pom2games
If you own a //c, a PAL //e or a Le Chat Mauve card and can compare a program or two with POM2, that would help a lot. Bug reports are very welcome, here or on GitHub.
**Thank you**
This list is as complete as I could make it. If I missed you, it is my mistake.
*Emulators whose code or behaviour POM2 follows*
- **The MAME team**, which is the reference for most of the hardware models. By name, for the drivers POM2 ported: **R. Belmont** (SoftCard, TransWarp, Uthernet); **Rhett Aultman** and **Spiro Trikaliotis** (Uthernet I, from VICE); **Vas Crabb** and **Fabio Priuli** (SNES controllers); **Frank Palazzolo, Aaron Giles, Jonathan Gevaryahu, Raphael Nabet, Couriersud** and **Michael Zapf** (Echo+ speech); **Nathan Woods, Olivier Galibert** and **Miodrag Milanovic** (floppy device and drive sound samples); **benrg** (artifact colour).
- **AppleWin**: **William S. Simms, Michael Pohoreski** and **Tom Charlesworth** (NTSC colour); **Andrea Odetti** (Uthernet II); **Nick Westgate** (No-Slot Clock notes).
- **OpenEmulator**, by **Marc S. Ressl** (composite shader), with **Zellyn Hunter**'s apple2shader and notebook explaining it.
- **apple2js**, by **Will Scullin** (Disk II sequencer table).
- **greg-kennedy** and **Christopher G. Mason** (the ImageWriter II emulation, from the GSport/KEGS lineage).
- **Mike Daley** (web-a2e: printer character tables, screen dump) and **Shawn Bullock** (printer sound).
- **Gerard Putter** (Virtual ][ drive and printer recordings, optional, not distributed).
- **Paleotronic** (MicroM8), whose rewind and 3D view inspired POM2's.
- **The FujiNet project** and **Thomas Cherryhomes** (FujiNet).
*Test suites*
- **Tom Harte** (SingleStepTests), **Klaus Dormann** (6502/65C02 functional tests), **Frank Cringle** (zexall), **Sean Young** (The Undocumented Z80 Documented).
*Documentation, dumps and measurements*
- **Jim Sather** (Understanding the Apple II / IIe), **Linards Ticmanis** (video timing).
- **Steve Chamberlin** / BMOW (the Liron ROM dump and SmartPort notes).
- **markadev** (AppleII-RevEng dumps and the card audit), **Rich Dreher** (CFFA 2.0 firmware), **Abdess** / RetroBIOS (ROM collection).
- **John Keoni Morris** and Applesauce (WOZ and MOOF formats), **Brutal Deluxe** (Protocol Converter documentation), the **Apple II Documentation Project**, **Asimov** and the WOZ-a-day archive.
- For Le Chat Mauve: **fenarinarsa** (survey and real-hardware measurements), **Purplesoft** (whose Eve software corrected the manual), **retronik.silicium.org** (RVB Graph manual), the **system-cfg.com** forum members, **apple-iigs.info**.
- **Henry** at ReActiveMicro (ReActiveText ROM), **Lukazi** (4play and SNES MAX), **Kris Kennaway** (][-pix palette), **apple2history.org**, Nerdly Pleasures, **mrob**, 6502.org, 6502workshop.
*Software that served as test cases*
- **French Touch** (including **GROUiK**) for DIX, Oldskool, Terra Nova and the other demos. DIX is the reference POM2 is measured against. Also **Dubmood, z00m** and **rnR TAD** for the music, and **S.V. Bulba** and **Ivan Roshin** for the original PT3 player.
- **Vince "deater" Weaver**, **4am**, **Eric Rangell**, **Henry Lowe** (CardCat), **Roland Gustafsson** (Prince of Persia's RWTS18).
*Artwork and libraries*
- **Oscar Casamitjana** (Monitor II / Disk II artwork), **Omar Cornut** (Dear ImGui), **juliettef** (IconFontCppHeaders), **David Reid** (miniaudio), **Sean Barrett** (stb), and the GLFW, libslirp, Emscripten, DejaVu and Font Awesome projects.
And of course **Apple** and the people who designed these machines.
Thank you for reading. Questions, corrections and bug reports are all welcome.
Arnaud