xref: /linux/Documentation/devicetree/bindings/leds/backlight/mps,mp3309c.yaml (revision 02c4e661658f73d3c266c68f89f0b14bd8ba6bd8)
1*02c4e661SFlavio Suligoi# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2*02c4e661SFlavio Suligoi%YAML 1.2
3*02c4e661SFlavio Suligoi---
4*02c4e661SFlavio Suligoi$id: http://devicetree.org/schemas/leds/backlight/mps,mp3309c.yaml#
5*02c4e661SFlavio Suligoi$schema: http://devicetree.org/meta-schemas/core.yaml#
6*02c4e661SFlavio Suligoi
7*02c4e661SFlavio Suligoititle: MPS MP3309C backlight
8*02c4e661SFlavio Suligoi
9*02c4e661SFlavio Suligoimaintainers:
10*02c4e661SFlavio Suligoi  - Flavio Suligoi <f.suligoi@asem.it>
11*02c4e661SFlavio Suligoi
12*02c4e661SFlavio Suligoidescription: |
13*02c4e661SFlavio Suligoi  The Monolithic Power (MPS) MP3309C is a WLED step-up converter, featuring a
14*02c4e661SFlavio Suligoi  programmable switching frequency to optimize efficiency.
15*02c4e661SFlavio Suligoi  It supports two different dimming modes:
16*02c4e661SFlavio Suligoi
17*02c4e661SFlavio Suligoi  - analog mode, via I2C commands (default)
18*02c4e661SFlavio Suligoi  - PWM controlled mode.
19*02c4e661SFlavio Suligoi
20*02c4e661SFlavio Suligoi  The datasheet is available at:
21*02c4e661SFlavio Suligoi  https://www.monolithicpower.com/en/mp3309c.html
22*02c4e661SFlavio Suligoi
23*02c4e661SFlavio SuligoiallOf:
24*02c4e661SFlavio Suligoi  - $ref: common.yaml#
25*02c4e661SFlavio Suligoi
26*02c4e661SFlavio Suligoiproperties:
27*02c4e661SFlavio Suligoi  compatible:
28*02c4e661SFlavio Suligoi    const: mps,mp3309c
29*02c4e661SFlavio Suligoi
30*02c4e661SFlavio Suligoi  reg:
31*02c4e661SFlavio Suligoi    maxItems: 1
32*02c4e661SFlavio Suligoi
33*02c4e661SFlavio Suligoi  pwms:
34*02c4e661SFlavio Suligoi    description: if present, the backlight is controlled in PWM mode.
35*02c4e661SFlavio Suligoi    maxItems: 1
36*02c4e661SFlavio Suligoi
37*02c4e661SFlavio Suligoi  enable-gpios:
38*02c4e661SFlavio Suligoi    description: GPIO used to enable the backlight in "analog-i2c" dimming mode.
39*02c4e661SFlavio Suligoi    maxItems: 1
40*02c4e661SFlavio Suligoi
41*02c4e661SFlavio Suligoi  mps,overvoltage-protection-microvolt:
42*02c4e661SFlavio Suligoi    description: Overvoltage protection (13.5V, 24V or 35.5V).
43*02c4e661SFlavio Suligoi    enum: [ 13500000, 24000000, 35500000 ]
44*02c4e661SFlavio Suligoi    default: 35500000
45*02c4e661SFlavio Suligoi
46*02c4e661SFlavio Suligoi  mps,no-sync-mode:
47*02c4e661SFlavio Suligoi    description: disable synchronous rectification mode
48*02c4e661SFlavio Suligoi    type: boolean
49*02c4e661SFlavio Suligoi
50*02c4e661SFlavio Suligoirequired:
51*02c4e661SFlavio Suligoi  - compatible
52*02c4e661SFlavio Suligoi  - reg
53*02c4e661SFlavio Suligoi  - max-brightness
54*02c4e661SFlavio Suligoi  - default-brightness
55*02c4e661SFlavio Suligoi
56*02c4e661SFlavio SuligoiunevaluatedProperties: false
57*02c4e661SFlavio Suligoi
58*02c4e661SFlavio Suligoiexamples:
59*02c4e661SFlavio Suligoi  - |
60*02c4e661SFlavio Suligoi    i2c {
61*02c4e661SFlavio Suligoi        #address-cells = <1>;
62*02c4e661SFlavio Suligoi        #size-cells = <0>;
63*02c4e661SFlavio Suligoi
64*02c4e661SFlavio Suligoi        /* Backlight with PWM control */
65*02c4e661SFlavio Suligoi        backlight_pwm: backlight@17 {
66*02c4e661SFlavio Suligoi            compatible = "mps,mp3309c";
67*02c4e661SFlavio Suligoi            reg = <0x17>;
68*02c4e661SFlavio Suligoi            pwms = <&pwm1 0 3333333 0>; /* 300 Hz --> (1/f) * 1*10^9 */
69*02c4e661SFlavio Suligoi            max-brightness = <100>;
70*02c4e661SFlavio Suligoi            default-brightness = <80>;
71*02c4e661SFlavio Suligoi            mps,overvoltage-protection-microvolt = <24000000>;
72*02c4e661SFlavio Suligoi        };
73*02c4e661SFlavio Suligoi    };
74