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

   1 # PiStorm
   2
   3 ![logo](https://pbs.twimg.com/media/EoFm2H-WEAIxuTE?format=jpg)
   4
   5 # Join us on Discord or on Freenode IRC #PiStorm
   6
   7 * 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
   8 * There's also an IRC channel on the Freenode IRC network, `#PiStorm`, which is bridged with the `#general` channel on Discord.
   9
  10 # Project information
  11
  12 * 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.
  13 * 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.
  14 * 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.
  15 * 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™.
  16
  17 * 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.
  18 * General Performance with the current use of Musashi as the 68k CPU emulator is somewhere around a 70-80 MHz 68030.
  19 * 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.
  20 * The Raspberry Pi Zero and Model 2/4 cannot currently be used with the PiStorm, and support for these is not officially planned yet.
  21
  22 # Amiga-specific functionality
  23
  24 Since much of the initial work and testing for the PiStorm was done on Amiga computers, a number of extended features are available when the PiStorm is paired with for instance an Amiga 500:
  25 * Kickstart ROM mapping: 1.3, 2.0, 3.1, anything you might own and have dumped in a byteswapped format. Extended ROM mapping as well for instance with the CDTV extended BIOS.
  26   * An A1200 3.1+ Kickstart ROM is currently recommended, as this one has the most dynamic automatic configuration on boot.
  27 * Fast RAM: Z2, Z3 and CPU local Fast can be mapped for high performance memory available to the CPU only on the PiStorm side of things.
  28 * Virtual SCSI: PiSCSI, a high performance virtual SCSI interface for mapping raw RDB disk images or physical storage devices connected to the Pi for use on the Amiga.
  29 * RTG: PiGFX, a virtual RTG board with almost all P96-supported functionality supported and accelerated.
  30 * Some other things: Most likely I forgot something while writing this, but someone will probably tell me about it.
  31
  32 # Simple quickstart
  33
  34 * Download Raspberry Pi OS from https://www.raspberrypi.org/software/operating-systems/, the Lite version is recommended as the windowing system of the Full version adds a lot of extra system load which may impact performance.
  35 * Write the Image to a SD Card. 8GB is plenty for the PiStorm binaries and required libraries, but if you wish to use large hard drive images or sometthing with it, go with a bigger card.
  36 * Install the PiStorm adapter in place of the orignal CPU in the system, for instance an Amiga 500.
  37   Make sure the PiStorm sits flush and correct in the socket.
  38   When installed in an Amiga 500, The correct orientation on the PiStorm is with the USB port facing toward you and the HDMI port facing to the right.
  39   If the PiStorm does not stay in place properly (popping out of the CPU socket) then bend the pins of the PiStorm very very very slightly outwards.
  40   Double check that all is properly in place and no pins are bent.
  41 * Connect an HDMI Display and a USB keyboard to the PiStorm. Using a USB Hub is possible, an externally powered hub is recommended.
  42   Connect the Amiga to the PSU and PAL Monitor
  43 * Insert the SD into the Raspberry Pi, Power on the Amiga now. You should see a Rainbow colored screen on the HDMI Monitor and the PiStorm booting.
  44
  45 * When 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.
  46 * Log in as the default user, typically user: `pi` and password: `raspberry`. (The keyboard is set to US Layout on first boot!)
  47 * Run `sudo raspi-config`
  48 * Set up your preferences like keyboard layout, language, etc. It is recommended to set the screen resolution to 1280x720.
  49 * Set up your Wi-Fi credentials
  50 * Enable SSH at boot time
  51 * Exit raspi-config
  52
  53 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.
  54
  55 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:
  56 * `sudo apt-get install git`
  57 * `git clone https://github.com/captain-amygdala/pistorm.git`
  58 * `cd pistorm`
  59 * `sudo apt-get install libsdl2-dev`
  60 * `make`
  61
  62 Next up, follow the steps for installing the FPGA bitstream update below. (Scroll down.)
  63 You can now start the PiStorm emulator with a basic config by typing `sudo ./emulator` and hitting enter.
  64
  65 To exit the emulator you can press `Ctrl+C` (on the keyboard or over SSH) or press `Q` on the keyboard connected to the Raspberry Pi.
  66
  67 The Amiga Gayle 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.
  68
  69 Since PiSCSI can now autoboot RDSK hard drive images for Amiga computers, using the IDE controller emulation is not recommended unless you already have a suitable .img file set up for it.
  70
  71 # FPGA bitstream update :
  72
  73 Install OpenOCD:
  74 `sudo apt-get install openocd`
  75
  76 Make CPLD programming shell scripts executable:
  77 `chmod +x nprog.sh` `chmod +x nprog_240.sh`
  78
  79 Run the FPGA update with:
  80 `sudo ./nprog.sh` or `sudo ./nprog_240.sh` if you are using a Rev. B EPM240 PiStorm board.
  81 If no fatal error messages are printed on screen and you see a message saying `shutdown command invoked`, this means that the CPLD has been programmed successfully.