You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Moved information about updating precompiled firmware to device guide.
Transferred detailed steps for programming with the Programmer app
to the tool documentation.
Added a new page about precompiled firmware.
Reorganized information about programming methods for clarity.
NCSDK-29643.
Signed-off-by: Grzegorz Ferenc <Grzegorz.Ferenc@nordicsemi.no>
Copy file name to clipboardexpand all lines: doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst
+87-3
Original file line number
Diff line number
Diff line change
@@ -45,7 +45,6 @@ The build process generates firmware in two formats:
45
45
For more information about files generated as output of the build process, see :ref:`app_build_output_files`.
46
46
47
47
See the following sections for details regarding building and programming the firmware for Thingy:53 in various environments.
48
-
See :ref:`thingy53_app_update` for more detailed information about updating firmware on Thingy:53.
49
48
50
49
.. _thingy53_build_pgm_targets_wifi:
51
50
@@ -64,6 +63,53 @@ For example, you can use the following command when building on the command line
64
63
65
64
For the compatible Wi-Fi samples in the |NCS|, see the :ref:`wifi_samples` section.
66
65
66
+
.. _thingy53_app_update:
67
+
68
+
Programming methods for Thingy:53
69
+
*********************************
70
+
71
+
You can program the firmware on the Nordic Thingy:53 using an external debug probe and 10-pin JTAG cable, using :ref:`Visual Studio Code <thingy53_build_pgm_vscode>`, :ref:`command line <thingy53_build_pgm_command_line>`, or the `Programmer app <Programming Nordic Thingy:53_>`_ from nRF Connect for Desktop.
72
+
You can also program applications running on both the network and application core using the built-in MCUboot serial recovery mode, using the `Programmer app`_ from nRF Connect for Desktop or `nRF Util <Programming application firmware using MCUboot serial recovery_>`_.
73
+
74
+
Finally, you can use the `Programmer app`_ from nRF Connect for Desktop, the `nRF Programmer`_ mobile app for Android and iOS, or nRF Util to update the :ref:`preloaded application images <thingy53_precompiled>`.
75
+
76
+
.. _thingy53_app_update_debug:
77
+
78
+
Firmware update using external debug probe
79
+
==========================================
80
+
81
+
You can program the firmware on the Nordic Thingy:53 using an external debug probe and 10-pin JTAG cable.
82
+
In such cases, you can program the Thingy:53 the same way as the nRF5340 DK.
83
+
84
+
The external debug probe must support Arm Cortex-M33 (such as the nRF5340 DK).
85
+
You need a 10-pin 2x5 socket-to-socket 1.27 mm IDC (:term:`Serial Wire Debug (SWD)`) JTAG cable to connect to the external debug probe.
86
+
87
+
This method is supported when programming with :ref:`Visual Studio Code <thingy53_build_pgm_vscode>`, :ref:`command line <thingy53_build_pgm_command_line>`, or the `Programmer app <Programming Nordic Thingy:53_>`_ from nRF Connect for Desktop.
88
+
89
+
See also :ref:`ug_nrf5340` for additional information.
90
+
91
+
.. _thingy53_app_update_mcuboot:
92
+
93
+
Firmware update using MCUboot bootloader
94
+
========================================
95
+
96
+
Samples and applications built for Thingy:53 include the MCUboot bootloader that you can use to update the firmware out of the box.
97
+
This method uses signed binary files :file:`app_update.bin` and :file:`net_core_app_update.bin` (or :file:`dfu_application.zip`).
98
+
You can program the precompiled firmware image in one of the following ways:
99
+
100
+
* Use the :doc:`MCUboot<mcuboot:index-ncs>` feature and the built-in serial recovery mode of Thingy:53.
101
+
In this scenario, the Thingy is connected directly to your PC through USB.
102
+
For details, refer to the :ref:`thingy53_app_mcuboot_bootloader` section.
103
+
104
+
See `Programming Nordic Thingy:53`_ in the `Programmer app`_ for the detailed procedures on how to program the Thingy:53 using nRF Connect for Desktop.
105
+
106
+
* Update the firmware over-the-air (OTA) using Bluetooth® LE and the nRF Programmer mobile application for Android or iOS.
107
+
To use this method, the application that is currently programmed on Thingy:53 must support it.
108
+
For details, refer to :ref:`thingy53_app_fota_smp` section.
109
+
All precompiled images support OTA using Bluetooth.
110
+
111
+
See the :ref:`thingy53_gs_updating_ble` section for the detailed procedures on how to program a Thingy:53 using the `nRF Programmer`_ mobile app for Android or iOS.
112
+
67
113
.. _thingy53_build_pgm_vscode:
68
114
69
115
Building and programming using |VSC|
@@ -80,8 +126,15 @@ Complete the following steps to build and program using the |nRFVSC|:
80
126
3. Program the sample or application:
81
127
82
128
a. Connect the Nordic Thingy:53 to the debug out port on a 10-pin external debug probe, for example nRF5340 DK, using a 10-pin JTAG cable.
83
-
#. Connect the external debug probe to the PC using a USB cable.
129
+
130
+
.. figure:: ./images/thingy53_nrf5340_dk.webp
131
+
:alt:Nordic Thingy:53 connected to the debug port on a 10-pin external debug probe
132
+
133
+
Nordic Thingy:53 connected to the debug port on a 10-pin external debug probe
134
+
135
+
#. Connect the external debug probe to the PC using a micro-USB cable.
84
136
#. Make sure that the Thingy:53 and the external debug probe are powered on.
137
+
(On the Thingy:53, move the power switch **SW1** to the **ON** position.)
85
138
#. Click :guilabel:`Flash` in the :guilabel:`Actions View`.
86
139
87
140
.. _thingy53_build_pgm_command_line:
@@ -119,12 +172,43 @@ To build and program the source code from the command line, complete the followi
119
172
#. Program the sample or application:
120
173
121
174
a. Connect the Nordic Thingy:53 to the debug out port on a 10-pin external debug probe, for example nRF5340 DK, using a 10-pin JTAG cable.
122
-
#. Connect the external debug probe to the PC using a USB cable.
175
+
176
+
.. figure:: ./images/thingy53_nrf5340_dk.webp
177
+
:alt:Nordic Thingy:53 connected to the debug port on a 10-pin external debug probe
178
+
179
+
Nordic Thingy:53 connected to the debug port on a 10-pin external debug probe
180
+
181
+
#. Connect the external debug probe to the PC using a micro-USB cable.
123
182
#. Make sure that the Nordic Thingy:53 and the external debug probe are powered on.
183
+
(On the Thingy:53, move the power switch **SW1** to the **ON** position.)
124
184
#. Use the following command to program the sample or application to the device:
125
185
126
186
.. code-block:: console
127
187
128
188
west flash
129
189
130
190
The device resets and runs the programmed sample or application.
191
+
192
+
.. _thingy53_gs_updating_usb:
193
+
.. _thingy53_gs_updating_external_probe:
194
+
195
+
Programming using the Programmer app
196
+
************************************
197
+
198
+
You can program the Nordic Thingy:53 using the `Programmer app`_ from nRF Connect for Desktop and MCUboot's serial recovery feature.
199
+
You can use this application to also program precompiled firmware packages.
200
+
201
+
You can program the Thingy:53 using the Programmer app with either USB-C or an external debug probe.
202
+
See the `Programming Nordic Thingy:53`_ in the tool documentation for detailed steps.
203
+
204
+
Programming using nRF Util
205
+
**************************
206
+
207
+
You can use the nRF Util tool to program Thingy:53, including programming precompiled firmware packages.
208
+
See `Programming application firmware using MCUboot serial recovery`_ in the tool documentation for detailed steps.
209
+
210
+
Using the nRF Programmer mobile app
211
+
***********************************
212
+
213
+
You can use the `nRF Programmer`_ mobile app on your Android or iOS device to program precompiled firmware packages.
214
+
For detailed steps, see :ref:`thingy53_gs_updating_ble`.
Copy file name to clipboardexpand all lines: doc/nrf/app_dev/device_guides/thingy53/thingy53_application_guide.rst
+3-41
Original file line number
Diff line number
Diff line change
@@ -14,53 +14,15 @@ See the following sections for details of what is configured by default and what
14
14
15
15
.. _thingy53_serialports:
16
16
17
-
Connecting to Thingy:53
18
-
***********************
17
+
Connecting to Thingy:53 for logs
18
+
********************************
19
19
20
20
Applications and samples for the Nordic Thingy:53 use a serial terminal to provide logs.
21
21
By default, the serial terminal is accessible through the USB CDC ACM class handled by application firmware.
22
22
The serial port is visible right after the Thingy:53 is connected to the host using a USB cable.
23
23
The CDC ACM baudrate is ignored, and transfer goes with USB speed.
24
24
25
-
.. _thingy53_app_update:
26
-
27
-
Updating firmware image for Thingy:53
28
-
*************************************
29
-
30
-
You can program the firmware on the Nordic Thingy:53 using an external debug probe and 10-pin JTAG cable, as described in :ref:`thingy53_building_pgming`, using either :ref:`Visual Studio Code <thingy53_build_pgm_vscode>` or :ref:`command line <thingy53_build_pgm_command_line>`.
31
-
You can also update applications running on both the network and application core using the built-in MCUboot bootloader and the `Programmer app`_ for desktop or the `nRF Programmer`_ app for Android and iOS.
32
-
You can also update the prebuilt application images that way.
33
-
34
-
See :ref:`thingy53_gs_updating_firmware` for details about updating firmware image.
35
-
36
-
.. _thingy53_app_update_debug:
37
-
38
-
Firmware update using external debug probe
39
-
==========================================
40
-
41
-
If you are using an external debug probe, such as the nRF5340 DK, or any J-Link device supporting ARM Cortex-M33, you can program the Thingy:53 the same way as nRF5340 DK.
42
-
See :ref:`ug_nrf5340` for details.
43
-
44
-
.. _thingy53_app_update_mcuboot:
45
-
46
-
Firmware update using MCUboot bootloader
47
-
========================================
48
-
49
-
Samples and applications built for Thingy:53 include the MCUboot bootloader that you can use to update the firmware out of the box.
50
-
This method uses signed binary files :file:`app_update.bin` and :file:`net_core_app_update.bin` (or :file:`dfu_application.zip`).
51
-
You can program the precompiled firmware image using one of the following ways:
52
-
53
-
* Use the :doc:`MCUboot<mcuboot:index-ncs>` feature and the built-in serial recovery mode of Thingy:53.
54
-
In this scenario, the Thingy is connected directly to your PC through USB.
55
-
For details, refer to the :ref:`thingy53_app_mcuboot_bootloader` section.
56
-
57
-
See the :ref:`thingy53_gs_updating_usb` section in the :ref:`ug_thingy53_gs` guide for the detailed procedures on how to program the Thingy:53 using the `Programmer app`_.
58
-
* Update the firmware over-the-air (OTA) using Bluetooth® LE and the nRF Programmer mobile application for Android or iOS.
59
-
To use this method, the application that is currently programmed on Thingy:53 must support it.
60
-
For details, refer to :ref:`thingy53_app_fota_smp` section.
61
-
All precompiled images support OTA using Bluetooth.
62
-
63
-
See the :ref:`thingy53_gs_updating_ble` section in the :ref:`ug_thingy53_gs` guide for the detailed procedures on how to program a Thingy:53 using `nRF Programmer`_ for Android or iOS.
25
+
For more information, see :ref:`thingy53_app_usb`.
The Nordic Thingy:53 comes preloaded with the following firmware:
12
+
13
+
* `Edge Impulse`_ application firmware
14
+
* MCUboot bootloader
15
+
* SoftDevice controller on the network core
16
+
17
+
This page describes how to connect with Edge Impulse Studio or update Nordic Thingy:53 with precompiled firmware provided by Nordic Semiconductor.
18
+
19
+
.. _thingy53_gs_machine_learning:
20
+
21
+
Connecting with Edge Impulse Studio
22
+
***********************************
23
+
24
+
The Nordic Thingy:53 is preprogrammed with Edge Impulse firmware.
25
+
The Edge Impulse firmware enables data collection from all the sensors on the Nordic Thingy:53.
26
+
You can use the collected data to train and test machine learning models.
27
+
Deploy the trained machine learning model to the Nordic Thingy:53 over Bluetooth LE or USB.
28
+
29
+
Complete the following steps to get started with Edge Impulse:
30
+
31
+
1. Go to the `Edge Impulse`_ website.
32
+
#. Create a free Edge Impulse account.
33
+
#. Download the `nRF Edge Impulse mobile app`_.
34
+
#. Follow the instructions in the `Nordic Semi Thingy:53 page`_.
35
+
36
+
Precompiled Thingy:53 firmware
37
+
******************************
38
+
39
+
If you want to program your Nordic Thingy:53 with other precompiled firmware, you can download the latest precompiled firmware from the following sources:
40
+
41
+
* The `Nordic Thingy:53 Downloads`_ page (the Precompiled application firmware section).
42
+
The package contains a :file:`CONTENTS.txt` file listing the locations and names of different firmware images.
43
+
* The `nRF Programmer`_ mobile application (available for Android and iOS).
44
+
The application lists the available precompiled firmware images when you open it.
45
+
46
+
.. _thingy53_gs_updating_ble:
47
+
48
+
Updating precompiled firmware
49
+
=============================
50
+
51
+
You can update the precompiled firmware using any of the following methods:
52
+
53
+
.. tabs::
54
+
55
+
.. tab:: nRF Programmer (Bluetooth LE)
56
+
57
+
You can update the Nordic Thingy:53 application and network core over Bluetooth LE using the nRF Programmer mobile application for Android or iOS.
0 commit comments