samples: usb: add a sample that covers legacy netusb

Add a sample that covers legacy CDC EEM/ECM and RNDIS functions.
Network functionality is limited to ICMP.

Signed-off-by: Johann Fischer <[email protected]>

Author: jfischer-no

doc/connectivity/usb/device/usb_device.rst

@@ -373,9 +373,7 @@ Ethernet connection between the remote (USB host) and Zephyr network support.
 * CDC EEM class, enabled with :kconfig:option:`CONFIG_USB_DEVICE_NETWORK_EEM`
 * RNDIS support, enabled with :kconfig:option:`CONFIG_USB_DEVICE_NETWORK_RNDIS`
 
-See :zephyr:code-sample:`zperf` or :zephyr:code-sample:`socket-dumb-http-server` for reference.
-Typically, users will need to add a configuration file overlay to the build,
-such as :zephyr_file:`samples/net/zperf/overlay-netusb.conf`.
+See :zephyr:code-sample:`legacy-netusb` sample for reference.
 
 Applications using RNDIS support should enable :kconfig:option:`CONFIG_USB_DEVICE_OS_DESC`
 for a better user experience on a host running Microsoft Windows OS.

samples/subsys/usb/legacy/netusb/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(zperf)
+
+target_sources(app PRIVATE src/main.c)

samples/subsys/usb/legacy/netusb/README.rst

@@ -0,0 +1,32 @@
+.. zephyr:code-sample:: legacy-netusb
+   :name: Legacy USB device netusb sample
+   :relevant-api: net_config _usb_device_core_api
+
+   Use USB CDC EEM/ECM or RNDIS implementation
+
+Overview
+********
+
+Use the USB CDC EEM/ECM or RNDIS implementation to establish a network
+connection to a device running the Zephyr RTOS.
+
+.. note::
+   This samples demonstrate deprecated :ref:`usb_device_stack`.
+
+This sample can be found under :zephyr_file:`samples/subsys/usb/legacy/netusb` in the
+Zephyr project tree.
+
+Requirements
+************
+
+This project requires an USB device driver, which is available for multiple
+boards supported in Zephyr.
+
+Building and Running
+********************
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/subsys/usb/legacy/netusb
+   :board: reel_board
+   :goals: flash
+   :compact:

samples/subsys/usb/legacy/netusb/prj.conf

@@ -0,0 +1,33 @@
+CONFIG_NETWORKING=y
+CONFIG_NET_LOG=y
+CONFIG_NET_IPV6=y
+CONFIG_NET_IPV4=y
+CONFIG_NET_UDP=y
+
+CONFIG_NET_PKT_RX_COUNT=40
+CONFIG_NET_PKT_TX_COUNT=40
+CONFIG_NET_BUF_RX_COUNT=160
+CONFIG_NET_BUF_TX_COUNT=160
+CONFIG_NET_BUF_DATA_SIZE=256
+CONFIG_NET_IF_UNICAST_IPV6_ADDR_COUNT=4
+CONFIG_NET_IF_MCAST_IPV6_ADDR_COUNT=5
+CONFIG_NET_IF_UNICAST_IPV4_ADDR_COUNT=1
+CONFIG_NET_MAX_CONTEXTS=5
+CONFIG_NET_TC_TX_COUNT=1
+CONFIG_POSIX_API=y
+
+CONFIG_INIT_STACKS=y
+CONFIG_TEST_RANDOM_GENERATOR=y
+
+CONFIG_NET_L2_ETHERNET=y
+
+CONFIG_NET_CONFIG_SETTINGS=y
+CONFIG_NET_CONFIG_MY_IPV6_ADDR="2001:db8::1"
+CONFIG_NET_CONFIG_MY_IPV4_ADDR="192.0.2.1"
+
+CONFIG_LOG=y
+CONFIG_SHELL_CMDS_RESIZE=n
+
+CONFIG_USB_DEVICE_STACK=y
+CONFIG_USB_DEVICE_NETWORK_ECM=y
+CONFIG_USB_DEVICE_INITIALIZE_AT_BOOT=n

samples/subsys/usb/legacy/netusb/sample.yaml

@@ -0,0 +1,26 @@
+common:
+  tags:
+    - net
+    - usb
+  min_ram: 192
+  depends_on: usb_device
+  build_only: true
+  platform_exclude:
+    - native_sim
+    - native_sim/native/64
+sample:
+  description: Samples for legacy CDC ECM, CDC EEM, RNDIS functions
+  name: Legacy ECM EEM RNDIS
+tests:
+  sample.usb.legacy.cdc_ecm:
+    extra_configs:
+      - CONFIG_USB_DEVICE_NETWORK_ECM=y
+      - CONFIG_USB_DEVICE_NETWORK_EEM=n
+  sample.usb.legacy.cdc_eem:
+    extra_configs:
+      - CONFIG_USB_DEVICE_NETWORK_ECM=n
+      - CONFIG_USB_DEVICE_NETWORK_EEM=y
+  sample.usb.legacy.rndis:
+    extra_configs:
+      - CONFIG_USB_DEVICE_NETWORK_ECM=n
+      - CONFIG_USB_DEVICE_NETWORK_RNDIS=y

samples/subsys/usb/legacy/netusb/src/main.c

@@ -0,0 +1,22 @@
+/*
+ * Copyright (c) 2020 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/usb/usb_device.h>
+#include <zephyr/net/net_config.h>
+
+int main(void)
+{
+	int ret;
+
+	ret = usb_enable(NULL);
+	if (ret != 0) {
+		printk("usb enable error %d\n", ret);
+	}
+
+	(void)net_config_init_app(NULL, "Initializing network");
+
+	return 0;
+}