[patch 31/32] greybus: documentation

2016-09-16 Thread Greg KH
This describes all of the sysfs files that greybus exposes to userspace

Signed-off-by: Greg Kroah-Hartman 
---
 Documentation/ABI/testing/sysfs-bus-greybus |  275 
 1 file changed, 275 insertions(+)

--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-greybus
@@ -0,0 +1,275 @@
+What:  /sys/bus/greybus/devices/greybusN
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The "root" greybus device for the Greybus device tree, or bus,
+   where N is a dynamically assigned 1-based id.
+
+What:  /sys/bus/greybus/devices/greybusN/bus_id
+Date:  April 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The ID of the "root" greybus device, or bus.
+
+What:  /sys/bus/greybus/devices/N-M
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   A Module M on the bus N, where M is the 1-byte interface
+   ID of the module's primary interface.
+
+What:  /sys/bus/greybus/devices/N-M/eject
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Writing a non-zero argument to this attibute disables the
+   module's interfaces before physically ejecting it.
+
+What:  /sys/bus/greybus/devices/N-M/module_id
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The ID of a Greybus module, corresponding to the ID of its
+   primary interface.
+
+What:  /sys/bus/greybus/devices/N-M/num_interfaces
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The number of interfaces of a module.
+
+What:  /sys/bus/greybus/devices/N-M.I
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   An Interface I on the bus N and module N-M, where I is the
+   1-byte interface ID.
+
+What:  /sys/bus/greybus/devices/N-M.I/current_now
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Current measurement of the interface in microamps (uA)
+
+What:  /sys/bus/greybus/devices/N-M.I/ddbl1_manufacturer_id
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Unipro Device Descriptor Block Level 1 manufacturer ID for the
+   greybus Interface.
+
+What:  /sys/bus/greybus/devices/N-M.I/ddbl1_product_id
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Unipro Device Descriptor Block Level 1 product ID for the
+   greybus Interface.
+
+What:  /sys/bus/greybus/devices/N-M.I/interface_id
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The ID of a Greybus interface.
+
+What:  /sys/bus/greybus/devices/N-M.I/interface_type
+Date:  June 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The type of a Greybus interface; "dummy", "unipro", "greybus",
+   or "unknown".
+
+What:  /sys/bus/greybus/devices/N-M.I/power_now
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Power measurement of the interface in microwatts (uW)
+
+What:  /sys/bus/greybus/devices/N-M.I/power_state
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   This file reflects the power state of a Greybus interface. If
+   the value read from it is "on", then power is currently
+   supplied to the interface. Otherwise it will read "off" and
+   power is currently not supplied to the interface.
+
+   If the value read is "off", then writing "on" (or '1', 'y',
+   'Y') to this file will enable power to the interface and an
+   attempt to boot and possibly enumerate it will be made. Note
+   that on errors, the interface will again be powered down.
+
+   If the value read is "on", then writing "off" (or '0', 'n',
+   'N') to this file will power down the interface.
+
+What:  /sys/bus/greybus/devices/N-M.I/product_id
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Product ID of a Greybus interface.
+
+What:

[patch 31/32] greybus: documentation

2016-09-16 Thread Greg KH
This describes all of the sysfs files that greybus exposes to userspace

Signed-off-by: Greg Kroah-Hartman 
---
 Documentation/ABI/testing/sysfs-bus-greybus |  275 
 1 file changed, 275 insertions(+)

--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-bus-greybus
@@ -0,0 +1,275 @@
+What:  /sys/bus/greybus/devices/greybusN
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The "root" greybus device for the Greybus device tree, or bus,
+   where N is a dynamically assigned 1-based id.
+
+What:  /sys/bus/greybus/devices/greybusN/bus_id
+Date:  April 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The ID of the "root" greybus device, or bus.
+
+What:  /sys/bus/greybus/devices/N-M
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   A Module M on the bus N, where M is the 1-byte interface
+   ID of the module's primary interface.
+
+What:  /sys/bus/greybus/devices/N-M/eject
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Writing a non-zero argument to this attibute disables the
+   module's interfaces before physically ejecting it.
+
+What:  /sys/bus/greybus/devices/N-M/module_id
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The ID of a Greybus module, corresponding to the ID of its
+   primary interface.
+
+What:  /sys/bus/greybus/devices/N-M/num_interfaces
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The number of interfaces of a module.
+
+What:  /sys/bus/greybus/devices/N-M.I
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   An Interface I on the bus N and module N-M, where I is the
+   1-byte interface ID.
+
+What:  /sys/bus/greybus/devices/N-M.I/current_now
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Current measurement of the interface in microamps (uA)
+
+What:  /sys/bus/greybus/devices/N-M.I/ddbl1_manufacturer_id
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Unipro Device Descriptor Block Level 1 manufacturer ID for the
+   greybus Interface.
+
+What:  /sys/bus/greybus/devices/N-M.I/ddbl1_product_id
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Unipro Device Descriptor Block Level 1 product ID for the
+   greybus Interface.
+
+What:  /sys/bus/greybus/devices/N-M.I/interface_id
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The ID of a Greybus interface.
+
+What:  /sys/bus/greybus/devices/N-M.I/interface_type
+Date:  June 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   The type of a Greybus interface; "dummy", "unipro", "greybus",
+   or "unknown".
+
+What:  /sys/bus/greybus/devices/N-M.I/power_now
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Power measurement of the interface in microwatts (uW)
+
+What:  /sys/bus/greybus/devices/N-M.I/power_state
+Date:  March 2016
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   This file reflects the power state of a Greybus interface. If
+   the value read from it is "on", then power is currently
+   supplied to the interface. Otherwise it will read "off" and
+   power is currently not supplied to the interface.
+
+   If the value read is "off", then writing "on" (or '1', 'y',
+   'Y') to this file will enable power to the interface and an
+   attempt to boot and possibly enumerate it will be made. Note
+   that on errors, the interface will again be powered down.
+
+   If the value read is "on", then writing "off" (or '0', 'n',
+   'N') to this file will power down the interface.
+
+What:  /sys/bus/greybus/devices/N-M.I/product_id
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Product ID of a Greybus interface.
+
+What:  /sys/bus/greybus/devices/N-M.I/serial_number
+Date:  October 2015
+KernelVersion: 4.9
+Contact:   Greg Kroah-Hartman 
+Description:
+   Serial Number of the Greybus interface, represented by a 64 bit
+   hexadecimal number.
+