BRIEF-INSTALLATION-INSTRUCTIONS

   1 JPC-RR quick installation instructions:
   2
   3 1) Ensure you have JDK6 installed, if not, install it (no, JRE or JDK5 is
   4 not sufficient)
   5
   6 2) Compile the source. './build.sh' (Unix) or 'build' (windows).
   7
   8 3) Get BIOS/DOS disk images. Original JPC source code
   9 (http://www-jpc.physics.ox.ac.uk/download_download.html) is good place
  10 to rip those from. They are files bios.bin, vgabios.bin and floppy.img.
  11
  12 4) Change directory to top of source tree.
  13
  14 5) Launch the emulator
  15
  16 'java JPCApplication -library disklibrary -autoexec assemble.jpcrrinit'
  17
  18 disklibrary is directory where disk images are found and stored
  19 (if it doesn't exist, it will be created).
  20 assemble.jpcrrinit contains reasonable set of initialization commands.
  21
  22 If you run emulator from directory other than the source tree, then:
  23
  24 -Set CLASSPATH to '<directory-jpcrr-source-is>:.' (Unix) or
  25 '<directory-jpcrr-source-is>;.' (Windows)
  26 - Replace 'disklibrary' with path to library directory.
  27 - Replace 'assemble.jpcrrinit' with path to corresponding file.
  28
  29 First time you start, you may get complaint about being unable
  30 to find BIOS image. Just dismiss it.
  31
  32 5) Convert the images:
  33
  34 Import BIOS image: Select Drives  -> Import Image and input
  35
  36 Image Name: BIOS
  37 Image File: <path-to-bios.bin>
  38 Image Type: BIOS image
  39
  40 Then hit "import". Pop-up should say that image was imported.
  41
  42 Then same thing for VGABIOS, this time values are:
  43
  44 Image Name: VGABIOS
  45 Image File: <path-to-vgabios.bin>
  46 Image Type: BIOS image
  47
  48 Import FreeDOS image, values are:
  49
  50 Image Name: FreeDOS
  51 Image File: <path-to-floppy.img>
  52 Image Type: Floppy disk
  53 Standard geometry: Checked
  54
  55 Note that BIOS should be named 'BIOS' and vgabios should be named
  56 'VGABIOS' as those are the defaults for main system BIOS / VGA BIOS.
  57
  58 If the boot floppy is oddly sized, you may have to specify geometry
  59 manually.
  60
  61 6) Grab game files and make images out of these:
  62
  63 File -> Import image and fill the form. The image file may be directory.
  64
  65 I use 16 sides,63 sectors,16 tracks if game fits into that (it provodes
  66 ~8MB space). If it doesn't then bump tracks to 128 (~64MB) or even 1023
  67 (~512MB).
  68
  69 The emulator should now be set up (File->Assemble)
  70
  71 7) To relaunch the emulator, use the same command as in 4)
  72
  73 'java JPCApplication -library disklibrary -autoexec assemble.jpcrrinit'
  74
  75 Replace parameters with appropriate values if needed (and set CLASSPATH
  76 if needed, see 4)).
  77
  78 Hints:
  79
  80 - DOSIDLE interferes with emulator. Either skip autoexec.bat coming
  81 on FreeDOS that comes with JPC or confirm line by line and leave
  82 that out.
  83 - Putting the HD as HDD (4th hard drive) avoids BIOS having to timeout
  84 HDD, speeding up boot.