UTILITIES and LANGUAGES

UTILITIES

C’MON Lite – A simple assembler, disassembler, and monitor by Aleksi Eeben, originally for the unexpanded Commodore VIC-20. As ported by yours truly, it takes up exactly 2 KB of RAM and loads at $0C00. It displays a page of memory (hex and ASCII) or 6502 disassembly at a time, and can write a series of bytes at a time, plus print out the CPU registers. A command sheet, source code, and even a KIM-1 Hypertape (3x) audio file are available.

MICROMON – A fuller-featured disassembler/debugger, with search, copy, fill, compare, branch offset calculator, number converters, and hex add/subtract. But easily the best feature is the ‘New Locator,’ which converts absolute address references from one range of memory to another. Super handy when relocating a program in memory. Originally by Bill Seiler for the Commodore PET and ported by me, this 4K program loads at $6000, and is less than half the size of comparable programs for the PAL-1. A brief user guide is included.

MELODY MAKER – Want to hear your PAL-1 or microKIM make music? If so, then this is what you need! Written to make it a lot easier to enter tunes into the classic "Music Box" by Jim Butterfield, the ZIP file here contains my Melody Maker music entry program, plus full documentation -- including examples of program integration for KB9, Tiny BASIC, VTL-02, etc. Many extras, schematics, too. Check out the VTL-02C game Borg Attack and the machine language game Grenade Lobber 3 for a demonstration of just what can be done with an 'unexpanded' 5K machine.

CODE TEST – From The First Book of KIM, this is Stan Ockers's Morse code practice program from 1976. It has been modified to run on an unexpanded PAL-1 (only one, on-board 6532 RIOT I/O chip) using the PB7 line off the expansion connector, ala Music Box. Source code, PTP, and AHEX included.

LIL’ BUG – This is a suite of tools I wrote, ported, or collected to be of help to unexpanded PAL-1 users. Included are the eWozLite monitor, Wozniak and Baum’s 6502 Disassembler from 1976, Lew Edwards’ MOVIT, a search module based on Jeff Tranter’s JMON routine, plus fill, memory dump, and register print routines. The complete v0.4 program package, which loads at $0B00, is here, plus documentation and some source code. The individual modules (for v0.2) can be found on my github repository, including a friend’s relocated version for burning the suite into an (E)EPROM to $A000. BONUS FILE: eWozLite plus the Woz/Baum disassembler ONLY. Loads at $1010 (start of disassembler - enter eWozLite at $1220). Maybe that's all you need. :^)

LOAD & SAVE for TinyBASIC -- This is a small routine modeled on the load and save in KB9. I've tucked it away at $17A0 in the RIOT chip's RAM. The instructions for use are in the source code text file, which includes a .PTP file and Apple hex file. Also, if you want to use Hypertape, I've bundled everything together into a ZIP file, with a relocated HT to $0115 that will not interfere with TinyBASIC and a version of the Load & Save that will access it.

eWozLite – The aforementioned monitor, which just by itself is an order of magnitude better than the KIM-1 TTY monitor. More of an ‘amputation’ of Jim McClanahan’s eWOZ 1.0p version for the PAL-1 than an actual port, I moved the input buffer to the top of user RAM and stripped out the Intel hex load code, and gained 704 bytes of contiguous RAM over the original eWOZ, which is significant - all of the ‘First Book of KIM’ programs are smaller than just the savings! This loads at $1220 (another version loads at $9220) and behaves exactly like the original 1976 WozMon, except with a working backspace and JSR $xxxx instead of a (JMP) for the ‘R’ command (both are F. Safstrom additions in the original eWOZ). Jim’s commented source code, with my ‘additions,’ is included. It’s like stepping into a time machine!

HUEY -- From 1977, a scientific calculator with RPN and somewhat programmable, written in 6502 assembly by Don Rindsberg. Similar in function and structure to an HP-25 calculator. The ZIP file contains the original Kilobaud magazine article with instructions, commented disassembly by C.R. Bond, and a relocated version from yours truly at $2000 for PAL-1/KIM-1, both PTP and AHEX.

SKETCH -- An on-screen drawing program by yours truly, for both KIM-1 BASIC 9 and VTL-02C. Reminiscent of the old Etch-a-Sketch game from days gone by. Draw monochrome blocks of varying intensity across the screen to make pictures in the KB9 version, and draw in either monochrome or "in living color" with the VTL-02 version, which also has documentation..

J.A.S.L. - a 6502 S-RECORD LOADER -- My brutal Frankenstein's monster hack-up of Jeff Tranter's Motorola S-Record loading routine in his awesome 6502 monitor/debugger JMON, J.A.S.L. stands for "Jeff's Amazing S-record Loader." While not often encountered, there are occasions when one needs to load an S-Record into a 6502 machine. This 705-byte KIM-1 version loads at $1133 and will get the job done without having to load all 9 KB of JMON from tape. Source code included in the ZIP (all caps comments are mine).

PTP CHECKSUM CALCULATOR -- A little machine language utility that calculates the ending checksum of a single record/line of a MOS Papertape file. I wrote it because when trying to edit/chop a line in a PTP, I was going crazy trying to add 14 hexidecimal numbers in my head. Two bytes, yes; 14, no. The instructions are included in the source code (link above, in the title). Just the PTP file alone, which loads at $1340, is also available.

LANGUAGES

APPLE BASIC PACKAGE -- This 5.5K "package" includes the original Apple BASIC by Steve Wozniak as used on the Apple 1, the eWOZLite monitor (both patched by Jim McClanahan for use on the PAL-1, and both lightly modded by me), a tape load-and-save routine that uses Hypertape, and a crude-but-functional "free memory" routine. The .PTP file is linked in the title, with documentation and the L&S routine source code also available. Need the original, 1976 Apple BASIC manual? We've got you covered!

Tiny PILOT -- UPDATED 18.MAY.23 Resurrected from the pages of 1979's MICRO magazine, this is Nicholas Vrtis's Tiny PILOT, with additions by Bob Applegate and myself. The core features of PILOT are represented, mostly, in this 1K version. Not a math powerhouse, PILOT's strength is as an interactive dialog engine, and it was used widely in the '70s and '80s in Computer-Assisted Instruction in schools and universities. I typed in the source code by hand, and it seems to work fine, but any mistakes you find are certainly mine, so drop me a line about it, please. Included in the ZIP file are: a PTP, source code, a user guide, ten demonstration programs (with two CAI examples), and relevant PDFed pages from MICRO. There is also a version with an "enhanced" M/match statement that brings Tiny PILOT up to PILOT-73 standards, which is presented here.

FOCAL-65 -- UPDATED 20.OCT.23 The 1977 Aresco 6502 version (v3D) of the DEC high-level language FOCAL-8 for the PDP-8. Full floating point numbers and user-definable functions, all in 5.5 KB. A manual and other docs are in the ZIP, too. NOW - from 1977, the full, original, 105-page User Guide, as provided by the Denver 6502 Group (authors) and The 6502 Program Exchange (distributors). The PTP file in the archive has been patched to address the KIM-1 TTY echo issue -- the patch came from a KIM-1 Users' Club document.

PAL PILOT -- A modified port of Michael Tinglof's VIC and PET PILOT Interpreter, which appeared in COMPUTE! Magazine in Dec. 1982. It sits inside of KIM-1 BASIC (KB9) as a program, so it's not the fastest of languages, but this one has all the "core" of the PILOT-73 standard, plus some additional math operations, a very good Match statement, and the ability to load and save PILOT programs. Included in the package is the editor/interpreter, a "tokenizer" for importing text files from a modern text editor (updated 19.Mar.23), three sample programs, source code, and a user's guide.

VTL-02: A Very Tiny Language -- I've altered the start address of this cool little high-level language (originally ported from 6800 code to 6502 by Mike Barry) for use on the 'unexpanded' PAL-1. It's like a stripped-down (further?!?) TinyBASIC, and when loaded at $0FB0, this leaves 3,247 bytes for your Very Tiny Masterpiece - that's almost a full kilobyte more user RAM than Tiny BASIC allows! The ZIPped package includes a MOS papertape of VTL-02C, a two-page "operating notes" crib sheet (with TinyBASIC equivalents), the full 2nd ed. manual by VTL-2 co-author Frank McCoy, plus three games: Hammurabi, Lunar Lander, and a VTL-02 version of the game WIPEOUT (KB9, Tiny BASIC, etc., versions in the GAMES section) - one copy ready for ASCII upload, and another with some light commenting, so you can see how things work in this...well...very tiny language. A tape save-n-load routine, with instructions, is available. For the exceptionally nutty among us, there's a Hypertape WAV file of VTL-02C here, too.

LANGUAGE PACK for Unexpanded 5K PAL-1 -- UPDATED 31.AUGUST.23 Tiny BASIC, VTL-02C, and Tiny PILOT all bundled up in a ZIP file with ready-to-run PTP files, along with documentation, user guides, sources, alternate versions for expanded memory, and other aids.