Changes in sysfs-bus-usb

12fc84e8 - usb: Export BOS descriptor to sysfs

Tue, 05 Mar 2024 00:23:01 +0000

usb: Export BOS descriptor to sysfsMotivation----------The binary device object store (BOS) of a USB device consists of the BOSdescriptor followed by a set of device capability descriptors. One that isof interest to users is the platform descriptor. This contains a 128-bitUUID and arbitrary data, and it allows parties outside of USB-IF to addadditional metadata about a USB device in a standards-compliant manner.Notable examples include the WebUSB and Microsoft OS 2.0 descriptors.The kernel already retrieves and caches the BOS from USB devices if itsbcdUSB is >= 0x0201. Because the BOS is flexible and extensible, we exportthe entire BOS to sysfs so users can retrieve whatever device capabilitiesthey desire, without requiring USB I/O or elevated permissions.Implementation--------------Add bos_descriptors attribute to sysfs. This is a binary file and it worksthe same way as the existing descriptors attribute. The file exists only ifthe BOS is present in the USB device.Also create a binary attribute group, so the driver core can handle thecreation of both the descriptors and bos_descriptors attributes in sysfs.Signed-off-by: Elbert Mai Link: https://lore.kernel.org/r/20240305002301.95323-1-code@elbertmai.comSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

59de2a56 - usb: typec: Link enumerated USB devices with Type-C partner

Wed, 11 Oct 2023 10:58:24 +0000

usb: typec: Link enumerated USB devices with Type-C partnerAdding functions that USB hub code can use to inform theType-C class about connected USB devices.Once taken into use, it will allow the Type-C port driversto power off components that are not needed, for example ifUSB2 device is enumerated, everything that is only relevantfor USB3 (retimers, etc.), can be powered off.This will also create a symlink "typec" for the USB devicespointing to the USB Type-C partner device.Suggested-by: Benson Leung Tested-by: Benson Leung Signed-off-by: Heikki Krogerus Link: https://lore.kernel.org/r/20231011105825.320062-2-heikki.krogerus@linux.intel.comSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

f176638a - USB: Remove Wireless USB and UWB documentation

Wed, 09 Aug 2023 00:44:35 +0000

USB: Remove Wireless USB and UWB documentationSupport for Wireless USB and Ultra WideBand was removed in 2020 bycommit caa6772db4c1 ("Staging: remove wusbcore and UWB from the kerneltree."). But the documentation files were left behind.Let's get rid of that out-of-date documentation.Signed-off-by: Alan Stern Link: https://lore.kernel.org/r/015d4310-bcd3-4ba4-9a0e-3664f281a9be@rowland.harvard.eduSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

83cb2604 - usb: core: add sysfs entry for usb device state

Thu, 08 Jun 2023 01:59:12 +0000

usb: core: add sysfs entry for usb device stateExpose usb device state to userland as the information is useful indetecting non-compliant setups and diagnosing enumeration failures.For example:- End-to-end signal integrity issues: the device would fail port reset repeatedly and thus be stuck in POWERED state.- Charge-only cables (missing D+/D- lines): the device would never enter POWERED state as the HC would not see any pullup.What's the status quo?We do have error logs such as "Cannot enable. Maybe the USB cable is bad?"to flag potential setup issues, but there's no good way to expose them touserspace.Why add a sysfs entry in struct usb_port instead of struct usb_device?The struct usb_device is not device_add() to the system until it's inADDRESS state hence we would miss the first two states. The structusb_port is a better place to keep the information because its lifecycle is longer than the struct usb_device that is attached to the port.Reported-by: kernel test robot Closes: https://lore.kernel.org/oe-lkp/202306042228.e532af6e-oliver.sang@intel.comReviewed-by: Alan Stern Signed-off-by: Roy Luo Message-ID: <20230608015913.1679984-1-royluo@google.com>Signed-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

f98e0640 - USB: core: Add wireless_status sysfs attribute

Thu, 02 Mar 2023 10:55:53 +0000

USB: core: Add wireless_status sysfs attributeAdd a wireless_status sysfs attribute to USB devices to keep track ofwhether a USB device that's comprised of a receiver dongle and an emitterdevice over a, most of the time proprietary, wireless link has its emitterconnected or disconnected.This will be used by user-space OS components to determine whether thebattery-powered part of the device is wirelessly connected or not,allowing, for example:- upower to hide the battery for devices where the device is turned off but the receiver plugged in, rather than showing 0%, or other values that could be confusing to users- Pipewire to hide a headset from the list of possible inputs or outputs or route audio appropriately if the headset is suddenly turned off, or turned on- libinput to determine whether a keyboard or mouse is present when its receiver is plugged in.This is done at the USB interface level as:- the interface on which the wireless status is detected is sometimes not the same as where it could be consumed (eg. the audio interface on a headset dongle will still appear even if the headset is turned off), and we cannot have synchronisation of status across subsystems.- this behaviour is not specific to HID devices, even if the protocols used to determine whether or not the remote device is connected can be HID.This is not an attribute that is meant to replace protocol specificAPIs, such as the ones available for WWAN, WLAN/Wi-Fi, or Bluetoothor any other sort of networking, but solely for wireless devices withan ad-hoc “lose it and your device is e-waste” receiver dongle.The USB interface will only be exporting the wireless_status sysfsattribute if it gets set through the API exported in the next commit.Signed-off-by: Bastien Nocera Acked-by: Greg Kroah-Hartman Acked-by: Alan Stern Link: https://lore.kernel.org/r/20230302105555.51417-4-hadess@hadess.netSigned-off-by: Benjamin Tissoires List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

430d57f5 - usb: core: stop USB enumeration if too many retries

Mon, 07 Nov 2022 07:27:54 +0000

usb: core: stop USB enumeration if too many retriesWhen a broken USB accessory connects to a USB host, usbcore mightkeep doing enumeration retries. If the host has a watchdog mechanism,the kernel panic will happen on the host.This patch provides an attribute early_stop to limit the numbers of retriesfor each port of a hub. If a port was marked with early_stop attribute,unsuccessful connection attempts will fail quickly. In addition, if anearly_stop port has failed to initialize, it will ignore all futureconnection events until early_stop attribute is clear.Signed-off-by: Ray Chi Reviewed-by: Alan Stern Link: https://lore.kernel.org/r/20221107072754.3336357-1-raychi@google.comSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

f061f43d - usb: hub: port: add sysfs entry to switch port power

Tue, 07 Jun 2022 11:45:22 +0000

usb: hub: port: add sysfs entry to switch port powerIn some cases the port of an hub needs to be disabled or switched offand on again. E.g. when the connected device needs to be re-enumerated.Or it needs to be explicitly disabled while the rest of the usb treestays working.For this purpose this patch adds an sysfs switch to enable/disable theport on any hub. In the case the hub is supporting power switching, thepower line will be disabled to the connected device.When the port gets disabled, the associated device gets disconnected andremoved from the logical usb tree. No further device will be enumeratedon that port until the port gets enabled again.Reviewed-by: Alan Stern Signed-off-by: Michael Grzeschik Link: https://lore.kernel.org/r/20220607114522.3359148-1-m.grzeschik@pengutronix.deSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

8c67d06f - usb: Link the ports to the connectors they are attached to

Thu, 23 Dec 2021 08:23:49 +0000

usb: Link the ports to the connectors they are attached toCreating link to the USB Type-C connector for every new portthat is added when possible.Reviewed-by: Andy Shevchenko Acked-by: Rafael J. Wysocki Signed-off-by: Heikki Krogerus Link: https://lore.kernel.org/r/20211223082349.45616-1-heikki.krogerus@linux.intel.comSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

989eff9c - ABI: sysfs-bus-usb: add missing sysfs fields

Mon, 27 Sep 2021 13:59:47 +0000

ABI: sysfs-bus-usb: add missing sysfs fieldsThere are lots of interface, power and endpoint properties that are currentlymissing any documentation.Add a description for them.Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/7f6f7b955032836546f78a9041b22c10b6f4bc5b.1632750608.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

e06ab8d5 - ABI: sysfs-bus-usb: use a wildcard for interface name on What

Mon, 27 Sep 2021 13:59:46 +0000

ABI: sysfs-bus-usb: use a wildcard for interface name on WhatUse instead of INTERFACE, in order for the get_abi.plscript to be able to identify this as a wildcard.Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/cec7048385b6a4779894e19af681226e60f4d8b9.1632750608.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

3628f573 - ABI: sysfs-bus-usb: better document variable argument

Thu, 16 Sep 2021 08:59:28 +0000

ABI: sysfs-bus-usb: better document variable argumentOn almost all ABI documents, variable arguments are declaredas . Change it here too, in order to allow replacingsuch wildcards by regexes on a scriptable way.Acked-by: Heikki Krogerus Acked-by: Rajat Jain Acked-by: Bjorn Helgaas Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/2f7e4e874677dbd82693a6b219decefa18802e8f.1631782432.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

70f400d4 - driver core: Move the "removable" attribute from USB to core

Mon, 24 May 2021 17:18:11 +0000

driver core: Move the "removable" attribute from USB to coreMove the "removable" attribute from USB to core in order to allow it to besupported by other subsystem / buses. Individual buses that want to supportthis attribute can populate the removable property of the device whileenumerating it with the 3 possible values - - "unknown" - "fixed" - "removable"Leaving the field unchanged (i.e. "not supported") would mean that theattribute would not show up in sysfs for that device. The UAPI (location,symantics etc) for the attribute remains unchanged.Move the "removable" attribute from USB to the device core so it can beused by other subsystems / buses.By default, devices do not have a "removable" attribute in sysfs.If a subsystem or bus driver wants to support a "removable" attribute, itshould call device_set_removable() before calling device_register() ordevice_add(), e.g.: device_set_removable(dev, DEVICE_REMOVABLE); device_register(dev);The possible values and the resulting sysfs attribute contents are: DEVICE_REMOVABLE_UNKNOWN -> "unknown" DEVICE_REMOVABLE -> "removable" DEVICE_FIXED -> "fixed"Convert the USB "removable" attribute to use this new device corefunctionality. There should be no user-visible change in the location orsemantics of attribute for USB devices.Reviewed-by: Bjorn Helgaas Signed-off-by: Rajat Jain Link: https://lore.kernel.org/r/20210524171812.18095-1-rajatja@google.comSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

5bdb080f - Revert "usb: Link the ports to the connectors they are attached to"

Mon, 12 Apr 2021 12:36:02 +0000

Revert "usb: Link the ports to the connectors they are attached to"This reverts commit 63cd78617350dae99cc5fbd8f643b83ee819fe33 as itcauses a build error: depmod: ERROR: Cycle detected: usbcore -> typec -> usbcore depmod: ERROR: Found 2 modules in dependency cycles!Reported-by: Stephen Rothwell Link: https://lore.kernel.org/r/20210412213655.3776e15e@canb.auug.org.auCc: Heikki Krogerus Signed-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

63cd7861 - usb: Link the ports to the connectors they are attached to

Wed, 07 Apr 2021 06:55:53 +0000

usb: Link the ports to the connectors they are attached toCreating link to the USB Type-C connector for every new portthat is added when possible.Signed-off-by: Heikki Krogerus Link: https://lore.kernel.org/r/20210407065555.88110-3-heikki.krogerus@linux.intel.comSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

54a19b4d - docs: ABI: cleanup several ABI documents

Fri, 30 Oct 2020 07:40:50 +0000

docs: ABI: cleanup several ABI documentsThere are some ABI documents that, while they don't generateany warnings, they have issues when parsed by get_abi.pl scripton its output result.Address them, in order to provide a clean output.Reviewed-by: Tom Rix # for fpga-managerReviewed-By: Kajol Jain # for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7Acked-by: Jonathan Cameron #for IIOAcked-by: Oded Gabbay # for HabanalabsAcked-by: Vaibhav Jain # for sysfs-bus-papr-pmemAcked-by: Cezary Rojewski # for catptAcked-by: Suzuki K Poulose Acked-by: Ilya Dryomov # for rbdAcked-by: Jonathan Corbet Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/5bc78e5b68ed1e9e39135173857cb2e753be868f.1604042072.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

34433332 - docs: ABI: testing: make the files compatible with ReST output

Fri, 30 Oct 2020 07:40:39 +0000

docs: ABI: testing: make the files compatible with ReST outputSome files over there won't parse well by Sphinx.Fix them.Acked-by: Jonathan Cameron # for IIOAcked-by: Fabrice Gasnier Acked-by: Jonathan Corbet Signed-off-by: Mauro Carvalho Chehab Link: https://lore.kernel.org/r/58cf3c2d611e0197fb215652719ebd82ca2658db.1604042072.git.mchehab+huawei@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

68f1ec8e - usb: Change "wired" to "hardwired" for connect_type

Fri, 01 Feb 2019 21:55:07 +0000

usb: Change "wired" to "hardwired" for connect_typeThe sysfs documentation for /sys/bus/usb/.../portX/connect_type has oneof the possible values listed as "wired" when the actual value should be"hardwired".Changes the ABI documentation for connect_type to match the strings inport.c.Signed-off-by: Jon Flatley Signed-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

355c74e5 - usb: export firmware port location in sysfs

Fri, 28 Sep 2018 13:40:31 +0000

usb: export firmware port location in sysfsThe platform firmware "location" data is used to find port peerrelationships. But firmware is an unreliable source, and there arereal world examples of errors leading to missing or wrong peerrelationships. Debugging this is currently hard.Exporting the location attribute makes it easier to spot mismatchesbetween the firmware data and the real world.Signed-off-by: Bjørn Mork Signed-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

201af55d - usb: core: added uevent for over-current

Thu, 20 Sep 2018 17:17:54 +0000

usb: core: added uevent for over-currentAfter commit 1cbd53c8cd85 ("usb: core: introduce per-port over-currentcounters") usb ports expose a sysfs value 'over_current_count'to user space. This value on its own is not very useful as it requiresmanual polling.As a solution, fire a udev event from the usb hub device that specifiesthe values 'OVER_CURRENT_PORT' and 'OVER_CURRENT_COUNT' that indicatethe path of the usb port where the over-current event occurred and thevalue of 'over_current_count' in sysfs. Additionally, callsysfs_notify() so the sysfs value supports poll().Signed-off-by: Jon Flatley Signed-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb

aa071a92 - usb: hub: Per-port setting to reduce TRSTRCY to 10 ms

Mon, 28 May 2018 06:32:19 +0000

usb: hub: Per-port setting to reduce TRSTRCY to 10 msCurrently, the USB hub core waits for 50 ms after enumerating thedevice. This was added to help "some high speed devices" toenumerate (b789696af8 "[PATCH] USB: relax usbcore reset timings").On some devices, the time-to-active is important, so we providea per-port option to reduce the time to what the USB specificationrequires: 10 ms.Signed-off-by: Nicolas Boichat Signed-off-by: Greg Kroah-Hartman List of files: /linux-6.15/Documentation/ABI/testing/sysfs-bus-usb