build-files/BRIEF-INSTALLATION-INSTRUCTIONS

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