ViewVC Help
View File | Revision Log | Show Annotations | Revision Graph | Root Listing
root/cebix/BasiliskII/README
Revision: 1.6
Committed: 1999-10-21T13:19:11Z (25 years, 1 month ago) by cebix
Branch: MAIN
Changes since 1.5: +3 -0 lines
Log Message:
- added fbdev video code and SPARC assembly optimizations

File Contents

# Content
1
2 Basilisk II, Version 0.7
3 A free, portable Mac II emulator
4
5 Copyright (C) 1997-1999 Christian Bauer et al.
6 Freely distributable
7
8
9 License
10 -------
11
12 Basilisk II is available under the terms of the GNU General Public License.
13 See the file "COPYING" that is included in the distribution for details.
14
15
16 Overview
17 --------
18
19 Basilisk II is a free, portable, Open Source 68k Mac emulator. It requires
20 a copy of a Mac ROM and a copy of MacOS to run. Basilisk II is freeware and
21 distributed under the GNU General Public License.
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)
26 - AmigaOS 3.x
27 - Windows NT 4.0 (mostly works under Windows 95/98, too)
28
29 Some features of Basilisk II:
30 - Emulates either a Mac Classic (which runs MacOS 0.x thru 7.5)
31 or a Mac II series machine (which runs MacOS 7.x, 8.0 and 8.1),
32 depending on the ROM being used
33 - Color video display
34 - CD quality sound output
35 - Floppy disk driver (only 1.44MB disks supported)
36 - Driver for HFS partitions and hardfiles
37 - CD-ROM driver with basic audio functions
38 - Ethernet driver
39 - Serial drivers
40 - SCSI Manager (old-style) emulation
41 - Emulates extended ADB keyboard and 3-button mouse
42 - Uses UAE 68k emulation or (under AmigaOS) real 68k processor
43
44 The emulator is not yet complete. See the file "TODO" for a list of
45 unimplemented stuff.
46
47
48 Requirements and Installation
49 -----------------------------
50
51 Please consult the file "INSTALL" for a list of system requirements and
52 installation instructions.
53
54
55 Configuration
56 -------------
57
58 Basilisk II is configured via the preferences editor that appears on startup.
59 If you have a version without preferences editor (e.g. because of missing GTK+
60 under Unix), you have to edit the preferences file manually.
61
62 The settings are stored in a text file:
63
64 BeOS:
65 /boot/home/config/settings/BasiliskII_prefs
66
67 Unix:
68 ~/.basilisk_ii_prefs
69
70 AmigaOS:
71 ENV:BasiliskII_prefs
72
73 Windows:
74 BasiliskII_prefs (in the same directory as the executable)
75
76 If no preferences file is present, Basilisk II will create one with the
77 default settings upon startup.
78
79
80 Preferences File Format
81 -----------------------
82
83 The preferences file is a text file editable with any text editor.
84 Each line in this file has the format "keyword value" and describes
85 one preferences item. For each keyword, the meaning of the "value"
86 string may vary across platforms. The following keywords exist:
87
88 disk <volume description>
89
90 This item describes one MacOS volume to be mounted by Basilisk II.
91 There can be multiple "disk" lines in the preferences file. Basilisk II
92 can handle hardfiles (byte-per-byte images of HFS volumes in a file on
93 the host system) as well as HFS partitions on hard disks etc. (but Basilisk
94 II doesn't know about MacOS partition tables; it relies on the host OS to
95 handle this). The "volume description" is either the pathname of a hardfile
96 or a platform-dependant description of an HFS partition or drive. If the
97 volume description starts with an asterisk ("*"), the volume is write
98 protected for MacOS (and the "*" is discarded).
99
100 BeOS:
101 To specify an HFS partition, simply specify its path (e.g.
102 "/dev/disk/scsi/0/1/0/0_3"). If you don't specify any volume, Basilisk II
103 will search for and use all available HFS partitions.
104
105 Unix:
106 To specify an HFS partition, simply specify its path (e.g.
107 "/dev/sda5").
108
109 AmigaOS:
110 Partitions/drives are specified in the following format:
111 /dev/<device name>/<unit>/<open flags>/<start block>/<size>/<block size>
112 "start block" and "size" are given in blocks, "block size" is given in
113 bytes.
114
115 Windows:
116 To define a logical volume (Windows NT only), specify its path (e.g. "c:\").
117 To define a physical volume (NT and 9x), additionally give the "physical"
118 keyword (E.g. "physical c:\"). For safety reasons, volumes are mounted as
119 read-only. This is due to the bugs in PC Exchange. If you don't specify
120 any volume, the files *.hfv and *.dsk are searched from the current
121 directory. Note that in this case, Basilisk II tries to boot from the first
122 volume file found, which is random and may not be what you want.
123
124 floppy <floppy drive description>
125
126 This item describes one floppy drive to be used by Basilisk II. There
127 can be multiple "floppy" lines in the preferences file. If no "floppy"
128 line is given, Basilisk II will try to automatically detect and use
129 installed floppy drives. The format of the "floppy drive description"
130 is the same as that of "disk" lines.
131
132 cdrom <CD-ROM drive description>
133
134 This item describes one CD-ROM drive to be used by Basilisk II. There
135 can be multiple "cdrom" lines in the preferences file. If no "cdrom"
136 line is given, Basilisk II will try to automatically detect and use
137 installed CD-ROM drives. The format of the "CD-ROM drive description"
138 is the same as that of "disk" lines.
139
140 scsi0 <SCSI target> ... scsi6 <SCSI target>
141
142 These items describe the SCSI target to be used for a given Mac SCSI
143 ID by Basilisk II. Basilisk II emulates the old SCSI Manager and allows
144 to assign a different SCSI target (they don't even have to be on the
145 same SCSI bus) for each SCSI ID (0..6) as seen by the MacOS. "scsi0"
146 describes the target for ID 0, "scsi1" the target for ID 1 etc.
147 The format of the "SCSI target" is platform specific.
148
149 BeOS:
150 The "SCSI target" has the format "<bus>/<unit>" (e.g. "0/2").
151 Due to a bug in BeOS, using SCSI with Basilisk II may cause the
152 SCSI bus to hang. Use with caution.
153
154 Linux:
155 The "SCSI target" has to be the name of a device that complies to
156 the Generic SCSI driver API. On a standard Linux installation, these
157 devices are "/dev/sg0", "/dev/sg1" etc. Note that you must have
158 appropriate access rights to these devices and that Generic SCSI
159 support has to be compiled into the kernel.
160
161 FreeBSD:
162 The "SCSI target" has the format "<id>/<lun>" (e.g. "2/0").
163
164 AmigaOS:
165 The "SCSI target" has the format "<device name>/<unit>" (e.g.
166 "scsi.device/2").
167
168 Windows:
169 The "SCSI target" has the format <"Vendor"> <"Model"> (e.g.
170 scsi0 "HP" "CD-Writer+ 7100"). Note the use of quotes.
171
172 screen <video mode>
173
174 This item describes the type of video display to be used by Basilisk II.
175 If you are using a Mac Classic ROM, the display is always 1-bit 512x342
176 and this item is ignored. The format of the "video mode" is platform
177 specific.
178
179 BeOS:
180 The "video mode" is one of the following:
181 win/<width>/<height>
182 8-bit color display in a window of the given size. This is the
183 default.
184 scr/<mode>
185 Full-screen display in BWindowScreen. <mode> is the bit number of
186 the video mode to use (see headers/be/interface/GraphicsDefs.h).
187 E.g. 0 = 640x480x8, 1 = 800x600x8 etc., 10 = 640x480x24,
188 11 = 800x600x24 etc., 18 = 640x480x15, 19 = 800x600x15 etc.
189 15 bit modes are preferable to 16 bit modes (which may show false
190 colors on PowerPC machines).
191 When you run in full-screen mode and switch to another Workspace,
192 Basilisk II is put in "suspend" mode (i.e. MacOS will be frozen).
193
194 Unix:
195 The "video mode" is one of the following:
196 win/<width>/<height>
197 Color display in an X11 window of the given size. The color depth
198 (8/15/24 bit) depends on the depth of the underlying X11 screen.
199 This is the default.
200 dga/<width>/<height>
201 Full-screen display using the X11 DGA extensions. The color depth
202 (8/15/24 bit) depends on the depth of the underlying X11 screen.
203 "width" and "height" specify the maximum width/height to use.
204 Saying "dga/0/0" means "complete screen". For DGA to work, Basilisk II
205 must be compiled with DGA support enabled (selectable in the configure
206 script).
207
208 AmigaOS:
209 The "video mode" is one of the following:
210 win/<width>/<height>
211 Black-and-white display in a window of the given size on the
212 Workbench screen. This is the default and will also be used when
213 one of the other options (PIP/screen) fails to open.
214 pip/<width>/<height>
215 15-bit truecolor display in a Picasso96 PIP. This requires
216 Picasso96 as well as a PIP-capable graphics card (e.g. Picasso IV).
217 scr/<hexadecimal mode ID>
218 8/15/24-bit fullscreen display on a Picasso96 screen with the given
219 mode ID. This requires Picasso96. For 15 and 24 bit, the frame buffer
220 format must be QuickDraw-compatible (big-endian, xRGB 1:5:5:5 or
221 xRGB 8:8:8:8). The screen size will be the default size for that
222 mode ID.
223
224 Windows:
225 The "video mode" is one of the following:
226 win/<width>/<height>/<bits per pixel>
227 A refreshed screen mode that uses Windows GDI calls to write to the
228 screen. You may have other windows on top of Basilisk II.
229 dx/<width>/<height>/<bits per pixel>
230 A refreshed DirectX mode (minimum version 5.0). There are ways to
231 install DirectX 5 on NT 4. Some new display adapters work fine even
232 with DirectX 3.
233 fb/<width>/<height>/<bits per pixel>
234 A non-refreshed video mode that works only on NT. It accesses the
235 linear frame buffer directly (best performance of all three modes).
236 Use the hotkey Control-Shift-F12 to switch between Windows and Mac
237 displays. Fast task switch (Alt-Tab) and Explorer start menu
238 (Control-Esc) are disabled, Control-Alt-Del is enabled.
239 <width> and <height> can be either zeroes (uses current screen values),
240 or something else. "win" mode can use almost anything, for other modes
241 there must be a corresponding DirectX mode.
242 <bits> is ignored for mode "win" (uses current screen values).
243 If the mode is "win" and the dimensions are different than the desktop
244 dimensions, windowed mode is used. The window can be moved around by
245 dragging with the right mouse button. This mode remembers window positions
246 separately for different dimensions.
247 The supported values are 8,15,16,24,32. It is possible that some of them
248 do not work for you. In particular, it may be that only one of the
249 two modes, 15 and 16, is suitable for your card. You need to find out
250 the best solution by experimenting.
251 Basilisk II checks what display mode you are currently running and uses
252 that mode. The screen is always full screen. When you switch to another
253 application via Alt-Tab, Basilisk II is put in "snooze" mode (i.e. MacOS
254 is frozen).
255
256 seriala <serial port description>
257
258 This item describes the serial port to be used as Port A (Modem Port)
259 by Basilisk II. If no "seriala" line is given, Basilisk II will try to
260 automatically detect and use installed serial ports. The "serial port
261 description" is a platform-dependant description of a serial port.
262
263 BeOS:
264 Either specify the name of a serial port (e.g. "serial1") or one of
265 "parallel1", "parallel2" or "parallel3". See below for more information
266 about parallel ports.
267
268 Unix:
269 Specify the device name of a serial port (e.g. "/dev/ttyS0") or a
270 parallel "lp" port (e.g. "/dev/lp1"; this only works under Linux and
271 FreeBSD). See below for more information about parallel ports.
272
273 AmigaOS:
274 You have to specify the name of the serial device and the device unit
275 as "<device name>/<unit>" (e.g. "serial.device/0"). If the given device
276 is not compatible to serial.device, Basilisk II will crash. If the
277 device name starts with an asterisk (e.g. "*parallel.device/0"), the
278 device is treated as a parallel.device compatible device. See below for
279 more information about parallel ports.
280
281 Windows:
282 Specify "COM1" or "COM2" for com port 1 or 2, respectively.
283
284 Parallel ports: If you select a parallel port it will look like a serial
285 port to MacOS but Basilisk II will only allow data output and ignore baud
286 rate settings etc. You should be able to get some printers to work with
287 this method (provided that you have the right printer driver, like
288 "Power Print" (see www.gdt.com)).
289
290 serialb <serial port description>
291
292 This item describes the serial port to be used as Port B (Printer Port)
293 by Basilisk II. If no "serialb" line is given, Basilisk II will try to
294 automatically detect and use installed serial ports. The format of the
295 "serial port description" is the same as that of the "seriala" option.
296
297 ether <ethernet card description>
298
299 This item describes the Ethernet card to be used for Ethernet networking
300 by Basilisk II. If no "ether" line is given, Ethernet networking is disabled
301 (although the Ethernet driver of Basilisk II will behave like a "dummy"
302 Ethernet card in this case). If you are using a Mac Classic ROM, Ethernet
303 is not available and this setting is ignored. The "ethernet card description"
304 is a platform-dependant description of an ethernet card.
305
306 BeOS:
307 It doesn't matter what you give as "ethernet card description", Basilisk II
308 will always use the first Ethernet card it finds as long an an "ether"
309 line exists (e.g. say "ether yes"). As Basilisk II requires the sheep_net
310 net server add-on from SheepShaver, you can only use Ethernet on PowerPC
311 machines.
312
313 Linux:
314 The "ethernet card description" is the name of an Ethernet interface.
315 There are two approaches to networking with Basilisk II:
316 1. Direct access to an Ethernet card via the "sheep_net" driver.
317 In this case, the "ethernet card description" must be the name
318 of a real Ethernet card, e.g. "eth0". It also requires the "sheep_net"
319 driver to be installed and accessible. This approach will allow you
320 to run all networking protocols under MacOS (TCP/IP, AppleTalk, IPX
321 etc.) but there is no connection between Linux networking and MacOS
322 networking. MacOS will only be able to talk to other machines on
323 the Ethernet, but not to other networks that your Linux box routes
324 (e.g. a second Ethernet or a PPP connection to the Internet).
325 2. Putting Basilisk II on a virtual Ethernet via the "ethertap" device.
326 In this case, the "ethernet card description" must be the name
327 of an ethertap interface, e.g. "tap0". It also requires that you
328 configure your kernel to enable routing and the ethertap device:
329 under "Networking options", enable "Kernel/User netlink socket" and
330 "Netlink device emulation", under "Network device support", activate
331 "Ethertap network tap". Next, see /usr/src/linux/Documentation/
332 networking/ethertap.txt for information on how to set up /dev/tap*
333 device nodes and activate the ethertap interface. Under MacOS,
334 select an IP address that is on the virtual network and set the
335 default gateway to the IP address of the ethertap interface. This
336 approach will let you access all networks that your Linux box has
337 access to (especially, if your Linux box has a dial-up Internet
338 connection and is configured for IP masquerading, you can access
339 the Internet from MacOS). The drawback is that you can only use
340 network protocols that Linux can route, so you have to install and
341 configure netatalk if you want to use AppleTalk.
342
343 AmigaOS:
344 You have to specify the name of the SANA-II Ethernet device and the device
345 unit as "<device name>/<unit>" (e.g. "ariadne.device/0"). If the given
346 device is not a SANA-II device, Basilisk II will crash. If the device is
347 not an Ethernet device, Basilisk II will display a warning message and
348 disable Ethernet networking.
349
350 rom <ROM file path>
351
352 This item specifies the file name of the Mac ROM file to be used by
353 Basilisk II. If no "rom" line is given, the ROM file has to be named
354 "ROM" and put in the same directory as the Basilisk II executable.
355
356 bootdrive <drive number>
357
358 Specify MacOS drive number of boot volume. "0" (the default) means
359 "boot from first bootable volume".
360
361 bootdriver <driver number>
362
363 Specify MacOS driver number of boot volume. "0" (the default) means
364 "boot from first bootable volume". Use "-62" to boot from CD-ROM.
365
366 ramsize <bytes>
367
368 Allocate "bytes" bytes of RAM for MacOS system and application memory.
369 The value given will be rounded down to the nearest multiple of 1MB.
370 If you are using a Mac Classic ROM, the maximum available value is 4MB
371 and higher values will be ignored. The default is 8MB.
372
373 frameskip <frames to skip>
374
375 For refreshed graphics modes (usually window modes), this specifies
376 how many frames to skip after drawing one frame. Higher values make
377 the video display more responsive but require more processing power.
378 The default is "8".
379
380 modelid <MacOS model ID>
381
382 Specifies the Model ID that Basilisk II should report to MacOS.
383 The default is "5" which corresponds to a Mac IIci. If you want to
384 run MacOS 8, you have to set this to "14" (Quadra 900). Other values
385 are not officially supported and may result in crashes. MacOS versions
386 earlier than 7.5 may only run with the Model ID set to "5". If you are
387 using a Mac Classic ROM, the model is always "Mac Classic" and this
388 setting is ignored.
389
390 nosound <"true" or "false">
391
392 Set this to "true" to disable all sound output. This is useful if the
393 sound takes too much CPU time on your machine or to get rid of warning
394 messages if Basilisk II can't use your audio hardware.
395
396 nocdrom <"true" or "false">
397
398 Set this to "true" to disable Basilisk's built-in CD-ROM driver.
399 The only reason to do this is if you want to use a third-party CD-ROM
400 driver that uses the SCSI Manager. The default is "false".
401
402 nogui <"true" or "false">
403
404 Set this to "true" to disable the GUI preferences editor and GUI
405 error alerts. All errors will then be reported to stdout. The default
406 is "false".
407
408 For additional information, consult the source.
409
410
411 System-specific configuration
412 -----------------------------
413
414 Unix:
415
416 keycodes <"true" or "false">
417 keycodefile <Keycode file path>
418
419 By default, the X11 event handler in Basilisk II uses KeySyms to
420 translate keyboard event to Mac keycodes. While this method is very
421 compatible and ought to work with all X servers, it only works well
422 if your keyboard has a US layout. If you set "keycodes" to "true",
423 Basilisk II will use raw keycodes instead of KeySyms. The keycode
424 depends only on the physical location of a key on the keyboard and
425 not on the selected keymap. Unfortunately it depends on the X server
426 being used and possibly also on the type of keyboard attached. So
427 Basilisk II needs a table to translate X keycodes to Mac keycodes.
428 This table is read by default from /usr/local/lib/basilisk_ii_keycodes
429 unless you specify a different file with the "keycodefile" item.
430 A sample keycode file ("basilisk_ii_keycodes") is included with
431 Basilisk II.
432
433 AmigaOS:
434
435 sound <sound output description>
436
437 This item specifies what method to use for sound output. The only choice
438 is currently AHI, but you can specify the AHI mode ID to be used. The
439 "sound output description" looks like this:
440
441 ahi/<hexadecimal mode ID>
442
443 Windows:
444
445 noscsi <"true" or "false">
446
447 Completely disables SCSI Manager support when set to "true".
448 Note that currently all SCSI operations are executed synchronously,
449 even if Mac application has requested asynchronous operation. What this
450 means is that the control is not returned to the application until the
451 command is completely finished. Normally this is not an issue, but when a
452 CDR/CDRW is closed or erased the burner program typically wants to wait in
453 some progress dialog The result may be that the application reports a
454 time-out error, but the operation completes all right anyway.
455
456 nofloppyboot <"true" or "false">
457
458 Set this to "true" to disable booting from a floppy.
459
460 replacescsi <"Vendor1"> <"Model1"> <"Vendor2"> <"Model2">
461
462 This command tricks the Mac to believe that you have a SCSI device Model2
463 from vendor Vendor2, although your real hardware is Model1 from Vendor1.
464 This is very useful since many devices have almost identical ATAPI and SCSI
465 versions of their hardware, and MacOS applications usually support the SCSI
466 version only. The example below is typical:
467
468 replacescsi "HP" "CD-Writer+ 7100" "PHILIPS" "CDD3600"
469
470 Note the use of quotes.
471
472 rightmouse <0/1>
473
474 Defines what the right mouse button is used for. The default values of 0
475 means that it is used to move windowed mode BasiliskII screen.
476 Value 1 sends a combination Control and mouse click to the MacOS.
477 This may be useful under OS versions 8 and above.
478
479 keyboardfile <path>
480
481 Defines the path of the customized keyboard code file.
482
483 pollmedia <"true" or "false">
484
485 If true (default), tries to automatically detect new media.
486 Applies to all "floppy", "cd" or "disk" removable media except
487 1.44 MB floppies. May cause modest slow down. If unchecked,
488 use Ctrl-Shift-F11 to manually mount new media.
489 If you have auto-insert notification (AIN) enabled, you may turn this
490 option off. Note that some CD related software require AIN,
491 and some other need it to be turned off. Consult the documentation
492 of your CD software to learn which one is optimal for you.
493
494 framesleepticks <milliseconds>
495
496 The amount of time between video frames.
497
498 showfps <true/false>
499
500 If true, the real frame rate is displayed.
501
502 stickymenu <true/false>
503
504 If true, the main menu bar is kept open even after the mouse button is released,
505 under all OS versions (OS 8 has this feature already). There are extensions to do
506 the same thing, but it's faster to handle this in native code.
507 Default is "true".
508
509 ntdx5hack <"true" or "false">
510
511 You may need this on NT if your display adapter driver has a bug in DirectX
512 palette support. Black and white are reversed. It fixes the palette issue
513 by using GDI palette instead of D3D palette. Default is false.
514
515
516 Usage
517 -----
518
519 Quitting:
520 The right way to quit Basilisk II is to select the "Shut Down" menu item
521 from the Finder's "Special" menu. You should not kill it from the shell
522 unless it hangs. Under Unix, pressing "Esc" while holding the Ctrl key will
523 also quit Basilisk II (in case you are using it in DGA mode and it crashed).
524 Under Windows, try Alt-F4 (or Control-Alt-Del to log off and back on again
525 if it crashes really badly).
526
527 Suspending:
528 The Unix version of Basilisk II can be suspended while running in DGA mode
529 by pressing "Tab" while holding the Ctrl key. Pressing "Space" in the
530 "suspended" window will resume the emulation. Under BeOS, switching to
531 a different Workspace when BasiliskII is in full-screen mode will also
532 suspend the emulation.
533
534 Keyboard:
535 On PC-style keyboards, "Alt" is the Mac "Command" key, while the "Windows"
536 key is the Mac "Option" key.
537
538 Floppy:
539 Basilisk II can only handle 1.44MB MFM floppies. Depending on your platform,
540 flopyy disk changes might not be detected automatically. Under Linux, press
541 Ctrl-F1 to mount a floppy. Under BeOS, select the appropriate "Mount" menu
542 item or press Ctrl-F1 to mount a floppy. Under Windows, press Ctrl-Shift-F11.
543
544 HFS partitions:
545 Having HFS partitions mounted for read-write access under Basilisk II while
546 they are also mounted on the host OS will most likely result in volume
547 corruption and data losses. Unmount your HFS volumes before starting
548 Basilisk II.
549
550 ZIP drives:
551 Iomega ZIP disks can be mounted either with the "disk" prefs item or (on
552 platforms that support the SCSI Manager emulation of Basilisk II) by
553 installing the IomegaWare on the Mac side. Do not use both ways
554 simultaneously!
555
556 Hardfiles:
557 In addition to plain images of HFS volumes, Basilisk II can also handle
558 some types of Mac "disk image" files, as long as they are uncompressed
559 and unencoded.
560
561 Mac Classic emulation:
562 Sound output and Ethernet are not supported if you are using a Mac Classic
563 ROM. Also, the video display is fixed to 512x342 in monochrome. The AmigaOS
564 and BeOS/PPC versions of Basilisk II cannot do Mac Classic emulation.
565
566 Sound output:
567 Sound output under Basilisk II requires Sound Manager 3.0 or later. This
568 is included starting with MacOS 7.5 and available as a system extension
569 for earlier MacOS versions. Sample rate, bit resolution and mono/stereo
570 can be selected in the Sound control panel (section "Sound Out").
571
572 Ethernet:
573 Basilisk II supports all Ethernet protocols. Running a protocol under
574 Basilisk II that already runs within the host operating system on the same
575 network card (e.g. running MacTCP under Basilisk II on a BeOS machine) may
576 or may not work (generally, it should work, but some specific things like
577 "ping" may not). If you have problems with FTP, try setting your FTP client
578 to passive mode.
579
580 LocalTalk:
581 LocalTalk is not supported by Basilisk II. There is no way of getting
582 LocalTalk to work with the serial drivers of Basilisk II. Any attempt to
583 activate LocalTalk will either result in a crash or revert to Ethernet.
584
585 Serial:
586 You can use the serial ports in Basilisk II to connect to the Internet
587 with a modem and "MacPPP".
588
589
590 Technical Documentation
591 -----------------------
592
593 Please see the included file "TECH" for a technical overview of the emulator.
594
595
596 Acknowledgements
597 ----------------
598
599 Contributions by:
600 - Bernd Schmidt <crux@pool.informatik.rwth-aachen.de>: UAE 68k emulation
601 - Marc Hellwig <Marc.Hellwig@uni-mainz.de>: audio output, BeOS video code
602 and networking
603 - Lauri Pesonen <lpesonen@nic.fi>: Windows NT port
604 - Orlando Bassotto <future@powercube.mediabit.net>: FreeBSD support
605 - Brian J. Johnson <bjohnson@sgi.com>: IRIX support
606 - Marc Chabanas <Marc.Chabanas@france.sun.com>: Solaris sound support
607 - Bill Huey <billh@mag.ucsd.edu>: 15/16 bit DGA and 15/16/32 bit X11
608 window support
609 - David Lawrence <davidl@jlab.org>: incremental window refresh code
610 - Gwenole Beauchesne <gb@dial.oleane.com>: SPARC assembly optimizations and
611 fbdev video code
612 - and others...
613
614 Special thanks to:
615 - Bernd Schmidt for letting me use his UAE 68k emulation
616 - Daniel Bobbert who printed dozens of pages from the THINK Reference for
617 me years ago
618 - All ShapeShifter and SheepShaver users and beta testers
619 - Apple Computer Inc., who made writing a Macintosh emulator a child's play
620
621
622 Bug reports
623 -----------
624
625 You found a bug? Well, use the source, fix it and send the fix to
626 <Christian.Bauer@uni-mainz.de>
627 for inclusion in the next release of Basilisk II.
628
629
630 Author
631 ------
632
633 You can contact me at <Christian.Bauer@uni-mainz.de>. Don't send bug
634 reports, send fixes. Ports to other platforms are also very welcome.
635 Please contact me before you intend to make major changes to the source.
636 You might be working on something that I have already done or I may have
637 different ideas about the Right Way to do it.
638
639 Questions about ROM files will not be answered. There is also no point in
640 sending me questions etc. that are specific to the Windows port of
641 Basilisk II. I don't have Windows and can't say anything about that.
642 Ask Lauri Pesonen instead.
643
644
645 Support
646 -------
647
648 The official Basilisk II home page is at
649 http://www.uni-mainz.de/~bauec002/B2Main.html
650
651 There is no user-level support for Basilisk II at the moment.
652
653
654 History
655 -------
656
657 Please consult the file "ChangeLog" for the release history.
658
659
660 Christian Bauer
661 <Christian.Bauer@uni-mainz.de>