Software Update

Piper Software Update Guide

There are two ways to get the latest version of Piper software onto your Piper Computer Kit: 1) update your software "over the air" directly from your Raspberry Pi, and 2) download the update on another computer then copy it onto the SD card that came with your Raspberry Pi. The option that will work best for you depends on the software version you are currently using. Before continuing with this guide, turn on your Piper Computer, open the settings screen, and note the number in the bottom left corner of the screen.

Option button highlighted

Settings screen buttons

 

If your version is lower than 2.3 (e.g. 2.2.0 or 2.0.2), the easiest way for you to get up to date would be by downloading the update on another computer. However, that method requires your other computer to be able to read micro SD cards. If that is not the case, please continue reading for instruction on how to update over the air from your version.

Please note: over-the-air update from versions lower than 2.3 is only supported on 16BG SD cards, so if your version is lower than 2.3 and you have a 8GB SD card, over-the-air update will not work and you will have to manually download the update or contact support for a replacement SD card.

For all over-the-air updates, you must first make sure your Piper Computer Kit is connected to the internet. The WiFi menu can be accessed from the main menu, and will display a list of available networks to connect to. See below for screenshots showing where to find the WiFi button in your version.

 

How to update over-the-air update from...
...v2.0.2
...v2.2.0
...v2.2.1
...v2.3.4

 

v2.0.2

v2.0.2 Wifi menu button
WiFi button in 2.0.2

Once the Piper kit is connected to the internet there should be a prompt to update. If this appears, click “Ok” to start the update. If the update message does not appear, click the update button at the top left of the main menu.

The update should take 5-10 minutes. If a message appears saying the Piper kit is already up to date, make sure the Piper kit is connected to the internet and then restart the kit.

v2.0.2 update message
Update message in 2.0.2

Once this update is complete, the piper application will restart and will have been updated to version 2.2.1. To finish updating to the latest software, proceed to the section of this guide for version 2.2.1.

 

v2.2.0

v2.2.0 wifi button
WiFi button in 2.2.0

Once the Piper kit is connected to the internet there should be a prompt to update. If this appears, click “Ok” to start the update. If the update message does not appear, click the update button at the top left of the main menu.

The update should take 5-10 minutes. If a message appears saying the Piper kit is already up to date, make sure the Piper kit is connected to the internet and then restart the kit.

v2.2.0 update message
Update message in 2.2.0

Once this update is complete, the piper application will restart and will have been updated to version 2.2.1.  To finish updating to the latest software, proceed to the section of this guide for version 2.2.1.

 

v2.2.1

IMPORTANT: Completing the update to the latest Piper software requires an upgrade of the operating system of the Raspberry Pi. This update takes between one and two hours depending on internet speed, and may render the SD card unusable if an error occurs. In addition, this process requires free disk space and is only recommended for 16GB SD cards. Please visit https://support.playpiper.com for support if there are any issues with the update process.

Before starting this operating system update, please make sure the battery is fully charged and the Piper kit can be left uninterrupted with an internet connection for up to two hours.

On startup of the Piper software, an update prompt should appear. Pressing “Ok” will open a warning box with instructions about the upgrade.

OS upgrade warning
Warning message in 2.2.1

If you are prepared to begin the operating system upgrade, press the “Ok” button on the warning message. This will open an upgrade progress bar which will give an estimate on the percentage completion of the upgrade.

OS upgrade progress bar
Update progress screen in 2.2.1

If the upgrade takes significantly longer than two hours or if the progress bar seems to reset or get stuck at a given percentage, there was likely an error in the upgrade process. Try unplugging the Raspberry Pi, waiting at least 10 seconds, plugging the Raspberry Pi back in and restarting the upgrade process.

Once the upgrade is complete your Piper kit will restart, and when the Piper software launches you will be prompted to finish the update by installing the latest software version. If you need to recharge your battery, press the “Shutdown” button to shut down the Raspberry Pi. Once your battery is fully charged, you can safely continue your update by rebooting your Pi.

Continue update message

Once this final update is finished, your Raspberry Pi will reboot once more. On the next startup, check the version number and make sure it starts with “2.4”. Congratulations, you are now up to date with the latest Piper software!

There may be a slight delay when pressing the “Play” button on the main menu for the first time after updating, but this will only happen once. If you encounter any issues with the update process, please visit https://support.playpiper.com for support.

 

v2.3.4

First, ensure the Piper kit is connected to the internet. The WiFi menu can be accessed from the main menu; this will display a list of available networks to connect to. Once the Piper kit is connected to the internet there should be a prompt to update, if this appears click the “Ok” button to start the update. If the update message does not appear, click the update button at the top left of the main menu, it should take 5-10 minutes. If a message appears saying the Piper kit is already up to date, make sure the Piper kit is connected to the internet and then restart the kit.

2.4 update message

Once this final update is finished, your Raspberry Pi will reboot once more. On the next startup, check the version number and make sure it starts with “2.4”. Congratulations, you are now up to date with the latest Piper software!

If you encounter any issues with the update process, please visit https://support.playpiper.com for support.

 

Download and Install Piper SD Card Image

If you encounter issues with the over-the-air update process, are on a very old version of Piper software, or are using an 8GB SD card, follow these instructions to download the latest Piper SD card image and manually update your card.

Please note that to update your card, the computer you use to download the image will need to be capable of reading micro SD cards. If that is not the case, please contact support for a replacement SD card.

  1. Download the latest Piper SD card image
    Image for 8 GB SD cards
    Image for 16 GB or larger SD cards
  2. Follow the instructions on the Raspberry Pi website under "Writing an image to the SD card"

ATTENTION: The first time you boot your Piper kit with your newly-updated card, it will reboot several times before finally launching the Piper software. You might see some unfamiliar things happen during the reboots, but don't worry, that's just your kit getting everything setup to work with your new software!

In some rare cases, the Piper intro video ends on a black screen which doesn't automatically get dismissed. If this happens to you, simply click your mouse button to proceed to the main menu.