| 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-2000 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) |
| 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 |
| 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: |
| 662 |
< |
- Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation |
| 663 |
< |
- Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code |
| 664 |
< |
and networking |
| 665 |
< |
- 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: |
