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

   1 # pistorm
   2
   3 ![logo](https://pbs.twimg.com/media/EoFm2H-WEAIxuTE?format=jpg)
   4
   5
   6 # Join us on IRC Freenode #PiStorm
   7
   8 * 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!
   9 * 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 :)
  10
  11 # wip-crap tutorial/quickstart
  12
  13 In order to successfully use the features on the wip-crap branch, you need to take a few additional steps:
  14
  15 * Follow the steps in the "Simple quickstart" below up to `sudo apt-install git`, then do this:
  16 * `git clone https://github.com/beeanyew/pistorm.git`
  17 * `cd pistorm`
  18 * `git checkout wip-crap`
  19 * `sudo apt-get install libsdl2-dev`
  20 * `make`
  21 * Follow the instructions for `FPGA bitstream update` below the quickstart. This is very important, as the latest commit on the branch uses the updated proto3 firmware.
  22
  23
  24 # Simple quickstart
  25
  26 * Download Raspberry OS from https://www.raspberrypi.org/software/operating-systems/ , the Lite version is sufficent
  27 * Write the Image to a SD Card (8GB sized is plenty, for larger HDD Images pick a bigger one)
  28 * Install the pistorm adapter inplace of the orignal CPU into the Amiga500. Make sure the pistorm sits flush and correct in the Amiga.
  29   The correct orientation on the pistorm is the USB port facing towards you and the HDMI port is facing to the right
  30
  31   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
  32   outwards. Double check that all is properly in place and no pins are bend.
  33
  34 * 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
  35 * 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
  36
  37
  38 * 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
  39   with the login prompt
  40 * Log in as user : pi , password : raspberry (The keyboard is set to US Layout on first boot!)
  41 * run : `sudo raspi-config`
  42 * Setup your preferences like keyboard layout,language etc.
  43 * Setup your Wifi credentials
  44 * Enable SSH at boot time
  45 * Exit raspi-config
  46
  47   You can now reach the pistorm over SSH , look into you router webpage to find the IP of the pistorm or run : ifconfig
  48
  49 * run : `sudo apt-get install git`
  50
  51 * run : `git clone https://github.com/captain-amygdala/pistorm.git`
  52
  53 * run : `cd pistorm`
  54
  55 * run : `make`
  56
  57
  58 to start the pistorm emulator
  59
  60 run : `sudo ./emulator`
  61
  62 to exit emulation
  63 `ctrl+c` or pressing `q` on the keyboard connected to the Raspberry Pi.
  64
  65 The IDE emulation can take both hard drive images generated using `makedisk` in the `ide` directory (these have a 1KB header) or headerless RDSK/RDB images created for instance in WinUAE or as empty files. The IDE emulation currently has a quirk that may require you to reduce/increase the size of the image file by 2MB in order for it to work.
  66
  67 Since PiSCSI can now autoboot RDSK hard drive images, using the IDE controller emulation is not recommended unless you already have a suitable .img file set up for it.
  68
  69 # FPGA bitstream update :
  70
  71 install openocd
  72 `sudo apt-get install openocd`
  73
  74 make nprog.sh executable
  75 `chmod +x nprog.sh`
  76
  77 run the FPGA update with
  78 `sudo ./nprog.sh`
  79
  80
  81
  82