alistair23-linux/drivers/staging/greybus/Documentation/sysfs-bus-greybus

What:		/sys/bus/greybus/device/endoE
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The "root" endo devices for the Greybus device tree. E
		is replaced with a 2 byte number representing the endo,
		mostly 0.

What:		/sys/bus/greybus/device/endoE/id
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The Endo ID, which is a 2-byte hexadecimal value
		defined by the Endo layout scheme, documented in
		the ARA Module Developer Kit.

What:		/sys/bus/greybus/device/endoE/ap_intf_id
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The AP interface ID, a 1-byte non-zero integer which
		defines the position of the AP module on the Endo.
		The interface positions are defined in the ARA
		Module Developer Kit.

What:		/sys/bus/greybus/device/endoE/svc/serial_number
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The serial number of the SVC device

What:		/sys/bus/greybus/device/endoE/svc/version
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The version number of the firmware in the SVC device.

What:		/sys/bus/greybus/device/endoE:M
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		A module slot on the endoE, M is replaced by a 1-byte
		number representing the module slot.

What:		/sys/bus/greybus/device/endoE:M/epm
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The EPM (Electropermanent Magnet) control file for
		the specific module slot the file is present in.
		Writing 1 to it turns it on, writing 0 to it turns it
		off.  Reading the value returns if it is on or off.

What:		/sys/bus/greybus/device/endoE:M/power_control
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The power control file for the specific module slot that
		the file is present in.  Writing 1 to it turns power on
		to the module, writing 0 to it turns power off to the
		module.  Reading the value returns if it is on or off.

What:		/sys/bus/greybus/device/endoE:M/present
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The "is a module present in the slot" file for the
		specific module slot that the file is present in.
		This is read-only, 1 means a module is present, 0 means
		no module is present.

What:		/sys/bus/greybus/device/endoE:M:I
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		An Interface I on the module slot M on the endoE, I is
		replaced by a 1-byte number representing the interface.

What:		/sys/bus/greybus/device/endoE:M:I/device_id
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The device ID of a Greybus interface block.

What:		/sys/bus/greybus/device/endoE:M:I/product
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Product ID of a Greybus interface block.

What:		/sys/bus/greybus/device/endoE:M:I/product_string
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Product ID string of a Greybus interface block.

What:		/sys/bus/greybus/device/endoE:M:I/vendor
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Vendor ID of a Greybus interface block.

What:		/sys/bus/greybus/device/endoE:M:I/vendor_string
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		Vendor ID string of a Greybus interface block.

What:		/sys/bus/greybus/device/endoE:M:I:B
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		A bundle B on the Interface I, B is replaced by a 1-byte
		number representing the bundle.

What:		/sys/bus/greybus/device/endoE:M:I:B/class
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		The greybus class of the bundle B.

What:		/sys/bus/greybus/device/endoE:M:I:B/state
Date:		October 2015
KernelVersion:	4.XX
Contact:	Greg Kroah-Hartman <greg@kroah.com>
Description:
		A bundle has a state that is managed by the userspace
		Endo process.  This file allows that Endo to signal
		other Android HALs that the state of the bundle has
		changed to a specific value.  When written to, any
		process watching the file will be woken up, and the new
		value can be read. It's a "poor-man's IPC", yes, but
		simplifies the Android userspace code immensely.