rtems/rtems-docs
1
0
Fork 0
mirror of https://git.rtems.org/rtems-docs/ synced 2025-07-04 02:31:41 +08:00
Code Issues Packages Projects Releases Wiki Activity

user: Update migration guide

Browse Source 
Update #3895.
This commit is contained in:
Sebastian Huber 2020-04-14 16:39:14 +02:00
parent ca6611241b
commit 02bded3f03
1 changed files with 44 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
user/migration/v4_11-to-v5.rst
View File

@ -1,6 +1,7 @@
.. SPDX-License-Identifier: CC-BY-SA-4.0 .. SPDX-License-Identifier: CC-BY-SA-4.0
.. Copyright (C) 2020 Chris Johns .. Copyright (C) 2020 Chris Johns
.. Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
.. _Migration_4_11_to_5: .. _Migration_4_11_to_5:
@ -10,14 +11,38 @@ RTEMS 4.11 to RTEMS 5
This section provides helpful information when migrating from RTEMS 4.11 to This section provides helpful information when migrating from RTEMS 4.11 to
RTEMS 5. RTEMS 5.
Configuration Application Configuration Options
------------- ---------------------------------
A number of configurations macros have moved as a result of internal changes in The evaluation of application configuration options in ``<rtems/confdefs.h>``
RTEMS. Some of these will produce a warning indicating the new configuration was reworked during the RTEMS 5 development cycle. All options which let the
setings you need to define. If you need to run an application on RTEMS 4.11 and user define data structures were removed, this includes
RTEMS 5 the following code exmaple shows how to conditionally define the
settings. The example is: * ``CONFIGURE_HAS_OWN_CONFIGURATION_TABLE``,
* ``CONFIGURE_HAS_OWN_BDBUF_TABLE``,
* ``CONFIGURE_HAS_OWN_DEVICE_DRIVER_TABLE``,
* ``CONFIGURE_HAS_OWN_FILESYSTEM_TABLE``,
* ``CONFIGURE_HAS_OWN_INIT_TABLE``,
* ``CONFIGURE_HAS_OWN_MOUNT_TABLE``,
* ``CONFIGURE_HAS_OWN_MULTIPROCESSING_TABLE``, and
* ``CONFIGURE_POSIX_HAS_OWN_INIT_THREAD_TABLE``.
The configuration of SMP schedulers changed. For example,
:c:func:`RTEMS_SCHEDULER_EDF_SMP` has now only one parameter. Please read
section `Clustered Scheduler Configuration` in the `RTEMS Classic API Guide`.
A number of configurations options have moved or are obsolete as a result of
internal changes in RTEMS. Some of these will produce a warning indicating the
new configuration settings you need to define. If you need to run an application
on RTEMS 4.11 and RTEMS 5 the following code example shows how to conditionally
define the settings. The example is:
.. code-block:: c .. code-block:: c
@ -37,6 +62,13 @@ settings. The example is:
#define CONFIGURE_MAXIMUM_FILE_DESCRIPTORS MAX_FILE_DESCRIPTORS #define CONFIGURE_MAXIMUM_FILE_DESCRIPTORS MAX_FILE_DESCRIPTORS
#endif #endif
Clock Manager
-------------
The directive :c:func:`rtems_clock_get` was removed. See section
`Transition Advice for the Removed rtems_clock_get()` in the
`RTEMS Classic API Guide` for alternatives.
Networking Networking
---------- ----------