xref: /freebsd-src/sys/contrib/device-tree/Bindings/leds/backlight/mps,mp3309c.yaml (revision 8d13bc63c0e1d50bc9e47ac1f26329c999bfecf0)
184943d6fSEmmanuel Vadot# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
284943d6fSEmmanuel Vadot%YAML 1.2
384943d6fSEmmanuel Vadot---
484943d6fSEmmanuel Vadot$id: http://devicetree.org/schemas/leds/backlight/mps,mp3309c.yaml#
584943d6fSEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
684943d6fSEmmanuel Vadot
784943d6fSEmmanuel Vadottitle: MPS MP3309C backlight
884943d6fSEmmanuel Vadot
984943d6fSEmmanuel Vadotmaintainers:
1084943d6fSEmmanuel Vadot  - Flavio Suligoi <f.suligoi@asem.it>
1184943d6fSEmmanuel Vadot
1284943d6fSEmmanuel Vadotdescription: |
1384943d6fSEmmanuel Vadot  The Monolithic Power (MPS) MP3309C is a WLED step-up converter, featuring a
1484943d6fSEmmanuel Vadot  programmable switching frequency to optimize efficiency.
1584943d6fSEmmanuel Vadot  It supports two different dimming modes:
1684943d6fSEmmanuel Vadot
17*8d13bc63SEmmanuel Vadot  - analog mode, via I2C commands, as default mode (32 dimming levels)
18*8d13bc63SEmmanuel Vadot  - PWM controlled mode (optional)
1984943d6fSEmmanuel Vadot
2084943d6fSEmmanuel Vadot  The datasheet is available at:
2184943d6fSEmmanuel Vadot  https://www.monolithicpower.com/en/mp3309c.html
2284943d6fSEmmanuel Vadot
2384943d6fSEmmanuel VadotallOf:
2484943d6fSEmmanuel Vadot  - $ref: common.yaml#
2584943d6fSEmmanuel Vadot
2684943d6fSEmmanuel Vadotproperties:
2784943d6fSEmmanuel Vadot  compatible:
2884943d6fSEmmanuel Vadot    const: mps,mp3309c
2984943d6fSEmmanuel Vadot
3084943d6fSEmmanuel Vadot  reg:
3184943d6fSEmmanuel Vadot    maxItems: 1
3284943d6fSEmmanuel Vadot
3384943d6fSEmmanuel Vadot  pwms:
3484943d6fSEmmanuel Vadot    description: if present, the backlight is controlled in PWM mode.
3584943d6fSEmmanuel Vadot    maxItems: 1
3684943d6fSEmmanuel Vadot
3784943d6fSEmmanuel Vadot  enable-gpios:
3884943d6fSEmmanuel Vadot    description: GPIO used to enable the backlight in "analog-i2c" dimming mode.
3984943d6fSEmmanuel Vadot    maxItems: 1
4084943d6fSEmmanuel Vadot
4184943d6fSEmmanuel Vadot  mps,overvoltage-protection-microvolt:
4284943d6fSEmmanuel Vadot    description: Overvoltage protection (13.5V, 24V or 35.5V).
4384943d6fSEmmanuel Vadot    enum: [ 13500000, 24000000, 35500000 ]
4484943d6fSEmmanuel Vadot    default: 35500000
4584943d6fSEmmanuel Vadot
4684943d6fSEmmanuel Vadot  mps,no-sync-mode:
4784943d6fSEmmanuel Vadot    description: disable synchronous rectification mode
4884943d6fSEmmanuel Vadot    type: boolean
4984943d6fSEmmanuel Vadot
5084943d6fSEmmanuel Vadotrequired:
5184943d6fSEmmanuel Vadot  - compatible
5284943d6fSEmmanuel Vadot  - reg
5384943d6fSEmmanuel Vadot
5484943d6fSEmmanuel VadotunevaluatedProperties: false
5584943d6fSEmmanuel Vadot
5684943d6fSEmmanuel Vadotexamples:
5784943d6fSEmmanuel Vadot  - |
5884943d6fSEmmanuel Vadot    i2c {
5984943d6fSEmmanuel Vadot        #address-cells = <1>;
6084943d6fSEmmanuel Vadot        #size-cells = <0>;
6184943d6fSEmmanuel Vadot
6284943d6fSEmmanuel Vadot        /* Backlight with PWM control */
6384943d6fSEmmanuel Vadot        backlight_pwm: backlight@17 {
6484943d6fSEmmanuel Vadot            compatible = "mps,mp3309c";
6584943d6fSEmmanuel Vadot            reg = <0x17>;
6684943d6fSEmmanuel Vadot            pwms = <&pwm1 0 3333333 0>; /* 300 Hz --> (1/f) * 1*10^9 */
67*8d13bc63SEmmanuel Vadot            brightness-levels = <0 4 8 16 32 64 128 255>;
68*8d13bc63SEmmanuel Vadot            default-brightness = <6>;
6984943d6fSEmmanuel Vadot            mps,overvoltage-protection-microvolt = <24000000>;
7084943d6fSEmmanuel Vadot        };
7184943d6fSEmmanuel Vadot    };
72