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 -autoexec assemble.jpcrrinit'
  17
  18 assemble.jpcrrinit contains reasonable set of initialization commands.
  19
  20 First time you start, you may get complaint about being unable
  21 to find BIOS image. Just dismiss it.
  22
  23 5) Convert the images:
  24
  25 Import BIOS image: Select Drives  -> Import Image and input
  26
  27 Image Name: BIOS
  28 Image File: <path-to-bios.bin>
  29 Image Type: BIOS image
  30
  31 Then hit "import". Pop-up should say that image was imported.
  32
  33 Then same thing for VGABIOS, this time values are:
  34
  35 Image Name: VGABIOS
  36 Image File: <path-to-vgabios.bin>
  37 Image Type: BIOS image
  38
  39 Import FreeDOS image, values are:
  40
  41 Image Name: FreeDOS
  42 Image File: <path-to-floppy.img>
  43 Image Type: Floppy disk
  44 Standard geometry: Checked
  45
  46 Note that BIOS should be named 'BIOS' and vgabios should be named
  47 'VGABIOS' as those are the defaults for main system BIOS / VGA BIOS.
  48
  49 If the boot floppy is oddly sized, you may have to specify geometry
  50 manually.
  51
  52 6) Grab game files and make images out of these:
  53
  54 File -> Import image and fill the form. The image file may be directory.
  55
  56 I use 16 sides,63 sectors,16 tracks if game fits into that (it provodes
  57 ~8MB space). If it doesn't then bump tracks to 128 (~64MB) or even 1023
  58 (~512MB).
  59
  60 The emulator should now be set up (File->Assemble)
  61
  62 7) To relaunch the emulator, use the same command as in 4)
  63
  64 'java JPCApplication -autoexec assemble.jpcrrinit'
  65
  66 Replace parameters with appropriate values if needed.
  67
  68 Hints:
  69
  70 - DOSIDLE interferes with emulator. Either skip autoexec.bat coming
  71 on FreeDOS that comes with JPC or confirm line by line and leave
  72 that out.
  73 - Putting the HD as HDD (4th hard drive) avoids BIOS having to timeout
  74 HDD, speeding up boot.