Skip to content

Conversation

@nordic-hani
Copy link
Contributor

  • Clean up the page to use the concept of "modem firmware products".
  • The cellular variant of libmodem actually supports three different modem firmware products.
  • Added example of exceptions from the table.
  • Altered the existing note to become a footnote for the "AT" entry.

@github-actions github-actions bot added the doc-required PR must not be merged without tech writer approval. label Nov 26, 2025
@nordic-hani nordic-hani force-pushed the doc_variants_features branch from 5bbd793 to 887051c Compare November 26, 2025 12:38
@nordic-hani nordic-hani changed the title doc: libmodem: clean up the variants and feature page doc: nrf_modem: clean up the variants and feature page Nov 26, 2025
NordicBuilder added a commit to NordicBuilder/sdk-nrf that referenced this pull request Nov 26, 2025
Automatically created by action-manifest-pr GH action from PR:
nrfconnect/sdk-nrfxlib#1935

Signed-off-by: Nordic Builder <pylon@nordicsemi.no>
* Clean up the page to use wording "modem firmware".
* The cellular variant of libmodem actually supports three different
  modem firmware products.
* Added example of exceptions from the table.
* Altered the existing note to become a footnote for the "AT" entry.

Signed-off-by: Håvard Vermeer <havard.vermeer@nordicsemi.no>
@nordic-hani nordic-hani force-pushed the doc_variants_features branch from 887051c to 8e0a699 Compare December 11, 2025 15:04
@nordic-hani nordic-hani marked this pull request as ready for review December 11, 2025 15:05
@nordic-hani nordic-hani requested review from a team as code owners December 11, 2025 15:05
@sonarqubecloud
Copy link

NordicBuilder added a commit to NordicBuilder/sdk-nrf that referenced this pull request Dec 11, 2025
Automatically created by action-manifest-pr GH action from PR:
nrfconnect/sdk-nrfxlib#1935

Signed-off-by: Nordic Builder <pylon@nordicsemi.no>
#####################

The Modem library comes in two variants, each with a specific feature set and support for a specific variant of the nRF91 Series firmware.
The Modem library comes in two *variants*, each with a specific feature set and support for the equivalent *modem firmware*.
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
The Modem library comes in two *variants*, each with a specific feature set and support for the equivalent *modem firmware*.
The Modem library comes in two variants, each with a specific feature set and support for the equivalent modem firmware.

I think these need not be in italics as these are normal terms used in the docs.


* mfw-nr+_nrf91x1

Features that are common across *modem firmware*, are also common across *Modem library variants*.
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
Features that are common across *modem firmware*, are also common across *Modem library variants*.
Features that are common across modem firmware are also common across Modem library variants.

| :ref:`nrf_modem_rs_capture_api` | :file:`nrf_modem_rs_capture.h` | No | Yes | Yes | No |
+---------------------------------+--------------------------------+-------------+-------------+-----------------+-----------------+

.. [#at-note] Although the Modem library AT interface is fully supported by both Modem library variants, the AT command set supported by the cellular modem firmware and the DECT NR+ modem firmware is different.
Copy link
Contributor

Choose a reason for hiding this comment

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

Could remove the footnote as it is not used in the table.

.. note::
Although the Modem library AT interface is fully supported by both Modem library variants, the AT command set supported by the cellular and DECT NR+ PHY firmware is different.
The different APIs may have certain subsets of functionality that are only supported by certain modem firmware and modem firmware versions.
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
The different APIs may have certain subsets of functionality that are only supported by certain modem firmware and modem firmware versions.
The different APIs might have certain subsets of functionality that are only supported by certain modem firmware and modem firmware versions.

.. note::
Although the Modem library AT interface is fully supported by both Modem library variants, the AT command set supported by the cellular and DECT NR+ PHY firmware is different.
The different APIs may have certain subsets of functionality that are only supported by certain modem firmware and modem firmware versions.
For example, :ref:`nrf_sockets` is supported for all cellular firmware products (and Modem library variants), but the socket option ``NRF_SO_SEC_CIPHERSUITE_USED`` is not suported by mfw_nrf9160.
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
For example, :ref:`nrf_sockets` is supported for all cellular firmware products (and Modem library variants), but the socket option ``NRF_SO_SEC_CIPHERSUITE_USED`` is not suported by mfw_nrf9160.
For example, :ref:`nrf_sockets` is supported for all cellular firmware (and Modem library variants), but the socket option ``NRF_SO_SEC_CIPHERSUITE_USED`` is not supported by mfw_nrf9160.

Comment on lines +60 to +65
Exceptions like this are documented with notes like the one below:

.. code-block:: c
/**
* @note This is only supported by the following modem firmware products:
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
Exceptions like this are documented with notes like the one below:
.. code-block:: c
/**
* @note This is only supported by the following modem firmware products:
Exceptions like this are documented with notes like the following in the header files:
.. code-block:: c
/**
* @note This is only supported by the following modem firmware:

Maybe we could mention that it is documented in the header file?

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.

3 participants