[nrf fromtree] samples: usb: add console sample for the new USB device stack

Add sample to shows how to use the CDC ACM UART provided by the new
experimental USB device stack as a serial backend for the console.

Signed-off-by: Johann Fischer <[email protected]>
(cherry picked from commit be5e666)
Signed-off-by: Tomasz Moń <[email protected]>

Author: jfischer-no

samples/subsys/usb/console-next/CMakeLists.txt

@@ -0,0 +1,8 @@
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.20.0)
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(console-next)
+
+FILE(GLOB app_sources src/*.c)
+target_sources(app PRIVATE ${app_sources})

samples/subsys/usb/console-next/README.rst

@@ -0,0 +1,39 @@
+.. zephyr:code-sample:: usbd-cdc-acm-console
+   :name: Console over USB CDC ACM
+   :relevant-api: usbd_api uart_interface
+
+   Output "Hello World!" to the console over USB CDC ACM.
+
+Overview
+********
+
+This example application shows how to use the CDC ACM UART provided by the new
+experimental USB device stack as a serial backend for the console.
+
+Requirements
+************
+
+This project requires an experimental USB device driver (UDC API).
+
+Building and Running
+********************
+
+This sample can be built for multiple boards, in this example we will build it
+for the reel_board board:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/subsys/usb/console-next
+   :board: reel_board
+   :goals: flash
+   :compact:
+
+Plug the board into a host device, for sample, a PC running Linux OS.
+The board will be detected as a CDC ACM serial device. To see the console output
+from the sample, use a command similar to :command:`minicom -D /dev/ttyACM1`.
+
+.. code-block:: console
+
+   Hello World! arm
+   Hello World! arm
+   Hello World! arm
+   Hello World! arm

samples/subsys/usb/console-next/app.overlay

@@ -0,0 +1,17 @@
+/*
+ * Copyright (c) 2021 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/ {
+	chosen {
+		zephyr,console = &cdc_acm_uart0;
+	};
+};
+
+&zephyr_udc0 {
+	cdc_acm_uart0: cdc_acm_uart0 {
+		compatible = "zephyr,cdc-acm-uart";
+	};
+};

samples/subsys/usb/console-next/prj.conf

@@ -0,0 +1,10 @@
+CONFIG_SERIAL=y
+CONFIG_CONSOLE=y
+CONFIG_UART_CONSOLE=y
+CONFIG_STDOUT_CONSOLE=y
+CONFIG_UART_LINE_CTRL=y
+
+CONFIG_USB_DEVICE_STACK_NEXT=y
+CONFIG_CDC_ACM_SERIAL_INITIALIZE_AT_BOOT=y
+CONFIG_CDC_ACM_SERIAL_PID=0x0004
+CONFIG_CDC_ACM_SERIAL_PRODUCT_STRING="USBD console sample"

samples/subsys/usb/console-next/sample.yaml

@@ -0,0 +1,10 @@
+sample:
+  name: Console over CDC ACM serial
+tests:
+  sample.usbd.console:
+    depends_on:
+      - usbd
+    tags: usb
+    harness: console
+    harness_config:
+      fixture: fixture_usb_cdc

samples/subsys/usb/console-next/src/main.c

@@ -0,0 +1,30 @@
+/*
+ * Copyright (c) 2016 Intel Corporation.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/kernel.h>
+#include <zephyr/sys/printk.h>
+#include <zephyr/drivers/uart.h>
+
+BUILD_ASSERT(DT_NODE_HAS_COMPAT(DT_CHOSEN(zephyr_console), zephyr_cdc_acm_uart),
+	     "Console device is not ACM CDC UART device");
+
+int main(void)
+{
+	const struct device *const dev = DEVICE_DT_GET(DT_CHOSEN(zephyr_console));
+	uint32_t dtr = 0;
+
+	/* Poll if the DTR flag was set */
+	while (!dtr) {
+		uart_line_ctrl_get(dev, UART_LINE_CTRL_DTR, &dtr);
+		/* Give CPU resources to low priority threads. */
+		k_sleep(K_MSEC(100));
+	}
+
+	while (1) {
+		printk("Hello World! %s\n", CONFIG_ARCH);
+		k_sleep(K_SECONDS(1));
+	}
+}