File: BasiliskV0_6.tar.gz Author: cbauer@iphcip1.physik.uni-mainz.de (Christian Bauer) Release: 0.6 (31.May 1997) Compatibility: DR9 (AA) Location: contrib/emulators Description: Macintosh Classic emulator Notes: Basilisk, Version 0.6 A Macintosh Classic emulator for the BeBox Copyright (C) 1996-97 Christian Bauer, Bernd Schmidt et al. Freely distributable Overview -------- "Basilisk V0.6" is a beta release of a freeware Mac Classic emulator for the BeBox, based on the 68k emulation of UAE, the Un*x Amiga Emulator by Bernd Schmidt. No, this is not (and will never be) a port of ShapeShifter. Installation ------------ The archive contains a precompiled BeOS binary. To recompile, type "make -fMakefile.Be". Basilisk needs a 512K Macintosh Classic ROM image (yes, the Classic really has 512K of ROM, not 256K). For copyright reasons this is not included in the archive. No, I don't know where you can download it. No, I won't send you one. Basilisk has only been tested with a 512K Mac Classic ROM version 118, revision 1 and probably doesn't work with any other ROM revision. The ROM file should be named "ClassicROM" and put in the same directory as Basilisk. Usage ----- Command line options: -h : Give help on the options -f n : Display every nth frame (default is 4) -D : Start up with debugger -E : Mount ROM .EDisk -[0123] file : Use file instead of fd[0123].image as filedisks -r file : Use file as ROM image instead of 'ClassicROM' -p file : Use filename to save PRAM contents instead of 'PRAM' Mouse: Only the primary mouse button is supported. Keyboard: Basilisk emulates a full Extended ISO ADB keyboard. Sound: None. The "Mac" will hang when it tries to play sound. The first thing you should therefore do is to open the control panel and set the sound volume to zero. Floppy disks: Basilisk can use Mac HD (no DD!) floppy disks with the internal floppy drive of the BeBox. This beta version only allows read accesses and treats every disk as being write-protected. To mount a disk, insert it and select the "Mount Floppy Disk" item from Basilisk's application menu. If there's a disk in the drive upon startup, Basilisk will mount it automatically. Unmount/eject disks as usual on the Macintosh. The BeBox floppy drive doesn't automatically eject disks, but Basilisk will tell you when it's safe to remove the disk from the drive. Filedisks: AKA hardfiles. Basilisk allows using up to 4 Mac volumes which are emulated in one file (each) on the BeBox file system. Basilisk can use any files as filedisks that consist of a 0-511 byte header followed by a 512- byte sector image of a Mac volume. This includes uncompressed Apple DiskCopy image files and headerless image files as used by other Macintosh emulators. EDisk: The 512K Mac Classic ROM contains a bootable System 6.0.3 "ROM disk". To mount it, use the "-E" command line option. If there's no other bootable volume, Basilisk will boot from the EDisk. Quitting: Although you can quit Basilisk at any time by closing its window, you should only do that if the "Mac" crashed. The right way to quit Basilisk is to select the "Shut Down" menu item from the Finder's "Special" menu, and then quit the program when you are instructed to "turn off your Macintosh". MacOS versions supported ------------------------ Basilisk has been tested (i.e. it booted) with MacOS System 5.0, 6.0.3, 6.0.8, 7.1 and 7.5. Your Mileage May Vary. System 5.x and 6.x are somewhere on Apple's FTP site. Booting from floppy may take several minutes (esp. System 7), so be patient. Unimplemented features ---------------------- - Macintosh hardware emulation - Time Manager - Networking (don't turn on AppleTalk, it will crash) - Serial ports - SCSI - Sound - Printing - Only a Mac Classic, i.e. no Color QuickDraw, no QuickTime, no ... - more ... Speed ----- On a Dual603e-133, Basilisk seems to run at the full speed of a real Mac Classic. If you think that Basilisk uses too much CPU time, try the "-f n" command line option with n>4. Acknowledgements ---------------- Special thanks to: - Bernd Schmidt for letting me use his UAE 68k emulation - The guys at DeBUG for beta testing - Daniel Bobbert who printed dozens of pages from the THINK Reference for me years ago - All ShapeShifter users and beta testers - Apple Computer Inc., who made writing a Macintosh emulator a child's play Legal stuff ----------- Copyright 1996 Christian Bauer, Bernd Schmidt et al. This program is freeware. You may do whatever you want with it for personal use. Permission is granted to redistribute this program free of charge, provided it is distributed in the full archive with unmodified contents and no profit beyond the price of the media on which it is distributed is made. Exception to the last rule: It may be included on freeware/shareware collections on CD-ROM. There are no warranties of any kind for this program. If you use this program, you do so at your own risk. The authors are not responsible for any damages that might result from using this program. Author ------ You can contact me at . Because of the very preliminary state of this software, I will accept neither feature requests nor bug reports at this time. Bug fixes are welcome. There are two things I will NOT do: 1. Send you Mac ROM files 2. Explain to you how to use a Macintosh History ------- V0.4 - first public release V0.5 - minor fixes, faster screen refresh, can be started from the Browser V0.6 - ported to BeOS AA:DR9 Christian Bauer