|
| 1 | +.. |
| 2 | + # ******************************************************************************* |
| 3 | + # Copyright (c) 2025 Contributors to the Eclipse Foundation |
| 4 | + # |
| 5 | + # See the NOTICE file(s) distributed with this work for additional |
| 6 | + # information regarding copyright ownership. |
| 7 | + # |
| 8 | + # This program and the accompanying materials are made available under the |
| 9 | + # terms of the Apache License Version 2.0 which is available at |
| 10 | + # https://www.apache.org/licenses/LICENSE-2.0 |
| 11 | + # |
| 12 | + # SPDX-License-Identifier: Apache-2.0 |
| 13 | + # ******************************************************************************* |
| 14 | +
|
| 15 | +S-Core v0.5-alpha release notes |
| 16 | +=============================== |
| 17 | + |
| 18 | +.. document:: S-Core v0.5-alpha release note |
| 19 | + :id: doc__score_v05_alpha_release_note |
| 20 | + :status: draft |
| 21 | + :safety: ASIL_B |
| 22 | + :realizes: PROCESS_wp__platform_sw_release_note |
| 23 | + |
| 24 | +| **Platform Name**: S-CORE |
| 25 | +| **Release Tag**: v0.5.0-alpha |
| 26 | +| **Origin Release Tag**: none - first published release |
| 27 | +| **Release Commit Hash**: <add hash> |
| 28 | +| **Release Date**: 2025-11-11 |
| 29 | +
|
| 30 | +Overview |
| 31 | +^^^^^^^^^ |
| 32 | + |
| 33 | +This document provides an overview of the changes, improvements, and bug fixes included in the software platform release version v0.5.0-alpha. |
| 34 | +This is the very first release of the **Eclipse S-Core platform**. The software architectue and implemented modules are presented at the image below. |
| 35 | + |
| 36 | +.. image:: ../_assets/architecture.drawio.svg |
| 37 | + :width: 1000 |
| 38 | + :alt: Architecture overview |
| 39 | + :align: center |
| 40 | + |
| 41 | +| |
| 42 | +
|
| 43 | +Timeline |
| 44 | +--------- |
| 45 | +The current timeline for Eclipse S-Core releases is shown below. |
| 46 | + |
| 47 | +.. image:: ../_assets/score_release_plan.drawio.svg |
| 48 | + :width: 800 |
| 49 | + :alt: Architecture overview |
| 50 | + :align: center |
| 51 | + |
| 52 | +| |
| 53 | +
|
| 54 | +For more detailed planning overview please check our `GitHub project <https://github.com/orgs/eclipse-score/projects/17/views/26>`_. |
| 55 | + |
| 56 | +S-Core book |
| 57 | +------------ |
| 58 | +First version of **Eclipse S-Core book**, that can be used as "how-to" for all who wants to start with S-Core project, can be found here: TODO Link. |
| 59 | +This book provides explanation of general concepts of **Eclipse S-Core project** and contains a "step-by-step" guide for building a first application |
| 60 | +based on Eclipse S-Core platform modules. |
| 61 | + |
| 62 | +New Features |
| 63 | +^^^^^^^^^^^^^ |
| 64 | + |
| 65 | +- **Inter-process Communication** |
| 66 | +- **Base libs** |
| 67 | +- **Fixed execution order framework** |
| 68 | +- **Logging** |
| 69 | +- **Persistency Key-Value-Storage** |
| 70 | +- **Reference integration** |
| 71 | + |
| 72 | +Improvements |
| 73 | +^^^^^^^^^^^^^ |
| 74 | + |
| 75 | +- please consider release notes of every module |
| 76 | + |
| 77 | +Bug Fixes |
| 78 | +^^^^^^^^^^^^ |
| 79 | + |
| 80 | +- please consider release notes of every module |
| 81 | + |
| 82 | +Integrated Software Modules |
| 83 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 84 | + |
| 85 | +- **Communication**: (Version). Link to Software module release note. |
| 86 | +- **FEO**: (Version). Link to Software module release note. |
| 87 | +- **Logging**: (Version). Link to Software module release note. |
| 88 | +- **Tracing**: (Version). Link to Software module release note. |
| 89 | +- **Baselibs**: (Version). Link to Software module release note. |
| 90 | +- **OS**: (Version). Link to Software module release note (external module). |
| 91 | +- **Persistency**: (Version). Link to Software module release note. |
| 92 | +- **Reference integration**: central place for integration of Eclipse S-Core modules |
| 93 | + |
| 94 | + - **Link to release**: tbd |
| 95 | + - **Release notes** |
| 96 | + |
| 97 | + - Provides reference QNX x86_64 qemu image, for usage see `reference integration README <https://github.com/eclipse-score/reference_integration/blob/main/qnx_qemu/README.md>`_ |
| 98 | + - Provides integration of all 0.5 modules including `scrample demo application <https://github.com/eclipse-score/scrample>`_ |
| 99 | + - Provides `basic itf tests <https://github.com/eclipse-score/reference_integration/tree/main/qnx_qemu/test/itf>`_. |
| 100 | + Check following `build commands <https://github.com/eclipse-score/reference_integration/tree/main/qnx_qemu#build-commands>`_ for running itf tests locally and for other important commands. |
| 101 | + - Provide CI/CD workflows to ensure stability of the reference integration: |
| 102 | + |
| 103 | + - `build and test on every pr <https://github.com/eclipse-score/reference_integration/blob/main/.github/workflows/build_and_test_on_every_pr.yml>`_ executes all itf tests in reference qnx image on every pr |
| 104 | + to ensure that the image is still functional |
| 105 | + - `release verification <https://github.com/eclipse-score/reference_integration/blob/main/.github/workflows/release_verification.yml>`_ does the same on every release |
| 106 | + - `test integration <https://github.com/eclipse-score/reference_integration/blob/main/.github/workflows/test_integration.yml>`_ for every pr and on every release builds all functional modules of Eclipse S-Core v0.5 |
| 107 | + release and additionally executes component tests with `<score-test-scenarios https://github.com/eclipse-score/testing_tools>`_ framework for some of components. |
| 108 | + |
| 109 | + |
| 110 | +Associated Infrastructure Modules |
| 111 | +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
| 112 | + |
| 113 | +- **process_description**: (Version). Process description of S-CORE. Link to release note? |
| 114 | +- **docs-as-code**: (Version). Tooling for linking and generation of documentation. Link to release note? |
| 115 | +- **tooling**: (Version). Provided tooling for S-CORE development. Link to release note? |
| 116 | +- **ITF**: Integration Testing Framework for execution of feature integration tests on the reference image |
| 117 | + |
| 118 | + - **Link to release**: `itf v0.1.0 <https://github.com/eclipse-score/itf/releases/tag/0.1.0>`_ |
| 119 | + - **Release notes** |
| 120 | + |
| 121 | + - Bazel setup for macro *py_itf_test* |
| 122 | + - Pinging target |
| 123 | + - SSH and SPTP module |
| 124 | + - DLT module |
| 125 | + - Starting Qemu from `reference_integration <https://github.com/eclipse-score/reference_integration/tree/main/qnx_qemu>`_ repository |
| 126 | + - `ITF readme <https://github.com/eclipse-score/itf/blob/main/README.md>`_ |
| 127 | + - `reference_integration readme <https://github.com/eclipse-score/reference_integration/blob/main/qnx_qemu/README.md#build-commands>`_ |
| 128 | + |
| 129 | + |
| 130 | +Performed Verification |
| 131 | +^^^^^^^^^^^^^^^^^^^^^^^^ |
| 132 | +Following tests were executed: |
| 133 | + |
| 134 | +- every module has executed its unit-tests |
| 135 | +- few basic integration tests were executed with reference integration qnx image in Qemu as can be seen e.g. in the following `Action Run <https://github.com/eclipse-score/reference_integration/actions/runs/19128779084/job/54664320615#step:7:689>`_. |
| 136 | +- for some of the modules (**TODO**), component tests with score-test-scenarios framework were executed |
| 137 | + |
| 138 | +Known Issues |
| 139 | +^^^^^^^^^^^^^^^^ |
| 140 | +- see release notes of every module seperately |
| 141 | + |
| 142 | +Upgrade Instructions |
| 143 | +^^^^^^^^^^^^^^^^^^^^^^^^ |
| 144 | +- none, first published release. |
| 145 | + |
| 146 | +Contact Information |
| 147 | +^^^^^^^^^^^^^^^^^^^^ |
| 148 | +For any questions or support, please contact the *Project lead* or raise an issue/discussion. |
0 commit comments