| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Message-ID: <20210113070850.1184506-2-troy_lee@aspeedtech.com>
Date: Wed, 13 Jan 2021 07:08:45 +0000
From: Troy Lee <troy_lee@...eedtech.com>
To: <openbmc@...ts.ozlabs.org>, Jean Delvare <jdelvare@...e.com>,
"Guenter Roeck" <linux@...ck-us.net>,
Rob Herring <robh+dt@...nel.org>,
Joel Stanley <joel@....id.au>,
Andrew Jeffery <andrew@...id.au>,
Jonathan Corbet <corbet@....net>,
Philipp Zabel <p.zabel@...gutronix.de>,
Ryan Chen <ryan_chen@...eedtech.com>,
"open list:HARDWARE MONITORING" <linux-hwmon@...r.kernel.org>,
"open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS"
<devicetree@...r.kernel.org>,
"moderated list:ARM/ASPEED MACHINE SUPPORT"
<linux-arm-kernel@...ts.infradead.org>,
"moderated list:ARM/ASPEED MACHINE SUPPORT"
<linux-aspeed@...ts.ozlabs.org>,
open list <linux-kernel@...r.kernel.org>,
"open list:DOCUMENTATION" <linux-doc@...r.kernel.org>
CC: <chiawei_wang@...eedtech.com>, <leetroy@...il.com>,
<troy_lee@...eedtech.com>
Subject: [PATCH v2 1/4] dt-bindings: hwmon: Add Aspeed AST2600 PWM/Fan
We add binding for supporting a new AST2600 PWM/Fan hwmon driver.
Changes since v1:
- dt binding with DT schema format
Signed-off-by: Troy Lee <troy_lee@...eedtech.com>
---
.../hwmon/aspeed,ast2600-pwm-tachometer.yaml | 137 ++++++++++++++++++
1 file changed, 137 insertions(+)
create mode 100644 Documentation/devicetree/bindings/hwmon/aspeed,ast2600-pwm-tachometer.yaml
diff --git a/Documentation/devicetree/bindings/hwmon/aspeed,ast2600-pwm-tachometer.yaml b/Documentation/devicetree/bindings/hwmon/aspeed,ast2600-pwm-tachometer.yaml
new file mode 100644
index 000000000000..b84076a4a338
--- /dev/null
+++ b/Documentation/devicetree/bindings/hwmon/aspeed,ast2600-pwm-tachometer.yaml
@@ -0,0 +1,137 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+
+$id: http://devicetree.org/schemas/hwmon/aspeed,ast2600-pwm-tachometer.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: ASPEED AST2600 PWM and Fan Tacho controller device driver
+
+maintainers:
+ - Ryan Chen <ryan_chen@...eedtech.com>
+
+description: |
+ The ASPEED PWM controller can support upto 16 PWM outputs. The ASPEED Fan Tacho
+ controller can support upto 16 Fan tachometer inputs.
+ There can be upto 16 fans supported. Each fan can have one PWM output and
+ one Fan tach inputs.
+
+properties:
+ compatible:
+ const: aspeed,ast2600-pwm-tachometer
+
+ "#address-cells":
+ const: 1
+
+ "#size-cells":
+ const: 0
+
+ "#cooling-cells":
+ const: 2
+
+ reg:
+ description:
+ Address and length of the register set for the device.
+
+ clocks:
+ description:
+ phandle to clock provider with the clock number in the second cell
+
+ resets:
+ description:
+ phandle to reset controller with the reset number in the second cell
+
+patternProperties:
+ "@[0-9]+$":
+ type: object
+ description:
+ Under fan subnode there can upto 16 child nodes, with each child node
+ representing a fan. There are 16 fans each fan can have one PWM port and one
+ Fan tach inputs.
+ For PWM port can be configured cooling-levels to create cooling device.
+ Cooling device could be bound to a thermal zone for the thermal control.
+
+ properties:
+ reg:
+ minimum: 0
+ maximum: 15
+ description:
+ This property identify the PWM control channel of this fan.
+
+ fan-tach-ch:
+ $ref: /schemas/types.yaml#/definitions/uint8
+ minimum: 0
+ maximum: 15
+ description:
+ This property identify the fan tach input channel.
+
+ pulses-per-revolution:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ default: 2
+ minimum: 1
+ description:
+ Specify tacho pulse per revolution of the fan.
+
+ cooling-levels:
+ description:
+ PWM duty cycle values in a range from 0 to 255
+ which correspond to thermal cooling states.
+
+ aspeed,pwm-freq:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ default: 25000
+ minimum: 24
+ maximum: 780000
+ description:
+ Specify the frequency of PWM.
+
+ aspeed,inverse-pin:
+ type: boolean
+ description:
+ Inverse PWM output signal.
+
+ aspeed,falling-point:
+ $ref: /schemas/types.yaml#/definitions/uint8
+ default: 10
+ minimum: 0
+ maximum: 255
+ description:
+ Initialize the pulse width.
+
+ required:
+ - fan-tach-ch
+ - reg
+
+ additionalProperties: true
+
+required:
+ - compatible
+ - reg
+
+additionalProperties: false
+
+examples:
+ - |
+ pwm_tacho: pwm-tacho-controller@...10000 {
+ compatible = "aspeed,ast2600-pwm-tachometer";
+ #address-cells = <1>;
+ #size-cells = <0>;
+ reg = <0x1e610000 0x100>;
+
+ fan@1 {
+ reg = <0x00>;
+ aspeed,pwm-freq = <25000>;
+ cooling-levels = /bits/ 8 <125 151 177 203 229 255>;
+ fan-tach-ch = /bits/ 8 <0x00>;
+ pulses-per-revolution = <2>;
+ };
+
+ fan@2 {
+ reg = <0x01>;
+ aspeed,pwm-freq = <25000>;
+ cooling-levels = /bits/ 8 <125 151 177 203 229 255>;
+ fan-tach-ch = /bits/ 8 <0x01>;
+ pulses-per-revolution = <2>;
+ };
+ };
+...
--
2.25.1
Powered by blists - more mailing lists