xref: /linux/Documentation/devicetree/bindings/mfd/khadas,mcu.yaml (revision 2ed2e359dea752e7758d29a423033031a0b96584) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/mfd/khadas,mcu.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Khadas on-board Microcontroller
8
9maintainers:
10  - Neil Armstrong <neil.armstrong@linaro.org>
11
12description: |
13  Khadas embeds a microcontroller on their VIM and Edge boards adding some
14  system feature as PWM Fan control (for VIM2 rev14 or VIM3), User memory
15  storage, IR/Key resume control, system power LED control and more.
16
17properties:
18  compatible:
19    enum:
20      - khadas,mcu # MCU revision is discoverable
21      - khadas,vim4-mcu # Different MCU variant, not discoverable
22
23  "#cooling-cells": # Only needed for boards having FAN control feature
24    const: 2
25
26  reg:
27    maxItems: 1
28
29  fan-supply:
30    description: Phandle to the regulator that powers the fan.
31
32required:
33  - compatible
34  - reg
35
36allOf:
37  - if:
38      properties:
39        compatible:
40          contains:
41            const: khadas,vim4-mcu
42    then:
43      required:
44        - fan-supply
45    else:
46      properties:
47        fan-supply: false
48
49additionalProperties: false
50
51examples:
52  - |
53    i2c {
54      #address-cells = <1>;
55      #size-cells = <0>;
56      khadas_mcu: system-controller@18 {
57        compatible = "khadas,mcu";
58        reg = <0x18>;
59        #cooling-cells = <2>;
60      };
61    };
62