Kit Utility Commands#

Firmware Upgrade#

Updates the application running on the board controller on the kit to a new version provided in an .emz file by Silicon Labs.

Command Line Syntax

$ commander adapter fwupgrade --serialno <J-Link serial number> <filename>

Command Line Input Example

$ commander adapter fwupgrade -s 440050184 S1015B_wireless_stk_firmware_package_0v14p0b435.emz

Command Line Usage Output

Checking manifest...
Checking if target is in bootloader...
Waiting for kit to restart...
Package is usable
Deleting previous firmware...
Installing files...
Resetting target...
Waiting for kit to restart...
Finished!
DONE

Kit Information Probe#

Retrieves information about a connected kit. Lists information about the kit part number and name, connected boards, and firmware version.

The options --kit, --boards, and --firmware limit the output to just kit information, board list, or firmware information, respectively.

The VCOM Port line informs which virtual COM port name the kit has been assigned by the operating system. On Windows this is on the form COM<number>. On Linux and macOS, the name corresponds to a special file in the /dev/ folder. E.g. VCOM Port: ttyACM0 indicates that the serial port is available at /dev/ttyACM0. This line is not always available, and may be omitted from the output.

The nickname, IP address and MAC address of the adapter may be omitted from the output if the information is not available to Simplicity Commander.

Command Line Syntax

$ commander adapter probe --serialno <J-Link serial number> [--kit] [--boards] [--firmware]

Command Line Input Example

$ commander adapter probe --serialno 440050184

Command Line Usage Output

Kit Information:
=======================================
Kit Name        : EFR32 Mighty Gecko 2400/915 MHz Dual Band Wireless Starter Kit
Kit Part Number : WSTK6002A Rev. A00
J-Link Serial   : 440050184
Debug Mode      : MCU
AEM Supported   : 1
VCOM Supported  : 1
IP Supported    : 1
VCOM Port       : COM3
Nickname        : Lab-01
IP Address      : 10.5.103.23
MAC Address     : D0:CF:5E:C0:FF:EE
Firmware Information:
=======================================
FW Version      : 0v14p0b435
Board List:
=======================================
Name            : Wireless Starter Kit Mainboard
Part Number     : BRD4001A Rev. A01
Serial Number   : 152607557
Name            : EFR32MG 2400/915 MHz 19.5 dBm Dual Band Radio Board
Part Number     : BRD4150B Rev. B00
Serial Number   : 151300035
Target Device	: EFR32MG1P233F256GM48-C0
DONE

Adapter Reset Command#

This command resets the adapter itself, causing a restart. The adapter reset command is usually not required during normal operation.

An error about "Communication timed out" may occur because the adapter sometimes restarts before it has time to reply to the command.

Command Line Syntax

$ commander adapter reset

Command Line Input Example

$ commander adapter reset

Command Line Output Example

Communication timed out: Requested 76 bytes, received 0 bytes !
DONE

Adapter Debug Mode Command#

This command sets or reads the current debug mode of the adapter. The supported debug modes are typically IN, OUT, MCU, and OFF in addition to MINI for Wireless Pro Kits and TARGET for Development Kits. See the Quick Start Guide for your kit for a description of the debug modes it supports.

Command Line Syntax

$ commander adapter dbgmode [mode]

Command Line Input Example

$ commander adapter dbgmode MCU

Command Line Output Example

Setting debug mode to MCU...
DONE

List Adapter IP Configuration Command#

The adapter ip command gets or sets the IP configuration of the adapter. With no options, the current configuration is retrieved and displayed.

Command Line Syntax

$ commander adapter ip

Command Line Input Example

$ commander adapter ip

Command Line Output Example

IP Address: 192.168.0.5/24
Gateway   : 192.168.0.1
DNS Server: 192.168.0.1
DONE

Adapter DHCP Command#

This command sets up the adapter to use DHCP to automatically retrieve IP, gateway and DNS addresses. This is the default con-figuration. After enabling DHCP, the adapter must be restarted for the change to take effect.

Command Line Syntax

$ commander adapter ip --dhcp

Command Line Input Example

$ commander adapter ip --dhcp

Command Line Output Example

Enabling DHCP. The adapter must be restarted to acquire a new IP address.
DONE

Set Static IP Configuration Command#

This command sets the IP address of the adapter in Classless Inter-Domain (CIDR) notation.

Command Line Syntax

$ commander adapter ip --addr <IP address/prefix> [--gw <gateway address>] [--dns <dns server address>]

Command Line Input Example

$ commander adapter ip --addr 192.168.1.5/24 --gw 192.168.1.1 --dns 192.168.1.1

Command Line Output Example

Setting IP Address: 192.168.1.5/24
Setting gateway: 192.168.1.1
Setting DNS server: 192.168.1.1
DONE

Get or Change Adapter Nickname#

You can get, set and clear the adapter's nickname using the adapter nick command.

If no new nickname is provided, the adapter's current nickname will be displayed.

If you provide a new nickname, this will be stored in the adapter.

Providing the --clear option will clear the adapter's stored nickname.

Command Line Syntax

$ commander adapter nick [nickname] [--clear]

Command Line Input Example

$ commander adapter nick "Hardware Lab"

This command line sets the adapter nickname to "Hardware Lab".

Command Line Output Example

Nickname set to "Hardware Lab"
DONE

Get or Change Target Voltage#

You can get and set the voltage that the adapter supplies to the target device using the adapter voltage command.

If no voltage is provided, the currently configured voltage and the measured voltage will be displayed.

If a voltage is provided, the voltage will be set. This setting does not persist across adapter reboots. After the voltage has been changed, the Advanced Energy Monitor (AEM) will automatically calibrate itself (see Calibrate the Advanced Energy Monitor for more details). Providing the option --nocalibrate will skip the automatic calibration.

Note: Changing the target voltage is not supported on all adapter boards.

Command Line Syntax

$ commander adapter voltage [voltage] [--nocalibrate]

Command Line Input Example

$ commander adapter voltage 3.3

This command line sets the target voltage to 3.3 V, allowing for the AEM to calibrate itself after the new voltage has been set.

Command Line Output Example

Voltage set to     : 3.3 V
Configured voltage : 3.3 V
AEM should be calibrated due to a change in target voltage.
Calibrating AEM due to a change in target voltage since last calibration (target power is off during calibration).
Successfully calibrated AEM.
DONE

Get or Change Target Power#

You can get and set the power state of the target device using the adapter power command.

If no argument is provided, the current target power state will be displayed.

If 'on' or 'off' is provided, the target power will be enabled or disabled, respectively. This setting does not persist across adapter reboots.

Note: Controlling target power is not supported on all adapter boards.

Command Line Syntax

$ commander adapter power [on|off]

Command Line Input Example

$ commander adapter power off

This command line takes the RPS image 'app.rps' and loads it onto the device.

Command Line Output Example

Target power turned off
DONE