ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/BasiliskII/README
(Generate patch)

Comparing BasiliskII/README (file contents):
Revision 1.7 by cebix, 1999-10-21T18:29:04Z vs.
Revision 1.17 by cebix, 2001-02-02T20:52:56Z

# Line 1 | Line 1
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
# Line 16 | Line 15 | See the file "COPYING" that is included
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  
# Line 41 | Line 42 | Some features of Basilisk II:
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.
# Line 234 | Line 236 | screen <video mode>
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:
# Line 332 | Line 334 | ether <ethernet card description>
334    Linux:
335      The "ethernet card description" is the name of an Ethernet interface.
336      There are two approaches to networking with Basilisk II:
337 +
338        1. Direct access to an Ethernet card via the "sheep_net" driver.
339           In this case, the "ethernet card description" must be the name
340           of a real Ethernet card, e.g. "eth0". It also requires the "sheep_net"
# Line 341 | Line 344 | ether <ethernet card description>
344           networking. MacOS will only be able to talk to other machines on
345           the Ethernet, but not to other networks that your Linux box routes
346           (e.g. a second Ethernet or a PPP connection to the Internet).
347 +
348        2. Putting Basilisk II on a virtual Ethernet via the "ethertap" device.
349           In this case, the "ethernet card description" must be the name
350           of an ethertap interface, e.g. "tap0". It also requires that you
351           configure your kernel to enable routing and the ethertap device:
352           under "Networking options", enable "Kernel/User netlink socket" and
353           "Netlink device emulation", under "Network device support", activate
354 <         "Ethertap network tap". Next, see /usr/src/linux/Documentation/
355 <         networking/ethertap.txt for information on how to set up /dev/tap*
356 <         device nodes and activate the ethertap interface. Under MacOS,
357 <         select an IP address that is on the virtual network and set the
358 <         default gateway to the IP address of the ethertap interface. This
359 <         approach will let you access all networks that your Linux box has
360 <         access to (especially, if your Linux box has a dial-up Internet
361 <         connection and is configured for IP masquerading, you can access
362 <         the Internet from MacOS). The drawback is that you can only use
363 <         network protocols that Linux can route, so you have to install and
364 <         configure netatalk if you want to use AppleTalk.
354 >         "Ethertap network tap". You also have to modify drivers/net/ethertap.c
355 >         a bit before compiling the new kernel:
356 >
357 >          - insert "#define CONFIG_ETHERTAP_MC 1" near the top (after the
358 >            #include lines)
359 >          - comment out the line "dev->flags|=IFF_NOARP;" in ethertap_probe()
360 >
361 >         Next, see /usr/src/linux/Documentation/networking/ethertap.txt for
362 >         information on how to set up /dev/tap* device nodes and activate the
363 >         ethertap interface. Under MacOS, select an IP address that is on the
364 >         virtual network and set the default gateway to the IP address of the
365 >         ethertap interface. This approach will let you access all networks
366 >         that your Linux box has access to (especially, if your Linux box has
367 >         a dial-up Internet connection and is configured for IP masquerading,
368 >         you can access the Internet from MacOS). The drawback is that you
369 >         can only use network protocols that Linux can route, so you have to
370 >         install and configure netatalk if you want to use AppleTalk. Here is
371 >         an example /etc/atalk/atalkd.conf for a LAN:
372 >
373 >           eth0 -seed -phase 2 -net 1 -addr 1.47 -zone "Ethernet"
374 >           tap0 -seed -phase 2 -net 2 -addr 2.47 -zone "Basilisknet"
375 >
376 >         (the "47" is an arbitrary node number). This will set up a zone
377 >         "Ethernet" (net 1) for the Ethernet and a zone "Basilisknet" (net 2)
378 >         for the internal network connection of the ethertap interface.
379 >         MacOS should automatically recognize the nets and zones upon startup.
380 >         If you are in an existing AppleTalk network, you should contact
381 >         your network administrator about the nets and zones you can use
382 >         (instead of the ones given in the example above).
383  
384    AmigaOS:
385      You have to specify the name of the SANA-II Ethernet device and the device
# Line 394 | Line 416 | frameskip <frames to skip>
416    For refreshed graphics modes (usually window modes), this specifies
417    how many frames to skip after drawing one frame. Higher values make
418    the video display more responsive but require more processing power.
419 <  The default is "8".
419 >  The default is "8". Under Unix/X11, a value of "0" selects a "dynamic"
420 >  update mode that cuts the display into rectangles and updates each
421 >  rectangle individually, depending on display changes.
422  
423   modelid <MacOS model ID>
424  
# Line 456 | Line 480 | Unix:
480      is /usr/local/share/BasiliskII/fbdevices. A sample file is included
481      with Basilisk II.
482  
483 +  mousewheelmode <mode>
484 +
485 +    If you have a mouse with a wheel, this option specifies whether moving
486 +    the wheel will be reported to the MacOS as "Page up/down" (mode 0) or
487 +    "Cursor up/down" (mode 1) keys.
488 +
489 +  mousewheellines <number of lines>
490 +
491 +    If "mousewheelmode" is set to mode 1 (Cursor up/down), this option sets
492 +    the number of key events sent to MacOS for each wheel movement (the
493 +    number of lines to scroll).
494 +
495   AmigaOS:
496  
497    sound <sound output description>
# Line 622 | Line 658 | Please see the included file "TECH" for
658   Acknowledgements
659   ----------------
660  
661 < Contributions by:
626 < - Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation
627 < - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
628 <   and networking
629 < - Lauri Pesonen <lpesonen@nic.fi>: Windows NT port
661 > Contributions by (in alphabetical order):
662   - Orlando Bassotto <future@powercube.mediabit.net>: FreeBSD support
663 < - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
663 > - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
664 >   fbdev video code
665   - Marc Chabanas <Marc.Chabanas@france.sun.com>: Solaris sound support
666 + - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
667 +   and networking
668   - Bill Huey <billh@mag.ucsd.edu>: 15/16 bit DGA and 15/16/32 bit X11
669     window support
670 + - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
671 + - Jürgen Lachmann <juergen_lachmann@t-online.de>: AmigaOS CyberGraphX support
672 + - Samuel Lander <blair_sp@hotmail.com>: tile-based window refresh code
673   - David Lawrence <davidl@jlab.org>: incremental window refresh code
674 < - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
675 <   fbdev video code
674 > - Lauri Pesonen <lpesonen@nic.fi>: Windows NT port
675 > - Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation
676   - and others...
677  
678   Special thanks to:

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines