Omnimon! and OmnimonXL
- Year
- 1982
- Publisher
- CDY Consulting
- Type
- Utility
- Category
- ROM-resident machine-language monitor
- Developer
- David Young
- Language
- 6502 machine language
- Requirements
- Omnimon!: Atari 400/800 with the piggyback board or a Newell Ramrod OS board. OmnimonXL: 800XL-class machine with a Ramrod XL or replacement OS ROM.
- Tags
- monitor, debugger, rom, disassembler, os-replacement, cdy-consulting, newell, ramrod, 400-800, xl
Overview
The Atari 400/800 shipped with no built-in machine-language monitor. The debuggers inside the Assembler Editor cartridge or Synassembler only worked while you were inside the assembler. Omnimon!, by David Young of CDY Consulting of Richardson, Texas, fixed that. It is a 4K monitor in ROM that sits in the unused $C000–$CFFF hole of the 400/800 memory map. From inside any running program you hold OPTION or SELECT and press SYSTEM RESET, and you drop straight into the monitor. The program and manual carry a 1982 copyright. Antic's David Duberman reviewed it in July 1983 at $89.95 and called it "a machine-language monitor that should have come with the ATARI."
History and versions
The line goes back to Supermon! (around 1982), which shipped with the earliest Newell Industries Ramrod OS boards. Omnimon! followed in several 4K variants:
| Version | Notes |
|---|---|
| Standard | the only version with a HELP command; sold with a piggyback board (by The Peripheral Connection) or with the Newell Ramrod |
| Advanced A | extra utilities; support for the Happy 810 Enhancement and the Bit 3 Full-View 80 card |
| Ramdisk R | as A, plus a RAM disk for Axlon banked memory |
| Banked L / U | a split pair: L has extra disk I/O, U has the debugger plus a mini-assembler and relocator |
| 8K Omnimon! (1984) | L and U on one 8K chip, selected by a toggle switch; the screen inverts to remind you to flip it |
Without a Ramrod, the piggyback board gave the chip a socket on the 800's OS board and needed one wire clipped to a pin on the floating-point ROM. No soldering was required.
OmnimonXL (1984) brought the monitor to the XL line as a complete replacement OS ROM. It combined Newell's OSNXL operating system (faster keyboard repeat, programmable cassette baud rate, most 400/800 entry points kept), Charles Marslett's Fastchip floating-point routines, and the monitor itself. It was also sold with Newell's Ramrod XL board, which holds three OS ROMs selected by a switch. CDY's later Omniview 80-column ROMs could share an 8K chip with Omnimon.
Using the monitor
Entering and leaving (OmnimonXL):
- OPTION+SELECT+RESET performs a warm start and then calls the monitor. Use this from BASIC.
- SELECT+RESET interrupts the running program while leaving OS variables and the stack alone, so you can usually resume it.
JSR $C001(orX=USR(49152)from BASIC) also enters it, as does anyBRKwhile it is active.- To leave, hold START and press RETURN.
On entry it prints the CPU registers (PC, flags, A, X, Y, SP). Everything is in hex, and you can cursor up onto an old line, edit it and press RETURN again.
Main commands: D display memory (hex or ATASCII; RETURN keeps scrolling), A alter, T toggle hex/character mode, S search, M move, V verify/compare, N relocate 6502 code, X disassemble, Y one-line assembler, E single-step/execute, J call a subroutine, C registers, H hex/decimal arithmetic, P echo output to the printer (or any device), B boot a disk, and F/O to record and replay a sequence of commands.
Disk commands without DOS: L selects the drive and toggles between sequential and linked-sector modes. R and W read and write sectors in single or double density. G binary-loads a DOS file (even one that loads on top of DOS) and lists the directory along the way.
H C000 A000 - 80 / ; $2000 bytes = 64 ($40) single-density sectors
W 1 A000 40 ; dump $A000-$BFFF to sectors 1-64 (scratch disk!)
T ; switch to character mode
R 169 6000 8 ; read the 8 directory sectors to $6000
D 6000 ; browse filenames, hold RETURN to scroll
The reviewer's favourite trick was a rescue. Say you typed a BASIC program without booting DOS. Note BASIC's pointers at $80–$91, write the memory out with W, boot DOS, restore the pointers, and read the memory back in. On a Happy drive, sector numbers of $800 and up address the drive's internal RAM, so you can inspect or upload drive code directly.
Gotchas
Wwrites raw sectors and ignores whatever is already on the disk. Use a scratch disk.- Because a
BRKdrops into the monitor, buggy or self-modifying software can trigger it unexpectedly. The Atari Macro Assembler has been seen jumping into Omnimon mid-assembly, so you may need to switch the ROM off while assembling.
Using it today
The OmnimonXL manual was transcribed from a well-used original. The transcriber noted that OmnimonXL worked, by his estimate, about 85% in Atari800Win. Altirra lets 400/800 firmware images use an XL-style 16K layout for $Cxxx extension firmware, which is where Omnimon lives. On real hardware, period Ramrod boards still turn up, and some modern OS-switching upgrades advertise space for Omnimon and Omniview firmware.
Credits
- Picture: Opening page of the original Omnimon! User's Guide for the 400/800. The program and manual are marked copyright 1982 by CDY Consulting. — First page of the Omnimon! User's Guide (David Young, CDY Consulting), scan from the Internet Archive item 'omnimon-4k-user-guide-600x600' (Used for identification/commentary)
- Antic Vol. 2 No. 4 (July 1983): Product Reviews — Omnimon (David Duberman) — AtariMagazines.com (Kevin Savetz), 1983
- Using OmniMon XL — command summary (1998 Usenet post) — Using OmniMon XL, 1998
- OmnimonXL documentation README (transcriber's notes)
- comp.sys.atari.8bit FAQ (Michael Current): personality boards, Supermon!/Omnimon!/OmnimonXL — Michael Current (comp.sys.atari.8bit FAQ)
- AtariAge forum: Problem with AMAC and Omnimon — AtariAge forum members
- Altirra changelog (400/800 $Cxxx extension firmware) — Avery Lee (Altirra)
- Internet Archive — Omnimon 4K User's Guide (scan) — First page of the Omnimon! User's Guide (David Young, CDY Consulting), scan from the Internet Archive item 'omnimon-4k-user-guide-600x600' (Used for identification/commentary)
