arc,arc2c0608.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/arc,arc2c0608.yaml#
  5$schema: http://devicetree.org/meta-schemas/core.yaml#
  6
  7title: ArcticSand arc2c0608 LED driver
  8
  9description: |
 10  The ArcticSand arc2c0608 LED driver provides ultra
 11  efficient notebook backlighting. Optional properties not
 12  specified will default to values in IC EPROM.
 13
 14  Datasheet:
 15  https://www.murata.com/-/media/webrenewal/products/power/power-semiconductor/overview/lineup/led-boost/arc2/arc2c0608.ashx.
 16
 17maintainers:
 18  - Brian Dodge <bdodge@arcticsand.com>
 19
 20allOf:
 21  - $ref: /schemas/leds/common.yaml
 22
 23properties:
 24  compatible:
 25    const: arc,arc2c0608
 26
 27  reg:
 28    maxItems: 1
 29
 30  default-brightness:
 31    $ref: /schemas/types.yaml#/definitions/uint32
 32    minimum: 0
 33    maximum: 4095
 34
 35  led-sources:
 36    $ref: /schemas/types.yaml#/definitions/uint32-array
 37    description: List of enabled channels
 38    items:
 39      enum: [0, 1, 2, 3, 4, 5]
 40    minItems: 1
 41    uniqueItems: true
 42
 43  arc,led-config-0:
 44    $ref: /schemas/types.yaml#/definitions/uint32
 45    description: Fading speed (period between intensity
 46      steps)
 47
 48  arc,led-config-1:
 49    $ref: /schemas/types.yaml#/definitions/uint32
 50    description: If set, sets ILED_CONFIG register. Used for
 51      fine tuning the maximum LED current.
 52
 53  arc,dim-freq:
 54    $ref: /schemas/types.yaml#/definitions/uint32
 55    description: PWM mode frequency setting (bits [3:0] used)
 56
 57  arc,comp-config:
 58    $ref: /schemas/types.yaml#/definitions/uint32
 59    description: Setting for register CONFIG_COMP which
 60      controls internal resitances, feed forward freqs,
 61      and initial VOUT at startup. Consult the datasheet.
 62
 63  arc,filter-config:
 64    $ref: /schemas/types.yaml#/definitions/uint32
 65    description: RC and PWM Filter settings.
 66      Bit Assignment
 67      7654 3    2    1    0
 68      xxxx RCF1 RCF0 PWM1 PWM0
 69      RCF statuses        PWM Filter Statues
 70      00 = OFF (default)  00 = OFF (default)
 71      01 = LOW            01 = 2 STEPS
 72      10 - MEDIUM         10 = 4 STEPS
 73      11 = HIGH           11 = 8 STEPS
 74
 75  arc,trim-config:
 76    $ref: /schemas/types.yaml#/definitions/uint32
 77    description: Sets percentage increase of Maximum LED
 78      Current.
 79      0x00 = 0% increase.
 80      0x20 = 20.2%.
 81      0x3F = 41.5%
 82
 83  label: true
 84
 85  linux,default-trigger: true
 86
 87additionalProperties: false
 88
 89required:
 90  - compatible
 91  - reg
 92
 93examples:
 94  - |
 95    i2c {
 96        #address-cells = <1>;
 97        #size-cells = <0>;
 98
 99        led-controller@30 {
100            compatible = "arc,arc2c0608";
101            reg = <0x30>;
102            default-brightness = <500>;
103            label = "lcd-backlight";
104            linux,default-trigger = "backlight";
105            led-sources = <0 1 2 5>;
106        };
107    };
108...