samples: usb: make WebUSB next sample default

Move legacy WebUSB sample to legacy directory and make WebUSB next
sample default.

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

Author: jfischer-no

doc/connectivity/usb/device/usb_device.rst

@@ -389,7 +389,7 @@ The application should register descriptors such as Capability Descriptor
 using :c:func:`usb_bos_register_cap`. Registered descriptors are added to the root
 BOS descriptor and handled by the stack.
 
-See :zephyr:code-sample:`webusb` sample for reference.
+See :zephyr:code-sample:`legacy-webusb` sample for reference.
 
 Interface number and endpoint address assignment
 ************************************************

doc/releases/release-notes-4.1.rst

@@ -958,7 +958,7 @@ New Samples
 * :zephyr:code-sample:`uart`
 * :zephyr:code-sample:`usb-midi2-device`
 * :zephyr:code-sample:`usbd-cdc-acm-console`
-* :zephyr:code-sample:`webusb-next`
+* :zephyr:code-sample:`webusb`
 
 Other notable changes
 *********************

samples/subsys/usb/webusb-next/CMakeLists.txt renamed to samples/subsys/usb/legacy/webusb/CMakeLists.txt

@@ -4,6 +4,7 @@ cmake_minimum_required(VERSION 3.20.0)
 find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
 project(webusb)
 
-include(${ZEPHYR_BASE}/samples/subsys/usb/common/common.cmake)
+target_include_directories(app PRIVATE ${ZEPHYR_BASE}/subsys/usb)
+
 FILE(GLOB app_sources src/*.c)
 target_sources(app PRIVATE ${app_sources})

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

@@ -0,0 +1,94 @@
+.. zephyr:code-sample:: legacy-webusb
+   :name: Legacy WebUSB
+   :relevant-api: _usb_device_core_api
+
+   Receive and echo data from a web page using WebUSB API.
+
+For a deeper dive into the WebUSB, refer to
+https://developers.google.com/web/updates/2016/03/access-usb-devices-on-the-web
+
+WebUSB API Specification:
+https://wicg.github.io/webusb/
+
+Overview
+********
+
+This simple echo application demonstrates the WebUSB sample application.
+This application receives the data and echoes back to the WebUSB
+based web application (web page) running in the browser at host.
+This application is intended for testing purposes only. For running
+real usecase, implement applications based on the WebUSB API.
+This sample can be found under :zephyr_file:`samples/subsys/usb/legacy/webusb` in the
+Zephyr project tree.
+
+.. note::
+   This samples demonstrate deprecated :ref:`usb_device_stack`.
+
+Requirements
+************
+
+This project requires an USB device driver, which is available for multiple
+boards supported in Zephyr.
+
+Building and Running
+********************
+
+Build and flash webusb sample with:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/subsys/usb/legacy/webusb
+   :board: <board to use>
+   :goals: flash
+   :compact:
+
+Testing with the latest Google Chrome on host
+*********************************************
+
+This sample application requires the latest Google Chrome, a web page
+based on WebUSB API to connect to the USB device and optionally
+http server running on localhost to serve the web page.
+
+WebUSB is a powerful new feature added to the Web and it is available
+only to secure origins. This means the web page/site that is used to
+connect to the device must be served over a secure connection (HTTPS).
+
+Follow these steps to run the demo on your host system:
+
+#. Run the latest Google Chrome on host.
+
+#. Implement a web app (web page) using WebUSB API and run
+   it on localhost.
+
+   The sample can be found in the webusb sample directory:
+   :zephyr_file:`samples/subsys/usb/legacy/webusb/index.html`.
+
+   This sample web page demonstrates how to create and use a WebUSB
+   interface, as well as demonstrate the communication between browser
+   and WebUSB enabled device.
+
+   There are two ways to access this sample page:
+
+   * Using Chrome browser go to :doc:`demo`
+
+   * Host the demo page locally: Start a web server
+     in the webusb sample directory.
+
+     .. code-block:: console
+
+        $ python -m http.server
+
+     Using Chrome browser open url http://localhost:8001/
+
+#. Connect the board to your host.
+
+#. Once the device is booted, you should see a notification from
+   Chrome: "Go to localhost to connect.". Click on the notification
+   to open demo page.
+   Note that at the moment WebUSB landing page notification is disabled
+   in Chrome on Windows. See https://github.com/WICG/webusb#implementation-status
+
+#. Click on the :guilabel:`Connect` button to connect to the device.
+
+#. Send some text to the device by clicking on the :guilabel:`Send` button.
+   The demo app will receive the same text from the device and display it in
+   the text area.

samples/subsys/usb/webusb-next/demo.rst renamed to samples/subsys/usb/legacy/webusb/demo.rst

@@ -0,0 +1,13 @@
+CONFIG_STDOUT_CONSOLE=y
+CONFIG_USB_DEVICE_STACK=y
+CONFIG_USB_DEVICE_BOS=y
+CONFIG_SERIAL=y
+CONFIG_USB_DEVICE_PRODUCT="Zephyr WebUSB sample"
+CONFIG_USB_DEVICE_PID=0x000A
+CONFIG_UART_INTERRUPT_DRIVEN=y
+CONFIG_UART_LINE_CTRL=y
+CONFIG_USB_DEVICE_INITIALIZE_AT_BOOT=n
+
+CONFIG_LOG=y
+CONFIG_USB_DRIVER_LOG_LEVEL_ERR=y
+CONFIG_USB_DEVICE_LOG_LEVEL_ERR=y

samples/subsys/usb/webusb-next/index.html renamed to samples/subsys/usb/legacy/webusb/index.html

@@ -0,0 +1,7 @@
+sample:
+  name: Web USB
+tests:
+  sample.usb.legacy.webusb:
+    depends_on: usb_device
+    build_only: true
+    tags: usb