LICENSES/libtiff.txt

+Copyright (c) 1988-1997 Sam Leffler
+Copyright (c) 1991-1997 Silicon Graphics, Inc.
+
+Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that (i) the above copyright notices and this permission notice appear in all copies of the software and related documentation, and (ii) the names of Sam Leffler and Silicon Graphics may not be used in any advertising or publicity relating to the software without the specific, prior written permission of Sam Leffler and Silicon Graphics.
+
+THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
+
+IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

README.md

@@ -6,7 +6,7 @@ SPDX-License-Identifier: CC-BY-4.0
 
 # Oniro Project
 
-Welcome to the Oniro\* Project main git reposiotory! Oniro is an Eclipse
+Welcome to the Oniro\* Project main git repository! Oniro is an Eclipse
 Foundation project focused on the development of a distributed open source
 operating system for consumer devices.
 

SECURITY.md

@@ -8,7 +8,7 @@ SPDX-License-Identifier: CC-BY-4.0
 
 If you think you have found a security issue in our distribution, please
 contact us immediatelly by posting a confidential issue in our bug
-tracker in a [dedicated security project](https://booting.oniroproject.org/security/bugtracker/-/issues).
+tracker in a [dedicated security project](https://gitlab.eclipse.org/security/oniro-core).
 
 To do so, login into our issue tracker or create a new account if you do not
 have one yet. Click on `New issue`, then make sure to check the checkbox at

docs/build-flavours/linux-flavour.rst

@@ -22,11 +22,12 @@ Supported machines (default in **bold**):
 
 * **qemux86-64**
 * qemux86
-* qemuarm
-* qemuarm64
+* qemuarm64-efi
+* qemuarm-efi
 * seco-intel-b68 (SECO SBC-B68)
 * seco-imx8mm-c61-2gb (SECO SBC-C61 2GB DRAM)
 * seco-imx8mm-c61-4gb (SECO SBC-C61 4GB DRAM)
+* seco-px30-d23 (SECO SBC-D23)
 
 Build steps example:
 
@@ -41,24 +42,30 @@ You can test the image built for the qemux86-64 target by issuing:
 
     $ runqemu qemux86-64 oniro-image-base wic ovmf slirp
 
+.. _linux-flavour-usage:
+
+Usage
+*****
+
 After successful bootup, you will be dropped into a login shell:
 
 .. code-block:: console
 
-    qemux86-64 login:
+    oniro-linux-qemux86-64 login:
     
-Default login is *root* without a password.
+The default login name is **oniro** with **oniro** as a password.
 
 After login you will see the shell prompt:
 
 .. code-block:: console
 
-    root@qemux86-64:~#
+    oniro@oniro-linux-qemux86-64:~$
 
 To exit qemu, you can either shut down the system:
 
 .. code-block:: console
 
-    root@qemux86:~# poweroff -f
+    oniro@oniro-linux-qemux86-64:~$ sudo poweroff    
+    Password: oniro 
 
 or close qemu using a key combination: *Ctrl-a followed by 'x'*.

docs/build-flavours/zephyr-flavour.rst

@@ -22,10 +22,7 @@ Supported machines (default in **bold**):
 
 * **qemu-x86**
 * qemu-cortex-m3
-* 96b-nitrogen (96Boards Nitrogen)
-* 96b-avenger96 (96Boards Avenger96)
 * arduino-nano-33-ble (Arduino Nano 33 BLE and Arduino Nano 33 BLE Sense)
-* nrf52840dk-nrf52840 (Nordic Semiconductor nRF 52840 Development Kit)
 
 Build steps example:
 
@@ -38,7 +35,7 @@ You can test the image built for the qemu-x86 target by issuing:
 
 .. code-block:: console
 
-    $ runqemu qemu-x86
+    $ runqemu qemu-x86 nographic
 
 After successful bootup, the output of the application will be similar to:
 

docs/ci/hidden-jobs/build-zephyr-image.rst

@@ -6,10 +6,12 @@
 .build-zephyr-image
 ===================
 
-The ``.build-zephyr-image`` job extends the :doc:`build-image` job to collect only
+The ``.build-zephyr-image`` job extends the :doc:`build-image` job to collect, by default
 the `*.bin` and `*.elf` files and remove all the other files that would
-normally be collected by the artifact system. It is recommended for Zephyr
-builds which produce bin and elf images.
+normally be collected by the artifact system. The file types of the artifacts can be overridden.
+This sets by default ``CI_ONIRO_BUILD_FLAVOUR`` to ``zephyr`` and ``CI_ONIRO_RECIPE_NAME``
+to ``zephyr-philosophers``, the latter can be overridden to change the recipe builded by bitbake.
+It is used by all Zephyr builds.
 
 Usage Guide
 ===========

docs/ci/hidden-jobs/build-zephyr.rst

-.. SPDX-FileCopyrightText: Huawei Inc.
-..
-.. SPDX-License-Identifier: CC-BY-4.0
-
-=============
-.build-zephyr
-=============
-
-The ``.build-zephyr`` job extends the :doc:`bitbake-workspace` job. It sets
-``CI_ONIRO_BUILD_FLAVOUR`` to ``zephyr`` and builds the bitbake targets (e.g.
-images) as defined by ``CI_ONIRO_BITBAKE_TARGETS`` (defaults included).
-
-Usage Guide
-===========
-
-This job is not intended for direct use. Instead it serves as a base for all
-the Zephyr-specific :doc:`../machines-and-flavours`.

docs/ci/hidden-jobs/index.rst

@@ -18,7 +18,6 @@ implementation details.
    bitbake-workspace
    build-linux
    build-linux-matrix
-   build-zephyr
    build-freertos
    build-recipe
    build-image
@@ -30,3 +29,4 @@ implementation details.
    lava-report
    aggregate-docs
    publish-rauc-bundle-to-hawkbit
+   oe-selftest

docs/ci/hidden-jobs/lava-test.rst

@@ -45,6 +45,12 @@ The name of the ``report`` job which will be triggered manually when the LAVA
 job(s) are finished with executution. This job will collect the results from
 LAVA and import them to GitLab.
 
+CI_UPDATE_JOB_NAME
+------------------
+
+The name of the ``update`` job which LAVA needs in order to download the
+correct SySOTA bundle from the pipeline.
+
 CI_LAVA_INSTANCE
 ----------------
 

docs/ci/hidden-jobs/oe-selftest.rst

+.. SPDX-FileCopyrightText: Huawei Inc.
+..
+.. SPDX-License-Identifier: CC-BY-4.0
+
+============
+.oe-selftest
+============
+
+The ``.oe-selftest`` job extends the :doc:`bitbake-workspace` job to configure
+OpenEmbedded Self test environment. The job does not run any tests by itself,
+actual tests should be run in the downstream test jobs.
+
+Job Variables
+=============
+
+Oe-selftest is based on Python unitest. Tests are organized by module, class
+and method. The ``.oe-selftest`` job defines two variables as a way to
+customize what tests to run.
+
+CI_ONIRO_OE_SELFTESTS
+---------------------
+
+The specific tests to run. The default value is empty. The order the tests are
+running is alphabetical.
+
+
+CI_ONIRO_OE_SEFLTEST_SKIPS
+--------------------------
+
+The specific tests to skip. The default value is empty.

docs/ci/hidden-jobs/workspace.rst

@@ -108,6 +108,20 @@ Merge Results`_ for more information.
 
 The default value is the empty string.
 
+
+CI_ONIRO_OECORE_BRANCH
+----------------------
+
+Can be used to specify Openembedded Core branch to be used for testing.
+If not specified, the one defined in ``CI_ONIRO_MANIFEST_NAME`` manifest file will be used
+
+CI_ONIRO_OECORE_REPO
+--------------------
+
+Can be used to specify Openembedded Core repo (remote) to be used for testing.
+If not specified, the one defined in ``CI_ONIRO_MANIFEST_NAME`` manifest file will be used
+NOTE: ``CI_ONIRO_OECORE_BRANCH`` *must* be specified for overriden repos
+
 Local git-repo Mirror
 =====================
 

docs/ci/machines-and-flavours.rst

@@ -66,6 +66,19 @@ architecture.
     The cache for this job is not public, as it contains proprietary elements
     that cannot be redistributed without an agreement with Freescale.
 
+linux-seco-px30-d23
+...................
+
+This job extends `.build-wic-image` job from the manifest repository and builds
+``oniro-image-base`` using the Linux flavour of |main_project_name| and
+``MACHINE=seco-px30-d23``. This job checks that |main_project_name| software can
+be built for the SECO D23 development board which features a Rockchip PX30 SoC
+(64bit ARMv8-A) architecture.
+
+.. note::
+    The cache for this job is not public, pending legal review of any firmware
+    that may be included.
+
 linux-raspberrypi4-64
 .....................
 
@@ -100,31 +113,6 @@ basic 32bit ARM micro-controller virtual machine.
 
 The cache for this job is publicly available.
 
-zephyr-96b-nitrogen
-...................
-
-This job extends `.build-zephyr` job from the manifest repository and builds
-``zephyr-philosophers`` using the Zephyr flavour of |main_project_name| and
-``MACHINE=96b-nitrogen``. This job checks that Zephyr can be built for the
-96Boards Nitrogen development board, which contains an nRF52832 SoC.
-
-.. note::
-    The cache for this job is not public, pending legal review of any firmware
-    that may be included.
-
-zephyr-96b-avenger
-..................
-
-This job extends `.build-zephyr` job from the manifest repository and builds
-``zephyr-philosophers`` using the Zephyr flavour of |main_project_name| and
-``MACHINE=96b-avenger96``. This job checks that Zephyr can be built for the
-96Boards Avenger development board cortex-M3 core, embedded into STM32MP157
-SoC.
-
-.. note::
-    The cache for this job is not public, pending legal review of any firmware
-    that may be included.
-
 zephyr-arduino-nano-33-ble
 ..........................
 

docs/debug-mode.rst

+.. SPDX-FileCopyrightText: Huawei Inc.
+..
+.. SPDX-License-Identifier: CC-BY-4.0
+
+.. include:: definitions.rst
+
+.. _DebugMode:
+
+Debug Mode
+##########
+
+In some situations, you may want to compile an image with some additional tools
+and features for easier debugging. For this reason, |main_project_name|
+offers the debug mode.
+
+Images built with the `debug mode` enabled contain additional tools and allow
+to log in as root (which is disabled in the default images).
+
+To enable the `debug mode`, edit your ``local.conf`` and add:
+
+.. code-block:: console
+
+    INHERIT += "oniro-debug-linux"
+
+For convenience, the section is already present commented-out in the template
+and you may uncoment it.
+
+When done, rebuild your image as usual. To go back to the production mode,
+comment the line out again and rebuild your image.
+
+.. Note::
+
+   Debug mode images are unsupported by the project and do not take part
+   of the release. They are provided for convenience only.

docs/default-password.rst

+.. SPDX-FileCopyrightText: Linaro Ltd
+..
+.. SPDX-License-Identifier: CC-BY-4.0
+
+.. include:: definitions.rst
+
+.. _DefaultPassword:
+
+Setting the Default Password
+############################
+
+|main_project_name| provides a default user with default password.
+Device vendor should change this password for their devices and disable the remote
+login if not needed.
+
+The default password is configured by the variable **"ONIRO_USER_PASSWORD"**.
+You can define in in your ``local.conf`` using a command like (replace the password
+and the seed by your own values):
+
+.. code-block:: console
+
+    mkpasswd -m sha-512 <yourpassword> -s "seed"
+
+Replace the seed and password with your own data, also make sure to escape all special shell
+characters, the `%q` formating of shell `printf` is useful. The final command could be:
+
+For example:
+
+.. code-block:: console
+
+    $ printf "%q" $(mkpasswd -m sha512crypt 123456 -s "seed1234" )
+    \$6\$seed1234\$qd8wosDovm0k4OSCKGSbnwrj4SJf.92UyAqEgdE3xhD0tHxhqqoSxqmsjiXfj4ue0ih4txcKHQWqGQ.1HZmm7.
+
+In this case, your ``local.conf`` (or an bbappend in one of your layers) should contain:
+
+.. code-block:: console
+
+    ONIRO_USER_PASSWORD="\$6\$seed1234\$qd8wosDovm0k4OSCKGSbnwrj4SJf.92UyAqEgdE3xhD0tHxhqqoSxqmsjiXfj4ue0ih4txcKHQWqGQ.1HZmm7."
+
+After rebuilding your image, you should be able to login with the `123456` password.
+
+.. Note::
+
+   The password and seed in this document is shown for illustration purposed only. In a production
+   sytem, use different values than the default ones, or what has been shown in this document.

docs/hardware-support/boards/96b-nitrogen.rst → docs/hardware-support/boards/archive/96b-nitrogen.rst

@@ -2,7 +2,7 @@
 ..
 .. SPDX-License-Identifier: CC-BY-4.0
 
-.. include:: ../../definitions.rst
+.. include:: ../../../definitions.rst
 
 .. _SupportedBoardNitrogen:
 

docs/hardware-support/boards/archive/index.rst

+.. SPDX-FileCopyrightText: Huawei Inc.
+..
+.. SPDX-License-Identifier: CC-BY-4.0
+
+.. include:: ../../../definitions.rst
+
+.. _ArchivedBoards:
+
+Archived Boards
+###############
+
+This sectoin details boards that have been archived. They may have been used in
+a past release and are retained here for reference.
+
+.. toctree::
+   :maxdepth: 1
+
+   96b-nitrogen
+   nRF52840-DK

docs/hardware-support/boards/nRF52840-DK.rst → docs/hardware-support/boards/archive/nRF52840-DK.rst

@@ -2,7 +2,7 @@
 ..
 .. SPDX-License-Identifier: CC-BY-4.0
 
-.. include:: ../../definitions.rst
+.. include:: ../../../definitions.rst
 
 .. _SupportedBoardnRF52840DK:
 

docs/hardware-support/boards/arduino-nano-33-ble.rst

@@ -74,6 +74,12 @@ sample application, *blinky*. In order to do so issue the following:
 3. After the build completes, the ``zephyr-philosophers.bin`` and the ``zephyr-blinky.bin``
    file can be found in ``build-oniro-zephyr/tmp-newlib/deploy/images/arduino-nano-33-ble/``.
 
+.. note::
+    By default, both zephyr-blinky and zephyr-philosophers applications will start once the board 
+    is powered on without waiting for a serial console connection.
+    To start an application only when serial console is connected, specify ONIRO_ENABLE_ACM0 = "1".
+    This option may be useful in automated testing environment.
+
 Flashing an Application
 =======================
 

docs/hardware-support/boards/index.rst

@@ -14,9 +14,9 @@ This section details the boards supported as part of |main_project_name|.
 .. toctree::
    :maxdepth: 1
 
-   96b-nitrogen
    seco-intel-b68
    seco-imx8mm-c61
+   seco-px30-d23
    raspberrypi4
+   raspberrypi-armv8
    arduino-nano-33-ble
-   nRF52840-DK