include/linux/platform_data/adp8860.h

   1 /* SPDX-License-Identifier: GPL-2.0-or-later */
   2 /*
   3  * Definitions and platform data for Analog Devices
   4  * Backlight drivers ADP8860
   5  *
   6  * Copyright 2009-2010 Analog Devices Inc.
   7  */
   8
   9 #ifndef __LINUX_I2C_ADP8860_H
  10 #define __LINUX_I2C_ADP8860_H
  11
  12 #include <linux/leds.h>
  13 #include <linux/types.h>
  14
  15 #define ID_ADP8860              8860
  16
  17 #define ADP8860_MAX_BRIGHTNESS  0x7F
  18 #define FLAG_OFFT_SHIFT 8
  19
  20 /*
  21  * LEDs subdevice platform data
  22  */
  23
  24 #define ADP8860_LED_DIS_BLINK   (0 << FLAG_OFFT_SHIFT)
  25 #define ADP8860_LED_OFFT_600ms  (1 << FLAG_OFFT_SHIFT)
  26 #define ADP8860_LED_OFFT_1200ms (2 << FLAG_OFFT_SHIFT)
  27 #define ADP8860_LED_OFFT_1800ms (3 << FLAG_OFFT_SHIFT)
  28
  29 #define ADP8860_LED_ONT_200ms   0
  30 #define ADP8860_LED_ONT_600ms   1
  31 #define ADP8860_LED_ONT_800ms   2
  32 #define ADP8860_LED_ONT_1200ms  3
  33
  34 #define ADP8860_LED_D7          (7)
  35 #define ADP8860_LED_D6          (6)
  36 #define ADP8860_LED_D5          (5)
  37 #define ADP8860_LED_D4          (4)
  38 #define ADP8860_LED_D3          (3)
  39 #define ADP8860_LED_D2          (2)
  40 #define ADP8860_LED_D1          (1)
  41
  42 /*
  43  * Backlight subdevice platform data
  44  */
  45
  46 #define ADP8860_BL_D7           (1 << 6)
  47 #define ADP8860_BL_D6           (1 << 5)
  48 #define ADP8860_BL_D5           (1 << 4)
  49 #define ADP8860_BL_D4           (1 << 3)
  50 #define ADP8860_BL_D3           (1 << 2)
  51 #define ADP8860_BL_D2           (1 << 1)
  52 #define ADP8860_BL_D1           (1 << 0)
  53
  54 #define ADP8860_FADE_T_DIS      0       /* Fade Timer Disabled */
  55 #define ADP8860_FADE_T_300ms    1       /* 0.3 Sec */
  56 #define ADP8860_FADE_T_600ms    2
  57 #define ADP8860_FADE_T_900ms    3
  58 #define ADP8860_FADE_T_1200ms   4
  59 #define ADP8860_FADE_T_1500ms   5
  60 #define ADP8860_FADE_T_1800ms   6
  61 #define ADP8860_FADE_T_2100ms   7
  62 #define ADP8860_FADE_T_2400ms   8
  63 #define ADP8860_FADE_T_2700ms   9
  64 #define ADP8860_FADE_T_3000ms   10
  65 #define ADP8860_FADE_T_3500ms   11
  66 #define ADP8860_FADE_T_4000ms   12
  67 #define ADP8860_FADE_T_4500ms   13
  68 #define ADP8860_FADE_T_5000ms   14
  69 #define ADP8860_FADE_T_5500ms   15      /* 5.5 Sec */
  70
  71 #define ADP8860_FADE_LAW_LINEAR 0
  72 #define ADP8860_FADE_LAW_SQUARE 1
  73 #define ADP8860_FADE_LAW_CUBIC1 2
  74 #define ADP8860_FADE_LAW_CUBIC2 3
  75
  76 #define ADP8860_BL_AMBL_FILT_80ms       0       /* Light sensor filter time */
  77 #define ADP8860_BL_AMBL_FILT_160ms      1
  78 #define ADP8860_BL_AMBL_FILT_320ms      2
  79 #define ADP8860_BL_AMBL_FILT_640ms      3
  80 #define ADP8860_BL_AMBL_FILT_1280ms     4
  81 #define ADP8860_BL_AMBL_FILT_2560ms     5
  82 #define ADP8860_BL_AMBL_FILT_5120ms     6
  83 #define ADP8860_BL_AMBL_FILT_10240ms    7       /* 10.24 sec */
  84
  85 /*
  86  * Blacklight current 0..30mA
  87  */
  88 #define ADP8860_BL_CUR_mA(I)            ((I * 127) / 30)
  89
  90 /*
  91  * L2 comparator current 0..1106uA
  92  */
  93 #define ADP8860_L2_COMP_CURR_uA(I)      ((I * 255) / 1106)
  94
  95 /*
  96  * L3 comparator current 0..138uA
  97  */
  98 #define ADP8860_L3_COMP_CURR_uA(I)      ((I * 255) / 138)
  99
 100 struct adp8860_backlight_platform_data {
 101         u8 bl_led_assign;       /* 1 = Backlight 0 = Individual LED */
 102
 103         u8 bl_fade_in;          /* Backlight Fade-In Timer */
 104         u8 bl_fade_out;         /* Backlight Fade-Out Timer */
 105         u8 bl_fade_law;         /* fade-on/fade-off transfer characteristic */
 106
 107         u8 en_ambl_sens;        /* 1 = enable ambient light sensor */
 108         u8 abml_filt;           /* Light sensor filter time */
 109
 110         u8 l1_daylight_max;     /* use BL_CUR_mA(I) 0 <= I <= 30 mA */
 111         u8 l1_daylight_dim;     /* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */
 112         u8 l2_office_max;       /* use BL_CUR_mA(I) 0 <= I <= 30 mA */
 113         u8 l2_office_dim;       /* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */
 114         u8 l3_dark_max;         /* use BL_CUR_mA(I) 0 <= I <= 30 mA */
 115         u8 l3_dark_dim;         /* typ = 0, use BL_CUR_mA(I) 0 <= I <= 30 mA */
 116
 117         u8 l2_trip;             /* use L2_COMP_CURR_uA(I) 0 <= I <= 1106 uA */
 118         u8 l2_hyst;             /* use L2_COMP_CURR_uA(I) 0 <= I <= 1106 uA */
 119         u8 l3_trip;             /* use L3_COMP_CURR_uA(I) 0 <= I <= 551 uA */
 120         u8 l3_hyst;             /* use L3_COMP_CURR_uA(I) 0 <= I <= 551 uA */
 121
 122         /**
 123          * Independent Current Sinks / LEDS
 124          * Sinks not assigned to the Backlight can be exposed to
 125          * user space using the LEDS CLASS interface
 126          */
 127
 128         int num_leds;
 129         struct led_info *leds;
 130         u8 led_fade_in;         /* LED Fade-In Timer */
 131         u8 led_fade_out;        /* LED Fade-Out Timer */
 132         u8 led_fade_law;        /* fade-on/fade-off transfer characteristic */
 133         u8 led_on_time;
 134
 135         /**
 136          * Gain down disable. Setting this option does not allow the
 137          * charge pump to switch to lower gains. NOT AVAILABLE on ADP8860
 138          * 1 = the charge pump doesn't switch down in gain until all LEDs are 0.
 139          *  The charge pump switches up in gain as needed. This feature is
 140          *  useful if the ADP8863 charge pump is used to drive an external load.
 141          *  This feature must be used when utilizing small fly capacitors
 142          *  (0402 or smaller).
 143          * 0 = the charge pump automatically switches up and down in gain.
 144          *  This provides optimal efficiency, but is not suitable for driving
 145          *  loads that are not connected through the ADP8863 diode drivers.
 146          *  Additionally, the charge pump fly capacitors should be low ESR
 147          * and sized 0603 or greater.
 148          */
 149
 150         u8 gdwn_dis;
 151 };
 152
 153 #endif /* __LINUX_I2C_ADP8860_H */