1 |
cebix |
1.1 |
BASILISK II INSTALLATION INSTRUCTIONS |
2 |
|
|
===================================== |
3 |
|
|
|
4 |
|
|
System Requirements |
5 |
|
|
------------------- |
6 |
|
|
|
7 |
|
|
To use Basilisk II, you need either a 512K Mac Classic ROM image or a |
8 |
|
|
512K or 1MB 32-bit clean Macintosh ROM image. You also need a copy of MacOS |
9 |
|
|
(0.x thru 7.5 for Classic emulation, 7.x or 8.0/8.1 for Mac II emulation). |
10 |
|
|
For copyright reasons, none of these items are included with Basilisk II. |
11 |
|
|
MacOS 7.5.3 and earlier versions can be downloaded from Apple and various |
12 |
|
|
other Internet sites. Mac ROM files are not freely available. You have to |
13 |
|
|
own a real Mac and read out its ROM. No, I don't know where you can download |
14 |
|
|
ROM files. No, I won't send you one. |
15 |
|
|
|
16 |
|
|
Depending on the platform you use, Basilisk II has additional requirements: |
17 |
|
|
|
18 |
|
|
BeOS: |
19 |
cebix |
1.7 |
You need BeOS R4 or later versions. |
20 |
cebix |
1.1 |
Basilisk II cannot do Mac Classic emulation. |
21 |
|
|
|
22 |
|
|
Unix: |
23 |
cebix |
1.5 |
You need X11R6 and a "make" utility with the VPATH feature (e.g. GNU make). |
24 |
|
|
For serial, ethernet and audio support, you need pthreads. To use the GUI |
25 |
|
|
preferences editor, you also need GTK+ version 1.2 or better. On Linux, you |
26 |
|
|
need glibc 2.0 or better. |
27 |
cebix |
1.1 |
|
28 |
|
|
AmigaOS: |
29 |
|
|
You need at least a 68020 and AmigaOS 3.0 or better. To get the GUI |
30 |
|
|
preferences editor, you need gtlayout.library V39 or later. To get sound |
31 |
|
|
output, you need AHI V2 or later. Both items can be found on Aminet. You |
32 |
|
|
also need the "PrepareEmul" utility that somes with ShapeShifter (or any |
33 |
|
|
equivalent PrepareEmul substitute). The AmigaOS version of Basilisk II |
34 |
|
|
cannot do Mac Classic emulation. |
35 |
|
|
|
36 |
|
|
Windows: |
37 |
|
|
You need at least Windows NT 4.0. Windows 95 and 98 can be used too, with a |
38 |
|
|
somewhat reduced set of features. Basilisk II supports DirectX version 5 or |
39 |
|
|
later, but version 3 may also work, depending on your graphics card. |
40 |
|
|
|
41 |
nigel |
1.8 |
Mac OS X: |
42 |
|
|
Versions 10.0 thru 10.2 can be used, and 10.3 will probably be no problem. |
43 |
|
|
(OS X public beta is not supported by the current executable or source code, |
44 |
|
|
but if you really need to use it, I can provide versions that will work) |
45 |
cebix |
1.1 |
|
46 |
|
|
Installation |
47 |
|
|
------------ |
48 |
|
|
|
49 |
|
|
BeOS: |
50 |
|
|
If you have a binary distribution of Basilisk II for BeOS, there are |
51 |
cebix |
1.6 |
executables for BeOS/PPC and/or BeOS/x86 included. Basilisk II cannot run |
52 |
|
|
concurrently with SheepShaver. Trying to do so will crash Basilisk II, or |
53 |
|
|
SheepShaver, or both. |
54 |
|
|
|
55 |
|
|
If you have the source distribution, do the following: |
56 |
cebix |
1.1 |
|
57 |
|
|
cd src/BeOS |
58 |
|
|
make |
59 |
|
|
|
60 |
cebix |
1.3 |
This will produce an executable "BasiliskII" in the "obj.ppc" or "obj.x86" |
61 |
cebix |
1.6 |
directory. To use Ethernet, you also have to do: |
62 |
|
|
|
63 |
|
|
cd SheepNet |
64 |
|
|
make install |
65 |
|
|
|
66 |
|
|
On a PowerPC system, you also have to do: |
67 |
|
|
|
68 |
|
|
cd SheepDriver |
69 |
|
|
make install |
70 |
cebix |
1.1 |
|
71 |
|
|
Unix: |
72 |
|
|
To compile Basilisk II, do the following: |
73 |
|
|
|
74 |
|
|
cd src/Unix |
75 |
|
|
./configure |
76 |
cebix |
1.4 |
make [or "gmake" if you have GNU make and "make" fails] |
77 |
cebix |
1.1 |
make install [optionally] |
78 |
|
|
|
79 |
|
|
To use Ethernet networking under Linux, you either have to configure your |
80 |
cebix |
1.7 |
kernel for ethertap support or make and install the "sheep_net" driver |
81 |
|
|
(this is explained in the README file, at the description of the "ether" |
82 |
|
|
preferences item). |
83 |
cebix |
1.1 |
|
84 |
|
|
This is what Brian J. Johnson says about compiling for IRIX: |
85 |
|
|
"I recommend compiling with "-Ofast". This requires changing "-g" |
86 |
|
|
to "-Ofast" in the Makefile, and adding "-ipa" to LDFLAGS. This |
87 |
|
|
turns on massive interprocedural optimization, and makes for much |
88 |
|
|
better performance." |
89 |
cebix |
1.5 |
|
90 |
|
|
ATTENTION NetBSD/m68k USERS: |
91 |
|
|
If you want to run Basilisk II natively (i.e. without CPU emulation), you |
92 |
|
|
must NOT use a pthreads library. User-level threads libraries such as PTL |
93 |
|
|
interfere with the signal handlers installed by Basilisk II and kernel- |
94 |
|
|
level threads are not supported by NetBSD, so you will have to live without |
95 |
cebix |
1.7 |
pthreads, and thus without serial/ethernet/audio support (but the "UDP |
96 |
|
|
tunnelling" network should work). |
97 |
cebix |
1.5 |
|
98 |
|
|
ATTENTION NetBSD/mac68k USERS: |
99 |
|
|
Current (as of July 2000) versions of the NetBSD/mac68k kernel have a bug |
100 |
|
|
that not only prevents Basilisk II from running properly but seems to even |
101 |
|
|
cause kernel panics under certain conditions! Apply the following patch to |
102 |
|
|
/sys/arch/mac68k/mac68k/macromasm.s, recompile and re-install the kernel |
103 |
|
|
and reboot before using Basilisk II: |
104 |
|
|
|
105 |
|
|
--- macromasm.s.orig Wed Jul 5 19:29:01 2000 |
106 |
|
|
+++ macromasm.s Wed Jul 5 19:12:34 2000 |
107 |
|
|
@@ -37,6 +37,8 @@ |
108 |
|
|
|
109 |
|
|
#include "opt_adb.h" |
110 |
|
|
#include "assym.h" |
111 |
|
|
+#include <machine/asm.h> |
112 |
|
|
+#include <machine/trap.h> |
113 |
|
|
|
114 |
|
|
|
115 |
|
|
/* Define this symbol as global with (v) value */ |
116 |
|
|
@@ -437,8 +439,9 @@ |
117 |
|
|
movw sp@(FR_HW + 4), d0 | retrieve status register |
118 |
|
|
andw #PSL_S, d0 | supervisor state? |
119 |
|
|
bne Lalnosup | branch if supervisor |
120 |
|
|
- jbsr _mrg_aline_user | user a-line trap |
121 |
|
|
- bra Lalrts |
122 |
|
|
+ addql #4, sp | pop frame ptr |
123 |
|
|
+ movql #T_ILLINST, d0 | user-mode fault |
124 |
|
|
+ jra _ASM_LABEL(fault) |
125 |
|
|
Lalnosup: |
126 |
|
|
#define FR_PC (FR_HW+2) |
127 |
|
|
movl sp@(FR_PC + 4), a0 | retrieve PC |
128 |
cebix |
1.1 |
|
129 |
|
|
AmigaOS: |
130 |
|
|
If you have a binary distribution of Basilisk II for AmigaOS, there is an |
131 |
|
|
executable included. You must also have the "PrepareEmul" utility installed |
132 |
|
|
that comes with ShapeShifter (or any equivalent PrepareEmul substitute, |
133 |
|
|
see the ShapeShifter docs). If you have the source distribution, do the |
134 |
|
|
following: |
135 |
|
|
|
136 |
|
|
cd src/AmigaOS |
137 |
cebix |
1.6 |
make |
138 |
cebix |
1.1 |
|
139 |
cebix |
1.6 |
To recompile Basilisk II, you need the GeekGadgets development suite and |
140 |
|
|
PhxAss (which can be found on Aminet). |
141 |
cebix |
1.1 |
|
142 |
|
|
Windows NT: |
143 |
|
|
If you have a binary distribution of Basilisk II for Windows, there is a |
144 |
|
|
Windows NT binary included. To access CD-ROMs under Windows NT, the driver |
145 |
|
|
"cdenable.sys" must be copied to your "\WinNT\System32\drivers" directory. |
146 |
|
|
To access CD-ROMs under Windows 9x, the driver "cdenable.vxd" must be copied |
147 |
|
|
to the "\Windows\System" directory. To recompile Basilisk II, you need |
148 |
|
|
MS Visual V++ 5.0 or later. Symantec C++ should work, too, with some |
149 |
|
|
modifications. See the "sysdeps.h" file in the "Windows" directory. |
150 |
nigel |
1.8 |
|
151 |
|
|
Mac OS X: |
152 |
|
|
If you have the prebuilt application, there is nothing to do. |
153 |
|
|
If you have the developer tools installed, and want to built it yourself, |
154 |
|
|
look in the file src/MacOSX/0_HOW_TO_BUILD.txt |
155 |
|
|
|
156 |
cebix |
1.1 |
|
157 |
|
|
The ROM file has to be named "ROM" and put in the same directory as the |
158 |
|
|
Basilisk II executable but you can specify a different location for the ROM |
159 |
|
|
file with the "rom" option in the preferences file (or with the preferences |
160 |
|
|
GUI). |