How to: Upload RF Explorer firmware in Linux

RF Explorer device firmware can be upgraded under Linux, starting with firmware version v1.12 Beta 13 and higher. Please do not try to use these instructions with any older firmware. 

The how-to instructions below are tested in Ubuntu 32bits v14.04, but can be easily adapted to any other modern Linux version, including Debian and CentOS. If you find any major differences and get some workaround for a particular Linux distro please let us know so other users can benefit from your experience. 

Background

From a software perspective, the RF Explorer Firmware Uploader tool has been modified to run in Linux under Mono, with proper detection of Linux serial port driver. Mono is a compatibility layer for .NET in Linux, developed by the Xamarin team, and works well with any recent version of Mono.

On the other hand, RF Explorer uses a Silabs CP2102 chip for USB communication. The Uploader will correctly list USB connections that are from a CP2102 device only.

Unfortunately most Mono Linux distributions include a very limited driver for the USB serial port and cannot work at 500Kbps (high speed) so the bootloader is limited to 2400bps (low speed compatibility mode). Therefore the upgrade process is slower in Linux than in Windows due to this driver dependency. A software change and Linux kernel build can resolve this problem, but requires significant Linux expertise. If you are interested in upgrading your Linux for 500kbps support under Mono, contact us. 

Installing Mono

Open a Terminal window and type

mono --version

If the answer is no version installed, then you need to install Mono. The simplest way is by running apt-get from terminal

sudo apt-get install mono-complete

It is important you install mono-complete and not any other limited Mono distributions. The lightweight Mono runtime is not enough, as WinForms dependencies require complete Mono libraries, so please make sure you do a complete install. If you need more details and help on installing Mono, please visit this official link

Below is a quick demo of how this works in an Ubuntu 14 standard distro.

Running the Uploader

Download the firmware file and uploader from our download page link and unpack the contents in a folder.

Due to the baudrate limitation discussed before, the first important step you need to complete is in the RF Explorer device. Power it on and go to the CONFIG MENU, and select USB Bauds: 2.4Kbps as shown below. If you keep this at 500Kbps the firmware uploader will fail to complete last steps.

The next step is to run the Uploader under Mono using this sentence from a Terminal window:

mono RFExplorerFirmwareUpdateLoader.exe

At some point in the process you will be required to connect the RF Explorer device. For that to work in Linux at 2400bps, you must click on <LEFT>+<ENTER>+<RIGHT> buttons while powering the unit ON. If properly started at 2400bps, you will see a bootloader screen with very clear message of baudrate like this one:

If you don't see this but a 500Kbps message, then try again using correct key combination. The communication and firmware upgrade can only work when all the steps are completed using the same baudrate.

Below is a demo of how this works in an Ubuntu 14 standard distro.