Skip to content

Commit 29cbe21

Browse files
[nrfconnect] Updated documentation for all nrfconnect examples
Updated docs for all nrfconnect examples to: * be aligned with the most recent NCS 2.7.0 version * mention that the examples are not production ready and redirect to the production ready NCS Matter samples
1 parent 34462f1 commit 29cbe21

File tree

11 files changed

+198
-188
lines changed

11 files changed

+198
-188
lines changed

examples/all-clusters-app/nrfconnect/README.md

+23-17
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Matter nRF Connect All Clusters Example Application
22

3+
> **Note:** This example is intended only to perform smoke tests of a Matter
4+
> solution integrated with nRF Connect SDK platform. The example quality is not production ready
5+
> and it may contain minor bugs or use not optimal configuration. It is not recommended to use this
6+
> example as a basis for creating a market ready product.
7+
>
8+
> For the production ready and optimized Matter samples, see [nRF Connect SDK samples](https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/samples/matter.html). The Matter samples in nRF Connect SDK use various additional software components and provide multiple optional features that improve the developer and user experience. To read more about it, see [Matter support in nRF Connect SDK](https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/protocols/matter/index.html#ug-matter) page. Using Matter samples from nRF Connect SDK allows you to get a full Nordic technical support via [DevZone](https://devzone.nordicsemi.com/) portal.
9+
310
The nRF All Clusters Example Application implements various ZCL clusters
411
populated on three endpoints. You can use this example as a reference for
512
creating your own application.
@@ -85,10 +92,10 @@ The example supports building and running on the following devices:
8592

8693
| Hardware platform | Build target | Platform image |
8794
| ------------------------------------------------------------------------------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
88-
| [nRF52840 DK](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF52840-DK) | `nrf52840dk_nrf52840` | <details><summary>nRF52840 DK</summary><img src="../../platform/nrfconnect/doc/images/nRF52840_DK_info-medium.jpg" alt="nRF52840 DK"/></details> |
89-
| [nRF5340 DK](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF5340-DK) | `nrf5340dk_nrf5340_cpuapp` | <details><summary>nRF5340 DK</summary><img src="../../platform/nrfconnect/doc/images/nRF5340_DK_info-medium.jpg" alt="nRF5340 DK"/></details> |
90-
| [nRF52840 Dongle](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF52840-Dongle) | `nrf52840dongle_nrf52840` | <details><summary>nRF52840 Dongle</summary><img src="../../platform/nrfconnect/doc/images/nRF52840_Dongle-medium.jpg" alt="nRF52840 Dongle"/></details> |
91-
| [nRF7002 DK](https://www.nordicsemi.com/Products/Development-hardware/nRF7002-DK) | `nrf7002dk_nrf5340_cpuapp` | <details><summary>nRF7002 DK</summary><img src="../../platform/nrfconnect/doc/images/nRF7002-DK_Front-small.png" alt="nRF7002 DK"/></details> |
95+
| [nRF52840 DK](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF52840-DK) | `nrf52840dk/nrf52840` | <details><summary>nRF52840 DK</summary><img src="../../platform/nrfconnect/doc/images/nRF52840_DK_info-medium.jpg" alt="nRF52840 DK"/></details> |
96+
| [nRF5340 DK](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF5340-DK) | `nrf5340dk/nrf5340/cpuapp` | <details><summary>nRF5340 DK</summary><img src="../../platform/nrfconnect/doc/images/nRF5340_DK_info-medium.jpg" alt="nRF5340 DK"/></details> |
97+
| [nRF52840 Dongle](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF52840-Dongle) | `nrf52840dongle/nrf52840` | <details><summary>nRF52840 Dongle</summary><img src="../../platform/nrfconnect/doc/images/nRF52840_Dongle-medium.jpg" alt="nRF52840 Dongle"/></details> |
98+
| [nRF7002 DK](https://www.nordicsemi.com/Products/Development-hardware/nRF7002-DK) | `nrf7002dk/nrf5340/cpuapp` | <details><summary>nRF7002 DK</summary><img src="../../platform/nrfconnect/doc/images/nRF7002-DK_Front-small.png" alt="nRF7002 DK"/></details> |
9299

93100
<hr>
94101

@@ -97,9 +104,9 @@ The example supports building and running on the following devices:
97104
The development kits for this sample offer the following IPv6 network support
98105
for Matter:
99106

100-
- Matter over Thread is supported for `nrf52840dk_nrf52840` and
101-
`nrf5340dk_nrf5340_cpuapp`.
102-
- Matter over Wi-Fi is supported for `nrf7002dk_nrf5340_cpuapp`.
107+
- Matter over Thread is supported for `nrf52840dk/nrf52840` and
108+
`nrf5340dk/nrf5340/cpuapp`.
109+
- Matter over Wi-Fi is supported for `nrf7002dk/nrf5340/cpuapp`.
103110

104111
## Device UI
105112

@@ -248,14 +255,14 @@ Complete the following steps to build the sample:
248255
249256
2. Run the following command to build the example, with _build-target_ replaced
250257
with the build target name of the Nordic Semiconductor's kit you own, for
251-
example `nrf52840dk_nrf52840`:
258+
example `nrf52840dk/nrf52840`:
252259
253-
$ west build -b build-target
260+
$ west build -b build-target --sysbuild
254261
255262
You only need to specify the build target on the first build. See
256263
[Requirements](#requirements) for the build target names of compatible kits.
257264
258-
The output `zephyr.hex` file will be available in the `build/zephyr/` directory.
265+
The output `zephyr.hex` file will be available in the `build/nrfconnect/zephyr/` directory.
259266
260267
### Removing build artifacts
261268
@@ -270,7 +277,7 @@ following command:
270277
To build the example with release configuration that disables the diagnostic
271278
features like logs and command-line interface, run the following command:
272279
273-
$ west build -b build-target -- -DCONF_FILE=prj_release.conf
280+
$ west build -b build-target --sysbuild -- -DCONF_FILE=prj_release.conf
274281
275282
Remember to replace _build-target_ with the build target name of the Nordic
276283
Semiconductor's kit you own.
@@ -281,9 +288,9 @@ Support for DFU using Matter OTA is disabled by default.
281288
282289
To build the example with configuration that supports DFU, run the following
283290
command with _build-target_ replaced with the build target name of the Nordic
284-
Semiconductor kit you are using (for example `nrf52840dk_nrf52840`):
291+
Semiconductor kit you are using (for example `nrf52840dk/nrf52840`):
285292
286-
$ west build -b build-target -- -DCONF_FILE=prj_dfu.conf
293+
$ west build -b build-target --sysbuild -- -DCONF_FILE=prj_dfu.conf
287294
288295
> **Note**:
289296
>
@@ -299,7 +306,7 @@ Semiconductor kit you are using (for example `nrf52840dk_nrf52840`):
299306
#### Changing bootloader configuration
300307
301308
To change the default MCUboot configuration, edit the `prj.conf` file located in
302-
the `child_image/mcuboot` directory.
309+
the `sysbuild/mcuboot` directory.
303310
304311
#### Changing flash memory settings
305312
@@ -311,8 +318,7 @@ purposes. You can change these settings by defining
311318
This example uses this option to define using an external flash.
312319
313320
To modify the flash settings of your board (that is, your _build-target_, for
314-
example `nrf52840dk_nrf52840`), edit the `pm_static_dfu.yml` file located in the
315-
`configuration/build-target/` directory.
321+
example `nrf52840dk/nrf52840`), edit the `pm_static_<build_target>.yml` file (for example `pm_static_nrf52840dk_nrf52840.yml`), located in the main application directory.
316322
317323
<hr>
318324
@@ -324,7 +330,7 @@ using the menuconfig utility.
324330
To open the menuconfig utility, run the following command from the example
325331
directory:
326332
327-
$ west build -b build-target -t menuconfig
333+
$ west build -b build-target --sysbuild -t menuconfig
328334
329335
Remember to replace _build-target_ with the build target name of the Nordic
330336
Semiconductor's kit you own.

examples/all-clusters-minimal-app/nrfconnect/README.md

+19-13
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# Matter nRF Connect All Clusters Example Application
22

3+
> **Note:** This example is intended only to perform smoke tests of a Matter
4+
> solution integrated with nRF Connect SDK platform. The example quality is not production ready
5+
> and it may contain minor bugs or use not optimal configuration. It is not recommended to use this
6+
> example as a basis for creating a market ready product.
7+
>
8+
> For the production ready and optimized Matter samples, see [nRF Connect SDK samples](https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/samples/matter.html). The Matter samples in nRF Connect SDK use various additional software components and provide multiple optional features that improve the developer and user experience. To read more about it, see [Matter support in nRF Connect SDK](https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/protocols/matter/index.html#ug-matter) page. Using Matter samples from nRF Connect SDK allows you to get a full Nordic technical support via [DevZone](https://devzone.nordicsemi.com/) portal.
9+
310
The nRF All Clusters Example Application implements various ZCL clusters
411
populated on three endpoints. You can use this example as a reference for
512
creating your own application.
@@ -77,9 +84,9 @@ The example supports building and running on the following devices:
7784

7885
| Hardware platform | Build target | Platform image |
7986
| ------------------------------------------------------------------------------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
80-
| [nRF52840 DK](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF52840-DK) | `nrf52840dk_nrf52840` | <details><summary>nRF52840 DK</summary><img src="../../platform/nrfconnect/doc/images/nRF52840_DK_info-medium.jpg" alt="nRF52840 DK"/></details> |
81-
| [nRF5340 DK](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF5340-DK) | `nrf5340dk_nrf5340_cpuapp` | <details><summary>nRF5340 DK</summary><img src="../../platform/nrfconnect/doc/images/nRF5340_DK_info-medium.jpg" alt="nRF5340 DK"/></details> |
82-
| [nRF52840 Dongle](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF52840-Dongle) | `nrf52840dongle_nrf52840` | <details><summary>nRF52840 Dongle</summary><img src="../../platform/nrfconnect/doc/images/nRF52840_Dongle-medium.jpg" alt="nRF52840 Dongle"/></details> |
87+
| [nRF52840 DK](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF52840-DK) | `nrf52840dk/nrf52840` | <details><summary>nRF52840 DK</summary><img src="../../platform/nrfconnect/doc/images/nRF52840_DK_info-medium.jpg" alt="nRF52840 DK"/></details> |
88+
| [nRF5340 DK](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF5340-DK) | `nrf5340dk/nrf5340/cpuapp` | <details><summary>nRF5340 DK</summary><img src="../../platform/nrfconnect/doc/images/nRF5340_DK_info-medium.jpg" alt="nRF5340 DK"/></details> |
89+
| [nRF52840 Dongle](https://www.nordicsemi.com/Software-and-Tools/Development-Kits/nRF52840-Dongle) | `nrf52840dongle/nrf52840` | <details><summary>nRF52840 Dongle</summary><img src="../../platform/nrfconnect/doc/images/nRF52840_Dongle-medium.jpg" alt="nRF52840 Dongle"/></details> |
8390

8491
<hr>
8592

@@ -240,14 +247,14 @@ environment:
240247

241248
2. Run the following command to build the example, with _build-target_ replaced
242249
with the build target name of the Nordic Semiconductor's kit you own, for
243-
example `nrf52840dk_nrf52840`:
250+
example `nrf52840dk/nrf52840`:
244251

245-
$ west build -b build-target
252+
$ west build -b build-target --sysbuild
246253

247254
You only need to specify the build target on the first build. See
248255
[Requirements](#requirements) for the build target names of compatible kits.
249256

250-
The output `zephyr.hex` file will be available in the `build/zephyr/` directory.
257+
The output `zephyr.hex` file will be available in the `build/nrfconnect/zephyr/` directory.
251258

252259
### Removing build artifacts
253260

@@ -262,7 +269,7 @@ following command:
262269
To build the example with release configuration that disables the diagnostic
263270
features like logs and command-line interface, run the following command:
264271

265-
$ west build -b build-target -- -DCONF_FILE=prj_release.conf
272+
$ west build -b build-target --sysbuild -- -DCONF_FILE=prj_release.conf
266273

267274
Remember to replace _build-target_ with the build target name of the Nordic
268275
Semiconductor's kit you own.
@@ -273,9 +280,9 @@ Support for DFU using Matter OTA is disabled by default.
273280

274281
To build the example with configuration that supports DFU, run the following
275282
command with _build-target_ replaced with the build target name of the Nordic
276-
Semiconductor kit you are using (for example `nrf52840dk_nrf52840`):
283+
Semiconductor kit you are using (for example `nrf52840dk/nrf52840`):
277284

278-
$ west build -b build-target -- -DCONF_FILE=prj_dfu.conf
285+
$ west build -b build-target --sysbuild -- -DCONF_FILE=prj_dfu.conf
279286

280287
> **Note**:
281288
>
@@ -291,7 +298,7 @@ Semiconductor kit you are using (for example `nrf52840dk_nrf52840`):
291298
#### Changing bootloader configuration
292299

293300
To change the default MCUboot configuration, edit the `prj.conf` file located in
294-
the `child_image/mcuboot` directory.
301+
the `sysbuild/mcuboot` directory.
295302

296303
#### Changing flash memory settings
297304

@@ -303,8 +310,7 @@ purposes. You can change these settings by defining
303310
This example uses this option to define using an external flash.
304311

305312
To modify the flash settings of your board (that is, your _build-target_, for
306-
example `nrf52840dk_nrf52840`), edit the `pm_static_dfu.yml` file located in the
307-
`configuration/build-target/` directory.
313+
example `nrf52840dk/nrf52840`), edit the `pm_static_<build_target>.yml` file (for example `pm_static_nrf52840dk_nrf52840.yml`), located in the main application directory.
308314

309315
<hr>
310316

@@ -316,7 +322,7 @@ using the menuconfig utility.
316322
To open the menuconfig utility, run the following command from the example
317323
directory:
318324

319-
$ west build -b build-target -t menuconfig
325+
$ west build -b build-target --sysbuild -t menuconfig
320326

321327
Remember to replace _build-target_ with the build target name of the Nordic
322328
Semiconductor's kit you own.

examples/chef/nrfconnect/README.md

+7
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,12 @@
11
# CHIP nRF Connect SDK Shell Application
22

3+
> **Note:** This example is intended only to perform smoke tests of a Matter
4+
> solution integrated with nRF Connect SDK platform. The example quality is not production ready
5+
> and it may contain minor bugs or use not optimal configuration. It is not recommended to use this
6+
> example as a basis for creating a market ready product.
7+
>
8+
> For the production ready and optimized Matter samples, see [nRF Connect SDK samples](https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/samples/matter.html). The Matter samples in nRF Connect SDK use various additional software components and provide multiple optional features that improve the developer and user experience. To read more about it, see [Matter support in nRF Connect SDK](https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/protocols/matter/index.html#ug-matter) page. Using Matter samples from nRF Connect SDK allows you to get a full Nordic technical support via [DevZone](https://devzone.nordicsemi.com/) portal.
9+
310
A [chip-shell](../README.md) project for the Nordic nRF52840 and nRF5340
411
development kits, built using the nRF Connect SDK.
512

0 commit comments

Comments
 (0)