Syntax

nRF Util

tags
nRF Util

The command uses the following structure:

nrfutil device mcu-state-set [--target ARG] [--serial-number ARG] [--traits ARG] [--remote-jlink ARG] [--append-batch PATH] [--generate] [--help] <ARG>
Long Short Values Description
--target ARG Target SoC.
--serial-number ARG Select one or more devices based on a comma-separated list of serial numbers: --serial-number SN_1,SN_2,..,SN_n.
--traits ARG Select devices based on a comma-separated list of device traits: --traits TRAIT_1,TRAIT_2,...

The list of device traits is treated as an OR filter. By default, all devices except for devices that only has the usb trait are enumerated and listed.

List of available device traits:
boardController Boardcontroller configuration
broken Indicates a broken device
devkit Device is a Nordic Semiconductor development kit
jlink J-Link probes
mcuBoot Device supports MCUboot
modem Device supports modem
nordicDfu Nordic USB devices with DFU trigger interface
nordicUsb USB devices (with VendorID 0x1915)
seggerUsb Segger USB devices (with VendorID 0x1366)
serialPorts Device has serialports
usb USB devices

nrfutil device uses plugins to enumerate devices and apply device operations. The --traits option activates only the plugins that control the specified traits. Some trait combinations in --traits might therefore make some operations or trait annotations unavailable for devices that should have supported these operations or traits.
--remote-jlink ARG Select one or more remote J-Link probes: --remote-jlink HOST_1[:PORT_1],HOST_2[:PORT_2],..,HOST_n[:PORT_n]

For more information about how to set up a J-Link Remote Server, see https://kb.segger.com/J-Link_Remote_Server.

The connection information passed in this flag is used to connect to the J-Link Remote Server instance, and the remote probe is then treated in the same way as a locally connected device.
--append-batch PATH Append the operation to the given batch file instead of running it

When this option is set, the command records the operation as JSON in the batch file and exits without performing the operation on a device. The generated batch file can then be executed on devices using nrfutil device batch-execute --batch-file <file_path>.

This flag cannot be used in combination with other device selection options, such as --serial-number, --traits, or --remote-jlink.
--generate -g - Show the JSON definition of the operation.
--help -h - Print help (see a summary with '-h')