linux-imx/Documentation/ABI/testing/usb-charger-uevent
Mauro Carvalho Chehab 54a19b4d3f docs: ABI: cleanup several ABI documents
There are some ABI documents that, while they don't generate
any warnings, they have issues when parsed by get_abi.pl script
on its output result.

Address them, in order to provide a clean output.

Reviewed-by: Tom Rix <trix@redhat.com> # for fpga-manager
Reviewed-By: Kajol Jain<kjain@linux.ibm.com> # for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7
Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for IIO
Acked-by: Oded Gabbay <oded.gabbay@gmail.com> # for Habanalabs
Acked-by: Vaibhav Jain <vaibhav@linux.ibm.com> # for sysfs-bus-papr-pmem
Acked-by: Cezary Rojewski <cezary.rojewski@intel.com> # for catpt
Acked-by: Suzuki K Poulose <suzuki.poulose@arm.com>
Acked-by: Ilya Dryomov <idryomov@gmail.com> # for rbd
Acked-by: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/5bc78e5b68ed1e9e39135173857cb2e753be868f.1604042072.git.mchehab+huawei@kernel.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
2020-10-30 13:14:29 +01:00

1.7 KiB

What: Raise a uevent when a USB charger is inserted or removed Date: 2020-01-14 KernelVersion: 5.6 Contact: linux-usb@vger.kernel.org Description: There are two USB charger states:

	- USB_CHARGER_ABSENT
	- USB_CHARGER_PRESENT

	There are five USB charger types:

	========================  ==========================
	USB_CHARGER_UNKNOWN_TYPE  Charger type is unknown
	USB_CHARGER_SDP_TYPE      Standard Downstream Port
	USB_CHARGER_CDP_TYPE      Charging Downstream Port
	USB_CHARGER_DCP_TYPE      Dedicated Charging Port
	USB_CHARGER_ACA_TYPE      Accessory Charging Adapter
	========================  ==========================

	https://www.usb.org/document-library/battery-charging-v12-spec-and-adopters-agreement

	Here are two examples taken using ``udevadm monitor -p`` when
	USB charger is online::

	    UDEV  change   /devices/soc0/usbphynop1 (platform)
	    ACTION=change
	    DEVPATH=/devices/soc0/usbphynop1
	    DRIVER=usb_phy_generic
	    MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
	    OF_COMPATIBLE_0=usb-nop-xceiv
	    OF_COMPATIBLE_N=1
	    OF_FULLNAME=/usbphynop1
	    OF_NAME=usbphynop1
	    SEQNUM=2493
	    SUBSYSTEM=platform
	    USB_CHARGER_STATE=USB_CHARGER_PRESENT
	    USB_CHARGER_TYPE=USB_CHARGER_SDP_TYPE
	    USEC_INITIALIZED=227422826

	USB charger is offline::

	    KERNEL change   /devices/soc0/usbphynop1 (platform)
	    ACTION=change
	    DEVPATH=/devices/soc0/usbphynop1
	    DRIVER=usb_phy_generic
	    MODALIAS=of:Nusbphynop1T(null)Cusb-nop-xceiv
	    OF_COMPATIBLE_0=usb-nop-xceiv
	    OF_COMPATIBLE_N=1
	    OF_FULLNAME=/usbphynop1
	    OF_NAME=usbphynop1
	    SEQNUM=2494
	    SUBSYSTEM=platform
	    USB_CHARGER_STATE=USB_CHARGER_ABSENT
	    USB_CHARGER_TYPE=USB_CHARGER_UNKNOWN_TYPE