How to manually update firmware on Airtame 1

Key Facts

• Manually flashing the SD card can only be done for Airtame 1.

• You will need a Micro SD card reader.

• You don't need to format the Micro SD card.

• You will need additional software to flash firmware manually.

Micro SD Card requirements

You can re-use the SD card already in Airtame. Should the SD card be corrupt then please follow the instructions a the bottom of this article.

• Size: recommended is 8 GBs. Can work with 4 GB cards.

• Speed Class: At least Class 4 (C4) or greater 

• Bus interface: UHS Class 1

How to manually flash the SD card

Airtame can be manually updated by

• Remove the SD card from the device
• Plug the SD card into your computer

Here is a video on how to do so:

Using Windows

1. Download the newest firmware image.

2. Use 7zip to extract the “airtame-fw-vX.X.X.tar.gz” file first. Do this by first installing 7-zip, then right-click on the “airtame-fw-vX.X.X.tar.gz” and select Extract Here.

3. Then use 7-zip again to extract the “airtame-fw-vX.X.X.tar” file, to get a .img file, which should be the final file installed on the microSD card.

4. Using your Micro SD card reader plug the SD card into your computer, a window will pop up, and click the Cancel button.

   1. There is no need to format the current SD card, so you can ignore any warning asking you to format it.

5. Download balenaEtcher, the program used to flash the Micro SD Card.
6. Open the Etcher installer and run the installer. 
7. Once the program is installed, open the program called balenaEtcher.
8. You will see this window popup, click on Select Image.

8. Navigate to the file location where you downloaded the file “airtame-fw-vX.X.X.tar.gz” and extracted its contents. Open the out folder, and select the “airtame-fw-vX.X.X.img” file.

9. By default if you do not have any other microSD cards plugged into your computer/laptop it will automatically select the microSD card for the Airtame 1 device.

10. Click on Flash! to flash the SD Card. You will be prompted to enter your username and password.

11. You will see the progress of the flash on the right-hand side.

12. When the flash is done you will see this screen:

Using macOS

1. Download the newest firmware image.

2. Double click on the file “airtame-fw-vX.X.X.tar.gz”, it will be extracted by using MacOS’s built-in unarchive program called “The Unarchiver”. Double-click again on the “airtame-fw-vX.X.X.tar” file, to extract a .img file, which should be the final file installed on the microSD card.

3. Using your Micro SD card reader plug the SD card into your computer, and a window will pop up, click the "Ignore" button. 

*There is no need to format the current SD card, ignore this warning*

4. Then download balenaEtcher, the program used to flash the microSD Card. Double-click on the icon named balenaEtcher.

5. A window will pop up, click on open, to open the application.

6. You will see this window popup, click on “Select Image”.

7. Navigate to the file location where you downloaded the file “airtame-fw-vX.X.X.tar.gz” and extracted its contents. Open the out folder, and select the “airtame-fw-vX.X.X.img” file.

8. By default if you do not have any other removable media plugged into your computer/laptop it will automatically select the microSD card for the Airtame 1 device.

9. Click on Flash! to flash the SD Card. You will be prompted to enter your user credentials.

10. You will see the progress of the flash on the right side.

11. When the flash is done you will see this screen:

In case of a corrupted microSD card

The most time-efficient way would be to obtain a new microSD card. Here are the microSD card requirements:

• Size: At least 8 GB or larger

• Speed Class: At least Class 4 (C4) or greater 

• Bus interface: UHS Class 1

Please note that the new microSD card would still have to be flashed to make sure that it has firmware for the device to run on. 

If you come across any problems with the above process or a corrupted SD Card please send your request to support@airtame.com