| 1 |
|
|
| 2 |
< |
Basilisk II, Version 0.8 |
| 3 |
< |
A free, portable Mac II emulator |
| 2 |
> |
Basilisk II |
| 3 |
> |
A 68k Macintosh emulator |
| 4 |
|
|
| 5 |
< |
Copyright (C) 1997-1999 Christian Bauer et al. |
| 6 |
< |
Freely distributable |
| 5 |
> |
Copyright (C) 1997-2001 Christian Bauer et al. |
| 6 |
|
|
| 7 |
|
|
| 8 |
|
License |
| 15 |
|
Overview |
| 16 |
|
-------- |
| 17 |
|
|
| 18 |
< |
Basilisk II is a free, portable, Open Source 68k Mac emulator. It requires |
| 19 |
< |
a copy of a Mac ROM and a copy of MacOS to run. Basilisk II is freeware and |
| 20 |
< |
distributed under the GNU General Public License. |
| 18 |
> |
Basilisk II is an Open Source 68k Macintosh emulator. That is, it enables |
| 19 |
> |
you to run 68k MacOS software on you computer, even if you are using a |
| 20 |
> |
different operating system. However, you still need a copy of MacOS and |
| 21 |
> |
a Macintosh ROM image to use Basilisk II. |
| 22 |
|
|
| 23 |
|
Basilisk II has currently been ported to the following systems: |
| 24 |
|
- BeOS R4 (PowerPC and x86) |
| 25 |
< |
- Unix (tested under Linux, Solaris 2.5, FreeBSD 3.x and IRIX 6.5) |
| 25 |
> |
- Unix (tested under Linux, Solaris 2.5, FreeBSD 3.x, NetBSD 1.4.2 and |
| 26 |
> |
IRIX 6.5) |
| 27 |
|
- AmigaOS 3.x |
| 28 |
|
- Windows NT 4.0 (mostly works under Windows 95/98, too) |
| 29 |
|
|
| 42 |
|
- Serial drivers |
| 43 |
|
- SCSI Manager (old-style) emulation |
| 44 |
|
- Emulates extended ADB keyboard and 3-button mouse |
| 45 |
< |
- Uses UAE 68k emulation or (under AmigaOS) real 68k processor |
| 45 |
> |
- Uses UAE 68k emulation or (under AmigaOS and NetBSD/m68k) real 68k |
| 46 |
> |
processor |
| 47 |
|
|
| 48 |
|
The emulator is not yet complete. See the file "TODO" for a list of |
| 49 |
|
unimplemented stuff. |
| 236 |
|
15-bit truecolor display in a Picasso96 PIP. This requires |
| 237 |
|
Picasso96 as well as a PIP-capable graphics card (e.g. Picasso IV). |
| 238 |
|
scr/<hexadecimal mode ID> |
| 239 |
< |
8/15/24-bit fullscreen display on a Picasso96 screen with the given |
| 240 |
< |
mode ID. This requires Picasso96. For 15 and 24 bit, the frame buffer |
| 241 |
< |
format must be QuickDraw-compatible (big-endian, xRGB 1:5:5:5 or |
| 242 |
< |
xRGB 8:8:8:8). The screen size will be the default size for that |
| 243 |
< |
mode ID. |
| 239 |
> |
8/15/24-bit fullscreen display on a Picasso96/CyberGraphX screen with |
| 240 |
> |
the given mode ID. This requires Picasso96 or CyberGraphX. For 15 and |
| 241 |
> |
24 bit, the frame buffer format must be QuickDraw-compatible |
| 242 |
> |
(big-endian, xRGB 1:5:5:5 or xRGB 8:8:8:8). The screen size will be |
| 243 |
> |
the default size for that mode ID. |
| 244 |
|
|
| 245 |
|
Windows: |
| 246 |
|
The "video mode" is one of the following: |
| 327 |
|
BeOS: |
| 328 |
|
It doesn't matter what you give as "ethernet card description", Basilisk II |
| 329 |
|
will always use the first Ethernet card it finds as long an an "ether" |
| 330 |
< |
line exists (e.g. say "ether yes"). As Basilisk II requires the sheep_net |
| 331 |
< |
net server add-on from SheepShaver, you can only use Ethernet on PowerPC |
| 332 |
< |
machines. |
| 330 |
> |
line exists (e.g. say "ether yes"). Using Ethernet requires the "sheep_net" |
| 331 |
> |
Net Server add-on to be installed. The first time you start Basilisk II |
| 332 |
> |
with Ethernet enabled you will be asked whether it's OK to make the |
| 333 |
> |
necessary changes to your BeOS network configuration to enable sheep_net. |
| 334 |
|
|
| 335 |
|
Linux: |
| 336 |
|
The "ethernet card description" is the name of an Ethernet interface. |
| 352 |
|
configure your kernel to enable routing and the ethertap device: |
| 353 |
|
under "Networking options", enable "Kernel/User netlink socket" and |
| 354 |
|
"Netlink device emulation", under "Network device support", activate |
| 355 |
< |
"Ethertap network tap". You also have to modify devices/net/ethertap.c |
| 355 |
> |
"Ethertap network tap". You also have to modify drivers/net/ethertap.c |
| 356 |
|
a bit before compiling the new kernel: |
| 357 |
|
|
| 358 |
|
- insert "#define CONFIG_ETHERTAP_MC 1" near the top (after the |
| 382 |
|
your network administrator about the nets and zones you can use |
| 383 |
|
(instead of the ones given in the example above). |
| 384 |
|
|
| 385 |
+ |
FreeBSD: |
| 386 |
+ |
The "ethertap" method described above also works under FreeBSD, but since |
| 387 |
+ |
no-one has found the time to write a section for this manual, you're on |
| 388 |
+ |
your own here... |
| 389 |
+ |
|
| 390 |
|
AmigaOS: |
| 391 |
|
You have to specify the name of the SANA-II Ethernet device and the device |
| 392 |
|
unit as "<device name>/<unit>" (e.g. "ariadne.device/0"). If the given |
| 394 |
|
not an Ethernet device, Basilisk II will display a warning message and |
| 395 |
|
disable Ethernet networking. |
| 396 |
|
|
| 397 |
+ |
See the next item for an alternative way to do networking with Basilisk II. |
| 398 |
+ |
|
| 399 |
+ |
udptunnel <"true" or "false"> |
| 400 |
+ |
|
| 401 |
+ |
Setting this to "true" enables a special network mode in which all network |
| 402 |
+ |
packets sent by MacOS are tunnelled over UDP using the host operating |
| 403 |
+ |
system's native TCP/IP stack. This only works with AppleTalk and can only |
| 404 |
+ |
be used to connect computers running Basilisk II (and not, for example, for |
| 405 |
+ |
connecting to an AppleShare server running on a real Mac), but it is |
| 406 |
+ |
probably the easiest way to set up a network between two instances of |
| 407 |
+ |
Basilisk II because the UDP tunnelling doesn't require any special kernel |
| 408 |
+ |
modules or network add-ons. It relies on IP broadcasting, however, so |
| 409 |
+ |
its range is limited. |
| 410 |
+ |
|
| 411 |
+ |
udpport <IP port number> |
| 412 |
+ |
|
| 413 |
+ |
This item specifies the IP port number to use for the "AppleTalk over UDP" |
| 414 |
+ |
tunnel mode. The default is 6066. |
| 415 |
+ |
|
| 416 |
|
rom <ROM file path> |
| 417 |
|
|
| 418 |
|
This item specifies the file name of the Mac ROM file to be used by |
| 441 |
|
For refreshed graphics modes (usually window modes), this specifies |
| 442 |
|
how many frames to skip after drawing one frame. Higher values make |
| 443 |
|
the video display more responsive but require more processing power. |
| 444 |
< |
The default is "8". |
| 444 |
> |
The default is "8". Under Unix/X11, a value of "0" selects a "dynamic" |
| 445 |
> |
update mode that cuts the display into rectangles and updates each |
| 446 |
> |
rectangle individually, depending on display changes. |
| 447 |
|
|
| 448 |
|
modelid <MacOS model ID> |
| 449 |
|
|
| 505 |
|
is /usr/local/share/BasiliskII/fbdevices. A sample file is included |
| 506 |
|
with Basilisk II. |
| 507 |
|
|
| 508 |
+ |
mousewheelmode <mode> |
| 509 |
+ |
|
| 510 |
+ |
If you have a mouse with a wheel, this option specifies whether moving |
| 511 |
+ |
the wheel will be reported to the MacOS as "Page up/down" (mode 0) or |
| 512 |
+ |
"Cursor up/down" (mode 1) keys. |
| 513 |
+ |
|
| 514 |
+ |
mousewheellines <number of lines> |
| 515 |
+ |
|
| 516 |
+ |
If "mousewheelmode" is set to mode 1 (Cursor up/down), this option sets |
| 517 |
+ |
the number of key events sent to MacOS for each wheel movement (the |
| 518 |
+ |
number of lines to scroll). |
| 519 |
+ |
|
| 520 |
|
AmigaOS: |
| 521 |
|
|
| 522 |
|
sound <sound output description> |
| 527 |
|
|
| 528 |
|
ahi/<hexadecimal mode ID> |
| 529 |
|
|
| 530 |
+ |
scsimemtype <type> |
| 531 |
+ |
|
| 532 |
+ |
This item controls the type of memory to use for SCSI buffers. Possible |
| 533 |
+ |
values are: |
| 534 |
+ |
0 Chip memory |
| 535 |
+ |
1 24-bit DMA capable memory |
| 536 |
+ |
2 Any memory |
| 537 |
+ |
|
| 538 |
+ |
Be warned that many SCSI host adapters will not work with the "Any memory" |
| 539 |
+ |
setting. Basilisk II has no way of knowing which memory type is supported |
| 540 |
+ |
by the host adapter and setting an unsupported type will result in data |
| 541 |
+ |
corruption. |
| 542 |
+ |
|
| 543 |
|
Windows: |
| 544 |
|
|
| 545 |
|
noscsi <"true" or "false"> |
| 635 |
|
On PC-style keyboards, "Alt" is the Mac "Command" key, while the "Windows" |
| 636 |
|
key is the Mac "Option" key. |
| 637 |
|
|
| 638 |
+ |
Mouse: |
| 639 |
+ |
Under Unix, press Ctrl-F5 while the Basilisk II window is active will grab |
| 640 |
+ |
the mouse. This is needed for compatibility with some MacOS programs, |
| 641 |
+ |
especially games. Press Ctrl-F5 again to return to normal mouse operation. |
| 642 |
+ |
|
| 643 |
|
Floppy: |
| 644 |
|
Basilisk II can only handle 1.44MB MFM floppies. Depending on your platform, |
| 645 |
< |
flopyy disk changes might not be detected automatically. Under Linux, press |
| 645 |
> |
floppy disk changes might not be detected automatically. Under Unix, press |
| 646 |
|
Ctrl-F1 to mount a floppy. Under BeOS, select the appropriate "Mount" menu |
| 647 |
|
item or press Ctrl-F1 to mount a floppy. Under Windows, press Ctrl-Shift-F11. |
| 648 |
|
|
| 701 |
|
Acknowledgements |
| 702 |
|
---------------- |
| 703 |
|
|
| 704 |
< |
Contributions by: |
| 646 |
< |
- Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation |
| 647 |
< |
- Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code |
| 648 |
< |
and networking |
| 649 |
< |
- Lauri Pesonen <lpesonen@nic.fi>: Windows NT port |
| 704 |
> |
Contributions by (in alphabetical order): |
| 705 |
|
- Orlando Bassotto <future@powercube.mediabit.net>: FreeBSD support |
| 706 |
< |
- Brian J. Johnson <bjohnson@sgi.com>: IRIX support |
| 706 |
> |
- Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and |
| 707 |
> |
fbdev video code |
| 708 |
|
- Marc Chabanas <Marc.Chabanas@france.sun.com>: Solaris sound support |
| 709 |
+ |
- Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code |
| 710 |
+ |
and networking |
| 711 |
|
- Bill Huey <billh@mag.ucsd.edu>: 15/16 bit DGA and 15/16/32 bit X11 |
| 712 |
|
window support |
| 713 |
< |
- David Lawrence <davidl@jlab.org>: incremental window refresh code |
| 713 |
> |
- Brian J. Johnson <bjohnson@sgi.com>: IRIX support |
| 714 |
> |
- Jürgen Lachmann <juergen_lachmann@t-online.de>: AmigaOS CyberGraphX support |
| 715 |
|
- Samuel Lander <blair_sp@hotmail.com>: tile-based window refresh code |
| 716 |
< |
- Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and |
| 717 |
< |
fbdev video code |
| 716 |
> |
- David Lawrence <davidl@jlab.org>: incremental window refresh code |
| 717 |
> |
- Lauri Pesonen <lpesonen@nic.fi>: Windows NT port |
| 718 |
> |
- Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation |
| 719 |
|
- and others... |
| 720 |
|
|
| 721 |
|
Special thanks to: |
