doc: thingy53: remove GSG guide #19828

greg-fer · 2025-01-09T16:05:22Z

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.

Changelog entry

NordicBuilder · 2025-01-09T16:08:00Z

CI Information

^{To view the history of this post, clich the 'edited' button above}
Build number: 7

Inputs:

Sources:

more details

Github labels

Enabled	Name	Description
	ci-disabled	Disable the ci execution
	ci-all-test	Run all of ci, no test spec filtering will be done
	ci-force-downstream	Force execution of downstream even if twister fails
	ci-run-twister	Force run twister
	ci-run-zephyr-twister	Force run zephyr twister

List of changed files detected by CI (0)

Outputs:

Toolchain

Version:
Build docker image:

Test Spec & Results: ✅ Success; ❌ Failure; 🟠 Queued; 🟡 Progress; ◻️ Skipped; ⚠️ Quarantine

◻️ Toolchain
◻️ Build twister
◻️ Integration tests

Note: This message is automatically posted and updated by the CI

NordicBuilder · 2025-01-10T09:42:31Z

You can find the documentation preview for this PR at this link. It will be updated about 10 minutes after the documentation build succeeds.

Note: This comment is automatically posted by the Documentation Publish GitHub Action.

peknis · 2025-01-10T10:25:40Z

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

+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>`, :ref:`command line <thingy53_build_pgm_command_line>`, or the `Programmer app <Programming Nordic Thingy:53_>`_ from nRF Connect for Desktop.
+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_>`_.


Suggested change

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>`, :ref:`command line <thingy53_build_pgm_command_line>`, or the `Programmer app <Programming Nordic Thingy:53_>`_ from nRF Connect for Desktop.

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_>`_.

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.

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_>`_.

peknis · 2025-01-10T10:26:54Z

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

+==========================================
+
+You can program the firmware on the Nordic Thingy:53 using an external debug probe and 10-pin JTAG cable.
+In such cases, you can program the Thingy:53 the same way as nRF5340 DK.


Suggested change

In such cases, you can program the Thingy:53 the same way as nRF5340 DK.

In such cases, you can program the Thingy:53 the same way as the nRF5340 DK.

peknis · 2025-01-10T10:28:11Z

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

+In such cases, you can program the Thingy:53 the same way as nRF5340 DK.
+
+The external debug probe must support Arm Cortex-M33 (such as the nRF5340 DK).
+You need a 10-pin 2x5 socket-socket 1.27 mm IDC (:term:`Serial Wire Debug (SWD)`) JTAG cable to connect to the external debug probe.


Suggested change

You need a 10-pin 2x5 socket-socket 1.27 mm IDC (:term:`Serial Wire Debug (SWD)`) JTAG cable to connect to the external debug probe.

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.

peknis · 2025-01-10T10:29:40Z

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

+  In this scenario, the Thingy is connected directly to your PC through USB.
+  For details, refer to the :ref:`thingy53_app_mcuboot_bootloader` section.
+
+  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.


Suggested change

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.

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.

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

peknis · 2025-01-10T10:33:18Z

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

+You can program the Nordic Thingy:53 using the `Programmer app`_ from nRF Connect for Desktop and MCUboot's serial recovery feature.
+This application can also be used to program precompiled firmware packages.
+
+You can program the Thingy:53 using the Programmer app using either USB-C or an external debug probe.


Suggested change

You can program the Thingy:53 using the Programmer app using either USB-C or an external debug probe.

You can program the Thingy:53 using the Programmer app with either USB-C or an external debug probe.

peknis · 2025-01-10T10:34:06Z

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

+Programming using nRF Util
+**************************
+
+You can use the nRF Util utility to program Thingy:53, including programming precompiled firmware packages.


Suggested change

You can use the nRF Util utility to program Thingy:53, including programming precompiled firmware packages.

You can use the nRF Util tool to program Thingy:53, including programming precompiled firmware packages.

peknis · 2025-01-10T10:35:16Z

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

+
+Samples and applications built for Thingy:53 include the MCUboot bootloader that you can use to update the firmware out of the box.
+This method uses signed binary files :file:`app_update.bin` and :file:`net_core_app_update.bin` (or :file:`dfu_application.zip`).
+You can program the precompiled firmware image using one of the following ways:


Suggested change

You can program the precompiled firmware image using one of the following ways:

You can program the precompiled firmware image in one of the following ways:

umapraseeda

There might be updates required for the tags file.

umapraseeda · 2025-01-10T11:51:16Z

doc/nrf/app_dev/device_guides/thingy53/thingy53_precompiled.rst

+The Nordic Thingy:53 is preprogrammed with Edge Impulse firmware.
+The Edge Impulse firmware enables data collection from all the sensors on the Nordic Thingy:53.
+You can use the collected data to train and test machine learning models.
+Deploy the trained machine learning model to the Nordic Thingy:53 over Bluetooth LE or USB.


Suggested change

Deploy the trained machine learning model to the Nordic Thingy:53 over Bluetooth LE or USB.

Deploy the trained machine learning model to the Nordic Thingy:53 over Bluetooth® LE or USB.

umapraseeda · 2025-01-10T12:17:46Z

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

+
+  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.
+
+* Update the firmware over-the-air (OTA) using Bluetooth® LE and the nRF Programmer mobile application for Android or iOS.


Suggested change

* Update the firmware over-the-air (OTA) using Bluetooth® LE and the nRF Programmer mobile application for Android or iOS.

* Update the firmware over-the-air (OTA) using Bluetooth LE and the nRF Programmer mobile application for Android or iOS.

divipillai

nits.

divipillai · 2025-01-10T15:50:40Z

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

+Firmware update using external debug probe
+==========================================
+
+You can program the firmware on the Nordic Thingy:53 using an external debug probe and 10-pin JTAG cable.


Suggested change

You can program the firmware on the Nordic Thingy:53 using an external debug probe and 10-pin JTAG cable.

You can program the firmware on the Nordic Thingy:53 using an external debug probe and a 10-pin JTAG cable.

divipillai · 2025-01-10T15:51:03Z

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

+Programming methods for Thingy:53
+*********************************
+
+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.


Suggested change

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.

You can program the firmware on the Nordic Thingy:53 using an external debug probe and a 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.

divipillai · 2025-01-10T15:51:54Z

doc/nrf/app_dev/device_guides/thingy53/building_thingy53.rst

+
+* Update the firmware over-the-air (OTA) using Bluetooth® LE and the nRF Programmer mobile application for Android or iOS.
+  To use this method, the application that is currently programmed on Thingy:53 must support it.
+  For details, refer to :ref:`thingy53_app_fota_smp` section.


Suggested change

For details, refer to :ref:`thingy53_app_fota_smp` section.

For details, refer to the :ref:`thingy53_app_fota_smp` section.

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 <[email protected]>

greg-fer added CI-disable Disable CI for this PR doc only labels Jan 9, 2025

greg-fer added this to the 3.0.0 milestone Jan 9, 2025

greg-fer requested review from wiba-nordic and divipillai January 9, 2025 16:05

greg-fer requested review from a team as code owners January 9, 2025 16:05

github-actions bot added doc-required PR must not be merged without tech writer approval. changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. labels Jan 9, 2025

greg-fer marked this pull request as draft January 9, 2025 16:06

greg-fer force-pushed the doc_move_thingy53_gs_to_dev_section branch from ef11554 to 8659c0b Compare January 10, 2025 09:23

github-actions bot removed the changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. label Jan 10, 2025

greg-fer marked this pull request as ready for review January 10, 2025 09:41

greg-fer requested a review from a team as a code owner January 10, 2025 09:41

greg-fer force-pushed the doc_move_thingy53_gs_to_dev_section branch from 8659c0b to 4b459a1 Compare January 10, 2025 10:20

peknis requested changes Jan 10, 2025

View reviewed changes

greg-fer force-pushed the doc_move_thingy53_gs_to_dev_section branch 2 times, most recently from 15fbef8 to f017ca8 Compare January 10, 2025 11:56

wiba-nordic approved these changes Jan 10, 2025

View reviewed changes

peknis approved these changes Jan 10, 2025

View reviewed changes

umapraseeda reviewed Jan 10, 2025

View reviewed changes

greg-fer force-pushed the doc_move_thingy53_gs_to_dev_section branch from f017ca8 to 547dfc5 Compare January 13, 2025 07:41

greg-fer requested a review from a team as a code owner January 13, 2025 07:41

divipillai approved these changes Jan 13, 2025

View reviewed changes

umapraseeda approved these changes Jan 13, 2025

View reviewed changes

greg-fer force-pushed the doc_move_thingy53_gs_to_dev_section branch from 547dfc5 to 2f4ed87 Compare January 13, 2025 12:24

annwoj approved these changes Jan 13, 2025

View reviewed changes

gmarull approved these changes Jan 13, 2025

View reviewed changes

gmarull merged commit 962ac08 into nrfconnect:main Jan 13, 2025
13 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

doc: thingy53: remove GSG guide #19828

doc: thingy53: remove GSG guide #19828

greg-fer commented Jan 9, 2025 •

edited

Loading

NordicBuilder commented Jan 9, 2025 •

edited

Loading

NordicBuilder commented Jan 10, 2025

peknis Jan 10, 2025

peknis Jan 10, 2025

peknis Jan 10, 2025

peknis Jan 10, 2025

peknis Jan 10, 2025

peknis Jan 10, 2025

peknis Jan 10, 2025

umapraseeda left a comment

umapraseeda Jan 10, 2025

umapraseeda Jan 10, 2025

divipillai left a comment

divipillai Jan 10, 2025

divipillai Jan 10, 2025

divipillai Jan 10, 2025

		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>`, :ref:`command line <thingy53_build_pgm_command_line>`, or the `Programmer app <Programming Nordic Thingy:53_>`_ from nRF Connect for Desktop.
		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_>`_.

	In such cases, you can program the Thingy:53 the same way as nRF5340 DK.
	In such cases, you can program the Thingy:53 the same way as the nRF5340 DK.

	You need a 10-pin 2x5 socket-socket 1.27 mm IDC (:term:`Serial Wire Debug (SWD)`) JTAG cable to connect to the external debug probe.
	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.

	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.
	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.

	You can program the Thingy:53 using the Programmer app using either USB-C or an external debug probe.
	You can program the Thingy:53 using the Programmer app with either USB-C or an external debug probe.

	You can use the nRF Util utility to program Thingy:53, including programming precompiled firmware packages.
	You can use the nRF Util tool to program Thingy:53, including programming precompiled firmware packages.

	You can program the precompiled firmware image using one of the following ways:
	You can program the precompiled firmware image in one of the following ways:

	Deploy the trained machine learning model to the Nordic Thingy:53 over Bluetooth LE or USB.
	Deploy the trained machine learning model to the Nordic Thingy:53 over Bluetooth® LE or USB.


		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.

		* Update the firmware over-the-air (OTA) using Bluetooth® LE and the nRF Programmer mobile application for Android or iOS.

	For details, refer to :ref:`thingy53_app_fota_smp` section.
	For details, refer to the :ref:`thingy53_app_fota_smp` section.

doc: thingy53: remove GSG guide #19828

doc: thingy53: remove GSG guide #19828

Conversation

greg-fer commented Jan 9, 2025 • edited Loading

NordicBuilder commented Jan 9, 2025 • edited Loading

CI Information

Inputs:

Sources:

Github labels

Outputs:

Toolchain

Test Spec & Results: ✅ Success; ❌ Failure; 🟠 Queued; 🟡 Progress; ◻️ Skipped; ⚠️ Quarantine

NordicBuilder commented Jan 10, 2025

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

umapraseeda left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

divipillai left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

greg-fer commented Jan 9, 2025 •

edited

Loading

NordicBuilder commented Jan 9, 2025 •

edited

Loading