thermal: sti: Supply Device Tree documentation

Signed-off-by: Ajit Pal Singh <ajitpal.singh@st.com>
Acked-by: Peter Griffin <peter.griffin@linaro.org>
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Signed-off-by: Zhang Rui <rui.zhang@intel.com>

1 files changed, 42 insertions, 0 deletions

diff --git a/Documentation/devicetree/bindings/thermal/st-thermal.txt b/Documentation/devicetree/bindings/thermal/st-thermal.txt
new file mode 100644
index 000000000000..3b9251b4a145
--- /dev/null
+++ b/Documentation/devicetree/bindings/thermal/st-thermal.txt
@@ -0,0 +1,42 @@
+Binding for Thermal Sensor driver for STMicroelectronics STi series of SoCs.
+
+Required parameters:
+-------------------
+
+compatible :    st,<SoC>-<module>-thermal; should be one of:
+                  "st,stih415-sas-thermal",
+                  "st,stih415-mpe-thermal",
+                  "st,stih416-sas-thermal"
+                  "st,stih416-mpe-thermal"
+                  "st,stid127-thermal" or
+                  "st,stih407-thermal"
+                according to the SoC type (stih415, stih416, stid127, stih407)
+                and module type (sas or mpe). On stid127 & stih407 there is only
+                one die/module, so there is no module type in the compatible
+                string.
+clock-names :   Should be "thermal".
+                  See: Documentation/devicetree/bindings/resource-names.txt
+clocks :        Phandle of the clock used by the thermal sensor.
+                  See: Documentation/devicetree/bindings/clock/clock-bindings.txt
+
+Optional parameters:
+-------------------
+
+reg :           For non-sysconf based sensors, this should be the physical base
+                address and length of the sensor's registers.
+interrupts :    Standard way to define interrupt number.
+                Interrupt is mandatory to be defined when compatible is
+                "stih416-mpe-thermal".
+                  NB: For thermal sensor's for which no interrupt has been
+                  defined, a polling delay of 1000ms will be used to read the
+                  temperature from device.
+
+Example:
+
+        temp1@fdfe8000 {
+                compatible      = "st,stih416-mpe-thermal";
+                reg             = <0xfdfe8000 0x10>;
+                clock-names     = "thermal";
+                clocks          = <&clk_m_mpethsens>;
+                interrupts      = <GIC_SPI 23 IRQ_TYPE_NONE>;
+        };