Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: tfm: Add documentation regarding configurable build #19562

Merged
merged 1 commit into from
Feb 6, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions doc/nrf/app_dev/device_guides/nrf53/logging_nrf5340.rst
Original file line number Diff line number Diff line change
Expand Up @@ -67,3 +67,30 @@ To use the middle COM port in the nRF5340 DK v1.0.0, complete the following step
};
#. Wire the previously mapped pins to **TxD**, **RxD**, **CTS**, and **RTS** on the **P24** connector.


.. _nrf5430_tfm_log:

Log output from TF-M on nRF5340 DK
**********************************

By default, the nRF5340 DK v1.0.0 requires that you connect specific wires on the kit to receive secure logs on the host PC.
Specifically, wire the pins **P0.25** and **P0.26** of the **P2** connector to **RxD** and **TxD** of the **P24** connector respectively.

On the nRF5340 DK v2.0.0, only two virtual COM ports are available.
By default, one of the ports is used by the non-secure UART0 peripheral from the application and the other by the UART1 peripheral from the network core.

There are several options to get UART output from the secure TF-M:

* Disable the output for the network core and change the pins used by TF-M.
The network core usually has a child image.
To configure logging in an |NCS| image, see :ref:`ug_logging`.
To change the pins used by TF-M, set the RXD (:kconfig:option:`CONFIG_TFM_UART1_RXD_PIN`) and TXD (:kconfig:option:`CONFIG_TFM_UART1_TXD_PIN`) Kconfig options in the application image to **P1.00** (32) and **P1.01** (33).

* You can wire the secure and non-secure UART peripherals to the same pins.
Specifically, physically wire together the pins **P0.25** and **P0.26** to **P0.20** and **P0.22**, respectively.

* If the non-secure application, network core, and TF-M outputs are all needed simultaneously, additional UART-to-USB hardware is needed.
You can use a second DK if available.
Connect the **P0.25** pin to the TXD pin, and **P0.26** to the RXD pin of the external hardware.
These pins provide the secure TF-M output, while the two native COM ports of the DK are used for the non-secure application and network core output.
184 changes: 184 additions & 0 deletions doc/nrf/images/nrf-secure-rom-granularity.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading