Programming external memory command

nRF Util

tags
nRF Util

To program external memory, use the following command pattern:

nrfutil device [--x-ext-mem-config-file <path_to_config_file>] program --firmware <hex_file> --serial-number <serial_number> [--options]

Note

  • The x in the subcommand name means that the command is currently experimental. Its implementation might change in the future.

In this command pattern:

  • [--x-ext-mem-config-file <path_to_config_file>] is used to provide the path to a JSON configuration file that specifies the external memory interface settings; it is optional when you connect to a supported development kit with a default configuration
  • <hex_file> is the HEX file containing the data to be programmed to external memory (the file can also include the firmware for the internal memory, and both will be programmed as part of the same operation)
  • <serial_number> is the serial number of the connected device
  • [--options] are the programming options (erase, verify, reset, or combinations thereof)

For example, the following command programs the firmware from data_going_to_external_flash.hex using the configuration from nrf5340dk_qspi_config.json to a device with the serial number 1050065027:

nrfutil device --x-ext-mem-config-file ../../nrf-probe/resources/firmware_config/nrf5340dk_qspi_config.json program --firmware data_going_to_external_flash.hex --serial-number 1050065027

When using a default configuration, such as for the nRF54L15 DK, you can omit --x-ext-mem-config-file:

nrfutil device program --firmware data_going_to_external_flash.hex --serial-number 1050065027