summaryrefslogtreecommitdiffstats
path: root/Documentation/devicetree/bindings/mfd/samsung,s2mu005-pmic.yaml
blob: aff68c035b38ef56f097aa3e223eaad5e525f524 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/mfd/samsung,s2mu005-pmic.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Samsung S2MU005 Power Management IC

maintainers:
  - Kaustabh Chakraborty <kauschluss@disroot.org>

description: |
  The S2MU005 is a companion power management IC which includes subdevices for
  a charger controller, an MUIC (Micro USB Interface Controller), and flash and
  RGB LED controllers.

allOf:
  - $ref: /schemas/power/supply/power-supply.yaml#

properties:
  compatible:
    const: samsung,s2mu005-pmic

  flash:
    $ref: /schemas/leds/samsung,s2mu005-flash.yaml#
    description:
      Child node describing flash LEDs.

  interrupts:
    maxItems: 1

  muic:
    $ref: /schemas/extcon/samsung,s2mu005-muic.yaml#
    description:
      Child node describing MUIC device.

  multi-led:
    type: object

    allOf:
      - $ref: /schemas/leds/leds-class-multicolor.yaml#

    properties:
      compatible:
        const: samsung,s2mu005-rgb

    required:
      - compatible

    unevaluatedProperties: false

  reg:
    maxItems: 1

required:
  - compatible
  - reg

unevaluatedProperties: false

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>
    #include <dt-bindings/leds/common.h>

    i2c {
        #address-cells = <1>;
        #size-cells = <0>;

        pmic@3d {
            compatible = "samsung,s2mu005-pmic";
            reg = <0x3d>;
            interrupt-parent = <&gpa2>;
            interrupts = <7 IRQ_TYPE_LEVEL_LOW>;

            monitored-battery = <&battery>;

            flash {
                compatible = "samsung,s2mu005-flash";
                #address-cells = <1>;
                #size-cells = <0>;

                led@0 {
                    reg = <0>;
                    color = <LED_COLOR_ID_WHITE>;
                    function = LED_FUNCTION_FLASH;
                };

                led@1 {
                    reg = <1>;
                    color = <LED_COLOR_ID_WHITE>;
                    function = LED_FUNCTION_FLASH;
                    function-enumerator = <1>;
                };
            };

            muic {
                compatible = "samsung,s2mu005-muic";

                connector {
                    compatible = "usb-b-connector";
                    label = "micro-USB";
                    type = "micro";
                };

                port {
                    muic_to_usb: endpoint {
                        remote-endpoint = <&usb_to_muic>;
                    };
                };
            };

            multi-led {
                compatible = "samsung,s2mu005-rgb";
                color = <LED_COLOR_ID_RGB>;
                function = LED_FUNCTION_INDICATOR;
                linux,default-trigger = "pattern";
            };
        };
    };