When the Imager finishes writing the image to your SD card you can insert it into the SD card slot of your RaspberryPi.
After turning your Amiga on you should see the Emu68 Logo on your HDMI output.
Ideally (though it is not essential), the Amiga should have both a HDMI monitor and standard Amiga monitor connected since both are used on the First run.
The first time the SD card is booted there will be several additional steps to perform:
Buptest is a check to ensure that communication between the Amiga and the PiStorm is functioning correctly. During the test your HDMI output will show several lines of text detailing the operation. If the test fails then you should seek to either correct any obvious problems with the placing of the PiStorm on the edge connector, or ask for help on the official Discord server HERE.
If all is well, your Amiga will continue booting Emu68. From this point on, all output will switch to your normal (RGB) Amiga monitor.
After the Amiga successfully boots into Workbench the first time, the Buptest stage will be disabled - a successful run is only needed once and it consumes boot time.
Currently Buptest does not run correctly for Pistorm under 3.1 so it is disabled should you install 3.1.
There are several scripts included that will finalise the installation of Workbench, including:
At this step, you will be asked to set up your Locale preferences. This is important for the clock to be set correctly when you go online (which is a requirement for accessing https sites). Note that this will not necessarily change your keyboard localisation settings, which you may need to complete after first boot has completed.
We have provided a Picasso96 settings file with many useful resolutions pre-set for you. Just run the ScreenMode preferences and set any resolution you like. All RTG resolutions will display on your HDMI display, whereas PAL/NTSC et al will show on your Amiga (RGB) monitor.
Workbench will be much snappier with RTG enabled, and you will be able to enjoy millions of colours alongside maximum available Chip RAM. We have also installed PeterK’s icon library that takes advantage of all these colours so you can install PNG icons in all their glory.
It is highly recommended that you take advantage of this display functionality when using a PiStorm, though not mandatory - AmigaOS will happily run without RTG, albeit with a maximum of 256 colours and greatly reduced ChipRAM availability.
If your SD Card is bigger than 100GB and you set up the Work: partition to be bigger than 101GB (the maximum PFS supports) then it will be split into additional partitions.
The first partition named Work: is already formatted, but you will need to format the rest yourself. Just select the Non Initialised partition icon and on the right click Icons menu select Format disk, then follow the instructions and format the partition.
Besides the usual Workbench Tools, Utilities and System Programs, we also included all necessary and useful PiStorm utilities - and also a selection of Programs that will help you with the PiStorm and Emu68 startup.
Both are placed in the same named folders on the Workbench: partition.
The included tools will enable you to monitor the status of Emu68, adjust all possible settings, start/stop and configure WiFi and more.
An essential utility to control everything Emu68 related. You can adjust how JIT performs, set Debug options and see some of the properties like core temperature.
Lets you tweak the RTG graphics output with filtering options. When RTG modes are active, they will be scaled to the resolution you set in the imager tool’s display settings. This means that a lower resolution will be scaled up to match. Use this tool if the bilinear filtering bothers you, or you need to sharpen the filter a touch.
If you want the settings to be used next time you boot, you must edit the Devs/Monitors/Videocore icon tooltypes accordingly.
If you correctly set up your WiFi SSID and Password in the imager tool, you can now double click on Online icon and your Amiga should immediately attempt to connect to your Wifi-enabled router.
The installation includes a demo version of Roadshow TCP/IP stack which will grant you a trial of up to 15 minutes online activity after which you will need to reset your Amiga.
Double-clicking the Offline icon will stop the TCP/IP stack and you will disconnect your Amiga from your Wifi.
Due to limitations in the demo version of Roadshow you may need to reboot your Amiga to go back online. We encourage you to consider buying the full version of Roadshow which does not have these limitations.
If you didn’t setup the WiFi SSID and Password before (or you want to change it) then you can use the WiFi Config icon which will allow you to edit the wifipi.device configuration file.
These two utilities will display the status of Emu68 and provide information on the model of Raspberry Pi used.
The SMB Config icon will bring up the included text editor with the configuration file for the included Samba driver. You can enter the connection string to your Samba share at the end of the file.
When you elect to mount the Samba share, you should navigate to the SYS:Storage/DOSDrivers folder and double click the SMB0 icon - or you can use the MountSMB button in Directory Opus (right clicking on the same button will allow you to unmount the Samba share volume).
If you wish to use WHDLoad Games and/or Demos then the appropriate kickstart ROM files must be present in the Devs:Kickstarts drawers.
We have provided this script in order to make it easier for you to copy the correct kickstart files automatically to that location from the FAT32 partition.
For this script to function, you must copy all your kickstart rom files into the folder named Kickstarts on your FAT32 partition. After you boot your Amiga, double-click on the TransferKick icon and the script will check for all suitable kickstart rom files and copy them to Devs:Kickstarts for you.
This script can install custom packages that you have in the Fat32 partition’s Install folder.
In the future we will make available packages that you can install for free. Just copy the Package (a simple .lha file) into the Install folder, boot your Amiga and double click the InstallPackages icon.
Please refer to the Additional Packages section of the documentation for further information.
This will launch IBrowse with the documentation saved on the SD card (you don’t have to be online to view it). Full documentation is available on your Amiga.
In addition to PiStorm tools we have also included a few essential/useful programs to complement your chosen AmigaOS.
Roadshow TCP/IP stack is included because it is the only TCP/IP stack that is still maintained for Amiga. It is a commercial product but we were graciously allowed to distribute the demo version with the tool. It is restricted to 15 minutes of online time, after which a reboot is required to connect again.
Please consider buying the unrestricted version from the author. More info in Programs Used by the Tool
This is one of the more commonly used file management tools on the Amiga. It is the pinnacle of the double-panel browser genre and no Amiga installation should be without it. We have also provided additional functionality (such as archive extraction) so it is all set up and good to go.
The demo version of the web browser for Amiga. This tool is essential, and if you use it regularly you are encouraged to buy the full version. Documentation for the installation - both the Imager tool and the AmigaOS portions - uses IBrowse for display. Ibrowse will facilitate browsing all of the Amiga related sites such as Aminet, EAB et al.
A Utility that lets you see what files and resources your AmigaOS is utilising and attempting to access. Essential to debug problems and find out what your system is missing.
An essential module (and much more) player that is still being developed. The latest version will be installed for your convenience.
The most commonly used program to display how fast your Amiga is and what is inside.
Once online, this tool will test how fast your transfer rate is.
A free and feature-rich Editor. This is especially needed when running AmigaOS 3.1 as it lacks a decent text editor by default.
These are pre-installed for your convenience and are essential for smooth operation of a PiStorm-enabled Workbench experience.
Please refer to What’s Included section to see where the tool downloads these programs and their documentation.