====== How to update the firmware ======

This howto explains how to update the firmware running on your rad1o from a binary release.

The rad1o firmware consists of these main parts:

  * The bootloader
  * Applications (camp, hackrf, testapp, …)
  * l0dables (snake, schedule, …)
  * Other files (configuration, fonts, graphics)

See [[firmware:releases|firmware:releases]] for the most recent version and a release history.

Alternatively, you can [[howto:build|build the firmware yourself]] and flash the latest version from git

===== Requirements =====

  * A rad1o
  * A computer with a USB-Port
  * A micro USB cable
  * A firmware file

===== Tasks =====

  * turn off the rad1o
  * connect the rad1o (rad1o port A) with a micro-USB cable to the computer
  * push and hold the joystick ''UP'' while you turn on the rad1o. it will now boot in ''MSC'' mode, appearing as a mass storage device (like a USB stick) to the computer
  * [[firmware:releases|Download the latest firmware file]]
  * unpack it and copy all the contained files to the mounted device, overwriting the existing files

  cd /mnt/FE49-AB84
  tar -xzv --strip 1 -f ~/Downloads/rad1o-revXX.tgz
  sync

(The paths will probably be different on your system; For example, the mount point in Debian/Ubuntu/Mint may be in /media/[username]/[device name; e.g. 0FC0-CABC])

(The tar has the firmware files in a subdir, hence the ''--strip 1'' [at least rad1o-rev02.tgz does]; the new firmware files must go to the root of rad1o's file system, or the upgrade won't work.)

(OS X users: If you unpack and copy via the Finder a lot of resource fork files will be generated, so tar is preferred.)
  * wait until the left bottom LED stops flashing
  * unmount the device
  * turn your rad1o off and on again. (If your screen goes dark, try unplugging the USB or setting the chargeled config to 0.)

===== Result =====

Your rad1o should now run the most recently released firmware. You can check the release version of your firmware in the "INFO" menu.

=====  Flash Firmware for recovery =====

Checkout Git F1rmware Repo

cd /f1rmware/smartflash/

Get all components:
  make gather 

Make MSC Update
  make UDISK=sdX msc 

or Make Full Update
  make UPATH=sdX flash