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

samples: Add nRF2220EK support for RT and DTM samples #21027

Merged
merged 1 commit into from
Mar 26, 2025

Conversation

dchat-nordic
Copy link
Contributor

Add nRF2220EK support for:

  • direct_test_mode
  • radio_test samples.

Jira: NCSDK-31910

@dchat-nordic dchat-nordic requested review from a team as code owners March 19, 2025 10:47
@github-actions github-actions bot added the doc-required PR must not be merged without tech writer approval. label Mar 19, 2025
@NordicBuilder
Copy link
Contributor

NordicBuilder commented Mar 19, 2025

CI Information

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

Inputs:

Sources:

sdk-nrf: PR head: c5709d287ac4d6528b431306124f952ddeb6b6e8

more details

sdk-nrf:

PR head: c5709d287ac4d6528b431306124f952ddeb6b6e8
merge base: e2245b18abbb77413b95fe5a27b336fb98a3a275
target head (main): 0b0505af66b488d263f472b2eec6283a7201abed
Diff

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 (6)
doc
│  ├── nrf
│  │  ├── includes
│  │  │  │ sample_dtm_radio_test_fem.txt
│  │  ├── releases_and_maturity
│  │  │  ├── releases
│  │  │  │  │ release-notes-changelog.rst
samples
│  ├── bluetooth
│  │  ├── direct_test_mode
│  │  │  ├── README.rst
│  │  │  │ sample.yaml
│  ├── peripheral
│  │  ├── radio_test
│  │  │  ├── README.rst
│  │  │  │ sample.yaml

Outputs:

Toolchain

Version: 4ffa2202d5
Build docker image: docker-dtr.nordicsemi.no/sw-production/ncs-build:4ffa2202d5_8bf7ca4353

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

  • ◻️ Toolchain - Skipped: existing toolchain is used
  • ✅ Build twister
    • sdk-nrf test count: 485
  • ✅ Integration tests
    • ✅ test-fw-nrfconnect-ble_samples
Disabled integration tests
    • desktop52_verification
    • doc-internal
    • test-fw-nrfconnect-apps
    • test-fw-nrfconnect-ble_mesh
    • test-fw-nrfconnect-boot
    • test-fw-nrfconnect-chip
    • test-fw-nrfconnect-fem
    • test-fw-nrfconnect-nfc
    • test-fw-nrfconnect-nrf-iot_cloud
    • test-fw-nrfconnect-nrf-iot_libmodem-nrf
    • test-fw-nrfconnect-nrf-iot_mosh
    • test-fw-nrfconnect-nrf-iot_positioning
    • test-fw-nrfconnect-nrf-iot_samples
    • test-fw-nrfconnect-nrf-iot_serial_lte_modem
    • test-fw-nrfconnect-nrf-iot_thingy91
    • test-fw-nrfconnect-nrf-iot_zephyr_lwm2m
    • test-fw-nrfconnect-nrf_crypto
    • test-fw-nrfconnect-proprietary_esb
    • test-fw-nrfconnect-ps
    • test-fw-nrfconnect-rpc
    • test-fw-nrfconnect-rs
    • test-fw-nrfconnect-tfm
    • test-fw-nrfconnect-thread
    • test-low-level
    • test-sdk-audio
    • test-sdk-dfu
    • test-sdk-find-my
    • test-sdk-mcuboot
    • test-sdk-pmic-samples
    • test-sdk-wifi
    • test-secdom-samples-public

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


To add support for the nRF21540 FEM, build the sample for a board containing nRF21540 FEM like :ref:`nrf21540dk/nrf52840 <zephyr:nrf21540dk_nrf52840>` or create a devicetree overlay file describing how FEM is connected to nRF5 SoC in your device.
To add support for the FEM, build the sample for a board containing FEM like :ref:`nrf21540dk/nrf52840 <zephyr:nrf21540dk_nrf52840>` or create a devicetree overlay file describing how FEM is connected to nRF5 SoC in your device.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To add support for the FEM, build the sample for a board containing FEM like :ref:`nrf21540dk/nrf52840 <zephyr:nrf21540dk_nrf52840>` or create a devicetree overlay file describing how FEM is connected to nRF5 SoC in your device.
To add support for the FEM, build the sample for a board containing FEM like :ref:`nRF21540 DK/nRF52840 <zephyr:nrf21540dk_nrf52840>` or create a devicetree overlay file describing how FEM is connected to the nRF52 Series SoC in your device.


.. note::
If you use the nRF21540 EK, append ``nrf21540ek`` shield to your build command instructing build system to append the appropriate devicetree overlay file.
If you use the nRF2220EK, append ``nrf2220ek`` shield to your build command instructing build system to append the appropriate devicetree overlay file.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you use the nRF2220EK, append ``nrf2220ek`` shield to your build command instructing build system to append the appropriate devicetree overlay file.
If you use the nRF2220 EK, append the ``nrf2220ek`` shield to your build command instructing the build system to append the appropriate devicetree overlay file.


.. include:: /includes/sample_dtm_radio_test_fem.txt

You can configure the transmitted power gain, antenna output and activation delay in nRF21540 using vendor-specific commands, see `Vendor-specific packet payload`_.
You can configure the transmitted power gain, antenna output and activation delay in FEMs using vendor-specific commands, see `Vendor-specific packet payload`_.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can configure the transmitted power gain, antenna output and activation delay in FEMs using vendor-specific commands, see `Vendor-specific packet payload`_.
You can configure the transmitted power gain, antenna output, and activation delay in FEMs using vendor-specific commands, see `Vendor-specific packet payload`_.


.. include:: /includes/sample_dtm_radio_test_fem.txt

You can configure the nRF21540 front-end module (FEM) transmitted power control, antenna output and activation delay using the main shell commands of the :ref:`radio_test_ui`.
You can configure the front-end module (FEM) transmitted power control, antenna output and activation delay using the main shell commands of the :ref:`radio_test_ui`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can configure the front-end module (FEM) transmitted power control, antenna output and activation delay using the main shell commands of the :ref:`radio_test_ui`.
You can configure the front-end module (FEM) transmitted power control, antenna output, and activation delay using the main shell commands of the :ref:`radio_test_ui`.

@@ -1,9 +1,10 @@
You can add support for the nRF21540 front-end module (FEM) to the sample.
You can add support for the nRF21540 or the nRF2220 front-end module (FEM) to the sample.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You can add support for the nRF21540 or the nRF2220 front-end module (FEM) to the sample.
You can add support for the nRF21540 or nRF2220 front-end module (FEM) to the sample.

Comment on lines 371 to 372
* Added loading of radio trims and a fix of a hardware errata for the nRF54H20 SoC to improve the RF performance.
* Added support for the ``nRF2220`` front-end module.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Added loading of radio trims and a fix of a hardware errata for the nRF54H20 SoC to improve the RF performance.
* Added support for the ``nRF2220`` front-end module.
* Added:
* Loading of radio trims and a fix of a hardware errata for the nRF54H20 SoC to improve the RF performance.
* Support for the nRF2220 front-end module.

Copy link
Contributor

@divipillai divipillai Mar 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Support for the :ref: nRF2220 front-end module <ug_radio_fem_nrf2220ek>.

Good to link to the Developing with the nRF2220 EK guide.

Comment on lines 582 to 583
* Added loading of radio trims and a fix of a hardware errata for the nRF54H20 SoC to improve the RF performance.
* Added support for the ``nRF2220`` front-end module.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Added loading of radio trims and a fix of a hardware errata for the nRF54H20 SoC to improve the RF performance.
* Added support for the ``nRF2220`` front-end module.
* Added:
* Loading of radio trims and a fix of a hardware errata for the nRF54H20 SoC to improve the RF performance.
* Support for the ``nRF2220`` front-end module.

Copy link
Contributor

@divipillai divipillai Mar 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Support for the :ref: nRF2220 front-end module <ug_radio_fem_nrf2220ek>.

Good to link to the Developing with the nRF2220 EK guide.

Copy link
Contributor

@grochu grochu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The code looks good, but I'd like to clarify details of different scenarios of power/gain control:

  • how does the CONFIG_DTM_POWER_CONTROL_AUTOMATIC option affect the nRF2220? Does this FEM allow an open-loop gain control at all? Is there a register where the direct gain value can be set if this option is disabled, when user sends the FEM_TX_POWER_CONTROL_SET command (length = 4 in a VS command)? Is the register value encoded the same way?
  • the same question goes for Radio Test

Please align these vendor-specific commands with the new FEM if needed. Maybe the CONFIG_DTM_POWER_CONTROL_AUTOMATIC option doesn't apply to nRF2220? Please align documentation in this aspect.
Additionally, antenna selection is not available for this FEM.

@dchat-nordic dchat-nordic marked this pull request as draft March 20, 2025 13:43
@dchat-nordic dchat-nordic marked this pull request as ready for review March 25, 2025 10:04
@dchat-nordic dchat-nordic force-pushed the fem22 branch 2 times, most recently from 6d7e72e to 4caefd6 Compare March 25, 2025 10:33
* Added:

* Loading of radio trims and a fix of a hardware errata for the nRF54H20 SoC to improve the RF performance.
* Support for the :ref: nRF2220 front-end module <ug_radio_fem_nrf2220ek>.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Support for the :ref: nRF2220 front-end module <ug_radio_fem_nrf2220ek>.
* Support for the :ref:`nRF2220 front-end module <ug_radio_fem_nrf2220ek>`.

* Added:

* Loading of radio trims and a fix of a hardware errata for the nRF54H20 SoC to improve the RF performance.
* Support for the :ref: nRF2220 front-end module <ug_radio_fem_nrf2220ek>.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* Support for the :ref: nRF2220 front-end module <ug_radio_fem_nrf2220ek>.
* Support for the :ref:`nRF2220 front-end module <ug_radio_fem_nrf2220ek>`.

Copy link
Contributor

@grochu grochu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Adding a doc related comment. Otherwise the PR looks good to me.


.. include:: /includes/sample_dtm_radio_test_fem.txt

You can configure the nRF21540 front-end module (FEM) transmitted power control, antenna output and activation delay using the main shell commands of the :ref:`radio_test_ui`.
You can configure the front-end module (FEM) transmitted power control, antenna output, and activation delay using the main shell commands of the :ref:`radio_test_ui`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a note to make it clear to the users, that each FEM has different interface and not all commands will work the same way, and some may not be supported, maybe something like:
Note: each front-end module (FEM) has different capabilities and operating modes, so some commands may not be supported by a specific FEM and those supported may work differently on different FEMs.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added


.. include:: /includes/sample_dtm_radio_test_fem.txt

You can configure the transmitted power gain, antenna output and activation delay in nRF21540 using vendor-specific commands, see `Vendor-specific packet payload`_.
You can configure the transmitted power gain, antenna output, and activation delay in FEMs using vendor-specific commands, see `Vendor-specific packet payload`_.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please add a note to make it clear to the users, that each FEM has different interface and not all commands will work the same way, and some may not be supported, maybe something like:
Note: each front-end module (FEM) has different capabilities and operating modes, so some commands may not be supported by a specific FEM and those supported may work differently on different FEMs.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added

You can configure the transmitted power gain, antenna output, and activation delay in FEMs using vendor-specific commands, see `Vendor-specific packet payload`_.

.. note::
Each front-end module (FEM) has different capabilities and operating modes, so some commands may not be supported by a specific front-end module (FEM) and those supported may work differently on different front-end modules (FEMs).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Each front-end module (FEM) has different capabilities and operating modes, so some commands may not be supported by a specific front-end module (FEM) and those supported may work differently on different front-end modules (FEMs).
Each front-end module (FEM) has different capabilities and operating modes, so some commands may not be supported by a specific FEM and those supported may work differently on different FEMs.

You can configure the front-end module (FEM) transmitted power control, antenna output, and activation delay using the main shell commands of the :ref:`radio_test_ui`.

.. note::
Each front-end module (FEM) has different capabilities and operating modes, so some commands may not be supported by a specific front-end module (FEM) and those supported may work differently on different front-end modules (FEMs).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Each front-end module (FEM) has different capabilities and operating modes, so some commands may not be supported by a specific front-end module (FEM) and those supported may work differently on different front-end modules (FEMs).
Each front-end module (FEM) has different capabilities and operating modes, so some commands may not be supported by a specific FEM and those supported may work differently on different FEMs.

Add nRF2220EK support for:
- direct_test_mode
- radio_test
samples.

Jira: NCSDK-31910

Signed-off-by: Dominik Chat <dominik.chat@nordicsemi.no>
@rlubos rlubos merged commit c8d1abe into nrfconnect:main Mar 26, 2025
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
doc-required PR must not be merged without tech writer approval.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants