Skip to content

Commit 4c6ab4d

Browse files
divipillaijukkar
divipillai
authored and
jukkar
committed
doc: Move Thingy:53 under application development
Moved Thingy:53 under application development. Signed-off-by: divya pillai <[email protected]>
1 parent c43a9ee commit 4c6ab4d

File tree

10 files changed

+172
-152
lines changed

10 files changed

+172
-152
lines changed

‎doc/_utils/redirects.py‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -214,17 +214,18 @@
214214
("working_with_nrf/nrf53/nrf5340", "app_dev/device_guides/nrf53/index"),
215215
("device_guides/working_with_nrf/nrf53/nrf5340", "app_dev/device_guides/nrf53/index"),
216216
("device_guides/nrf53/index", "app_dev/device_guides/nrf53/index"),
217-
("ug_thingy53", "app_dev/device_guides/nrf53/index"), # Developing with Thingy:53 (removed for 2.7.0)
218-
("working_with_nrf/nrf53/thingy53", "app_dev/device_guides/nrf53/index"),
219-
("device_guides/working_with_nrf/nrf53/thingy53", "app_dev/device_guides/nrf53/index"),
217+
("ug_thingy53", "app_dev/device_guides/thingy53/index"), # Developing with Thingy:53 (removed for 2.7.0)
218+
("working_with_nrf/nrf53/thingy53", "app_dev/device_guides/thingy53/index"),
219+
("device_guides/working_with_nrf/nrf53/thingy53", "app_dev/device_guides/thingy53/index"),
220220
("device_guides/nrf53/features_nrf53", "app_dev/device_guides/nrf53/features_nrf53"), # Features of nRF53 Series
221221
("device_guides/nrf53/building_nrf53", "app_dev/device_guides/nrf53/building_nrf53"), # Building and programming with nRF53 Series
222222
("device_guides/nrf53/fota_update_nrf5340", "app_dev/device_guides/nrf53/fota_update_nrf5340"), # FOTA updates with nRF5340 DK
223223
("device_guides/nrf53/multi_image_nrf5340", "app_dev/device_guides/nrf53/multi_image_nrf5340"), # Multi-image builds on the nRF5340 DK using child and parent images
224224
("device_guides/nrf53/simultaneous_multi_image_dfu_nrf5340", "app_dev/device_guides/nrf53/simultaneous_multi_image_dfu_nrf5340"), # Simultaneous multi-image DFU with nRF5340 DK
225225
("device_guides/nrf53/serial_recovery", "app_dev/device_guides/nrf53/serial_recovery"), # MCUboot’s serial recovery of the networking core image
226226
("device_guides/nrf53/logging_nrf5340", "app_dev/device_guides/nrf53/logging_nrf5340"), # Getting logging output with nRF5340 DK
227-
("device_guides/nrf53/thingy53_application_guide", "app_dev/device_guides/nrf53/thingy53_application_guide"), # Application guide for Thingy:53
227+
("device_guides/nrf53/thingy53_application_guide", "app_dev/device_guides/thingy53/thingy53_application_guide"), # Application guide for Thingy:53
228+
("app_dev/device_guides/nrf53/thingy53_application_guide", "app_dev/device_guides/thingy53/thingy53_application_guide"),
228229
("device_guides/working_with_nrf/nrf53/qspi_xip_guide", "app_dev/device_guides/nrf53/qspi_xip_guide_nrf5340"), # External execute in place (XIP) configuration on the nRF5340 SoC
229230
("device_guides/nrf53/qspi_xip_guide_nrf5340", "app_dev/device_guides/nrf53/qspi_xip_guide_nrf5340"),
230231
("ug_nrf52", "app_dev/device_guides/nrf52/index"), # Developing with nRF52 Series (landing)

‎doc/_zoomin/ncs.tags.yml‎

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -213,18 +213,16 @@ mapping_topics:
213213
- nrf/app_dev/device_guides/nrf53/*.html: ["nrf53-series"]
214214
- nrf/app_dev/device_guides/nrf53/features_nrf53.html: ["nrf5340", "thingy53", "development-kits",
215215
"prototyping-platforms"]
216-
- nrf/app_dev/device_guides/nrf53/building_nrf53.html: ["nrf5340", "thingy53", "development-kits",
217-
"prototyping-platforms",
216+
- nrf/app_dev/device_guides/nrf53/building_nrf53.html: ["nrf5340", "development-kits",
218217
"nrf-connect-vsc"]
219218
- nrf/app_dev/device_guides/nrf53/fota_update_nrf5340.html: ["nrf5340", "development-kits"]
220219
- nrf/app_dev/device_guides/nrf53/multi_image_nrf5340.html: ["nrf5340", "development-kits"]
221220
- nrf/app_dev/device_guides/nrf53/simultaneous_multi_image_dfu_nrf5340.html: ["nrf5340",
222221
"development-kits"]
223222
- /nrf/app_dev/device_guides/nrf53/serial_recovery.html: ["nrf5340", "development-kits"]
224223
- /nrf/app_dev/device_guides/nrf53/logging_nrf5340.html: ["nrf5340", "development-kits"]
225-
- nrf/app_dev/device_guides/nrf53/thingy53_application_guide.html: ["thingy53",
226-
"prototyping-platforms"]
227224
- nrf/app_dev/device_guides/nrf53/qspi_xip_guide_nrf5340.html: ["nrf5340", "development-kits"]
225+
- nrf/app_dev/device_guides/thingy53/*.html: ["thingy53", "prototyping-platforms", "nrf53-series"]
228226
- nrf/app_dev/device_guides/nrf52/*.html: ["nrf52-series", "development-kits", "nrf52840",
229227
"nrf52833", "nrf52832", "nrf52820", "nrf52811",
230228
"nrf52810", "nrf52805"]

‎doc/nrf/app_dev.rst‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,7 @@ For detailed integration instructions of specific technologies and components, c
3232
app_dev/device_guides/nrf52/index
3333
app_dev/device_guides/thingy91x/index
3434
app_dev/device_guides/thingy91/index
35+
app_dev/device_guides/thingy53/index
3536
app_dev/device_guides/pmic/index
3637
app_dev/device_guides/fem/index
3738
app_dev/device_guides/wifi_coex

‎doc/nrf/app_dev/device_guides/nrf53/building_nrf53.rst‎

Lines changed: 0 additions & 131 deletions
Original file line numberDiff line numberDiff line change
@@ -147,134 +147,3 @@ To program the nRF5340 DK from the command line, use either west (which uses nrf
147147
148148
.. note::
149149
The ``--verify`` command confirms that the writing operation has succeeded.
150-
151-
.. _thingy53_building_pgming:
152-
153-
Building and programming with Thingy:53
154-
***************************************
155-
156-
You can program the Nordic Thingy:53 by using the images obtained by building the code in the |NCS| environment.
157-
158-
To set up your system to be able to build a firmware image, follow the :ref:`installation` guide for the |NCS|.
159-
160-
.. _thingy53_build_pgm_targets:
161-
162-
Board targets
163-
=============
164-
165-
The board targets of interest for Thingy:53 in the |NCS| are listed in the following table:
166-
167-
+--------------------------------+----------------------------------------------------------------------------------------------------------------------------------+
168-
|Component | Board target |
169-
+================================+==================================================================================================================================+
170-
| nRF5340 SoC - Application core |``thingy53/nrf5340/cpuapp`` for :ref:`Cortex-M Security Extensions (CMSE) disabled <app_boards_spe_nspe_cpuapp>` |
171-
| | |
172-
| |``thingy53/nrf5340/cpuapp/ns`` for :ref:`CMSE enabled <app_boards_spe_nspe_cpuapp_ns>` |
173-
+--------------------------------+----------------------------------------------------------------------------------------------------------------------------------+
174-
| nRF5340 SoC - Network core |``thingy53/nrf5340/cpunet`` |
175-
+--------------------------------+----------------------------------------------------------------------------------------------------------------------------------+
176-
177-
The |NCS| uses :ref:`ug_multi_image` for Thingy:53 by default.
178-
When you choose ``thingy53/nrf5340/cpuapp`` or ``thingy53/nrf5340/cpuapp/ns`` as the board target when building a sample or application, you will generate firmware for both the application core and network core:
179-
180-
* The application core firmware consists of MCUboot bootloader and an application image.
181-
* The network core firmware consists of network core bootloader (B0n) and application firmware of the network core.
182-
183-
The build process generates firmware in two formats:
184-
185-
* Intel Hex file (:file:`merged.hex` and :file:`merged_CPUNET.hex`) - Used with an external debug probe.
186-
These file contains bootloaders and applications for each core.
187-
* Binary files (:file:`zephyr.signed.bin`), containing signed application firmwares for the application and network core, respectively.
188-
For convenience, the binary files are bundled in :file:`dfu_application.zip`, together with a manifest that describes them.
189-
You can use the binary files or the combined zip archive to update application firmware for both cores, with either MCUboot serial recovery or OTA DFU using Bluetooth LE.
190-
191-
For more information about files generated as output of the build process, see :ref:`app_build_output_files`.
192-
193-
See the following sections for details regarding building and programming the firmware for Thingy:53 in various environments.
194-
See :ref:`thingy53_app_update` for more detailed information about updating firmware on Thingy:53.
195-
196-
.. _thingy53_build_pgm_targets_wifi:
197-
198-
Building Wi-Fi applications on Thingy:53
199-
----------------------------------------
200-
201-
.. building_wi_fi_applications_on_thingy_53_start
202-
203-
You can use the Nordic Thingy:53 with the nRF7002 Expansion Board (EB) for Wi-Fi development.
204-
Connect the nRF7002 EB to the **P9** connector on Thingy:53.
205-
206-
To build for the nRF7002 EB with Thingy:53, use the ``thingy53/nrf5340/cpuapp`` board target with the CMake ``SHIELD`` variable set to ``nrf7002eb``.
207-
For example, you can use the following command when building on the command line:
208-
209-
.. code-block::
210-
211-
west build -b thingy53/nrf5340/cpuapp -- -DSHIELD=nrf7002eb
212-
213-
.. building_wi_fi_applications_on_thingy_53_end
214-
215-
For the compatible Wi-Fi samples in the |NCS|, see the :ref:`wifi_samples` section.
216-
217-
.. _thingy53_build_pgm_vscode:
218-
219-
Building and programming using |VSC|
220-
====================================
221-
222-
Complete the following steps to build and program using the |nRFVSC|:
223-
224-
.. |sample_path_vsc| replace:: :file:`nrf/samples/bluetooth/peripheral_lbs`
225-
226-
.. |vsc_sample_board_target_line| replace:: select ``thingy53/nrf5340/cpuapp`` as the board target
227-
228-
.. include:: /includes/vsc_build_and_run.txt
229-
230-
3. Program the sample or application:
231-
232-
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.
233-
#. Connect the external debug probe to the PC using a USB cable.
234-
#. Make sure that the Thingy:53 and the external debug probe are powered on.
235-
#. Click :guilabel:`Flash` in the :guilabel:`Actions View`.
236-
237-
.. _thingy53_build_pgm_command_line:
238-
239-
Building and programming on the command line
240-
============================================
241-
242-
You must :ref:`build_environment_cli` before you start building an |NCS| project on the command line.
243-
244-
To build and program the source code from the command line, complete the following steps:
245-
246-
1. |open_terminal_window_with_environment|
247-
#. Go to the specific directory for the sample or application.
248-
249-
For example, the directory path is :file:`ncs/nrf/applications/machine_learning` when building the source code for the :ref:`nrf_machine_learning_app` application.
250-
251-
#. Make sure that you have the required version of the |NCS| repository by pulling the ``sdk-nrf`` repository on GitHub as described in :ref:`dm-wf-get-ncs` and :ref:`dm-wf-update-ncs` sections.
252-
#. Get the rest of the dependencies using west:
253-
254-
.. code-block:: console
255-
256-
west update
257-
258-
#. Build the sample or application code as follows:
259-
260-
.. parsed-literal::
261-
:class: highlight
262-
263-
west build -b *board_target* -d *destination_directory_name*
264-
265-
The board target should be ``thingy53/nrf5340/cpuapp`` or ``thingy53/nrf5340/cpuapp/ns`` when building samples for the application core.
266-
The proper child image for ``thingy53/nrf5340/cpunet`` will be built automatically.
267-
See :ref:`thingy53_build_pgm_targets` for details.
268-
269-
#. Program the sample or application:
270-
271-
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.
272-
#. Connect the external debug probe to the PC using a USB cable.
273-
#. Make sure that the Nordic Thingy:53 and the external debug probe are powered on.
274-
#. Use the following command to program the sample or application to the device:
275-
276-
.. code-block:: console
277-
278-
west flash
279-
280-
The device resets and runs the programmed sample or application.

‎doc/nrf/app_dev/device_guides/nrf53/features_nrf53.rst‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,6 @@ For additional information, refer to the following resources:
1616

1717
* `nRF53 Series`_ for the technical documentation on the nRF53 Series chips and associated kits.
1818
* :ref:`installation` and :ref:`configuration_and_build` documentation to install the |NCS| and learn more about its development environment.
19-
* :ref:`ug_thingy53_gs` for getting started with the Thingy:53.
2019

2120
Dual-core architecture
2221
**********************
@@ -34,7 +33,6 @@ The separation of application and network functionalities simplifies firmware up
3433

3534
This architecture is ideal for devices requiring significant data processing alongside continuous wireless connectivity.
3635

37-
3836
.. _ug_nrf5340_intro_net_core:
3937

4038
Network core

‎doc/nrf/app_dev/device_guides/nrf53/index.rst‎

Lines changed: 0 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
.. _ug_nrf53:
22
.. _nrf53_working:
33
.. _ug_nrf5340:
4-
.. _ug_thingy53:
54

65
Developing with nRF53 Series
76
############################
@@ -29,10 +28,6 @@ Zephyr and the |NCS| provide support and contain board definitions for developin
2928
- ``nrf5340_audio_dk/nrf5340/cpuapp``, ``nrf5340_audio_dk/nrf5340/cpuapp/ns``, ``nrf5340_audio_dk/nrf5340/cpunet``
3029
- | `Hardware Specification <nRF5340 Audio DK Hardware_>`_
3130
| :ref:`nrf53_audio_app`
32-
* - :ref:`zephyr:thingy53_nrf5340`
33-
- PCA20053
34-
- ``thingy53/nrf5340/cpuapp``, ``thingy53/nrf5340/cpuapp/ns``, ``thingy53/nrf5340/cpunet``
35-
- `Hardware Specification <Nordic Thingy:53 Hardware_>`_
3631
3732
.. note::
3833
The nRF5340 PDK has been deprecated with the introduction of the production-level nRF5340 DK.
@@ -46,10 +41,6 @@ It is meant for use with for :ref:`nrf53_audio_app`, which integrate the LE Audi
4641
Given their complexity, the applications use custom building and programming procedures.
4742
Refer to their documentation for more information.
4843

49-
The Nordic Thingy:53 is a battery-operated prototyping platform for IoT Systems.
50-
The Nordic Thingy:53 integrates the nRF5340 SoC that supports Bluetooth® Low Energy, IEEE 802.15.4 based protocols and Near Field Communication (NFC).
51-
The nRF5340 is augmented with the nRF21540 RF FEM (Front-end Module) Range extender that has an integrated power amplifier (PA)/low-noise amplifier (LNA) and nPM1100 Power Management IC (PMIC) that has an integrated dual-mode buck regulator and battery charger.
52-
5344
.. toctree::
5445
:maxdepth: 2
5546
:caption: Subpages:
@@ -61,5 +52,4 @@ The nRF5340 is augmented with the nRF21540 RF FEM (Front-end Module) Range exten
6152
simultaneous_multi_image_dfu_nrf5340
6253
serial_recovery
6354
logging_nrf5340
64-
thingy53_application_guide
6555
qspi_xip_guide_nrf5340

0 commit comments

Comments
 (0)