]> git.sesse.net Git - pistorm/blobdiff - README.md
Use more familiar offset and limit convention
[pistorm] / README.md
index d83847d389415006b44cbf736d254f8162671a0d..0753d3b6851ba7889512f562d9d4e2b27527c97f 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,5 +1,14 @@
 # pistorm
 
+![logo](https://pbs.twimg.com/media/EoFm2H-WEAIxuTE?format=jpg)
+
+
+# Join us on IRC Freenode #PiStorm 
+
+* 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!
+* 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 :)
+
+
 Simple quickstart
 
 
@@ -8,8 +17,10 @@ Simple quickstart
 * Write the Image to a SD Card (8GB sized is plenty, for larger HDD Images pick a bigger one)
 * Install the pistorm adapter inplace of the orignal CPU into the Amiga500. Make sure the pistorm sits flush and correct in the Amiga.
   The correct orientation on the pistorm is the USB port facing towards you and the HDMI port is facing to the right
-  **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
+
+  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
   outwards. Double check that all is properly in place and no pins are bend.
+
 * 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
 * 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
 
@@ -17,7 +28,7 @@ Simple quickstart
 * 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
   with the login prompt
 * Log in as user : pi , password : raspberry (The keyboard is set to US Layout on first boot!)
-* run : sudo raspi-config
+* run : `sudo raspi-config`
 * Setup your preferences like keyboard layout,language etc.
 * Setup your Wifi credentials
 * Enable SSH at boot time
@@ -25,22 +36,38 @@ Simple quickstart
   
   You can now reach the pistorm over SSH , look into you router webpage to find the IP of the pistorm or run : ifconfig 
 
-run : sudo apt-get install git
-run : cd pistorm
-run : make
+* run : `sudo apt-get install git`
+
+* run : `git clone https://github.com/captain-amygdala/pistorm.git`
+
+* run : `cd pistorm`
+
+* run : `make`
+
 
 to start the pistorm emulator 
 
-run : ./run.sh 
+run : `./run.sh`
 
 to exit emulation
-ctrl+c
+`ctrl+c`
 
 If you want to use the minimal hdd image you need to unpack it :
-run : tar xvfz hd0.tar.gz 
+run : `tar xvfz hd0.tar.gz`
 
 **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 :) 
 
+** FPGA bitstream update :
+
+install openocd 
+`sudo apt-get install openocd`
+
+make nprog.sh executable
+`chmod +x nprog.sh`
+
+run the FPGA update with
+`sudo ./nprog.sh`
+