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 |
|
611 |
Special thanks to: |
612 |
- Bernd Schmidt for letting me use his UAE 68k emulation |
613 |
- Daniel Bobbert who printed dozens of pages from the THINK Reference for |
614 |
me years ago |
615 |
- All ShapeShifter and SheepShaver users and beta testers |
616 |
- Apple Computer Inc., who made writing a Macintosh emulator a child's play |
617 |
|
618 |
|
619 |
Bug reports |
620 |
----------- |
621 |
|
622 |
You found a bug? Well, use the source, fix it and send the fix to |
623 |
<Christian.Bauer@uni-mainz.de> |
624 |
for inclusion in the next release of Basilisk II. |
625 |
|
626 |
|
627 |
Author |
628 |
------ |
629 |
|
630 |
You can contact me at <Christian.Bauer@uni-mainz.de>. Don't send bug |
631 |
reports, send fixes. Ports to other platforms are also very welcome. |
632 |
Please contact me before you intend to make major changes to the source. |
633 |
You might be working on something that I have already done or I may have |
634 |
different ideas about the Right Way to do it. |
635 |
|
636 |
Questions about ROM files will not be answered. There is also no point in |
637 |
sending me questions etc. that are specific to the Windows port of |
638 |
Basilisk II. I don't have Windows and can't say anything about that. |
639 |
Ask Lauri Pesonen instead. |
640 |
|
641 |
|
642 |
Support |
643 |
------- |
644 |
|
645 |
The official Basilisk II home page is at |
646 |
http://www.uni-mainz.de/~bauec002/B2Main.html |
647 |
|
648 |
There is no user-level support for Basilisk II at the moment. |
649 |
|
650 |
|
651 |
History |
652 |
------- |
653 |
|
654 |
Please consult the file "ChangeLog" for the release history. |
655 |
|
656 |
|
657 |
Christian Bauer |
658 |
<Christian.Bauer@uni-mainz.de> |