View Original Text

Hide Table of Contents

CompatiBoot 2k

An improved, tiny, really fast, DOS 3.3 file compatible, fully relocatable, run-time configurable, game oriented, TK-2000 aware, (Pseudo) Operating Systemfor 6502 systems using the Apple's Disk II interface card with a nice API. ;-)

Download it NOW - you can also give a peek on the historic versions.

Read more on my talk on Dev In Sampa 2012, or watch it running on this poorly narrated video. =P

How to test it:

First, download the images:

Now you will need either a real Apple II system, a real TK-2000 or an emulator for one (or both!) the systems. If you decide to use it on the real thing, you will need to upload the disk image to the machine using something like ADT-Pro (can I ask you to use and test my improved version? Feedbacks are wellcome!).

The CB2k was succesfully tested on the following enviroments:

On the other hand, it's known to DO NOTwork (yet?) on:

  1. Apple //gs using CFFA3000 - Leandro Polimeno (ditto)
  2. Apple //gs using internal disk support

There's no reason to believe it will not work on other emulators or Apple2 systems, as long it's an Apple II compatible system using an Apple Disk II compatible interface card and disk drive. It's known to work fine with Victor Trucco's S-Disk II (a brazilian revision of the Nishida' S-Disk, and an excellent review - in Portuguese, Chrome Translator to the rescue! - from Mauro Xavier can be found here).

The Kernel and the R*TS (fast low level disk reading routines) works fine on Microdigital's TK-2000 using the Tomato adapter projected by Fabio Belavenuto and implemented by Claudio Moisés. It's expected (but yet to be proven) to work fine also using the Microdigital's Disk Controller for the TK-2000.

Trucco sells a very professionally made Tomato adapter, based on the Fabio's project. Strongly recommended.

The demo programs had to be reworked as the TK-2000 system ROM is substantially different from the AppleII line. See the SYSTEM.DEF/SYSTEM.INC files to see how I ended up making all this things work together for both machines. Now that it's already made, it's not that hard, really!

Currently, the TK-2000 is fully supported and since the the 1.1 R2 (2012-0415) CB2k is proven to work fine on the TK-2000 machine.

The Test Suite for Kernel and R*TS can be downloaded (as well early CB2k versions - for historic reaons) can be found here.

Please read the READ.ME file, as it contais important information about running the tests. They're updated regularly, so come back occasionally to check for news.

All the tests passed 100% using the hardware described in Item 5 and the above mentioned emulators.

How to use it

If you want to build your own CB2k boot disk with your software (especially built, or DOS-less legacy software), it's enough to duplicate an existing one (I suggest using the clean disk included in the R3 and forward) and copy a BIN file into it.

The CB2k, once booted, will load and run the first entry on the disk's CATALOG, as long it is a BIN file, and it's not deleted. CB2k will not search for a suitable file on the CATALOG, it will try to load the first entry, or will abort in panic.

If you are building a more complex disk, use a CATALOG beautifier utility (as Copy II PC's Alphabetize Catalog option, or the Beagle Bros' FatCat Utility) to place your files in a suitable position. Keep in mind that CB2k likes to load the files in sequence. Ordering your files on the disk's catalog is the easiest way to load multiple files in sequence.

The CB2k's demo disk has numbers on the file names to make easier to guarantee the correct file order using the Copy II PC utility - it's important to remember that CB2k does cares squat about file names. All that matters are the file's index in the catalog.

Keep in mind that deleted files does not "free" an index, and they will raise an exception when accessed.

Versions Provided

The CB2k zip file provides:

How to program for it

Included with the distribution are the sources for the demo programs (special attention for the Electric Duets's player ported to TK-2000!).

They are minimalist, and the API, besides well defined, stills lacks some documentation.

You will need a GNU compliant shell and compiler (I'm using MINGW on my WinXP Box) and CC65 to compile your own programs. I strongly recommend CiderPress (github, sourceforge (historic)) to deal with disk images.

Feel free to contact support at lisias dot net for further information and hands on help. I'll be glad to advise.

Known Applications

Fábio Belavenuto fully dissassembled Midwest Pirates' Guild Beautiful Boot (I found a marvelous article about the Scene - French) and ported it to CB2k.

It was included with Fabio's permission on the CB2k distribution files since 1.1 R3.

Fábio also ported the TK2000 Karateka (originally on tape) for the CB2k.

How to help

Currently, I need help on testing this damned thing on real hardware.

I'll appreciate any reports on using the various versions of the Test Suite on the most different platforms and Disk II compatible devices (and disk emulators). Testing on Apple II emulators on other (like MacOS) will also be welcome.

While knowing that the TK-DOS hosted Test Suite works fine on a real TK-2000, I'm curious about Micro Professor II compatibility. If you know of someone who has a working MPF-II with a Disk Drive, please notify me.

Testing on a real Microdigital's Disk Interface Cartridge for the TK-2000 is to be realized yet.

The following videos shows what the Test Suites are:

Greetings and Thankings

It's being fun, guys! Thanks!

In memorian

Eduardo M. Bürnheim. You're utterly missed, my friend.