Upgrade the Firmware

Tone2 Pro - XMOS & MCU Firmware Upgrade

Tone1 - Upgrade to Official Khadas Firmware v2.00

Tone1 - Upgrade to Official Khadas Firmware v2.00

Link: Khadas Blog

Tone1 - Upgrade to Official Khadas Firmware via legacy methods

Preparation:

  • Download the USB Upgrade Tool and extract it.
  • Download the firmware .bin files from this directory and extract them.
  • Connect your Tone to your PC using a USB-C data cable.

Tone With USB-C Cable

Installation:

  • Run setup_eval.exe to install the tool to upgrade your Tone’s firmware.

Tone USB Upgrade Tool Installation

  • Press Yes, then disconnect and reconnect your Tone.

Disconnect and Reconnect Tone

Upgrading:

  • Open the TUSBAudio Firmware Upgrade tool, from your Start Menu.

TUSBAudio Firmware Upgrade Tool

  • It should show Device Opened, which means your Tone is connected and ready for upgrading. (If not, disconnect and reconnect your Tone)

Tone Ready For Upgrade

  • Click Browse and load the firmware .bin file you extracted, into the tool.

Tone USB Upgrade Tool Browse For .img

  • Click Start to begin the upgrade process.

Tone USB Upgrade Tool Click Start

  • Once firmware has upgraded, click Exit.

Tone USB Upgrade Tool Finished And Exit

  • Uninstall the EVAL driver that you used for upgrading firmware, and re-install the v224 driver.

  • Alternatively, if you’re on Windows 10, uninstall all Khadas-supplied drivers and use the native Win10 UAC2 driver supplied with the OS.

Preparation:

1
2
$ sudo apt-get update
$ sudo apt-get install git libusb-1.0-0 libusb-1.0-0-dev

Download Burning Tool:

Tone DFU burning tool on Ubuntu is in utils repository.

1
$ git clone https://github.com/khadas/utils

Or just pull it (if you have already cloned this repository).

1
2
$ cd /path/to/utils
$ git pull

Install Burning Tool:
You need to install USB rules and create some links.

1
2
$ cd /path/to/utils/tone-dfu-tool
$ sudo ./INSTALL

You will see this print-out if it was successful.

1
2
3
4
5
6
7
8
9
10
11
[sudo] password for nick: 

===============================================

Host PC: Ubuntu 20.04

===============================================

Installing USB rules...
Installing tone-burn-tool...
Done!
Note

Root privilege required.

Upgrading:

  • Download the firmware files from this directory and extract them to somewhere like your Home folder.

  • Open a Terminal window, and cd into your Home folder.

1
$ cd /home/*
  • Run the tool with your firmware file of choice (drag and drop your .bin file to replace /path/to/firmware.bin).
1
$ sudo tone-burn-tool -i /path/to/firmware.bin
Note

Upgrading will stuck at Waiting for device to restart and enter DFU mode for about 20 seconds, please wait patiently.

  • If upgrading was done successfully, you should see:
1
2
3
4
5
6
7
8
9
Upgrading Tone firmware...
Khadas Tone1 detected!
Tone DFU application started - Interface 2 claimed
Detaching device from application mode.
Waiting for device to restart and enter DFU mode...
... DFU firmware upgrade device opened
... Downloading image (Tone1_Firmware_V2.00_201016.bin) to device
... Download complete
... Returning device to application mode

Uninstall Burning Tool:

1
2
$ cd /path/to/utils/tone-dfu-tool
$ sudo ./UNINSTALL

Preparation:

Download the ready to use dfu tool to somewhere like:~/Desktop

1
2
$ wget https://dl.khadas.com/products/tone2/dfu_tool/tone_dfu_tool_macos
$ chmod +x ./tone_dfu_tool_macos

Upgrading:

  • Download a firmware file from https://dl.khadas.com/Firmware/ToneBoard/, then extract the .zip file.
  • Connect your Tone to your Macbook / iMac via a USB-C data cable.
  • Return to Terminal and type ./tone_dfu_tool --download, followed by space, and drag the firmware.bin you just downloaded, from the Finder into Terminal. Then hit Enter.
  • If successful, you should see the following Terminal output:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    $ ./tone_dfu_tool --download /path/to/Tone2_Pro_DFU_TEST201228_nothing.bin 
    VID = 0x3353, PID = 0xa002
    Khadas Tone2 Pro detected!
    Tone DFU application started - Interface 2 claimed
    Detaching device from application mode.
    Waiting for device to restart and enter DFU mode...
    VID = 0x3353, PID = 0xa002
    ... DFU firmware upgrade device opened
    ... Downloading image (/path/to/Tone2_Pro_DFU_TEST201228_nothing.bin) to device
    ... Download complete
    ... Returning device to application mode
Note
  • If you get the following output when attempting to upgrade the firmware on Mac OS:
    1
    2
    3
    4
    5
    ./tone_dfu_tool --download /path/to/Tone2_Pro_DFU_TEST201228_nothing.bin
    dyld: Library not loaded: /usr/local/lib/libusb-1.0.0.dylib
      Referenced from: /Users/username/Downloads/USB-Audio-2.0-Software-v6.1-master/sc_usb_audio/module_dfu/host/xmos_dfu_osx/./xmosdfu
      Reason: image not found
    Abort trap: 6
  • It means you need to upgrade libusb. You can do this by typing brew install libusb.
  • If typing brew install libusb didn’t work, it means that you need to install HomeBrew.
  • If HomeBrew fails, you need to install Xcode Command Line Tools, type xcode-select --install into Terminal.

See Also: