--- BasiliskII/README 2000/07/06 16:04:23 1.11 +++ BasiliskII/README 2001/05/24 14:31:05 1.20 @@ -1,9 +1,8 @@ - Basilisk II, Version 0.8 - A free, portable Mac II emulator + Basilisk II + A 68k Macintosh emulator - Copyright (C) 1997-2000 Christian Bauer et al. - Freely distributable + Copyright (C) 1997-2001 Christian Bauer et al. License @@ -16,13 +15,15 @@ See the file "COPYING" that is included Overview -------- -Basilisk II is a free, portable, Open Source 68k Mac emulator. It requires -a copy of a Mac ROM and a copy of MacOS to run. Basilisk II is freeware and -distributed under the GNU General Public License. +Basilisk II is an Open Source 68k Macintosh emulator. That is, it enables +you to run 68k MacOS software on you computer, even if you are using a +different operating system. However, you still need a copy of MacOS and +a Macintosh ROM image to use Basilisk II. Basilisk II has currently been ported to the following systems: - BeOS R4 (PowerPC and x86) - - Unix (tested under Linux, Solaris 2.5, FreeBSD 3.x and IRIX 6.5) + - Unix (tested under Linux, Solaris 2.5, FreeBSD 3.x, NetBSD 1.4.2 and + IRIX 6.5) - AmigaOS 3.x - Windows NT 4.0 (mostly works under Windows 95/98, too) @@ -41,7 +42,8 @@ Some features of Basilisk II: - Serial drivers - SCSI Manager (old-style) emulation - Emulates extended ADB keyboard and 3-button mouse - - Uses UAE 68k emulation or (under AmigaOS) real 68k processor + - Uses UAE 68k emulation or (under AmigaOS and NetBSD/m68k) real 68k + processor The emulator is not yet complete. See the file "TODO" for a list of unimplemented stuff. @@ -325,9 +327,10 @@ ether BeOS: It doesn't matter what you give as "ethernet card description", Basilisk II will always use the first Ethernet card it finds as long an an "ether" - line exists (e.g. say "ether yes"). As Basilisk II requires the sheep_net - net server add-on from SheepShaver, you can only use Ethernet on PowerPC - machines. + line exists (e.g. say "ether yes"). Using Ethernet requires the "sheep_net" + Net Server add-on to be installed. The first time you start Basilisk II + with Ethernet enabled you will be asked whether it's OK to make the + necessary changes to your BeOS network configuration to enable sheep_net. Linux: The "ethernet card description" is the name of an Ethernet interface. @@ -349,7 +352,7 @@ ether configure your kernel to enable routing and the ethertap device: under "Networking options", enable "Kernel/User netlink socket" and "Netlink device emulation", under "Network device support", activate - "Ethertap network tap". You also have to modify devices/net/ethertap.c + "Ethertap network tap". You also have to modify drivers/net/ethertap.c a bit before compiling the new kernel: - insert "#define CONFIG_ETHERTAP_MC 1" near the top (after the @@ -379,6 +382,11 @@ ether your network administrator about the nets and zones you can use (instead of the ones given in the example above). + FreeBSD: + The "ethertap" method described above also works under FreeBSD, but since + no-one has found the time to write a section for this manual, you're on + your own here... + AmigaOS: You have to specify the name of the SANA-II Ethernet device and the device unit as "/" (e.g. "ariadne.device/0"). If the given @@ -414,7 +422,9 @@ frameskip For refreshed graphics modes (usually window modes), this specifies how many frames to skip after drawing one frame. Higher values make the video display more responsive but require more processing power. - The default is "8". + The default is "8". Under Unix/X11, a value of "0" selects a "dynamic" + update mode that cuts the display into rectangles and updates each + rectangle individually, depending on display changes. modelid @@ -476,6 +486,18 @@ Unix: is /usr/local/share/BasiliskII/fbdevices. A sample file is included with Basilisk II. + mousewheelmode + + If you have a mouse with a wheel, this option specifies whether moving + the wheel will be reported to the MacOS as "Page up/down" (mode 0) or + "Cursor up/down" (mode 1) keys. + + mousewheellines + + If "mousewheelmode" is set to mode 1 (Cursor up/down), this option sets + the number of key events sent to MacOS for each wheel movement (the + number of lines to scroll). + AmigaOS: sound @@ -486,6 +508,19 @@ AmigaOS: ahi/ + scsimemtype + + This item controls the type of memory to use for SCSI buffers. Possible + values are: + 0 Chip memory + 1 24-bit DMA capable memory + 2 Any memory + + Be warned that many SCSI host adapters will not work with the "Any memory" + setting. Basilisk II has no way of knowing which memory type is supported + by the host adapter and setting an unsupported type will result in data + corruption. + Windows: noscsi <"true" or "false"> @@ -642,20 +677,21 @@ Please see the included file "TECH" for Acknowledgements ---------------- -Contributions by: - - Bernd Schmidt : UAE 68k emulation - - Marc Hellwig : audio output, BeOS video code - and networking - - Lauri Pesonen : Windows NT port +Contributions by (in alphabetical order): - Orlando Bassotto : FreeBSD support - - Brian J. Johnson : IRIX support + - Gwenole Beauchesne : SPARC assembly optimizations and + fbdev video code - Marc Chabanas : Solaris sound support + - Marc Hellwig : audio output, BeOS video code + and networking - Bill Huey : 15/16 bit DGA and 15/16/32 bit X11 window support - - David Lawrence : incremental window refresh code + - Brian J. Johnson : IRIX support + - Jürgen Lachmann : AmigaOS CyberGraphX support - Samuel Lander : tile-based window refresh code - - Gwenole Beauchesne : SPARC assembly optimizations and - fbdev video code + - David Lawrence : incremental window refresh code + - Lauri Pesonen : Windows NT port + - Bernd Schmidt : UAE 68k emulation - and others... Special thanks to: