Preparing your device

Overview

This guide is for users that already have a supported Raspberry or Orange PI and would like to load SolarAssistant on it. If you purchased a device with software you can skip this article and continue with the WiFi or ETH cable setup steps.

Step 1 - Download SD card image

You can download the SD card image on the sites page. It will require registration if you aren't already registered.

Download SolarAssistant

Step 2 - Install SD card writing tool

Download and install the latest Raspberry PI imager:

Download RPI Imager WindowsDownload Raspberry PI Imager for Windows
Download RPI Imager AppleDownload Raspberry PI Imager for macOS
Download RPI Imager UbuntuDownload Raspberry PI Imager for Ubuntu

Step 3 - Flash SD card

Start the Raspberry PI imager and select your Pi device type.

Using Raspberry PI Imager to flash SolarAssistant to SD card

For the next step, scroll to the bottom of the image list and select "Use custom". This will prompt you to navigate to and select the image downloaded in step 1 as shown below.

Using balenaEtcher to flash SolarAssistant to SD card

NB: Do not flash the downloaded ZIP file. Extract it and flash the ".img" file inside it as shown below.

Select .img file

Then, you will need to select the storage device you would like to flash the image onto.

Select storage device

Tip: You can select an SSD instead of an SD card if you prefer to run SolarAssistant from an SSD.

Lastly, you will need to click "write" to start the flashing process. You will then have to accept that the SD card will be erased and all data will be lost.

Select storage deviceSelect storage device

Step 4 - Start monitoring device

Insert the SD card in the Pi and turn it on. You should see a WiFi hotspot named SolarAssistant appear, unless you have an ETH cable plugged in. Continue with one of the guides below:

Troubleshooting

If you find the device is not booting, or it only shows a solid red LED when booting but after the flash, it is more than likely a "bad" flash. You may have to repeat the process again, just make sure that you are selecting the ".img" file and not the ".zip" file you downloaded. You will need to unzip that file before doing the flash. If that does not help, you may consider redownloading the image and trying again.

Otherwise, if you are having issues with RPi Imager, you can also flash the SD card using Balena Etcher. You can read more about that process via our Balena Etcher Guide. Balena Etcher is also the better option if you are flashing multiple SD cards at once.