• Flavio Suligoi's avatar
    dt-bindings: backlight: mp3309c: Remove two required properties · 87f33a1b
    Flavio Suligoi authored
    The two properties:
    
    - max-brightness
    - default brightness
    
    are not really required, so they can be removed from the "required"
    section.
    The "max-brightness" is no longer used in the current version
    of the driver (it was used only in the first version).
    The "default-brightness", if omitted in the DT, is managed by the
    device driver, using a default value. This value depends on the dimming
    mode used:
    
    - for the "analog mode", via I2C commands, this value is fixed by
      hardware (=31)
    - while in case of pwm mode the default used is the last value of the
      brightness-levels array.
    
    Also the brightness-levels array is not required:
    
    - in "analog mode", via I2C commands, the brightness-level array is
      fixed by hardware (0..31).;
    - in pwm dimming mode, the driver uses a default array of 0..255 and
      the "default-brightness" is the last one, which is "255"
    
    NOTE: there are no compatibility problems with the previous version,
          since the device driver has not yet been included in any kernel.
          Only this dt-binding yaml file is already included in the current
          v6.7.0-rc1 kernel version.
          No developer may have used it.
    
    Other changes:
    
    - improve the backlight working mode description, in the "description"
      section
    - update the example, removing the "max-brightness" and introducing the
      "brightess-levels" property
    Signed-off-by: default avatarFlavio Suligoi <f.suligoi@asem.it>
    Acked-by: default avatarConor Dooley <conor.dooley@microchip.com>
    Reviewed-by: default avatarDaniel Thompson <daniel.thompson@linaro.org>
    Link: https://lore.kernel.org/r/20231116105319.957600-2-f.suligoi@asem.itSigned-off-by: default avatarLee Jones <lee@kernel.org>
    87f33a1b
mps,mp3309c.yaml 1.74 KB