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

   1 # pistorm
   2
   3 # Join us on IRC Freenode #PiStorm
   4
   5 * 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!
   6 * 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 :)
   7
   8
   9 Simple quickstart
  10
  11
  12
  13 * Download Raspberry OS from https://www.raspberrypi.org/software/operating-systems/ , the Lite version is sufficent
  14 * Write the Image to a SD Card (8GB sized is plenty, for larger HDD Images pick a bigger one)
  15 * Install the pistorm adapter inplace of the orignal CPU into the Amiga500. Make sure the pistorm sits flush and correct in the Amiga.
  16   The correct orientation on the pistorm is the USB port facing towards you and the HDMI port is facing to the right
  17
  18   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
  19   outwards. Double check that all is properly in place and no pins are bend.
  20
  21 * 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
  22 * 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
  23
  24
  25 * 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
  26   with the login prompt
  27 * Log in as user : pi , password : raspberry (The keyboard is set to US Layout on first boot!)
  28 * run : `sudo raspi-config`
  29 * Setup your preferences like keyboard layout,language etc.
  30 * Setup your Wifi credentials
  31 * Enable SSH at boot time
  32 * Exit raspi-config
  33
  34   You can now reach the pistorm over SSH , look into you router webpage to find the IP of the pistorm or run : ifconfig
  35
  36 * run : `sudo apt-get install git`
  37
  38 * run : `git clone https://github.com/captain-amygdala/pistorm.git`
  39
  40 * run : `cd pistorm`
  41
  42 * run : `make`
  43
  44
  45 to start the pistorm emulator
  46
  47 run : `./run.sh`
  48
  49 to exit emulation
  50 `ctrl+c`
  51
  52 If you want to use the minimal hdd image you need to unpack it :
  53 run : `tar xvfz hd0.tar.gz`
  54
  55 **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 :)
  56
  57 ** FPGA bitstream update :
  58
  59 install openocd
  60 `sudo apt-get install openocd`
  61
  62 make nprog.sh executable
  63 `chmod +x nprog.sh`
  64
  65 run the FPGA update with
  66 `sudo ./nprog.sh`
  67
  68
  69
  70