git.sesse.net Git - pistorm/blob - README.md

   1 # pistorm
   2
   3 # Hardware files are in Hardware.zip, using the hardware design or parts of it in a commercial product (aka selling with profit) needs a explicit approval from me!
   4 # Even selling blank PCBs at eBay or so without my approval might makes me pretty mad and probably leads to the forthcomming related projects to be closed source. You have been warned :)
   5
   6
   7 Simple quickstart
   8
   9
  10
  11 * Download Raspberry OS from https://www.raspberrypi.org/software/operating-systems/ , the Lite version is sufficent
  12 * Write the Image to a SD Card (8GB sized is plenty, for larger HDD Images pick a bigger one)
  13 * Install the pistorm adapter inplace of the orignal CPU into the Amiga500. Make sure the pistorm sits flush and correct in the Amiga.
  14   The correct orientation on the pistorm is the USB port facing towards you and the HDMI port is facing to the right
  15
  16   If the pistorm should not stay in place properly (jumping out of the CPU socket) then bend the pins of the pistorm very very very slightly
  17   outwards. Double check that all is properly in place and no pins are bend.
  18
  19 * Connect a HDMI Display and a USB Keyboard to the pistorm. Using a USB Hub is possible, connect the Amiga to the PSU and PAL Monitor
  20 * Insert the SD into the Raspberry, Power on the Amiga now. You should see a Rainbow colored screen on the HDMI Monitor and the pistrom booting
  21
  22
  23 * As soon as the boot process is finished (on the first run it reboots automatically after resizing the filesystems to your SD) you should be greeted
  24   with the login prompt
  25 * Log in as user : pi , password : raspberry (The keyboard is set to US Layout on first boot!)
  26 * run : `sudo raspi-config`
  27 * Setup your preferences like keyboard layout,language etc.
  28 * Setup your Wifi credentials
  29 * Enable SSH at boot time
  30 * Exit raspi-config
  31
  32   You can now reach the pistorm over SSH , look into you router webpage to find the IP of the pistorm or run : ifconfig
  33
  34 * run : `sudo apt-get install git`
  35
  36 * run : `git clone https://github.com/captain-amygdala/pistorm.git`
  37
  38 * run : `cd pistorm`
  39
  40 * run : `make`
  41
  42
  43 to start the pistorm emulator
  44
  45 run : `./run.sh`
  46
  47 to exit emulation
  48 `ctrl+c`
  49
  50 If you want to use the minimal hdd image you need to unpack it :
  51 run : `tar xvfz hd0.tar.gz`
  52
  53 **Currently the emulation is a bit buggy on IDE Interrupts, so it takes ages to boot from the emulated HDD. This will be fixed soon :)
  54
  55 ** FPGA bitstream update :
  56
  57 install openocd
  58 `sudo apt-get install openocd`
  59
  60 make nprog.sh executable
  61 `chmod +x nprog.sh`
  62
  63 run the FPGA update with
  64 `sudo ./nprog.sh`
  65
  66
  67
  68