michaelh/zephyr
1
0
Fork 0
Code Releases Activity

native_posix docs: Warn users about the deprecation

Browse source 
So they switch to native_sim.

Signed-off-by: Alberto Escolar Piedras <alberto.escolar.piedras@nordicsemi.no>
This commit is contained in:
Alberto Escolar Piedras 2024-08-09 17:24:20 +02:00 • committed by Anas Nashif
commit 84ce8221bb
1 changed files with 9 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

18
boards/native/native_posix/doc/index.rst
View file

@ -11,6 +11,15 @@ Native POSIX execution (native_posix)
Overview Overview
******** ********
.. warning::
``native_posix`` is deprecated in favour of :ref:`native_sim<native_sim>`, and will be removed
in the 4.2 release.
.. note::
For native_posix users, if needed, :ref:`native_sim<native_sim>` includes a compatibility mode
:kconfig:option:`CONFIG_NATIVE_SIM_NATIVE_POSIX_COMPAT`,
which will set its configuration to mimic a native_posix-like configuration.
``native_posix`` is the predecessor of :ref:`native_sim<native_sim>`. ``native_posix`` is the predecessor of :ref:`native_sim<native_sim>`.
Just like with :ref:`native_sim<native_sim>` you can build your Zephyr application Just like with :ref:`native_sim<native_sim>` you can build your Zephyr application
with the Zephyr kernel, creating a normal Linux executable with your host tooling, with the Zephyr kernel, creating a normal Linux executable with your host tooling,
@ -19,15 +28,6 @@ and can debug and instrument it like any other Linux program.
But unlike with :ref:`native_sim<native_sim>` you are limited to only using the host C library. But unlike with :ref:`native_sim<native_sim>` you are limited to only using the host C library.
:ref:`native_sim<native_sim>` supports all ``native_posix`` use cases. :ref:`native_sim<native_sim>` supports all ``native_posix`` use cases.
.. note::
| If you are a new user, you are encouraged to use :ref:`native_sim<native_sim>` directly.
| If you have been using native_posix you are recommended to start using
:ref:`native_sim<native_sim>` instead.
| If needed, :ref:`native_sim<native_sim>` includes a compatibility mode
:kconfig:option:`CONFIG_NATIVE_SIM_NATIVE_POSIX_COMPAT`,
which will set its configuration to mimic a native_posix's like configuration.
This board does not intend to simulate any particular HW, but it provides This board does not intend to simulate any particular HW, but it provides
a few peripherals such as an Ethernet driver, display, UART, etc., to enable a few peripherals such as an Ethernet driver, display, UART, etc., to enable
developing and testing application code which would require them. developing and testing application code which would require them.