If you purchased your SD card in the last year, you might be experiencing issues with updates. Rest assured, we're working on fixing this, but until then, we recommend you manually update our software or request a replacement SD card using this form > 

Step 1: Find your Version

Step 2: Choose how to update

Step 3: Update

Auto

Manual

ORDER/REQUEST YOUR REPLACEMENT

HOW TO UPDATE YOUR PIPER SOFTWARE

STEP 1: FIGURE OUT WHAT VERSION OF PIPER SOFTWARE YOU HAVE

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 microSD 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.

How do I get to settings? (Check out the RED boxes)

Instructions to Update Your SD Card

Where does it say my version?

Instructions to Update Your SD Card

STEP 2: CHOOSE YOUR UPDATE METHOD (OVER-THE-AIR OR MANUAL)

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 microSD cards. Here are some links for microSD reader or adapters:

If that is not the case, please continue reading for instructions 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 16 GB microSD cards, so if your version is lower than 2.3 and you have a 8 GB microSD card, over-the-air update will not work and you will have to manually download the update or email hi@playpiper.com for a replacement microSD card.

Piper runs off a microSD CARD. To manually update, you need a microSD card reader.

You might have an SD card slot in your computer, but to use that, you will require an adapter. Otherwise, snag a microSD reader that plugs into the USB port!

Instructions to Update Your SD Card

STEP 3: START YOUR UPDATE TO GET TO V2.7.0

UPDATE OVER THE AIR (USING WIFI FROM YOUR PIPER)

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.

Quick Note: Versions before 2.3 need to be updated three times in order to fully update to our newest version 2.7.0.

SELECT YOUR VERSION BELOW TO LEARN HOW TO UPDATE TO v2.7.0

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.

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 email hi@playpiper.com or visit www.PlayPiper.com and use the live chat option 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://playpiper.com/getsupport for support.

v2.3.4-v2.4.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.  

*DISCLAIMER* the loading bar could appear it is 'stuck' at 50%, but rest assured, the update is still occurring. When your Piper is done updating, your display will show some "boot up" messages and will restart.***

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.6”.

Instructions to Update Your SD Card

Congratulations, you are now up to date with the latest Piper software!

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

UPDATE MANUALLY

If you encounter issues with the over-the-air update process, are on a very old version of Piper software, or are using an 8 GB microSD card, follow these instructions to download the latest Piper microSD 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 microSD cards. If that is not the case, please contact support for a replacement microSD card.

 

  1. Download the latest Piper microSD card image

  2. Follow the instructions on the Raspberry Pi website under "Writing an image to the microSD 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.

HOW DO I GET A REPLACEMENT microSD CARD?

If you are having issues with the steps above and would just like to get an updated microSD card shipped to you, we have two options for you:

ORDER A REPLACEMENT

(Recommended) Get a new microSD card which will be shipped to you fully updated and ready to use.

Instructions to Update Your SD Card

Sold out

SEND IN YOUR SD CARD

Go ahead and stick your old 16 GB microSD card in a regular envelope, slap a stamp on there, and drop it on the mail to:

Piper Learning, Inc.

2415 3rd St., Ste. 232,

San Francisco, CA 94941

We'll do the manual update steps on our end and get it back to you (shipping costs may apply).

Note: This method is only recommended for school groups who may have large numbers of SD cards which require updates.

If you got your Piper Computer Kit or Piper Mini within the LAST YEAR, you may have received a card with a faulty updater. We're working on figuring out what went wrong, but in the meantime, we would love to send you a replacement. Fill out this form and we'll ship out a new microSD card FREE OF CHARGE as soon as possible:

Value is required
Value is required
Value is required
We'll check your order and get your replacement shipped out!