Sys Commands #

Use the sys commands to query status, adjust settings, and perform maintenance operations.


Commands	Description
sys crashlog	Get crash log for firmware debugging.
sys drivermode	Set driver mode on Windows.
sys nickname	Set or show nickname.
sys reset sys	Reset the adapter.
sys restore	Restore all configurations to factory defaults.
sys scratch	Read or write to the scratchpad.
sys ver	Show the version of the bootloader and the application.
sys visual	Rapidly blink the red and green LEDs of the status indicator LED.
sys voltage	Show VMCU, 5V, 3V3 and VTarget voltage.

sys crashlog#

Gets crash log for firmware debugging.

Command Line Syntax

$ sys crashlog$ sys crashlog

Command Line Example

$ sys crashlog
0x00 : 0xACCABAAC
0x01 : 0xAAAAAA00
0x02 : 0x00000003
0x03 : 0x00000000
0x04 : 0x00000007
0x05 : 0x01FE0000
0x06 : 0x00000002
0x07 : 0x00000000
0x08 : 0x1170003F
0x09 : 0x00000020
0x0A : 0x00000002
0x0B : 0x00000000
0x0C : 0xF818101F
0x0D : 0x00000000
0x0E : 0x00000003
0x0F : 0x00000000
0x10 : 0x00000000
0x11 : 0x00000000
0x12 : 0xAAAAAA01
0x13 : 0x00000082
0x14 : 0x00000000
0x15 : 0x0814CB54
0x16 : 0x2400AE00
0x17 : 0x0813368B
0x18 : 0xDEADDEAD
0x19 : 0xDEADDEAD
0x1A : 0xDEADDEAD
0x1B : 0xDEADDEAD
0x1C : 0xDEADDEAD
0x1D : 0xDEADDEAD
0x1E : 0xDEADDEAD
0x1F : 0x00000000$ sys crashlog
0x00 : 0xACCABAAC
0x01 : 0xAAAAAA00
0x02 : 0x00000003
0x03 : 0x00000000
0x04 : 0x00000007
0x05 : 0x01FE0000
0x06 : 0x00000002
0x07 : 0x00000000
0x08 : 0x1170003F
0x09 : 0x00000020
0x0A : 0x00000002
0x0B : 0x00000000
0x0C : 0xF818101F
0x0D : 0x00000000
0x0E : 0x00000003
0x0F : 0x00000000
0x10 : 0x00000000
0x11 : 0x00000000
0x12 : 0xAAAAAA01
0x13 : 0x00000082
0x14 : 0x00000000
0x15 : 0x0814CB54
0x16 : 0x2400AE00
0x17 : 0x0813368B
0x18 : 0xDEADDEAD
0x19 : 0xDEADDEAD
0x1A : 0xDEADDEAD
0x1B : 0xDEADDEAD
0x1C : 0xDEADDEAD
0x1D : 0xDEADDEAD
0x1E : 0xDEADDEAD
0x1F : 0x00000000

sys drivermode#

Sets the driver mode on Windows OSes. Without arguments, the command shows the current driver mode status. Possible options are winusb to select the WinUSB driver and segger to select the SEGGER legacy kernel drivers.

Note: While otherwise transparent on all OSes, WinUSB mode affects the product ID of the adapter. When enabled, it allows operation of the adapter without installation of SEGGER legacy kernel drivers on Windows 8 and later. On Windows 7, WinUSB drivers can be installed manually.

Command Line Syntax

$ sys drivermode [winusb|segger] $ sys drivermode [winusb|segger]

Command Line Examples

$ sys drivermode
Driver mode is set to WinUSB

$ sys drivermode segger
Driver mode is set to SEGGER$ sys drivermode
Driver mode is set to WinUSB

$ sys drivermode segger
Driver mode is set to SEGGER

sys nickname#

Sets or shows nickname. Write nickname in quotes to set an arbitrary string. The maximum length of the nickname is 31 characters.

Command Line Syntax

$ sys nickname [nickname]$ sys nickname [nickname]

Command Line Examples

$ sys nickname "Example nickname"
Nickname: Example nickname

$ sys nickname
Nickname: Example nickname$ sys nickname "Example nickname"
Nickname: Example nickname

$ sys nickname
Nickname: Example nickname

sys reset sys#

Resets the adapter by using NVIC SysReset.

No output is shown because the adapter resets immediately.

Command Line Syntax

$ sys reset sys$ sys reset sys

Command Line Example

$ sys reset sys$ sys reset sys

sys restore#

Restores all persistent configurations to factory defaults. The adapter must be restarted after the command has been executed for all changes to take effect.

Command Line Syntax

$ sys restore$ sys restore

Command Line Example

$ sys restore
Restoring all configuration to factory defaults...
Configuration restored. Please restart the board for all changes to take effect.$ sys restore
Restoring all configuration to factory defaults...
Configuration restored. Please restart the board for all changes to take effect.

sys scratch#

Reads from or writes to the scratchpad.

When sending the sys scratch write command, the CLI starts accepting input. The CLI will stay in this input mode until an empty line has been sent. For every 125 characters that are received without line endings, CRLF line endings will be inserted. The input is parsed and any line endings will be preserved, as long as each line sent is less than 125 characters long.

Command Line Syntax

$ sys scratch <read/write>$ sys scratch <read/write>

Command Line Examples

$ sys scratch write
######## Write ########
First line
Second line
Last line

sys scratch read
######## Read [36] ########
First line
Second line
Last line$ sys scratch write
######## Write ########
First line
Second line
Last line

sys scratch read
######## Read [36] ########
First line
Second line
Last line

sys ver#

Shows the version of the bootloader(s) and the application.

Command Line Syntax

$ sys ver$ sys ver

Command Line Example

$ sys ver
FSBL: 1.0.0.32
SSBL: 0.12.2.49
Application: 1.6.1.373$ sys ver
FSBL: 1.0.0.32
SSBL: 0.12.2.49
Application: 1.6.1.373

sys visual#

Rapidly blinks the red and green LEDs of the status indicator LED. If an indication time is not supplied, the LEDs blink for 10 seconds.

Command Line Syntax

$ sys visual [indicationTime]$ sys visual [indicationTime]

Command Line Example

$ sys visual
Activating LED indication for 10 seconds$ sys visual
Activating LED indication for 10 seconds

sys voltage#

Shows VMCU, 5V, 3V3 and VTarget voltage. If one or more rails are not supported, the voltage will be replaced with the string 'Not supported'.

Command Line Syntax

$ sys voltage$ sys voltage

Command Line Example

$ sys voltage
VMCU    : 3.28 V
5V      : 4.70 V
VTarget : 3.28 V
3V3     : 3.34 V$ sys voltage
VMCU    : 3.28 V
5V      : 4.70 V
VTarget : 3.28 V
3V3     : 3.34 V