Skip to content

Commit 65a7139

Browse files
committed
doc/device_guide: nrfutil for qspi
Commandlines for qspi programing with nrfutil. Signed-off-by: Andrzej Puzdrowski <[email protected]> Signed-off-by: Anna Wojdylo <[email protected]>
1 parent 94f5b7c commit 65a7139

File tree

2 files changed

+11
-21
lines changed

2 files changed

+11
-21
lines changed

doc/nrf/app_dev/device_guides/nrf53/qspi_xip_guide_nrf5340.rst

Lines changed: 9 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -203,28 +203,21 @@ Programming the project
203203
***********************
204204

205205
For the nRF5340 DK and other boards equipped with flash working in the QSPI mode, use the :ref:`standard programming command <programming>` (``west flash``).
206-
For other cases, set up a configuration file for nrfjprog, as described in the following section.
207-
208-
.. note::
209-
|nrfjprog_deprecation_note|
206+
For other cases, set up a configuration file for `nRF Util`_, as described in the following section.
210207

211208
Programming to external flash in SPI/DSPI mode
212209
==============================================
213210

214-
Programming an application with west triggers the nrfjprog runner.
211+
Programming an application with west triggers the nRF Util runner.
215212
The runner uses the default system settings that configure the application in the QSPI mode when programming the external flash.
216-
You can change this behavior by using a custom :file:`Qspi.ini` configuration file.
213+
You can change this behavior by using a custom :file:`Qspi.json` configuration file.
214+
This file is used to set up the QSPI flash device and its parameters.
217215

218216
.. note::
219-
The :file:`Qspi.ini` file is required to work on the Nordic Thingy:53.
220-
221-
This file can specify the mode to use when programming the QSPI flash.
222-
For example, the following code is from the file for the Thingy:53 and uses ``PP`` for programming and ``READ2IO`` for reading:
223-
224-
.. literalinclude:: ../../../../../samples/nrf5340/extxip_smp_svr/Qspi_thingy53.ini
225-
:language: yaml
217+
The :file:`Qspi.json` file is required to work on the Nordic Thingy:53.
218+
Its QSPI configuration is different from the default one, for example, it uses the ``PP`` command for programming and ``READ2IO`` for reading.
226219

227-
To use this file automatically in a project, update the ``CMakeLists.txt`` file by :ref:`adding the mention of the new file <modifying_files_compiler>`.
220+
To use such a file automatically in a project, update the ``CMakeLists.txt`` file by :ref:`adding the mention of the new file <modifying_files_compiler>`.
228221
This way, the file can be applied globally for every board built with a project or applied to specific boards if a project supports multiple board targets, each with different configurations.
229222
The following code shows how to set the configuration file used when flashing the Thingy:53 only.
230223

@@ -238,7 +231,7 @@ The following code shows how to set the configuration file used when flashing th
238231
macro(app_set_runner_args)
239232
if(CONFIG_BOARD_THINGY53_NRF5340_CPUAPP)
240233
# Use alternative QSPI configuration file when flashing Thingy53
241-
board_runner_args(nrfjprog "--qspiini=${CMAKE_CURRENT_SOURCE_DIR}/Qspi_thingy53.ini")
234+
board_runner_args(nrfutil "--ext-mem-config-file=${CMAKE_CURRENT_SOURCE_DIR}/qspi_thingy53.json")
242235
endif()
243236
endmacro()
244237
@@ -248,7 +241,7 @@ The following code shows how to set the configuration file used when flashing th
248241
249242
.. note::
250243
The external flash chip must be connected to the dedicated QSPI peripheral port pins of the nRF5340 SoC.
251-
It is not possible to program an external flash chip that is connected to different pins using nrfjprog.
244+
It is not possible to program an external flash chip that is connected to different pins using nRF Util.
252245

253246
Troubleshooting
254247
***************

doc/nrf/app_dev/device_guides/nrf70/fw_patches_ext_flash.rst

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -167,14 +167,11 @@ With other tools
167167

168168
You must use the :file:`merged.hex` file instead of the :file:`zephyr.hex` file to choose the program image explicitly.
169169

170-
For example, for nrfjprog:
170+
For example, for nRF Util:
171171

172172
.. code-block:: console
173173
174-
nrfjprog -f nrf53 -s 0 --program build/merged.hex ---sectorerase --qspisectorerase --verify --reset
175-
176-
.. note::
177-
|nrfjprog_deprecation_note|
174+
nrfutil device program --x-family nrf53 --options chip_erase_mode=ERASE_RANGES_TOUCHED_BY_FIRMWARE,qspi_erase_mode=ERASE_ALL,verify=VERIFY_HASH,reset=RESET_SOFT --firmware build/merged.hex
178175
179176
Updating firmware patches
180177
=========================

0 commit comments

Comments
 (0)