| 16 |
|
Depending on the platform you use, Basilisk II has additional requirements: |
| 17 |
|
|
| 18 |
|
BeOS: |
| 19 |
< |
You need BeOS R4 or better. On a PowerPC system you also need the |
| 20 |
< |
"sheep" driver that comes with SheepShaver. To use Ethernet, you need |
| 21 |
< |
the "sheep_net" add-on that also comes with SheepShaver (both items |
| 22 |
< |
are included in the SheepShaver Trial Versions). The PowerPC version of |
| 19 |
> |
You need BeOS R4 or later versions. |
| 20 |
|
Basilisk II cannot do Mac Classic emulation. |
| 21 |
|
|
| 22 |
|
Unix: |
| 23 |
< |
You need X11R6, pthreads support and GNU make. To use the GUI preferences |
| 24 |
< |
editor, you also need GTK+ version 1.2 or better. On Linux, you need |
| 25 |
< |
glibc 2.0 or better. |
| 23 |
> |
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 |
|
|
| 28 |
|
AmigaOS: |
| 29 |
|
You need at least a 68020 and AmigaOS 3.0 or better. To get the GUI |
| 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 |
+ |
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 |
|
|
| 46 |
|
Installation |
| 47 |
|
------------ |
| 48 |
|
|
| 49 |
|
BeOS: |
| 50 |
|
If you have a binary distribution of Basilisk II for BeOS, there are |
| 51 |
< |
executables for BeOS/PPC and/or BeOS/x86 included. If you have the source |
| 52 |
< |
distribution, do the following: |
| 51 |
> |
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 |
|
|
| 57 |
|
cd src/BeOS |
| 58 |
|
make |
| 59 |
|
|
| 60 |
|
This will produce an executable "BasiliskII" in the "obj.ppc" or "obj.x86" |
| 61 |
< |
directory. Basilisk II cannot run concurrently with SheepShaver. Trying to |
| 62 |
< |
do so will crash Basilisk II, or SheepShaver, or both. On a PowerPC system |
| 63 |
< |
you must have installed the "sheep" driver that comes with SheepShaver. To |
| 64 |
< |
use Ethernet, you must have installed the "sheep_net" add-on that also comes |
| 65 |
< |
with SheepShaver |
| 61 |
> |
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 |
|
|
| 71 |
|
Unix: |
| 72 |
|
To compile Basilisk II, do the following: |
| 77 |
|
make install [optionally] |
| 78 |
|
|
| 79 |
|
To use Ethernet networking under Linux, you either have to configure your |
| 80 |
< |
kernel for ethertap support or make and install the "sheep_net" driver: |
| 81 |
< |
|
| 82 |
< |
make modules |
| 74 |
< |
|
| 75 |
< |
This should produce a kernel module "sheep_net.o" in the "Linux/NetDriver" |
| 76 |
< |
directory. Now su root and say |
| 77 |
< |
|
| 78 |
< |
cd Linux/NetDriver |
| 79 |
< |
make dev |
| 80 |
< |
/sbin/insmod sheep_net.o |
| 81 |
< |
|
| 82 |
< |
This will install the device node "/dev/sheep_net" and load the driver. |
| 83 |
< |
You should give appropriate access rights to /dev/sheep_net if you don't |
| 84 |
< |
want to have to run Basilisk II as root. |
| 80 |
> |
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 |
|
|
| 84 |
|
This is what Brian J. Johnson says about compiling for IRIX: |
| 85 |
|
"I recommend compiling with "-Ofast". This requires changing "-g" |
| 87 |
|
turns on massive interprocedural optimization, and makes for much |
| 88 |
|
better performance." |
| 89 |
|
|
| 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 |
+ |
pthreads, and thus without serial/ethernet/audio support (but the "UDP |
| 96 |
+ |
tunnelling" network should work). |
| 97 |
+ |
|
| 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 |
+ |
|
| 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 |
| 134 |
|
following: |
| 135 |
|
|
| 136 |
|
cd src/AmigaOS |
| 137 |
< |
smake |
| 137 |
> |
make |
| 138 |
|
|
| 139 |
< |
To recompile Basilisk II, you need SAS/C 6.58. Earlier versions may not work. |
| 139 |
> |
To recompile Basilisk II, you need the GeekGadgets development suite and |
| 140 |
> |
PhxAss (which can be found on Aminet). |
| 141 |
|
|
| 142 |
|
Windows NT: |
| 143 |
|
If you have a binary distribution of Basilisk II for Windows, there is a |
| 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 |
|
|
| 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 |
+ |
|
| 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 |
