1 /* 2 * Copyright (C) 2014-2015 Samsung Electronics 3 * Przemyslaw Marczak <p.marczak@samsung.com> 4 * 5 * Copyright (C) 2011-2012 Samsung Electronics 6 * Lukasz Majewski <l.majewski@samsung.com> 7 * 8 * SPDX-License-Identifier: GPL-2.0+ 9 */ 10 11 #ifndef __CORE_PMIC_H_ 12 #define __CORE_PMIC_H_ 13 14 #include <dm/ofnode.h> 15 #include <i2c.h> 16 #include <linux/list.h> 17 #include <power/power_chrg.h> 18 19 enum { PMIC_I2C, PMIC_SPI, PMIC_NONE}; 20 21 #ifdef CONFIG_POWER 22 enum { I2C_PMIC, I2C_NUM, }; 23 enum { PMIC_READ, PMIC_WRITE, }; 24 enum { PMIC_SENSOR_BYTE_ORDER_LITTLE, PMIC_SENSOR_BYTE_ORDER_BIG, }; 25 26 enum { 27 PMIC_CHARGER_DISABLE, 28 PMIC_CHARGER_ENABLE, 29 }; 30 31 struct p_i2c { 32 unsigned char addr; 33 unsigned char *buf; 34 unsigned char tx_num; 35 }; 36 37 struct p_spi { 38 unsigned int cs; 39 unsigned int mode; 40 unsigned int bitlen; 41 unsigned int clk; 42 unsigned int flags; 43 u32 (*prepare_tx)(u32 reg, u32 *val, u32 write); 44 }; 45 46 struct pmic; 47 struct power_fg { 48 int (*fg_battery_check) (struct pmic *p, struct pmic *bat); 49 int (*fg_battery_update) (struct pmic *p, struct pmic *bat); 50 }; 51 52 struct power_chrg { 53 int (*chrg_type) (struct pmic *p); 54 int (*chrg_bat_present) (struct pmic *p); 55 int (*chrg_state) (struct pmic *p, int state, int current); 56 }; 57 58 struct power_battery { 59 struct battery *bat; 60 int (*battery_init) (struct pmic *bat, struct pmic *p1, 61 struct pmic *p2, struct pmic *p3); 62 int (*battery_charge) (struct pmic *bat); 63 /* Keep info about power devices involved with battery operation */ 64 struct pmic *chrg, *fg, *muic; 65 }; 66 67 struct pmic { 68 const char *name; 69 unsigned char bus; 70 unsigned char interface; 71 unsigned char sensor_byte_order; 72 unsigned int number_of_regs; 73 union hw { 74 struct p_i2c i2c; 75 struct p_spi spi; 76 } hw; 77 78 void (*low_power_mode) (void); 79 struct power_battery *pbat; 80 struct power_chrg *chrg; 81 struct power_fg *fg; 82 83 struct pmic *parent; 84 struct list_head list; 85 }; 86 #endif /* CONFIG_POWER */ 87 88 #ifdef CONFIG_DM_PMIC 89 /** 90 * U-Boot PMIC Framework 91 * ===================== 92 * 93 * UCLASS_PMIC - This is designed to provide an I/O interface for PMIC devices. 94 * 95 * For the multi-function PMIC devices, this can be used as parent I/O device 96 * for each IC's interface. Then, each child uses its parent for read/write. 97 * 98 * The driver model tree could look like this: 99 * 100 *_ root device 101 * |_ BUS 0 device (e.g. I2C0) - UCLASS_I2C/SPI/... 102 * | |_ PMIC device (READ/WRITE ops) - UCLASS_PMIC 103 * | |_ REGULATOR device (ldo/buck/... ops) - UCLASS_REGULATOR 104 * | |_ CHARGER device (charger ops) - UCLASS_CHARGER (in the future) 105 * | |_ MUIC device (microUSB connector ops) - UCLASS_MUIC (in the future) 106 * | |_ ... 107 * | 108 * |_ BUS 1 device (e.g. I2C1) - UCLASS_I2C/SPI/... 109 * |_ PMIC device (READ/WRITE ops) - UCLASS_PMIC 110 * |_ RTC device (rtc ops) - UCLASS_RTC (in the future) 111 * 112 * We can find two PMIC cases in boards design: 113 * - single I/O interface 114 * - multiple I/O interfaces 115 * We bind a single PMIC device for each interface, to provide an I/O for 116 * its child devices. And each child usually implements a different function, 117 * controlled by the same interface. 118 * 119 * The binding should be done automatically. If device tree nodes/subnodes are 120 * proper defined, then: 121 * 122 * |_ the ROOT driver will bind the device for I2C/SPI node: 123 * |_ the I2C/SPI driver should bind a device for pmic node: 124 * |_ the PMIC driver should bind devices for its childs: 125 * |_ regulator (child) 126 * |_ charger (child) 127 * |_ other (child) 128 * 129 * The same for other device nodes, for multi-interface PMIC. 130 * 131 * Note: 132 * Each PMIC interface driver should use a different compatible string. 133 * 134 * If a PMIC child device driver needs access the PMIC-specific registers, 135 * it need know only the register address and the access can be done through 136 * the parent pmic driver. Like in the example: 137 * 138 *_ root driver 139 * |_ dev: bus I2C0 - UCLASS_I2C 140 * | |_ dev: my_pmic (read/write) (is parent) - UCLASS_PMIC 141 * | |_ dev: my_regulator (set value/etc..) (is child) - UCLASS_REGULATOR 142 * 143 * To ensure such device relationship, the pmic device driver should also bind 144 * all its child devices, like in the example below. It can be done by calling 145 * the 'pmic_bind_children()' - please refer to the function description, which 146 * can be found in this header file. This function, should be called inside the 147 * driver's bind() method. 148 * 149 * For the example driver, please refer the MAX77686 driver: 150 * - 'drivers/power/pmic/max77686.c' 151 */ 152 153 /** 154 * struct dm_pmic_ops - PMIC device I/O interface 155 * 156 * Should be implemented by UCLASS_PMIC device drivers. The standard 157 * device operations provides the I/O interface for it's childs. 158 * 159 * @reg_count: device's register count 160 * @read: read 'len' bytes at "reg" and store it into the 'buffer' 161 * @write: write 'len' bytes from the 'buffer' to the register at 'reg' address 162 */ 163 struct dm_pmic_ops { 164 int (*reg_count)(struct udevice *dev); 165 int (*read)(struct udevice *dev, uint reg, uint8_t *buffer, int len); 166 int (*write)(struct udevice *dev, uint reg, const uint8_t *buffer, 167 int len); 168 int (*suspend)(struct udevice *dev); 169 int (*resume)(struct udevice *dev); 170 int (*shutdown)(struct udevice *dev); 171 }; 172 173 /** 174 * enum pmic_op_type - used for various pmic devices operation calls, 175 * for reduce a number of lines with the same code for read/write or get/set. 176 * 177 * @PMIC_OP_GET - get operation 178 * @PMIC_OP_SET - set operation 179 */ 180 enum pmic_op_type { 181 PMIC_OP_GET, 182 PMIC_OP_SET, 183 }; 184 185 /** 186 * struct pmic_child_info - basic device's child info for bind child nodes with 187 * the driver by the node name prefix and driver name. This is a helper struct 188 * for function: pmic_bind_children(). 189 * 190 * @prefix - child node name prefix (or its name if is unique or single) 191 * @driver - driver name for the sub-node with prefix 192 */ 193 struct pmic_child_info { 194 const char *addr; 195 const char *prefix; 196 const char *driver; 197 }; 198 199 /* drivers/power/pmic-uclass.c */ 200 201 /** 202 * pmic_bind_children() - bind drivers for given parent pmic, using child info 203 * found in 'child_info' array. 204 * 205 * @pmic - pmic device - the parent of found child's 206 * @child_info - N-childs info array 207 * @return a positive number of childs, or 0 if no child found (error) 208 * 209 * Note: For N-childs the child_info array should have N+1 entries and the last 210 * entry prefix should be NULL - the same as for drivers compatible. 211 * 212 * For example, a single prefix info (N=1): 213 * static const struct pmic_child_info bind_info[] = { 214 * { .prefix = "ldo", .driver = "ldo_driver" }, 215 * { }, 216 * }; 217 * 218 * This function is useful for regulator sub-nodes: 219 * my_regulator@0xa { 220 * reg = <0xa>; 221 * (pmic - bind automatically by compatible) 222 * compatible = "my_pmic"; 223 * ... 224 * (pmic's childs - bind by pmic_bind_children()) 225 * (nodes prefix: "ldo", driver: "my_regulator_ldo") 226 * ldo1 { ... }; 227 * ldo2 { ... }; 228 * 229 * (nodes prefix: "buck", driver: "my_regulator_buck") 230 * buck1 { ... }; 231 * buck2 { ... }; 232 * }; 233 */ 234 int pmic_bind_children(struct udevice *pmic, ofnode parent, 235 const struct pmic_child_info *child_info); 236 237 /** 238 * pmic_get: get the pmic device using its name 239 * 240 * @name - device name 241 * @devp - returned pointer to the pmic device 242 * @return 0 on success or negative value of errno. 243 * 244 * The returned devp device can be used with pmic_read/write calls 245 */ 246 int pmic_get(const char *name, struct udevice **devp); 247 248 /** 249 * pmic_reg_count: get the pmic register count 250 * 251 * The required pmic device can be obtained by 'pmic_get()' 252 * 253 * @dev - pointer to the UCLASS_PMIC device 254 * @return register count value on success or negative value of errno. 255 */ 256 int pmic_reg_count(struct udevice *dev); 257 258 /** 259 * pmic_read/write: read/write to the UCLASS_PMIC device 260 * 261 * The required pmic device can be obtained by 'pmic_get()' 262 * 263 * @pmic - pointer to the UCLASS_PMIC device 264 * @reg - device register offset 265 * @buffer - pointer to read/write buffer 266 * @len - byte count for read/write 267 * @return 0 on success or negative value of errno. 268 */ 269 int pmic_read(struct udevice *dev, uint reg, uint8_t *buffer, int len); 270 int pmic_write(struct udevice *dev, uint reg, const uint8_t *buffer, int len); 271 272 /** 273 * pmic_reg_read() - read a PMIC register value 274 * 275 * @dev: PMIC device to read 276 * @reg: Register to read 277 * @return value read on success or negative value of errno. 278 */ 279 int pmic_reg_read(struct udevice *dev, uint reg); 280 281 /** 282 * pmic_reg_write() - write a PMIC register value 283 * 284 * @dev: PMIC device to write 285 * @reg: Register to write 286 * @value: Value to write 287 * @return 0 on success or negative value of errno. 288 */ 289 int pmic_reg_write(struct udevice *dev, uint reg, uint value); 290 291 /** 292 * pmic_clrsetbits() - clear and set bits in a PMIC register 293 * 294 * This reads a register, optionally clears some bits, optionally sets some 295 * bits, then writes the register. 296 * 297 * @dev: PMIC device to update 298 * @reg: Register to update 299 * @clr: Bit mask to clear (set those bits that you want cleared) 300 * @set: Bit mask to set (set those bits that you want set) 301 * @return 0 on success or negative value of errno. 302 */ 303 int pmic_clrsetbits(struct udevice *dev, uint reg, uint clr, uint set); 304 305 /** 306 * pmic_suspend() - suspend of PMIC 307 * 308 * @dev: PMIC device 309 * @return 0 on success or negative value of errno. 310 */ 311 int pmic_suspend(struct udevice *dev); 312 313 /** 314 * pmic_resume() - resume of PMIC 315 * 316 * @dev: PMIC device 317 * @return 0 on success or negative value of errno. 318 */ 319 int pmic_resume(struct udevice *dev); 320 321 /** 322 * pmic_shutdown() - power off supplies of PMIC 323 * 324 * @dev: PMIC device to update 325 * @return 0 on success or negative value of errno. 326 */ 327 int pmic_shutdown(struct udevice *dev); 328 329 #endif /* CONFIG_DM_PMIC */ 330 331 #ifdef CONFIG_POWER 332 int pmic_init(unsigned char bus); 333 int power_init_board(void); 334 int pmic_dialog_init(unsigned char bus); 335 int check_reg(struct pmic *p, u32 reg); 336 struct pmic *pmic_alloc(void); 337 struct pmic *pmic_get(const char *s); 338 int pmic_probe(struct pmic *p); 339 int pmic_reg_read(struct pmic *p, u32 reg, u32 *val); 340 int pmic_reg_write(struct pmic *p, u32 reg, u32 val); 341 int pmic_set_output(struct pmic *p, u32 reg, int ldo, int on); 342 #endif 343 344 #define pmic_i2c_addr (p->hw.i2c.addr) 345 #define pmic_i2c_tx_num (p->hw.i2c.tx_num) 346 347 #define pmic_spi_bitlen (p->hw.spi.bitlen) 348 #define pmic_spi_flags (p->hw.spi.flags) 349 350 #endif /* __CORE_PMIC_H_ */ 351