The implementation uses the system workqueue and a callback provided and registered by the application. The application callback is called in the context of the workqueue. Notification messages are stored in a queue and delivered to the callback in sequence. We cannot call application callback directly from the USB device stack thread because the behavior of arbitrary code provided by the application is unpredictable, and we do not want it to be executed in the same context where all events from the device controller are handled. Nor can we use the ZBUS subsystem directly. ZBUS offloads responsibility for defined behavior to the observers and application, and does not provide any way for the publisher to enforce defined behavior and execution context. ZBUS listener would be called from the USB thread context and is not acceptable. ZBUS subscriber does not provide delivery guarantee and cached message can be overwritten. ZBUS message subscriber has cumbersome global configuration and buffers that are too complicated to handle from USB configuration, and even if we would use it, defined behavior is not possible because of how listener and subscriber are handled. Signed-off-by: Johann Fischer <johann.fischer@nordicsemi.no>
53 lines
1.1 KiB
Plaintext
53 lines
1.1 KiB
Plaintext
# Copyright (c) 2022 Nordic Semiconductor ASA
|
|
#
|
|
# SPDX-License-Identifier: Apache-2.0
|
|
|
|
menuconfig USB_DEVICE_STACK_NEXT
|
|
bool "New USB device stack [EXPERIMENTAL]"
|
|
select EXPERIMENTAL
|
|
select UDC_DRIVER
|
|
select HWINFO
|
|
help
|
|
New experimental USB device stack.
|
|
|
|
if USB_DEVICE_STACK_NEXT
|
|
|
|
module = USBD
|
|
module-str = usbd
|
|
source "subsys/logging/Kconfig.template.log_config"
|
|
|
|
config USBD_SHELL
|
|
bool "USB device shell"
|
|
depends on SHELL
|
|
help
|
|
Enable USB device shell.
|
|
|
|
config USBD_THREAD_INIT_PRIO
|
|
int
|
|
default 90
|
|
help
|
|
USB device thread initialization priority level.
|
|
|
|
config USBD_THREAD_STACK_SIZE
|
|
int "USB device stack thread stack size"
|
|
default 1024
|
|
help
|
|
USB device stack thread stack size in bytes.
|
|
|
|
config USBD_MAX_UDC_MSG
|
|
int "Maximum number of UDC events"
|
|
default 10
|
|
help
|
|
Maximum number of USB device controller events that can be queued.
|
|
|
|
config USBD_MSG_SLAB_COUNT
|
|
int "Maximum number of USB device notification messages"
|
|
range 4 64
|
|
default 8
|
|
help
|
|
Maximum number of USB device notification messages that can be queued.
|
|
|
|
rsource "class/Kconfig"
|
|
|
|
endif # USB_DEVICE_STACK_NEXT
|