Skip to content

Commit a269aa2

Browse files
mrodgers-witekiokartben
authored andcommitted
boards: nrf52840dongle: update flashing instructions
Update flashing instructions using built-in bootloader to use latest version of tool for packaging and uploading images. Signed-off-by: Matt Rodgers <[email protected]>
1 parent 4455cd7 commit a269aa2

File tree

1 file changed

+19
-10
lines changed

1 file changed

+19
-10
lines changed

boards/nordic/nrf52840dongle/doc/index.rst

Lines changed: 19 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,10 @@ Option 1: Using the Built-In Bootloader Only
126126
The board is factory-programmed with Nordic's bootloader from Nordic's nRF5
127127
SDK. With this option, you'll use Nordic's `nrfutil`_ program to create
128128
firmware packages supported by this bootloader and flash them to the
129-
device. Make sure ``nrfutil`` is installed before proceeding.
129+
device. Before proceeding make sure:
130+
131+
* ``nrfutil`` is installed.
132+
* The ``nrf5sdk-tools`` command is installed within ``nrfutil``.
130133

131134
#. Reset the board into the Nordic bootloader by pressing the RESET button.
132135

@@ -151,16 +154,19 @@ device. Make sure ``nrfutil`` is installed before proceeding.
151154

152155
.. code-block:: console
153156
154-
nrfutil pkg generate --hw-version 52 --sd-req=0x00 \
155-
--application build/zephyr/zephyr.hex \
156-
--application-version 1 blinky.zip
157+
nrfutil nrf5sdk-tools pkg generate \
158+
--hw-version 52 \
159+
--sd-req=0x00 \
160+
--application build/zephyr/zephyr.hex \
161+
--application-version 1 \
162+
blinky.zip
157163
158164
#. Flash it onto the board. Note :file:`/dev/ttyACM0` is for Linux; it will be
159165
something like ``COMx`` on Windows, and something else on macOS.
160166

161167
.. code-block:: console
162168
163-
nrfutil dfu usb-serial -pkg blinky.zip -p /dev/ttyACM0
169+
nrfutil nrf5sdk-tools dfu usb-serial -pkg blinky.zip -p /dev/ttyACM0
164170
165171
When this command exits, observe the green LED on the board blinking,
166172
instead of the red LED used by the bootloader.
@@ -198,16 +204,19 @@ to the zephyr repository on your computer.
198204

199205
.. code-block:: console
200206
201-
nrfutil pkg generate --hw-version 52 --sd-req=0x00 \
202-
--application build/mcuboot/zephyr/zephyr.hex \
203-
--application-version 1 mcuboot.zip
207+
nrfutil nrf5sdk-tools pkg generate \
208+
--hw-version 52 \
209+
--sd-req=0x00 \
210+
--application build/mcuboot/zephyr/zephyr.hex \
211+
--application-version 1 \
212+
mcuboot.zip
204213
205214
#. Flash it onto the board. Note :file:`/dev/ttyACM0` is for Linux; it will be
206215
something like ``COMx`` on Windows, and something else on macOS.
207216

208217
.. code-block:: console
209218
210-
nrfutil dfu usb-serial -pkg mcuboot.zip -p /dev/ttyACM0
219+
nrfutil nrf5sdk-tools dfu usb-serial -pkg mcuboot.zip -p /dev/ttyACM0
211220
212221
You can now flash a Zephyr application to the board using MCUboot's serial
213222
recovery mode. We'll use the :zephyr:code-sample:`smp-svr` sample since it's ready to be
@@ -341,7 +350,7 @@ References
341350
.. _Nordic Semiconductor USB DFU:
342351
https://docs.nordicsemi.com/bundle/sdk_nrf5_v17.1.0/page/sdk_app_serial_dfu_bootloader.html
343352
.. _nrfutil:
344-
https://github.com/NordicSemiconductor/pc-nrfutil
353+
https://www.nordicsemi.com/Products/Development-tools/nrf-util
345354
.. _MCUboot:
346355
https://github.com/JuulLabs-OSS/mcuboot
347356
.. _mcumgr:

0 commit comments

Comments
 (0)