2017-04-06 05:35:39 +08:00
|
|
|
.. _zephyr_release_notes:
|
|
|
|
|
|
2023-02-28 23:39:25 +08:00
|
|
|
Releases
|
|
|
|
|
########
|
2017-01-04 03:38:53 +08:00
|
|
|
|
2017-06-17 08:04:24 +08:00
|
|
|
Zephyr project is provided as source code and build scripts for different
|
|
|
|
|
target architectures and configurations, and not as a binary image. Updated
|
2023-02-28 23:39:25 +08:00
|
|
|
versions of the Zephyr project are released approximately every four months.
|
2017-06-17 08:04:24 +08:00
|
|
|
|
2018-11-12 23:56:09 +08:00
|
|
|
All Zephyr project source code is maintained in a `GitHub repository`_.
|
2017-06-17 08:04:24 +08:00
|
|
|
|
2023-02-28 23:39:25 +08:00
|
|
|
Release Life Cycle and Maintenance
|
|
|
|
|
**********************************
|
|
|
|
|
|
|
|
|
|
Periodic Releases
|
|
|
|
|
=================
|
|
|
|
|
|
|
|
|
|
The Zephyr project provides periodic releases every 4 months leading to the
|
|
|
|
|
long term support releases approximately every 2 years. Periodic and non-LTS
|
|
|
|
|
releases are maintained with updates, bug fixes and security related updates
|
|
|
|
|
for at least two cycles, meaning that the project supports the most recent two
|
|
|
|
|
releases in addition to the most recent LTS.
|
|
|
|
|
|
|
|
|
|
Long Term Support and Maintenance
|
|
|
|
|
=================================
|
|
|
|
|
|
|
|
|
|
A Zephyr :ref:`Long Term Support (LTS) <release_process_lts>` release is
|
|
|
|
|
published every 2 years and is branched and maintained independently from the
|
|
|
|
|
main tree for at least 2.5 years after it was released.
|
|
|
|
|
|
|
|
|
|
Support and maintenance for an LTS release stops at least half a year
|
|
|
|
|
after the following LTS release is published.
|
|
|
|
|
|
|
|
|
|
Security Fixes
|
|
|
|
|
==============
|
|
|
|
|
|
|
|
|
|
Each security issue fixed within Zephyr is backported or submitted to the
|
|
|
|
|
following releases:
|
|
|
|
|
|
|
|
|
|
- Currently supported Long Term Support (LTS) release.
|
|
|
|
|
|
|
|
|
|
- The most recent two releases.
|
|
|
|
|
|
|
|
|
|
For more information, see :ref:`Security Vulnerability Reporting <reporting>`.
|
|
|
|
|
|
|
|
|
|
|
2023-02-28 23:58:31 +08:00
|
|
|
Supported Releases
|
|
|
|
|
******************
|
|
|
|
|
|
|
|
|
|
+-----------------+----------------+---------------+
|
|
|
|
|
| Release | Release date | EOL |
|
|
|
|
|
+=================+================+===============+
|
2023-06-23 17:54:50 +08:00
|
|
|
| `Zephyr 2.7.5`_ | 2023-06-01 | 2024-08-31 |
|
2023-02-28 23:58:31 +08:00
|
|
|
+-----------------+----------------+---------------+
|
2023-06-23 17:56:35 +08:00
|
|
|
| `Zephyr 3.4.0`_ | 2023-06-16 | 2024-02-29 |
|
|
|
|
|
+-----------------+----------------+---------------+
|
2023-06-23 17:54:50 +08:00
|
|
|
| `Zephyr 3.3.0`_ | 2023-02-19 | 2023-10-31 |
|
2023-02-28 23:58:31 +08:00
|
|
|
+-----------------+----------------+---------------+
|
|
|
|
|
|
2023-06-23 17:54:50 +08:00
|
|
|
As of 2022-01-01, LTS1 (1.14.x) is not supported and has reached end of life (EOL).
|
2023-02-28 23:58:31 +08:00
|
|
|
|
2023-02-28 23:39:25 +08:00
|
|
|
Release Notes
|
|
|
|
|
*************
|
|
|
|
|
|
2018-11-12 23:56:09 +08:00
|
|
|
For Zephyr versions up to 1.13, you can either download source as a tar.gz file
|
|
|
|
|
(see the bottom of the `GitHub tagged releases`_ page corresponding to each
|
|
|
|
|
release), or clone the GitHub repository.
|
2017-06-17 08:04:24 +08:00
|
|
|
|
2018-11-12 23:56:09 +08:00
|
|
|
With the introduction of the :ref:`west` tool after the release of Zephyr 1.13,
|
|
|
|
|
it is no longer recommended to download or clone the source code manually.
|
|
|
|
|
Instead we recommend you follow the instructions in :ref:`get_the_code` to do
|
|
|
|
|
so with the help of west.
|
2017-06-17 08:04:24 +08:00
|
|
|
|
2017-08-03 02:05:59 +08:00
|
|
|
The project's technical documentation is also tagged to correspond with a
|
2017-12-06 02:49:31 +08:00
|
|
|
specific release and can be found at https://docs.zephyrproject.org/.
|
2017-06-17 08:04:24 +08:00
|
|
|
|
2017-04-02 22:25:31 +08:00
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 1
|
2019-09-07 01:24:34 +08:00
|
|
|
:glob:
|
|
|
|
|
:reversed:
|
2017-03-14 07:37:14 +08:00
|
|
|
|
2023-10-17 07:14:23 +08:00
|
|
|
eol_releases
|
|
|
|
|
release-notes-2.7
|
|
|
|
|
release-notes-3.[3-5]
|
2017-12-06 02:49:31 +08:00
|
|
|
|
2023-08-31 22:19:08 +08:00
|
|
|
Migration Guides
|
|
|
|
|
****************
|
|
|
|
|
|
|
|
|
|
Zephyr provides migration guides for all major releases, in order to assist
|
|
|
|
|
users transition from the previous release.
|
|
|
|
|
|
|
|
|
|
.. toctree::
|
|
|
|
|
:maxdepth: 1
|
|
|
|
|
:glob:
|
|
|
|
|
:reversed:
|
|
|
|
|
|
|
|
|
|
migration-guide-*
|
|
|
|
|
|
2017-12-06 02:49:31 +08:00
|
|
|
.. _`GitHub repository`: https://github.com/zephyrproject-rtos/zephyr
|
|
|
|
|
.. _`GitHub tagged releases`: https://github.com/zephyrproject-rtos/zephyr/tags
|
2023-06-01 23:13:30 +08:00
|
|
|
.. _`Zephyr 2.7.5`: https://docs.zephyrproject.org/2.7.5/
|
2023-02-28 23:58:31 +08:00
|
|
|
.. _`Zephyr 3.3.0`: https://docs.zephyrproject.org/3.3.0/
|
2023-06-23 17:56:35 +08:00
|
|
|
.. _`Zephyr 3.4.0`: https://docs.zephyrproject.org/3.4.0/
|
