include/power/pmic.h

2  *  Copyright (C) 2014-2015 Samsung Electronics
5  *  Copyright (C) 2011-2012 Samsung Electronics
8  * SPDX-License-Identifier:	GPL-2.0+
90  * U-Boot PMIC Framework
93  * UCLASS_PMIC - This is designed to provide an I/O interface for PMIC devices.
95  * For the multi-function PMIC devices, this can be used as parent I/O 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)
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)
113  * - single I/O interface
114  * - multiple I/O interfaces
129  * The same for other device nodes, for multi-interface PMIC.
134  * If a PMIC child device driver needs access the PMIC-specific registers,
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
145  * the 'pmic_bind_children()' - please refer to the function description, which
150  * - 'drivers/power/pmic/max77686.c'
154  * struct dm_pmic_ops - PMIC device I/O interface
174  * enum pmic_op_type - used for various pmic devices operation calls,
177  * @PMIC_OP_GET - get operation
178  * @PMIC_OP_SET - set operation
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
190  * @prefix - child node name prefix (or its name if is unique or single)
191  * @driver - driver name for the sub-node with prefix
195 	const char *prefix;  member
199 /* drivers/power/pmic-uclass.c */
202  * pmic_bind_children() - bind drivers for given parent pmic, using child info
205  * @pmic       - pmic device - the parent of found child's
206  * @child_info - N-childs info array
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.
212  * For example, a single prefix info (N=1):
214  *     { .prefix = "ldo", .driver = "ldo_driver" },
218  * This function is useful for regulator sub-nodes:
221  *     (pmic - bind automatically by compatible)
224  *     (pmic's childs - bind by pmic_bind_children())
225  *     (nodes prefix: "ldo", driver: "my_regulator_ldo")
229  *     (nodes prefix: "buck", driver: "my_regulator_buck")
240  * @name - device name
241  * @devp - returned pointer to the pmic device
253  * @dev - pointer to the UCLASS_PMIC device
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
273  * pmic_reg_read() - read a PMIC register value
282  * pmic_reg_write() - write a PMIC register value
292  * pmic_clrsetbits() - clear and set bits in a PMIC register
306  * pmic_suspend() - suspend of PMIC
314  * pmic_resume() - resume of PMIC
322  * pmic_shutdown() - power off supplies of PMIC
344 #define pmic_i2c_addr (p->hw.i2c.addr)
345 #define pmic_i2c_tx_num (p->hw.i2c.tx_num)
347 #define pmic_spi_bitlen (p->hw.spi.bitlen)
348 #define pmic_spi_flags (p->hw.spi.flags)