Preliminary
...the world's most energy friendly microcontrollers
2010-04-09 - t0005_1.10
36
www.energymicro.com
15 Gecko Commander and Upgrades
Gecko Commander is a command line utility that comes with the Gecko DK Installer package. It can
perform various kit and EFM32 specific tasks. Press "h" for help at the prompt for a listing of available
commands. Press "h command" for help for a specific command, listing arguments and options.
15.1 Available commands
Table 15.1. Gecko Commander
Command
Description
ping
"Ping" kit, i.e. verify that target kit is up and running
speed
Sets the link speed for the serial wire debug interface from the kit, towards the EFM32
reset
Reset kit, which also implies a reset of the EFM32 as well
usb
Change J-Link USB port used, default is port 0. Unless you have multiple J-Link debuggers there
should be no reason to change this
version
Get PCB and firmware versions of kit
install
Install an application or boot package. This command, with a filename ending with .emz as an option
upgrades the kit software
ls
List directory, shows which binary files has been uploaded to the kit, which can be flashed with the GUI
put
Copy a binary file from host to target, that can be used to flash directly from the kit GUI (Flash
submenu)
rm
Remove file
flash
Flashes the EFM32 program memory with binary file, starting from flash address 0x0000000. Enter
filename as argument.
verify
Verifies correct installation of a binary into flash
dumpbin
Dumps content of memory of the EFM32 to file
erase
Erases the entire flash
unlock
Unlocks a locked chip and performs a device erase
lock
Locks the chip, prevents reading out the flash over debugger interface
protect
Write-protects pages in flash
uprotect
Clears all write protection lock bits
power
Dump power measurements from the running application to file. Enter filename as argument.
mode
Sets the mode of the on-board debugger. Available modes:
mcu - Debug the EFM32 using the on-board debugger
in - Debug the EFM32 using an external debugger
out - Use the STK as an external debugger
off - Disable the debugger
15.2 Upgrades
Upgrading the kit can be done by using the "Upgrade Kit" script in the start menu. New versions can
be downloaded from http://www.energymicro.com/downloads/. The script will use Gecko commander to
install the latest available Kit SW package. It is important to upgrade the kit when installing a new SW
package, as new Gecko commander functionality might require kit controller software upgrades.
electronic components distributor