Signed-off-by: Andrew Jeffery <and...@aj.id.au>
---
 Documentation/ABI/testing/sysfs-class-bmc | 62 +++++++++++++++++++++++
 1 file changed, 62 insertions(+)
 create mode 100644 Documentation/ABI/testing/sysfs-class-bmc

diff --git a/Documentation/ABI/testing/sysfs-class-bmc 
b/Documentation/ABI/testing/sysfs-class-bmc
new file mode 100644
index 000000000000..9d42106b89f9
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-class-bmc
@@ -0,0 +1,62 @@
+This document defines the sysfs attributes common to the bmc device class. See
+Documentation/devicetree/bindings/misc/bmc-misc-ctrl.txt for exhaustive list of
+field definitions.
+
+What:          /sys/class/bmc/<field>/label
+Date:          July, 2018
+KernelVersion: v4.19
+Contact:       open...@lists.ozlabs.org
+Description:
+               The name of the field of interest. Corresponds to the value of
+               <field> in the path
+Users:         open...@lists.ozlabs.org
+
+What:          /sys/class/bmc/<field>/value
+Date:          July, 2018
+KernelVersion: v4.19
+Contact:       open...@lists.ozlabs.org
+Description:
+               The value of the field of interest.
+
+               If the field is exposed from a read-modify-write register this
+               attribute will be RW, where writes will set the field to the
+               value written. Writing values that exceed the width of the
+               field will return an error.
+
+               If the field is exposed from a write-1-set/write-1-clear
+               register this attribute will be RO, and the attributes 'set'
+               and 'clear' will be present as write-only.
+Users:         open...@lists.ozlabs.org
+
+What:          /sys/class/bmc/<field>/mask
+Date:          July, 2018
+KernelVersion: v4.19
+Contact:       open...@lists.ozlabs.org
+Description:
+               The mask applied to the value read/written from the 'value'
+               attribute.
+Users:         open...@lists.ozlabs.org
+
+What:          /sys/class/bmc/<field>/set
+Users:         open...@lists.ozlabs.org
+Date:          July, 2018
+KernelVersion: v4.19
+Contact:       open...@lists.ozlabs.org
+Description:
+               For fields backed by write-1-set/write-1-clear registers,
+               set bits in the value written will be set in hardware. Zero
+               values are ignored. Writing values that exceed the width of the
+               mask value will return an error.
+Users:         open...@lists.ozlabs.org
+
+What:          /sys/class/bmc/<field>/clear
+Users:         open...@lists.ozlabs.org
+Date:          July, 2018
+KernelVersion: v4.19
+Contact:       open...@lists.ozlabs.org
+Description:
+               For fields backed by write-1-set/write-1-clear registers,
+               set bits in the value written will be cleared in hardware. Zero
+               values are ignored. Writing values that exceed the width of the
+               mask value will return an error.
+Users:         open...@lists.ozlabs.org
-- 
2.17.1

Reply via email to