Merge branch 'main' of https://github.com/captain-amygdala/pistorm into main

diff --git a/Makefile b/Makefile
index 107737e99c62b65a181d49137744fee8d410b9df..1f8e2a2c2c7afc0f71189cd8a689f7e143bba565 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -16,7 +16,7 @@ EXEPATH = ./
 
 CC        = gcc
 WARNINGS  = -Wall -Wextra -pedantic
-CFLAGS    = $(WARNINGS) -march=armv7 -O3 -pg
+CFLAGS    = $(WARNINGS) -march=armv7 -O3
 LFLAGS    = $(WARNINGS)
 
 TARGET = $(EXENAME)$(EXE)
@@ -31,7 +31,7 @@ clean:
 
 
 $(TARGET): $(MUSASHIGENHFILES) $(.OFILES) Makefile
-       $(CC) -o $@ $(.OFILES) -O3 -pthread $(LFLAGS) -lm -pg
+       $(CC) -o $@ $(.OFILES) -O3 -pthread $(LFLAGS) -lm
 
 $(MUSASHIGENCFILES) $(MUSASHIGENHFILES): $(MUSASHIGENERATOR)$(EXE)
        $(EXEPATH)$(MUSASHIGENERATOR)$(EXE)

diff --git a/README.md b/README.md
index 8de93ab204073b90a278be85b16dc09798f64dca..0fd060f7f6f6561bfda9f3d3aab39fdffb69996f 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1 +1,53 @@
 # pistorm
+
+Simple quickstart
+
+
+
+* Download Raspberry OS from https://www.raspberrypi.org/software/operating-systems/ , the Lite version is sufficent
+* 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
+  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
+
+
+* 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`
+* Setup your preferences like keyboard layout,language etc.
+* Setup your Wifi credentials
+* Enable SSH at boot time
+* Exit raspi-config 
+  
+  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 : `git clone https://github.com/captain-amygdala/pistorm.git`
+
+* run : `cd pistorm`
+
+* run : `make`
+
+
+to start the pistorm emulator 
+
+run : `./run.sh`
+
+to exit emulation
+`ctrl+c`
+
+If you want to use the minimal hdd image you need to unpack it :
+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 :) 
+
+
+
+