From mboxrd@z Thu Jan 1 00:00:00 1970 From: Xinwei Kong Subject: [PATCH v2 1/2] dt-bindings: Document the hi6220 thermal sensor bindings Date: Tue, 31 Mar 2015 14:59:21 +0800 Message-ID: <1427785162-15172-2-git-send-email-kong.kongxinwei@hisilicon.com> References: <1427785162-15172-1-git-send-email-kong.kongxinwei@hisilicon.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: In-Reply-To: <1427785162-15172-1-git-send-email-kong.kongxinwei@hisilicon.com> Sender: linux-kernel-owner@vger.kernel.org To: rui.zhuang@intel.com, edubezval@gmail.com Cc: linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linuxarm@huawei.com, devicetree@vger.kernel.org, liguozhu@hisilicon.com, xuwei5@hisilicon.com, jorge.ramirez-ortiz@linaro.org, xweikong@hotmail.com, mark.rutland@arm.com List-Id: devicetree@vger.kernel.org From: kongxinwei This adds documentation of device tree bindings for the thermal sensor controller of hi6220 SoC. Signed-off-by: Leo Yan Signed-off-by: kongxinwei --- .../bindings/thermal/hisilicon-thermal.txt | 45 ++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 Documentation/devicetree/bindings/thermal/hisilicon-thermal.txt diff --git a/Documentation/devicetree/bindings/thermal/hisilicon-thermal.txt b/Documentation/devicetree/bindings/thermal/hisilicon-thermal.txt new file mode 100644 index 0000000..ceb6e2e --- /dev/null +++ b/Documentation/devicetree/bindings/thermal/hisilicon-thermal.txt @@ -0,0 +1,45 @@ +* Hisilicon Thermal + +This driver is for hi6220 SoC which contain 4 thermal sensor. + + 1. sensor 0: local sensor; + 2. sensor 1: remote sensor for ACPU cluster 1; + 3. sensor 2: remote sensor for ACPU cluster 2; + 4. sensor 3: remote sensor for GPU. + +Every sensor use one child node to represent it, so thermal sensor include +parent node and four child node. The parent node describe common feature and +child node describe private feature for thermal sensor; + +** Required properties : + +- compatible: "hisilicon,tsensor". +- reg: physical base address of thermal sensor and length of memory mapped + region. +- interrupt: The interrupt number to the cpu. Defines the interrupt used + by SOCTHERM. +- clock-names: Input clock name, should be 'thermal_clk'. +- clocks: phandles for clock specified in "clock-names" property. +- #thermal-sensor-cells: Should be 1. See ./thermal.txt for a description. + +** Required properties for child nodes : + +- hisilicon,tsensor-id: the index of thermal sensor and use it to distinguish + thermal sensor. For example: <0> stands for local sensor; <1> stands for + acpu1 sensor; + +Example : + + tsensor: tsensor@0,f7030700 { + compatible = "hisilicon,tsensor"; + reg = <0x0 0xf7030700 0x0 0x1000>; + interrupts = <0 7 0x4>; + clocks = <&clock_sys HI6220_TSENSOR_CLK>; + clock-names = "thermal_clk"; + #thermal-sensor-cells = <1>; + + local_sensor { + hisilicon,tsensor-id = <0>; + } + ....... + } -- 1.9.1