AtariOnline Puts MAC/65 and the DDT Debugger in a Web Browser
In early April 2021 the AtariAge member Elkino announced a web page that boots an Atari 8-bit with the OSS MAC/65 cartridge and its DDT debugger inside a browser tab. The page, eahumada.github.io/AtariOnline/mac65/mac65-mame.html, is part of a larger work-in-progress site called AtariOnline. It uses the JavaScript build of MAME as its emulator.
What you can do with it
The page boots straight into the MAC/65 environment with a sample disk mounted. Elkino's example session loads a sprite demo, assembles it and runs it under the debugger:
ENTER #D:SPRITE1.LST
ASM
DDT
G 500B
The numeric keypad stands in for a joystick, and if MAME detects a gamepad you can move the sprite with that. The AtariOnline repository also has pages for the Atari Assembler Editor cartridge (so you can follow the book Atari Roots on a live machine), Atari BASIC, FastBasic, games and demos. Elkino invited others to fork it to publish their own interactive content.
Why he built it
Elkino said the idea came from watching the YouTube videos of 8-Bit and More without having a MAC/65/DDT cartridge to hand. His aim was teaching and learning: someone who sees a 6502 tutorial video should be able to search for an Atari emulator page and start typing code right away, instead of first setting up an IDE, a cross-assembler and an emulator, which can put beginners off. He also hoped that browser emulators would one day get network support, for example a FujiNet-style N: or R: device over WebSockets, so that new and old Atari software could be played online just by opening a page.
Teething problems: the keyboard
Early testers ran straight into key-mapping problems. MAME maps Atari keys by their physical position on a US keyboard, so a UK-layout user couldn't even type the characters needed to load a file, and the cursor keys didn't work. Elkino forked MAME's atari400 driver, changed the mappings and rebuilt it with Emscripten:
- F2 / F3 / F4 = START / SELECT / OPTION (as in Altirra)
- F7 = BREAK
- Left Alt = the Atari (inverse video) key
- Backspace deletes, Ctrl+Insert inserts a space, Ctrl+Backspace deletes forward
He also put a picture of the original Atari keyboard under the emulator so you can find keys by position. Users with non-US keyboards still found it hard going, and he acknowledged that the JavaScript MAME of the time was not a very accurate Atari emulator either.
Why it matters
Zero-install access to a period-correct assembler is a real help for anyone working through old books such as Atari Roots or magazine assembly tutorials. It came at a time when browser-based emulation, including the Atari target of 8bitworkshop, was making it easier to share interactive Atari programs on the web.
Try it
Open the MAC/65 page above in a desktop browser with a US keyboard layout set, and see the AtariOnline GitHub repository (github.com/eahumada/AtariOnline) for the source, ROM/ATR layout and instructions for embedding your own disk images.
Credits
- AtariAge — MAC/65 with DDT debugger, live emulator online. — AtariAge forum members
- GitHub — eahumada/AtariOnline — GitHub project authors
