samples: userspace: hello_world

This sample print a hello world message through a user thread.

Signed-off-by: Alexandre Mergnat <[email protected]>

Author: amergnat

samples/userspace/hello_world_user/CMakeLists.txt

@@ -0,0 +1,8 @@
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.13.1)
+
+include($ENV{ZEPHYR_BASE}/cmake/app/boilerplate.cmake NO_POLICY_SCOPE)
+project(hello_world_user)
+
+target_sources(app PRIVATE src/main.c)

samples/userspace/hello_world_user/README.rst

@@ -0,0 +1,35 @@
+.. _hello_world_user:
+
+Hello World
+###########
+
+Overview
+********
+A simple Hello World example that can be used with any supported board and
+prints 'Hello World from UserSpace!' to the console.
+This application can be built into modes:
+
+* single thread
+* multi threading
+
+Building and Running
+********************
+
+This project outputs 'Hello World from UserSpace!' to the console.
+It can be built and executed on QEMU as follows:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/userspace/hello_world_user
+   :host-os: unix
+   :board: qemu_riscv32
+   :goals: run
+   :compact:
+
+Sample Output
+=============
+
+.. code-block:: console
+
+    Hello World from UserSpace! qemu_riscv32
+
+Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.

samples/userspace/hello_world_user/prj.conf

@@ -0,0 +1,6 @@
+CONFIG_USERSPACE=y
+CONFIG_APPLICATION_DEFINED_SYSCALL=y
+CONFIG_ASSERT=y
+CONFIG_LOG=y
+CONFIG_LOG_MINIMAL=y
+CONFIG_MAIN_STACK_SIZE=2560

samples/userspace/hello_world_user/sample.yaml

@@ -0,0 +1,14 @@
+sample:
+  description: Hello World sample, the simplest userspace
+    Zephyr application
+  name: hello world user
+common:
+    tags: introduction
+    harness: console
+    harness_config:
+      type: one_line
+      regex:
+        - "Hello World from UserSpace! (.*)"
+tests:
+  sample.helloworld:
+    tags: introduction

samples/userspace/hello_world_user/src/main.c

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2020 BayLibre, SAS
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr.h>
+#include <stdio.h>
+#define USER_STACKSIZE	2048
+
+struct k_thread user_thread;
+K_THREAD_STACK_DEFINE(user_stack, USER_STACKSIZE);
+
+static void user_function(void *p1, void *p2, void *p3)
+{
+	printf("Hello World from UserSpace! %s\n", CONFIG_BOARD);
+}
+
+
+void main(void)
+{
+	k_thread_create(&user_thread, user_stack, USER_STACKSIZE,
+			user_function, NULL, NULL, NULL,
+			-1, K_USER, K_MSEC(0));
+}