zephyr

History

Anas Nashif 78eda66eb5 samples: synchronization: build this sample on all platforms Try to catch issues related to platforms and HAL changes using this basic sample. We have the same flag for a kernel test, but this is skipped if no kernel changes are present in the PR, so we were missing some coverage of platform related changes. Signed-off-by: Anas Nashif <anas.nashif@intel.com>		2023-09-20 10:05:14 -04:00
..
src	samples, tests, boards: Switch main return type from void to int	2023-04-14 07:49:41 +09:00
CMakeLists.txt	cmake: increase minimal required version to 3.20.0	2021-08-20 09:47:34 +02:00
prj.conf	samples/synchronization: Clean up SMP CPU pinning example	2021-02-18 12:04:49 -05:00
README.rst	samples: fully migrate basic samples to the new Sphinx extension	2023-09-13 09:15:34 +02:00
sample.yaml	samples: synchronization: build this sample on all platforms	2023-09-20 10:05:14 -04:00

README.rst

.. zephyr:code-sample:: synchronization
   :name: Basic Synchronization
   :relevant-api: thread_apis semaphore_apis

   Manipulate basic kernel synchronization primitives.

Overview
********

A simple application that demonstrates basic sanity of the kernel.
Two threads (A and B) take turns printing a greeting message to the console,
and use sleep requests and semaphores to control the rate at which messages
are generated. This demonstrates that kernel scheduling, communication,
and timing are operating correctly.

Building and Running
********************

This project outputs to the console.  It can be built and executed
on QEMU as follows:

.. zephyr-app-commands::
   :zephyr-app: samples/synchronization
   :host-os: unix
   :board: qemu_x86
   :goals: run
   :compact:

Sample Output
=============

.. code-block:: console

   threadA: Hello World!
   threadB: Hello World!
   threadA: Hello World!
   threadB: Hello World!
   threadA: Hello World!
   threadB: Hello World!
   threadA: Hello World!
   threadB: Hello World!
   threadA: Hello World!
   threadB: Hello World!

   <repeats endlessly>

Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.