drivers/regulator/da9121-regulator.h

   1 /* SPDX-License-Identifier: GPL-2.0+ */
   2 /*
   3  * DA9121 Single-channel dual-phase 10A buck converter
   4  * DA9130 Single-channel dual-phase 10A buck converter (Automotive)
   5  * DA9217 Single-channel dual-phase  6A buck converter
   6  * DA9122 Dual-channel single-phase  5A buck converter
   7  * DA9131 Dual-channel single-phase  5A buck converter (Automotive)
   8  * DA9220 Dual-channel single-phase  3A buck converter
   9  * DA9132 Dual-channel single-phase  3A buck converter (Automotive)
  10  *
  11  * Copyright (C) 2020  Dialog Semiconductor
  12  *
  13  * Authors: Steve Twiss, Dialog Semiconductor
  14  *          Adam Ward, Dialog Semiconductor
  15  */
  16
  17 #ifndef __DA9121_REGISTERS_H__
  18 #define __DA9121_REGISTERS_H__
  19
  20 /* Values for: DA9121_REG_BUCK_BUCKx_4 registers, fields CHx_y_MODE
  21  *             DA9121_REG_BUCK_BUCKx_7 registers, fields CHx_RIPPLE_CANCEL
  22  */
  23 #include <dt-bindings/regulator/dlg,da9121-regulator.h>
  24
  25 enum da9121_variant {
  26         DA9121_TYPE_DA9121_DA9130,
  27         DA9121_TYPE_DA9220_DA9132,
  28         DA9121_TYPE_DA9122_DA9131,
  29         DA9121_TYPE_DA9217
  30 };
  31
  32 enum da9121_subvariant {
  33         DA9121_SUBTYPE_DA9121,
  34         DA9121_SUBTYPE_DA9130,
  35         DA9121_SUBTYPE_DA9220,
  36         DA9121_SUBTYPE_DA9132,
  37         DA9121_SUBTYPE_DA9122,
  38         DA9121_SUBTYPE_DA9131,
  39         DA9121_SUBTYPE_DA9217
  40 };
  41
  42 /* Minimum, maximum and default polling millisecond periods are provided
  43  * here as an example. It is expected that any final implementation will
  44  * include a modification of these settings to match the required
  45  * application.
  46  */
  47 #define DA9121_DEFAULT_POLLING_PERIOD_MS        3000
  48 #define DA9121_MAX_POLLING_PERIOD_MS            10000
  49 #define DA9121_MIN_POLLING_PERIOD_MS            1000
  50
  51 /* Registers */
  52
  53 #define DA9121_REG_SYS_STATUS_0         0x01
  54 #define DA9121_REG_SYS_STATUS_1         0x02
  55 #define DA9121_REG_SYS_STATUS_2         0x03
  56 #define DA9121_REG_SYS_EVENT_0          0x04
  57 #define DA9121_REG_SYS_EVENT_1          0x05
  58 #define DA9121_REG_SYS_EVENT_2          0x06
  59 #define DA9121_REG_SYS_MASK_0           0x07
  60 #define DA9121_REG_SYS_MASK_1           0x08
  61 #define DA9121_REG_SYS_MASK_2           0x09
  62 #define DA9121_REG_SYS_MASK_3           0x0A
  63 #define DA9121_REG_SYS_CONFIG_0         0x0B
  64 #define DA9121_REG_SYS_CONFIG_1         0x0C
  65 #define DA9121_REG_SYS_CONFIG_2         0x0D
  66 #define DA9121_REG_SYS_CONFIG_3         0x0E
  67 #define DA9121_REG_SYS_GPIO0_0          0x10
  68 #define DA9121_REG_SYS_GPIO0_1          0x11
  69 #define DA9121_REG_SYS_GPIO1_0          0x12
  70 #define DA9121_REG_SYS_GPIO1_1          0x13
  71 #define DA9121_REG_SYS_GPIO2_0          0x14
  72 #define DA9121_REG_SYS_GPIO2_1          0x15
  73 #define DA9121_REG_BUCK_BUCK1_0         0x20
  74 #define DA9121_REG_BUCK_BUCK1_1         0x21
  75 #define DA9121_REG_BUCK_BUCK1_2         0x22
  76 #define DA9121_REG_BUCK_BUCK1_3         0x23
  77 #define DA9121_REG_BUCK_BUCK1_4         0x24
  78 #define DA9121_REG_BUCK_BUCK1_5         0x25
  79 #define DA9121_REG_BUCK_BUCK1_6         0x26
  80 #define DA9121_REG_BUCK_BUCK1_7         0x27
  81 #define DA9xxx_REG_BUCK_BUCK2_0         0x28
  82 #define DA9xxx_REG_BUCK_BUCK2_1         0x29
  83 #define DA9xxx_REG_BUCK_BUCK2_2         0x2A
  84 #define DA9xxx_REG_BUCK_BUCK2_3         0x2B
  85 #define DA9xxx_REG_BUCK_BUCK2_4         0x2C
  86 #define DA9xxx_REG_BUCK_BUCK2_5         0x2D
  87 #define DA9xxx_REG_BUCK_BUCK2_6         0x2E
  88 #define DA9xxx_REG_BUCK_BUCK2_7         0x2F
  89 #define DA9121_REG_OTP_DEVICE_ID        0x48
  90 #define DA9121_REG_OTP_VARIANT_ID       0x49
  91 #define DA9121_REG_OTP_CUSTOMER_ID      0x4A
  92 #define DA9121_REG_OTP_CONFIG_ID        0x4B
  93
  94 /* Register bits */
  95
  96 /* DA9121_REG_SYS_STATUS_0 */
  97
  98 #define DA9xxx_MASK_SYS_STATUS_0_SG                     BIT(2)
  99 #define DA9121_MASK_SYS_STATUS_0_TEMP_CRIT              BIT(1)
 100 #define DA9121_MASK_SYS_STATUS_0_TEMP_WARN              BIT(0)
 101
 102 /* DA9121_REG_SYS_STATUS_1 */
 103
 104 #define DA9xxx_MASK_SYS_STATUS_1_PG2                    BIT(7)
 105 #define DA9xxx_MASK_SYS_STATUS_1_OV2                    BIT(6)
 106 #define DA9xxx_MASK_SYS_STATUS_1_UV2                    BIT(5)
 107 #define DA9xxx_MASK_SYS_STATUS_1_OC2                    BIT(4)
 108 #define DA9121_MASK_SYS_STATUS_1_PG1                    BIT(3)
 109 #define DA9121_MASK_SYS_STATUS_1_OV1                    BIT(2)
 110 #define DA9121_MASK_SYS_STATUS_1_UV1                    BIT(1)
 111 #define DA9121_MASK_SYS_STATUS_1_OC1                    BIT(0)
 112
 113 /* DA9121_REG_SYS_STATUS_2 */
 114
 115 #define DA9121_MASK_SYS_STATUS_2_GPIO2                  BIT(2)
 116 #define DA9121_MASK_SYS_STATUS_2_GPIO1                  BIT(1)
 117 #define DA9121_MASK_SYS_STATUS_2_GPIO0                  BIT(0)
 118
 119 /* DA9121_REG_SYS_EVENT_0 */
 120
 121 #define DA9xxx_MASK_SYS_EVENT_0_E_SG                    BIT(2)
 122 #define DA9121_MASK_SYS_EVENT_0_E_TEMP_CRIT             BIT(1)
 123 #define DA9121_MASK_SYS_EVENT_0_E_TEMP_WARN             BIT(0)
 124
 125 /* DA9121_REG_SYS_EVENT_1 */
 126
 127 #define DA9xxx_MASK_SYS_EVENT_1_E_PG2                   BIT(7)
 128 #define DA9xxx_MASK_SYS_EVENT_1_E_OV2                   BIT(6)
 129 #define DA9xxx_MASK_SYS_EVENT_1_E_UV2                   BIT(5)
 130 #define DA9xxx_MASK_SYS_EVENT_1_E_OC2                   BIT(4)
 131 #define DA9121_MASK_SYS_EVENT_1_E_PG1                   BIT(3)
 132 #define DA9121_MASK_SYS_EVENT_1_E_OV1                   BIT(2)
 133 #define DA9121_MASK_SYS_EVENT_1_E_UV1                   BIT(1)
 134 #define DA9121_MASK_SYS_EVENT_1_E_OC1                   BIT(0)
 135
 136 /* DA9121_REG_SYS_EVENT_2 */
 137
 138 #define DA9121_MASK_SYS_EVENT_2_E_GPIO2                 BIT(2)
 139 #define DA9121_MASK_SYS_EVENT_2_E_GPIO1                 BIT(1)
 140 #define DA9121_MASK_SYS_EVENT_2_E_GPIO0                 BIT(0)
 141
 142 /* DA9121_REG_SYS_MASK_0 */
 143
 144 #define DA9xxx_MASK_SYS_MASK_0_M_SG                     BIT(2)
 145 #define DA9121_MASK_SYS_MASK_0_M_TEMP_CRIT              BIT(1)
 146 #define DA9121_MASK_SYS_MASK_0_M_TEMP_WARN              BIT(0)
 147
 148 /* DA9121_REG_SYS_MASK_1 */
 149
 150 #define DA9xxx_MASK_SYS_MASK_1_M_PG2                    BIT(7)
 151 #define DA9xxx_MASK_SYS_MASK_1_M_OV2                    BIT(6)
 152 #define DA9xxx_MASK_SYS_MASK_1_M_UV2                    BIT(5)
 153 #define DA9xxx_MASK_SYS_MASK_1_M_OC2                    BIT(4)
 154 #define DA9121_MASK_SYS_MASK_1_M_PG1                    BIT(3)
 155 #define DA9121_MASK_SYS_MASK_1_M_OV1                    BIT(2)
 156 #define DA9121_MASK_SYS_MASK_1_M_UV1                    BIT(1)
 157 #define DA9121_MASK_SYS_MASK_1_M_OC1                    BIT(0)
 158
 159 /* DA9121_REG_SYS_MASK_2 */
 160
 161 #define DA9121_MASK_SYS_MASK_2_M_GPIO2                  BIT(2)
 162 #define DA9121_MASK_SYS_MASK_2_M_GPIO1                  BIT(1)
 163 #define DA9121_MASK_SYS_MASK_2_M_GPIO0                  BIT(0)
 164
 165 /* DA9122_REG_SYS_MASK_3 */
 166
 167 #define DA9121_MASK_SYS_MASK_3_M_VR_HOT                 BIT(3)
 168 #define DA9xxx_MASK_SYS_MASK_3_M_SG_STAT                BIT(2)
 169 #define DA9xxx_MASK_SYS_MASK_3_M_PG2_STAT               BIT(1)
 170 #define DA9121_MASK_SYS_MASK_3_M_PG1_STAT               BIT(0)
 171
 172 /* DA9121_REG_SYS_CONFIG_0 */
 173
 174 #define DA9121_MASK_SYS_CONFIG_0_CH1_DIS_DLY            0xF0
 175 #define DA9121_MASK_SYS_CONFIG_0_CH1_EN_DLY             0x0F
 176
 177 /* DA9xxx_REG_SYS_CONFIG_1 */
 178
 179 #define DA9xxx_MASK_SYS_CONFIG_1_CH2_DIS_DLY            0xF0
 180 #define DA9xxx_MASK_SYS_CONFIG_1_CH2_EN_DLY             0x0F
 181
 182 /* DA9121_REG_SYS_CONFIG_2 */
 183
 184 #define DA9121_MASK_SYS_CONFIG_2_OC_LATCHOFF            0x60
 185 #define DA9121_MASK_SYS_CONFIG_2_OC_DVC_MASK            BIT(4)
 186 #define DA9121_MASK_SYS_CONFIG_2_PG_DVC_MASK            0x0C
 187
 188 /* DA9121_REG_SYS_CONFIG_3 */
 189
 190 #define DA9121_MASK_SYS_CONFIG_3_OSC_TUNE               0X70
 191 #define DA9121_MASK_SYS_CONFIG_3_I2C_TIMEOUT            BIT(1)
 192
 193 /* DA9121_REG_SYS_GPIO0_0 */
 194
 195 #define DA9121_MASK_SYS_GPIO0_0_GPIO0_MODE              0X1E
 196 #define DA9121_MASK_SYS_GPIO0_0_GPIO0_OBUF              BIT(0)
 197
 198 /* DA9121_REG_SYS_GPIO0_1 */
 199
 200 #define DA9121_MASK_SYS_GPIO0_1_GPIO0_DEB_FALL          BIT(7)
 201 #define DA9121_MASK_SYS_GPIO0_1_GPIO0_DEB_RISE          BIT(6)
 202 #define DA9121_MASK_SYS_GPIO0_1_GPIO0_DEB               0x30
 203 #define DA9121_MASK_SYS_GPIO0_1_GPIO0_PUPD              BIT(3)
 204 #define DA9121_MASK_SYS_GPIO0_1_GPIO0_POL               BIT(2)
 205 #define DA9121_MASK_SYS_GPIO0_1_GPIO0_TRIG              0x03
 206
 207 /* DA9121_REG_SYS_GPIO1_0 */
 208
 209 #define DA9121_MASK_SYS_GPIO1_0_GPIO1_MODE              0x1E
 210 #define DA9121_MASK_SYS_GPIO1_0_GPIO1_OBUF              BIT(0)
 211
 212 /* DA9121_REG_SYS_GPIO1_1 */
 213
 214 #define DA9121_MASK_SYS_GPIO1_1_GPIO1_DEB_FALL          BIT(7)
 215 #define DA9121_MASK_SYS_GPIO1_1_GPIO1_DEB_RISE          BIT(6)
 216 #define DA9121_MASK_SYS_GPIO1_1_GPIO1_DEB               0x30
 217 #define DA9121_MASK_SYS_GPIO1_1_GPIO1_PUPD              BIT(3)
 218 #define DA9121_MASK_SYS_GPIO1_1_GPIO1_POL               BIT(2)
 219 #define DA9121_MASK_SYS_GPIO1_1_GPIO1_TRIG              0x03
 220
 221 /* DA9121_REG_SYS_GPIO2_0 */
 222
 223 #define DA9121_MASK_SYS_GPIO2_0_GPIO2_MODE              0x1E
 224 #define DA9121_MASK_SYS_GPIO2_0_GPIO2_OBUF              BIT(0)
 225
 226 /* DA9121_REG_SYS_GPIO2_1 */
 227
 228 #define DA9121_MASK_SYS_GPIO2_1_GPIO2_DEB_FALL          BIT(7)
 229 #define DA9121_MASK_SYS_GPIO2_1_GPIO2_DEB_RISE          BIT(6)
 230 #define DA9121_MASK_SYS_GPIO2_1_GPIO2_DEB               0x30
 231 #define DA9121_MASK_SYS_GPIO2_1_GPIO2_PUPD              BIT(3)
 232 #define DA9121_MASK_SYS_GPIO2_1_GPIO2_POL               BIT(2)
 233 #define DA9121_MASK_SYS_GPIO2_1_GPIO2_TRIG              0x03
 234
 235 /* DA9121_REG_BUCK_BUCK1_0 / DA9xxx_REG_BUCK_BUCK2_0 */
 236
 237 #define DA9121_MASK_BUCK_BUCKx_0_CHx_SR_DVC_DWN         0x70
 238 #define DA9121_MASK_BUCK_BUCKx_0_CHx_SR_DVC_UP          0x0E
 239 #define DA9121_MASK_BUCK_BUCKx_0_CHx_EN                 BIT(0)
 240
 241 /* DA9121_REG_BUCK_BUCK1_1 / DA9xxx_REG_BUCK_BUCK2_1 */
 242
 243 #define DA9121_MASK_BUCK_BUCKx_1_CHx_SR_SHDN            0x70
 244 #define DA9121_MASK_BUCK_BUCKx_1_CHx_SR_STARTUP         0x0E
 245 #define DA9121_MASK_BUCK_BUCKx_1_CHx_PD_DIS             BIT(0)
 246
 247 /* DA9121_REG_BUCK_BUCK1_2 / DA9xxx_REG_BUCK_BUCK2_2 */
 248
 249 #define DA9121_MASK_BUCK_BUCKx_2_CHx_ILIM               0x0F
 250
 251 /* DA9121_REG_BUCK_BUCK1_3 / DA9xxx_REG_BUCK_BUCK2_3 */
 252
 253 #define DA9121_MASK_BUCK_BUCKx_3_CHx_VMAX               0xFF
 254
 255 /* DA9121_REG_BUCK_BUCK1_4 / DA9xxx_REG_BUCK_BUCK2_4 */
 256
 257 #define DA9121_MASK_BUCK_BUCKx_4_CHx_VSEL               BIT(4)
 258 #define DA9121_MASK_BUCK_BUCKx_4_CHx_B_MODE             0x0C
 259 #define DA9121_MASK_BUCK_BUCKx_4_CHx_A_MODE             0x03
 260
 261 /* DA9121_REG_BUCK_BUCK1_5 / DA9xxx_REG_BUCK_BUCK2_5 */
 262
 263 #define DA9121_MASK_BUCK_BUCKx_5_CHx_A_VOUT             0xFF
 264
 265 /* DA9121_REG_BUCK_BUCK1_6 / DA9xxx_REG_BUCK_BUCK2_6 */
 266
 267 #define DA9121_MASK_BUCK_BUCKx_6_CHx_B_VOUT             0xFF
 268
 269 /* DA9121_REG_BUCK_BUCK1_7 / DA9xxx_REG_BUCK_BUCK2_7 */
 270
 271 #define DA9xxx_MASK_BUCK_BUCKx_7_CHx_RIPPLE_CANCEL      0x03
 272
 273
 274 /* DA9121_REG_OTP_DEVICE_ID */
 275
 276 #define DA9121_MASK_OTP_DEVICE_ID_DEV_ID                0xFF
 277
 278 #define DA9121_DEVICE_ID        0x05
 279
 280 /* DA9121_REG_OTP_VARIANT_ID */
 281
 282 #define DA9121_SHIFT_OTP_VARIANT_ID_MRC                 4
 283 #define DA9121_MASK_OTP_VARIANT_ID_MRC                  0xF0
 284 #define DA9121_SHIFT_OTP_VARIANT_ID_VRC                 0
 285 #define DA9121_MASK_OTP_VARIANT_ID_VRC                  0x0F
 286
 287 #define DA9121_VARIANT_MRC_BASE 0x2
 288 #define DA9121_VARIANT_VRC      0x1
 289 #define DA9220_VARIANT_VRC      0x0
 290 #define DA9122_VARIANT_VRC      0x2
 291 #define DA9217_VARIANT_VRC      0x7
 292 #define DA9130_VARIANT_VRC      0x0
 293 #define DA9131_VARIANT_VRC      0x1
 294 #define DA9132_VARIANT_VRC      0x2
 295
 296 /* DA9121_REG_OTP_CUSTOMER_ID */
 297
 298 #define DA9121_MASK_OTP_CUSTOMER_ID_CUST_ID             0xFF
 299
 300 /* DA9121_REG_OTP_CONFIG_ID */
 301
 302 #define DA9121_MASK_OTP_CONFIG_ID_CONFIG_REV            0xFF
 303
 304 #endif /* __DA9121_REGISTERS_H__ */