zephyr/samples/synchronization
Carles Cufi 72046a8abc doc: getting_started: Support multi-OS instructions
In order to be able to document the build on Windows and UNIX
systems, slight variations are required on the app commands
that are used throughout the documentation system.

This includes getting rid of the prompt symbol and providing commands
for both UNIX and Windows operating systems.

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2018-01-18 16:53:31 -05:00
..
src kbuild: Removed KBuild 2017-11-08 20:00:22 -05:00
CMakeLists.txt cmake: remove IS_TEST handling 2018-01-08 10:03:57 -05:00
prj.conf samples: synchronization: move to legacy/ 2016-11-02 22:05:29 +00:00
prj_stack_guard.conf samples: synch: Add Thread Stack Guards conf 2017-05-16 09:28:06 -05:00
README.rst doc: getting_started: Support multi-OS instructions 2018-01-18 16:53:31 -05:00
sample.tc samples: synchronization: move to legacy/ 2016-11-02 22:05:29 +00:00
sample.yaml samples: remove build_only from various samples 2017-12-28 20:24:29 -05:00

.. _synchronization_sample:

Synchronization Sample
######################

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:

On the supported ARM MCUs the project can be built with the MPU and the Thread
Stack Guard feature enabled:

.. zephyr-app-commands::
   :zephyr-app: samples/synchronization
   :board: v2m_beetle
   :conf: prj_stack_guard.conf
   :goals: build flash
   :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>