]> git.sesse.net Git - pistorm/blobdiff - README.md
Update README.md
[pistorm] / README.md
index 8cc3b4da150496c3f6dff01e6639b271c5a74bac..618681f36aca782326629ed0fe09ec9745c143dc 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,23 +1,27 @@
 # PiStorm
 
-![logo](https://pbs.twimg.com/media/EoFm2H-WEAIxuTE?format=jpg)
+![logo](media/pistorm_banner.jpg)
 
 # Join us on Discord or on Freenode IRC #PiStorm 
 
 * There's a Discord server dedicated to PiStorm discussion and development, which you can join through this handy invite link: https://discord.com/invite/j6rPtzxaNW
 * There's also an IRC channel on the Freenode IRC network, `#PiStorm`, which is bridged with the `#general` channel on Discord.
 
+* **IMPORTANT NOTE: Selling blank or complete PCBs or derivatives on eBay or elsewhere for excessive profit is frowned upon and may lead to forthcoming related projects being closed source.**
+* Even with the current global chip shortage (May 2021), components are not **so** expensive that you should pay up to a hundred dollars or Euros for a board.
+* The PiStorm is not a project for making money, it is meant to be an affordable way to replace and extend the functionality of EOL Motorola 68000 processors and have fun in the process.
+* This is not meant to discourage you from making PiStorm boards for others to enjoy, but for instance selling the product as a commercial item and then pawning off support to the community if something doesn't work is absolutely not good™.
+
 # Project information
 
 * The PiStorm itself is an adapter board intended to be paired with a Raspberry Pi Model 3A+. It goes in the DIP socket on and acts in place of the CPU, but functionality can be extended beyond simple CPU emulation.
 * Hardware files are available in `PiStorm_RevB_EPM240_74LVC16373.zip`, but they may be out of date. Joining the Discord and checking for the latest revision/BoM for the PiStorm adapter board is recommended.
-* Selling blank PCBs or derivatives on eBay or similar for excessive profit is frowned upon and may lead to forthcoming related projects being closed source.
-* This is not meant to discourage you from making PiStorm boards for others to enjoy, but for instance selling the product as a commercial item and then pawning off support to the community if something doesn't work is absolutely not good™.
 
 * While the PiStorm should work with any DIP socket 16-bit 68000-powered system, the FC lines are currently not properly handled and no guarantees can be made for it working on anything except an Amiga 500, 500+ and 2000.
 * General Performance with the current use of Musashi as the 68k CPU emulator is somewhere around a 70-80 MHz 68030.
 * The intended Raspberry Pi model to use with the PiStorm is Model 3A+. 3B+ works, but due to component clearance issues it will not fit unless the Pi itself is modified (USB ports replaced) or a GPIO spacer/relocator is installed.
 * The Raspberry Pi Zero and Model 2/4 cannot currently be used with the PiStorm, and support for these is not officially planned yet.
+* If you cannot find the EPM570XXX listed in the BOM, you can substitute an EPM240T100C5N or equivalent
 
 # Amiga-specific functionality
 
@@ -53,10 +57,10 @@ Since much of the initial work and testing for the PiStorm was done on Amiga com
 You can now reach the PiStorm over SSH, check your router web/settings page to find the IP of the PiStorm, or run `ifconfig` locally on the PiStorm from the console.
 
 Now the final steps to get things up and running, all of this is done from a command prompt (terminal) either locally on the PiStorm or over ssh:
-* `sudo apt-get install git`
+* `sudo apt-get update`
+* `sudo apt-get install git libsdl2-dev`
 * `git clone https://github.com/captain-amygdala/pistorm.git`
 * `cd pistorm`
-* `sudo apt-get install libsdl2-dev`
 * `make`
 
 Next up, follow the steps for installing the FPGA bitstream update below. (Scroll down.)