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.10 by cebix, 2000-04-10T18:52:15Z vs.
Revision 1.21 by cebix, 2001-07-09T11:21:58Z

# 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-2000 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 325 | Line 327 | ether <ethernet card description>
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.
# Line 349 | Line 352 | ether <ethernet card description>
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
# Line 379 | Line 382 | ether <ethernet card description>
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
# Line 414 | Line 422 | frameskip <frames to skip>
422    For refreshed graphics modes (usually window modes), this specifies
423    how many frames to skip after drawing one frame. Higher values make
424    the video display more responsive but require more processing power.
425 <  The default is "8".
425 >  The default is "8". Under Unix/X11, a value of "0" selects a "dynamic"
426 >  update mode that cuts the display into rectangles and updates each
427 >  rectangle individually, depending on display changes.
428  
429   modelid <MacOS model ID>
430  
# Line 476 | Line 486 | Unix:
486      is /usr/local/share/BasiliskII/fbdevices. A sample file is included
487      with Basilisk II.
488  
489 +  mousewheelmode <mode>
490 +
491 +    If you have a mouse with a wheel, this option specifies whether moving
492 +    the wheel will be reported to the MacOS as "Page up/down" (mode 0) or
493 +    "Cursor up/down" (mode 1) keys.
494 +
495 +  mousewheellines <number of lines>
496 +
497 +    If "mousewheelmode" is set to mode 1 (Cursor up/down), this option sets
498 +    the number of key events sent to MacOS for each wheel movement (the
499 +    number of lines to scroll).
500 +
501   AmigaOS:
502  
503    sound <sound output description>
# Line 486 | Line 508 | AmigaOS:
508  
509        ahi/<hexadecimal mode ID>
510  
511 +  scsimemtype <type>
512 +
513 +    This item controls the type of memory to use for SCSI buffers. Possible
514 +    values are:
515 +      0 Chip memory
516 +      1 24-bit DMA capable memory
517 +      2 Any memory
518 +
519 +    Be warned that many SCSI host adapters will not work with the "Any memory"
520 +    setting. Basilisk II has no way of knowing which memory type is supported
521 +    by the host adapter and setting an unsupported type will result in data
522 +    corruption.
523 +
524   Windows:
525  
526    noscsi <"true" or "false">
# Line 581 | Line 616 | Keyboard:
616    On PC-style keyboards, "Alt" is the Mac "Command" key, while the "Windows"
617    key is the Mac "Option" key.
618  
619 + Mouse:
620 +  Under Unix, press Ctrl-F5 while the Basilisk II window is active will grab
621 +  the mouse. This is needed for compatibility with some MacOS programs,
622 +  especially games. Press Ctrl-F5 again to return to normal mouse operation.
623 +
624   Floppy:
625    Basilisk II can only handle 1.44MB MFM floppies. Depending on your platform,
626 <  flopyy disk changes might not be detected automatically. Under Linux, press
626 >  floppy disk changes might not be detected automatically. Under Unix, press
627    Ctrl-F1 to mount a floppy. Under BeOS, select the appropriate "Mount" menu
628    item or press Ctrl-F1 to mount a floppy. Under Windows, press Ctrl-Shift-F11.
629  
# Line 642 | Line 682 | Please see the included file "TECH" for
682   Acknowledgements
683   ----------------
684  
685 < 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
685 > Contributions by (in alphabetical order):
686   - Orlando Bassotto <future@powercube.mediabit.net>: FreeBSD support
687 < - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
687 > - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
688 >   fbdev video code
689   - Marc Chabanas <Marc.Chabanas@france.sun.com>: Solaris sound support
690 + - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
691 +   and networking
692   - Bill Huey <billh@mag.ucsd.edu>: 15/16 bit DGA and 15/16/32 bit X11
693     window support
694 < - David Lawrence <davidl@jlab.org>: incremental window refresh code
694 > - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
695 > - Jürgen Lachmann <juergen_lachmann@t-online.de>: AmigaOS CyberGraphX support
696   - Samuel Lander <blair_sp@hotmail.com>: tile-based window refresh code
697 < - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
698 <   fbdev video code
697 > - David Lawrence <davidl@jlab.org>: incremental window refresh code
698 > - Lauri Pesonen <lpesonen@nic.fi>: Windows NT port
699 > - Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation
700   - and others...
701  
702   Special thanks to:

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines