usb: host: add a structure to represent a USB device.

Add a structure to represent a USB device and wrappers to avoid
glue UHC calls when operating on devices. Although there is a long
road to device configuration and management, we can start with
the tools that can also be used for USB device support testing.

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

Author: jfischer-no

subsys/usb/host/CMakeLists.txt

@@ -8,6 +8,7 @@ zephyr_library_sources(
 	usbh_ch9.c
 	usbh_core.c
 	usbh_api.c
+	usbh_device.c
 )
 
 zephyr_library_sources_ifdef(

subsys/usb/host/usbh_device.c

@@ -0,0 +1,19 @@
+/*
+ * Copyright (c) 2023 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/usb/usbh.h>
+#include "usbh_device.h"
+
+#define USBH_USB_DEVICE_COUNT		1
+
+static struct usb_device udevs[USBH_USB_DEVICE_COUNT];
+
+struct usb_device *usbh_device_get_any(struct usbh_contex *const ctx)
+{
+	udevs->ctx = ctx;
+
+	return udevs;
+}

subsys/usb/host/usbh_device.h

@@ -0,0 +1,95 @@
+/*
+ * Copyright (c) 2023 Nordic Semiconductor ASA
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef ZEPHYR_INCLUDE_USBH_DEVICE_H
+#define ZEPHYR_INCLUDE_USBH_DEVICE_H
+
+#include <stdint.h>
+#include <zephyr/usb/usbh.h>
+#include <zephyr/drivers/usb/uhc.h>
+
+/* USB device state */
+enum usb_device_state {
+	USB_STATE_NOTCONNECTED,
+	USB_STATE_DEFAULT,
+	USB_STATE_ADDRESSED,
+	USB_STATE_CONFIGURED,
+};
+
+/* Host support view of a USB device */
+struct usb_device {
+	struct usbh_contex *ctx;
+	struct usb_device_descriptor dev_desc;
+	enum usb_device_state state;
+	uint8_t actual_cfg;
+	uint8_t addr;
+};
+
+/* Callback type to be used for e.g. synchronous requests */
+typedef int (*usbh_udev_cb_t)(struct usb_device *const udev,
+			      struct uhc_transfer *const xfer);
+
+/*
+ * Get a device to work on, there will only be one for the first time
+ * until we implement USB device configuration/management.
+ */
+struct usb_device *usbh_device_get_any(struct usbh_contex *const ctx);
+
+/* Wrappers around to avoid glue UHC calls. */
+static inline struct uhc_transfer *usbh_xfer_alloc(struct usb_device *udev,
+						   const uint8_t ep,
+						   const uint8_t attrib,
+						   const uint16_t mps,
+						   const uint16_t timeout,
+						   usbh_udev_cb_t *const cb)
+{
+	struct usbh_contex *const ctx = udev->ctx;
+
+	return uhc_xfer_alloc(ctx->dev, udev->addr, ep, attrib, mps, timeout, udev, cb);
+}
+
+static inline int usbh_xfer_buf_add(const struct usb_device *udev,
+				    struct uhc_transfer *const xfer,
+				    struct net_buf *buf)
+{
+	struct usbh_contex *const ctx = udev->ctx;
+
+	return uhc_xfer_buf_add(ctx->dev, xfer, buf);
+}
+
+static inline struct net_buf *usbh_xfer_buf_alloc(struct usb_device *udev,
+						  const size_t size)
+{
+	struct usbh_contex *const ctx = udev->ctx;
+
+	return uhc_xfer_buf_alloc(ctx->dev, size);
+}
+
+static inline int usbh_xfer_free(const struct usb_device *udev,
+				 struct uhc_transfer *const xfer)
+{
+	struct usbh_contex *const ctx = udev->ctx;
+
+	return uhc_xfer_free(ctx->dev, xfer);
+}
+
+static inline void usbh_xfer_buf_free(const struct usb_device *udev,
+				      struct net_buf *const buf)
+{
+	struct usbh_contex *const ctx = udev->ctx;
+
+	uhc_xfer_buf_free(ctx->dev, buf);
+}
+
+static inline int usbh_xfer_enqueue(const struct usb_device *udev,
+				    struct uhc_transfer *const xfer)
+{
+	struct usbh_contex *const ctx = udev->ctx;
+
+	return uhc_ep_enqueue(ctx->dev, xfer);
+}
+
+#endif /* ZEPHYR_INCLUDE_USBH_DEVICE_H */