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
Copy file name to clipboardExpand all lines: doc/nrf/app_dev/device_guides/nrf91/nrf91_snippet.rst
+97-20Lines changed: 97 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,12 +40,31 @@ nRF91 modem traces with flash backend using snippets
40
40
The ``nrf91-modem-trace-ext-flash`` snippet enables modem tracing, the flash backend, and external flash and configures them to store modem traces to a dedicated partition on the external flash for supported boards.
41
41
To change the partition size, the project needs to configure the :kconfig:option:`CONFIG_NRF_MODEM_LIB_TRACE_BACKEND_FLASH_PARTITION_SIZE` Kconfig option.
42
42
43
-
To enable modem traces with the flash backend, use the following command pattern, where *board_target* corresponds to your board target and `<image_name>` to your application image name:
43
+
To enable modem traces with the flash backend, add the ``nrf91-modem-trace-ext-flash`` snippet to the :term:`build configuration`.
44
+
You can do this in one of the following ways:
44
45
45
-
.. parsed-literal::
46
-
:class: highlight
46
+
.. tabs::
47
+
48
+
.. group-tab:: west
49
+
50
+
To add the modem traces with the flash backend snippet when building an application with west, use the following command pattern, where *board_target* corresponds to your board target and `<image_name>` to your application image name:
47
51
48
-
west build --board *board_target* -- -D<image_name>_SNIPPET="nrf91-modem-trace-ext-flash"
52
+
.. parsed-literal::
53
+
:class: highlight
54
+
55
+
west build --board *board_target* -- -D<image_name>_SNIPPET="nrf91-modem-trace-ext-flash"
56
+
57
+
.. group-tab:: CMake
58
+
59
+
To add the modem traces with the flash backend snippet when building an application with CMake, add the following command to the CMake arguments:
To build with the |nRFVSC|, specify ``-D<image_name>_SNIPPET="nrf91-modem-trace-ext-flash" [...]`` in the **Extra CMake arguments** field.
66
+
67
+
See :ref:`cmake_options` for more details.
49
68
50
69
.. _nrf91_modem_trace_ram_snippet:
51
70
@@ -55,12 +74,31 @@ nRF91 modem traces with RAM backend using snippets
55
74
The ``nrf91-modem-trace-ram`` snippet enables modem tracing and configures it to store modem traces to a dedicated partition on the RAM.
56
75
To change the partition size, the project needs to configure the :kconfig:option:`CONFIG_NRF_MODEM_LIB_TRACE_BACKEND_RAM_LENGTH` Kconfig option.
57
76
58
-
To enable modem traces with the RAM backend, use the following command pattern, where *board_target* corresponds to your board target and `<image_name>` to your application image name:
77
+
To enable modem traces with the RAM backend, add the ``nrf91-modem-trace-ram`` snippet to the :term:`build configuration`.
78
+
You can do this in one of the following ways:
59
79
60
-
.. parsed-literal::
61
-
:class: highlight
80
+
.. tabs::
81
+
82
+
.. group-tab:: west
83
+
84
+
To add modem traces with the RAM backend when building an application with west, use the following command pattern, where *board_target* corresponds to your board target and `<image_name>` to your application image name:
62
85
63
-
west build --board *board_target* -- -D<image_name>_SNIPPET="nrf91-modem-trace-ram"
86
+
.. parsed-literal::
87
+
:class: highlight
88
+
89
+
west build --board *board_target* -- -D<image_name>_SNIPPET="nrf91-modem-trace-ram"
90
+
91
+
.. group-tab:: CMake
92
+
93
+
To add the modem traces with the RAM backend snippet when building an application with CMake, add the following command to the CMake arguments:
To build with the |nRFVSC|, specify ``-D<image_name>_SNIPPET="nrf91-modem-trace-ram" [...]`` in the **Extra CMake arguments** field.
100
+
101
+
See :ref:`cmake_options` for more details.
64
102
65
103
.. _nrf91_modem_trace_uart_snippet:
66
104
@@ -74,8 +112,8 @@ If this configuration does not match your requirements, you can add a snippet or
74
112
.. note::
75
113
If you are using the nRF9160 DK, remember to :ref:`set the board controller switch to the **nRF91** position <build_pgm_nrf9160_board_controller>` before programming.
76
114
77
-
To enable modem tracing with the UART trace backend on a nRF91 device, add the ``nrf91-modem-trace-uart`` snippet to the :term:`build configuration`.
78
-
This can be done in one of the following ways:
115
+
To enable modem tracing with the UART trace backend on a nRF91 Series device, add the ``nrf91-modem-trace-uart`` snippet to the :term:`build configuration`.
116
+
You can do this in one of the following ways:
79
117
80
118
.. tabs::
81
119
@@ -98,7 +136,7 @@ This can be done in one of the following ways:
To build with the |nRFVSC|, specify ``-D<image_name>_SNIPPET="nrf91-modem-trace-uart" [...]`` in the **Extra CMake arguments** field.
104
142
@@ -111,22 +149,61 @@ nRF91 modem traces with RTT backend using snippets
111
149
112
150
The ``nrf91-modem-trace-rtt`` snippet enables the :kconfig:option:`CONFIG_NRF_MODEM_LIB_TRACE` Kconfig option and chooses the RTT trace backend with the necessary Kconfig options.
113
151
114
-
To enable modem traces with the RTT backend, use the following command pattern, where *board_target* corresponds to your board target and `<image_name>` to your application image name:
152
+
To enable modem tracing with the RTT backend, add the ``nrf91-modem-trace-rtt`` snippet to the :term:`build configuration`.
153
+
You can do this in one of the following ways:
115
154
116
-
.. parsed-literal::
117
-
:class: highlight
155
+
.. tabs::
156
+
157
+
.. group-tab:: west
158
+
159
+
To add modem traces with the RTT backend when building an application with west, use the following command pattern, where *board_target* corresponds to your board target and `<image_name>` to your application image name:
118
160
119
-
west build --board *board_target* -- -D<image_name>_SNIPPET="nrf91-modem-trace-rtt"
161
+
.. parsed-literal::
162
+
:class: highlight
163
+
164
+
west build --board *board_target* -- -D<image_name>_SNIPPET="nrf91-modem-trace-rtt"
165
+
166
+
.. group-tab:: CMake
167
+
168
+
To add the modem traces with the RTT backend snippet when building an application with CMake, add the following command to the CMake arguments:
To build with the |nRFVSC|, specify ``-D<image_name>_SNIPPET="nrf91-modem-trace-rtt" [...]`` in the **Extra CMake arguments** field.
175
+
176
+
See :ref:`cmake_options` for more details.
120
177
121
178
.. _tfm_enable_share_uart:
122
179
123
180
Shared UART for application and TF-M logging
124
181
********************************************
125
182
126
-
If you want to activate TF-M logging while having modem traces enabled, it can be useful to direct the TF-M logs to the UART (**UART0**) used by the application.
127
-
To activate both modem traces and TF-M logs, use the following command pattern, where *board_target* corresponds to your board target:
183
+
If you want to activate TF-M logging while having modem traces with the UART backend enabled, it can be useful to direct the TF-M logs to the UART (**UART0**) used by the application.
184
+
185
+
To enable modem traces and TF-M logs, add the ``nrf91-modem-trace-uart`` and ``tfm-enable-share-uart`` snippets to the :term:`build configuration`.
186
+
You can do this in one of the following ways:
128
187
129
-
.. parsed-literal::
130
-
:class: highlight
188
+
.. tabs::
131
189
132
-
west build --board *board_target* -S nrf91-modem-trace-uart -S tfm-enable-share-uart
190
+
.. group-tab:: west
191
+
192
+
To activate both modem traces and TF-M logs when building an application with west, use the following command pattern, where *board_target* corresponds to your board target:
193
+
194
+
.. parsed-literal::
195
+
:class: highlight
196
+
197
+
west build --board *board_target* -S nrf91-modem-trace-uart -S tfm-enable-share-uart
198
+
199
+
.. group-tab:: CMake
200
+
201
+
To activate TF-M logs when building an application with CMake, add the following command to the CMake arguments:
0 commit comments