Skip to content

Commit 5f335d3

Browse files
committed
app: Add overlay for UART1 hw-flow-control
1 parent 57b30a0 commit 5f335d3

3 files changed

Lines changed: 14 additions & 10 deletions

File tree

app/overlay-uart1-hwfc.overlay

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
/*
2+
* Copyright (c) 2026 Nordic Semiconductor ASA
3+
*
4+
* SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
5+
*/
6+
7+
&uart1 {
8+
hw-flow-control;
9+
};

doc/app/sm_configuration.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -303,5 +303,9 @@ The following configuration files are provided:
303303
This overlay can be used if your setup does not have the need or means for managing the power externally.
304304
Modify the overlay to fit your configuration.
305305

306+
* :file:`overlay-uart1-hwfc.overlay` - Devicetree overlay that enables hardware flow control on UART 1.
307+
This is needed when capturing modem traces and application debug logs simultaneously.
308+
See the :ref:`sm_logging` documentation for more information.
309+
306310
The board-specific devicetree overlays (:file:`boards/*.overlay`) set up configurations that are specific to each supported development kit.
307311
All of them configure the DTR to be deasserted from a button and RI to blink an LED.

doc/app/sm_logging.rst

Lines changed: 1 addition & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -59,16 +59,7 @@ Use the `Cellular Monitor app`_ for capturing and analyzing modem traces.
5959
Modem traces captured through UART are corrupted if application logs through RTT are simultaneously captured.
6060
When capturing modem traces through UART with the `Cellular Monitor app`_ and simultaneously capturing RTT logs, for example, with J-Link RTT Viewer, the modem trace misses packets, and captured packets might have incorrect information.
6161

62-
If you need to capture modem traces and RTT logs at the same time, enable HW flow control for modem trace UART.
63-
This can be done for the `nRF9151 DK <nrf9151dk_>`_ by adding the following change to :file:`app/boards/nrf9151dk_nrf9151_ns.overlay`:
64-
65-
.. parsed-literal::
66-
:class: highlight
67-
68-
&uart1 {
69-
hw-flow-control;
70-
};
71-
62+
If you need to capture modem traces and RTT logs at the same time, enable HW flow control for modem trace UART (``-DEXTRA_DTC_OVERLAY_FILE=overlay-uart1-hwfc.overlay``).
7263
Otherwise, you can choose not to capture RTT logs.
7364
Having only RTT logs enabled does not cause this issue.
7465

0 commit comments

Comments
 (0)