[PATCH v1 3/9] dt-bindings: mfd: document ASUS Transformer EC
From: Svyatoslav Ryhel <hidden>
Date: 2026-02-01 10:44:15
Also in:
linux-input, linux-leds, linux-pm, lkml
Subsystem:
multifunction devices (mfd), open firmware and flattened device tree bindings, the rest · Maintainers:
Lee Jones, Rob Herring, Krzysztof Kozlowski, Conor Dooley, Linus Torvalds
Document embedded controller used in ASUS Transformer device series. Signed-off-by: Svyatoslav Ryhel <redacted> --- .../devicetree/bindings/mfd/asus,ec.yaml | 153 ++++++++++++++++++ 1 file changed, 153 insertions(+) create mode 100644 Documentation/devicetree/bindings/mfd/asus,ec.yaml
diff --git a/Documentation/devicetree/bindings/mfd/asus,ec.yaml b/Documentation/devicetree/bindings/mfd/asus,ec.yaml
new file mode 100644
index 000000000000..5c28deebce7b
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/asus,ec.yaml@@ -0,0 +1,153 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mfd/asus,ec.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: ASUS Transformer's Embedded Controller + +description: + Several Nuvoton based Embedded Controller attached to an I2C bus, + running a custom ASUS firmware, specific to the Asus Transformer + device series. + +maintainers: + - Svyatoslav Ryhel <clamor95@gmail.com> + +properties: + compatible: + oneOf: + - enum: + - asus,ec-pad # Pad part of Asus Transformer + - asus,ec-dock # Dock part of Asus Transformer + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + + request-gpio: + maxItems: 1 + + asus,dockram: + $ref: /schemas/types.yaml#/definitions/phandle + description: I2C device used to access power related functions. + + battery: + type: object + $ref: /schemas/power/supply/power-supply.yaml + unevaluatedProperties: false + + properties: + compatible: + const: asus,ec-battery + + required: + - compatible + + charger: + type: object + $ref: /schemas/power/supply/power-supply.yaml + additionalProperties: false + + properties: + compatible: + const: asus,ec-charger + + monitored-battery: true + + required: + - compatible + + keyboard-ext: + type: object + description: top row of multimedia keys + additionalProperties: false + + properties: + compatible: + const: asus,ec-keys + + required: + - compatible + + led: + type: object + additionalProperties: false + + properties: + compatible: + const: asus,ec-led + + required: + - compatible + + serio: + type: object + description: keyboard and touchpad + additionalProperties: false + + properties: + compatible: + const: asus,ec-kbc + + required: + - compatible + + asus,clear-factory-mode: + type: boolean + description: clear Factory Mode bit in EC control register + additionalProperties: false + +required: + - compatible + - reg + - interrupts + - request-gpio + - asus,dockram + +additionalProperties: false + +examples: + - | + #include <dt-bindings/gpio/gpio.h> + #include <dt-bindings/interrupt-controller/irq.h> + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + embedded-controller@19 { + compatible = "asus,ec-dock"; + reg = <0x19>; + + interrupt-parent = <&gpio>; + interrupts = <151 IRQ_TYPE_LEVEL_LOW>; + + request-gpio = <&gpio 134 GPIO_ACTIVE_LOW>; + asus,dockram = <&dockram_ec>; + + battery { + compatible = "asus,ec-battery"; + monitored-battery = <&dock_battery>; + }; + + charger { + compatible = "asus,ec-charger"; + monitored-battery = <&dock_battery>; + }; + + keyboard-ext { + compatible = "asus,ec-keys"; + }; + + led { + compatible = "asus,ec-led"; + }; + + serio { + compatible = "asus,ec-kbc"; + }; + }; + }; +...
--
2.51.0