zephyr/samples/hello_world/README.rst

.. _hello_world:

Hello World
###########

Overview
********
A simple Hello World example that can be used with any supported board and
prints 'Hello World' to the console. This application can be built into modes:

* single thread
* multi threading

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

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

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

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

.. code-block:: console

    Hello World! x86

Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.
boards: add arduino_due board documentation Change-Id: Id98671fd0a1e6eddd8368123c60f1452b84f8fde Signed-off-by: Anas Nashif <anas.nashif@intel.com> 2017-01-15 07:39:24 +08:00			`.. _hello_world:`

doc: hello world: move to rst and expand docuemntation Change-Id: Id623dd8d2f97836c0f970424d06d9d549065f7c5 Signed-off-by: Anas Nashif <anas.nashif@intel.com> 2017-01-05 21:56:21 +08:00			`Hello World`
			`###########`

			`Overview`
doc: fix .rst files canonical heading order The headings on some .rst files were not following the expected heading order of using # for h1, * for h2, = for h3, and - for h4 This patch fixes that, and the doc/templates/*.tmpl files created for folks to use as templates for creating board and sample docs. Change-Id: I0263b005648558d5ea41a681ceaa4798c9594dd9 Signed-off-by: David B. Kinder <david.b.kinder@intel.com> 2017-01-21 07:58:05 +08:00			`********`
doc: hello world: move to rst and expand docuemntation Change-Id: Id623dd8d2f97836c0f970424d06d9d549065f7c5 Signed-off-by: Anas Nashif <anas.nashif@intel.com> 2017-01-05 21:56:21 +08:00			`A simple Hello World example that can be used with any supported board and`
			`prints 'Hello World' to the console. This application can be built into modes:`

			`* single thread`
			`* multi threading`

			`Building and Running`
doc: fix .rst files canonical heading order The headings on some .rst files were not following the expected heading order of using # for h1, * for h2, = for h3, and - for h4 This patch fixes that, and the doc/templates/*.tmpl files created for folks to use as templates for creating board and sample docs. Change-Id: I0263b005648558d5ea41a681ceaa4798c9594dd9 Signed-off-by: David B. Kinder <david.b.kinder@intel.com> 2017-01-21 07:58:05 +08:00			`********************`
doc: hello world: move to rst and expand docuemntation Change-Id: Id623dd8d2f97836c0f970424d06d9d549065f7c5 Signed-off-by: Anas Nashif <anas.nashif@intel.com> 2017-01-05 21:56:21 +08:00
			`This project outputs 'Hello World' to the console. It can be built and executed`
			`on QEMU as follows:`

samples: misc: Convert doc to CMake Convert misc samples doc to CMake. Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no> 2017-11-12 17:11:39 +08:00			`.. zephyr-app-commands::`
			`:zephyr-app: samples/hello_world`
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 00:32:31 +08:00			`:host-os: unix`
samples: misc: Convert doc to CMake Convert misc samples doc to CMake. Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no> 2017-11-12 17:11:39 +08:00			`:board: qemu_x86`
			`:goals: run`
			`:compact:`
doc: hello world: move to rst and expand docuemntation Change-Id: Id623dd8d2f97836c0f970424d06d9d549065f7c5 Signed-off-by: Anas Nashif <anas.nashif@intel.com> 2017-01-05 21:56:21 +08:00
			`Sample Output`
doc: fix .rst files canonical heading order The headings on some .rst files were not following the expected heading order of using # for h1, * for h2, = for h3, and - for h4 This patch fixes that, and the doc/templates/*.tmpl files created for folks to use as templates for creating board and sample docs. Change-Id: I0263b005648558d5ea41a681ceaa4798c9594dd9 Signed-off-by: David B. Kinder <david.b.kinder@intel.com> 2017-01-21 07:58:05 +08:00			`=============`
doc: hello world: move to rst and expand docuemntation Change-Id: Id623dd8d2f97836c0f970424d06d9d549065f7c5 Signed-off-by: Anas Nashif <anas.nashif@intel.com> 2017-01-05 21:56:21 +08:00
			`.. code-block:: console`

			`Hello World! x86`
doc: add how to exit from QEMU in samples While trying out the hello_world sample built for QEMU, I was expecting the sample app to exit and I'd return to a command prompt. Nope. You need to exit QEMU manually, so add that step to the sample instructions. Looking around, there are more uses of QEMU like this that could use this added step after running the sample app. Signed-off-by: David B. Kinder <david.b.kinder@intel.com> 2019-08-29 06:46:09 +08:00
			Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.