ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: usr / src / kernels / 5.14.0-611.49.2.el9_7.x86_64 / include / linux / usb

/* SPDX-License-Identifier: GPL-2.0+ */
/*
 * WebUSB descriptors and constants
 *
 * Copyright (C) 2023 Jó Ágila Bitsch <jgilab@gmail.com>
 */

#ifndef	__LINUX_USB_WEBUSB_H
#define	__LINUX_USB_WEBUSB_H

#include "uapi/linux/usb/ch9.h"

/*
 * little endian PlatformCapablityUUID for WebUSB
 * 3408b638-09a9-47a0-8bfd-a0768815b665
 * to identify Platform Device Capability descriptors as referring to WebUSB
 *
 * the UUID above MUST be sent over the wire as the byte sequence:
 * {0x38, 0xB6, 0x08, 0x34, 0xA9, 0x09, 0xA0, 0x47, 0x8B, 0xFD, 0xA0, 0x76, 0x88, 0x15, 0xB6, 0x65}.
 */
#define WEBUSB_UUID \
	UUID_INIT(0x38b60834, 0xa909, 0xa047, 0x8b, 0xfd, 0xa0, 0x76, 0x88, 0x15, 0xb6, 0x65)

/*
 * WebUSB Platform Capability data
 *
 * A device announces support for the
 * WebUSB command set by including the following Platform Descriptor Data in its
 * Binary Object Store associated with the WebUSB_UUID above.
 * See: https://wicg.github.io/webusb/#webusb-platform-capability-descriptor
 */
struct usb_webusb_cap_data {
	__le16 bcdVersion;
#define WEBUSB_VERSION_1_00	cpu_to_le16(0x0100) /* currently only version 1.00 is defined */
	u8  bVendorCode;
	u8  iLandingPage;
#define WEBUSB_LANDING_PAGE_NOT_PRESENT	0
#define WEBUSB_LANDING_PAGE_PRESENT	1 /* we chose the fixed index 1 for the URL descriptor */
} __packed;

#define USB_WEBUSB_CAP_DATA_SIZE	4

/*
 * Get URL Request
 *
 * The request to fetch an URL is defined in https://wicg.github.io/webusb/#get-url as:
 * bmRequestType: (USB_DIR_IN | USB_TYPE_VENDOR) = 11000000B
 * bRequest: bVendorCode
 * wValue: iLandingPage
 * wIndex: GET_URL = 2
 * wLength: Descriptor Length (typically U8_MAX = 255)
 * Data: URL Descriptor
 */
#define WEBUSB_GET_URL 2

/*
 * This descriptor contains a single URL and is returned by the Get URL request.
 *
 * See: https://wicg.github.io/webusb/#url-descriptor
 */
struct webusb_url_descriptor {
	u8  bLength;
#define WEBUSB_URL_DESCRIPTOR_HEADER_LENGTH	3
	u8  bDescriptorType;
#define WEBUSB_URL_DESCRIPTOR_TYPE		3
	u8  bScheme;
#define WEBUSB_URL_SCHEME_HTTP			0
#define WEBUSB_URL_SCHEME_HTTPS			1
#define WEBUSB_URL_SCHEME_NONE			255
	u8  URL[U8_MAX - WEBUSB_URL_DESCRIPTOR_HEADER_LENGTH];
} __packed;

/*
 * Buffer size to hold the longest URL that can be in an URL descriptor
 *
 * The descriptor can be U8_MAX  bytes long.
 * WEBUSB_URL_DESCRIPTOR_HEADER_LENGTH bytes are used for a header.
 * Since the longest prefix that might be stripped is "https://", we may accommodate an additional
 * 8 bytes.
 */
#define WEBUSB_URL_RAW_MAX_LENGTH (U8_MAX - WEBUSB_URL_DESCRIPTOR_HEADER_LENGTH + 8)

#endif /* __LINUX_USB_USBNET_H */

[-] uvc.h [edit]
[-] pd_ado.h [edit]
[-] tcpm.h [edit]
[-] ehci_pdriver.h [edit]
[-] onboard_dev.h [edit]
[-] rndis_host.h [edit]
[-] tcpci.h [edit]
[-] sl811.h [edit]
[-] isp1362.h [edit]
[-] pd_bdo.h [edit]
[-] otg.h [edit]
[-] typec_dp.h [edit]
[-] audio-v3.h [edit]
[-] iowarrior.h [edit]
[-] ohci_pdriver.h [edit]
[-] otg-fsm.h [edit]
[-] typec_tbt.h [edit]
[-] midi-v2.h [edit]
[-] typec_altmode.h [edit]
[-] typec_mux.h [edit]
[-] webusb.h [edit]
[-] uas.h [edit]
[-] pd.h [edit]
[-] net2280.h [edit]
[-] functionfs.h [edit]
[-] cdc.h [edit]
[-] typec_retimer.h [edit]
[-] renesas_usbhs.h [edit]
[-] phy_companion.h [edit]
[-] usbnet.h [edit]
[-] ch9.h [edit]
[-] tegra_usb_phy.h [edit]
[-] xhci-dbgp.h [edit]
[-] g_hid.h [edit]
[-] quirks.h [edit]
[-] input.h [edit]
[-] role.h [edit]
[-] chipidea.h [edit]
[-] isp116x.h [edit]
[-] phy.h [edit]
[-] ezusb.h [edit]
[-] typec.h [edit]
[-] ehci-dbgp.h [edit]
[-] cdc_ncm.h [edit]
[-] hcd.h [edit]
[-] pd_vdo.h [edit]
[-] r8152.h [edit]
[-] usb338x.h [edit]
[-] ulpi.h [edit]
[-] audio-v2.h [edit]
[-] gadget.h [edit]
[-] serial.h [edit]
[-] irda.h [edit]
[-] ljca.h [edit]
[-] of.h [edit]
[-] usb_phy_generic.h [edit]
[-] c67x00.h [edit]
[-] musb.h [edit]
[-] ehci_def.h [edit]
[-] ccid.h [edit]
[-] storage.h [edit]
[-] isp1301.h [edit]
[-] r8a66597.h [edit]
[-] m66592.h [edit]
[-] pd_ext_sdb.h [edit]
[-] composite.h [edit]
[+] ..
[-] cdc-wdm.h [edit]
[-] audio.h [edit]
[-] gadget_configfs.h [edit]
[-] musb-ux500.h [edit]