Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: backlight: Add MPS MP3309C

The Monolithic Power (MPS) MP3309C is a WLED step-up converter, featuring a
programmable switching frequency to optimize efficiency.
The brightness can be controlled either by I2C commands (called "analog"
mode) or by a PWM input signal (PWM mode).
This driver supports both modes.

For device driver details, please refer to:
- drivers/video/backlight/mp3309c_bl.c

The datasheet is available at:
- https://www.monolithicpower.com/en/mp3309c.html

Signed-off-by: Flavio Suligoi <f.suligoi@asem.it>
Reviewed-by: Rob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20230925122609.78849-1-f.suligoi@asem.it
Signed-off-by: Lee Jones <lee@kernel.org>

authored by

Flavio Suligoi and committed by
Lee Jones
02c4e661 0bb80ecc

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