xref: /linux-6.15/include/linux/mfd/samsung/core.h (revision 564f7dfd)
1 /*
2  * core.h
3  *
4  * copyright (c) 2011 Samsung Electronics Co., Ltd
5  *              http://www.samsung.com
6  *
7  *  This program is free software; you can redistribute  it and/or modify it
8  *  under  the terms of  the GNU General  Public License as published by the
9  *  Free Software Foundation;  either version 2 of the  License, or (at your
10  *  option) any later version.
11  *
12  */
13 
14 #ifndef __LINUX_MFD_SEC_CORE_H
15 #define __LINUX_MFD_SEC_CORE_H
16 
17 /* Macros to represent minimum voltages for LDO/BUCK */
18 #define MIN_3000_MV		3000000
19 #define MIN_2500_MV		2500000
20 #define MIN_2000_MV		2000000
21 #define MIN_1800_MV		1800000
22 #define MIN_1500_MV		1500000
23 #define MIN_1400_MV		1400000
24 #define MIN_1000_MV		1000000
25 
26 #define MIN_900_MV		900000
27 #define MIN_850_MV		850000
28 #define MIN_800_MV		800000
29 #define MIN_750_MV		750000
30 #define MIN_600_MV		600000
31 #define MIN_500_MV		500000
32 
33 /* Ramp delay in uV/us */
34 #define RAMP_DELAY_12_MVUS	12000
35 
36 /* Macros to represent steps for LDO/BUCK */
37 #define STEP_50_MV		50000
38 #define STEP_25_MV		25000
39 #define STEP_12_5_MV		12500
40 #define STEP_6_25_MV		6250
41 
42 enum sec_device_type {
43 	S5M8751X,
44 	S5M8763X,
45 	S5M8767X,
46 	S2MPA01,
47 	S2MPS11X,
48 	S2MPS13X,
49 	S2MPS14X,
50 	S2MPS15X,
51 	S2MPU02,
52 };
53 
54 /**
55  * struct sec_pmic_dev - s2m/s5m master device for sub-drivers
56  * @dev:		Master device of the chip
57  * @pdata:		Platform data populated with data from DTS
58  *			or board files
59  * @regmap_pmic:	Regmap associated with PMIC's I2C address
60  * @i2c:		I2C client of the main driver
61  * @device_type:	Type of device, matches enum sec_device_type
62  * @irq_base:		Base IRQ number for device, required for IRQs
63  * @irq:		Generic IRQ number for device
64  * @irq_data:		Runtime data structure for IRQ controller
65  * @wakeup:		Whether or not this is a wakeup device
66  */
67 struct sec_pmic_dev {
68 	struct device *dev;
69 	struct sec_platform_data *pdata;
70 	struct regmap *regmap_pmic;
71 	struct i2c_client *i2c;
72 
73 	unsigned long device_type;
74 	int irq_base;
75 	int irq;
76 	struct regmap_irq_chip_data *irq_data;
77 
78 	bool wakeup;
79 };
80 
81 int sec_irq_init(struct sec_pmic_dev *sec_pmic);
82 void sec_irq_exit(struct sec_pmic_dev *sec_pmic);
83 int sec_irq_resume(struct sec_pmic_dev *sec_pmic);
84 
85 struct sec_platform_data {
86 	struct sec_regulator_data	*regulators;
87 	struct sec_opmode_data		*opmode;
88 	int				device_type;
89 	int				num_regulators;
90 
91 	int				irq_base;
92 	int				(*cfg_pmic_irq)(void);
93 
94 	bool				wakeup;
95 	bool				buck_voltage_lock;
96 
97 	int				buck_gpios[3];
98 	int				buck_ds[3];
99 	unsigned int			buck2_voltage[8];
100 	bool				buck2_gpiodvs;
101 	unsigned int			buck3_voltage[8];
102 	bool				buck3_gpiodvs;
103 	unsigned int			buck4_voltage[8];
104 	bool				buck4_gpiodvs;
105 
106 	int				buck_set1;
107 	int				buck_set2;
108 	int				buck_set3;
109 	int				buck2_enable;
110 	int				buck3_enable;
111 	int				buck4_enable;
112 	int				buck_default_idx;
113 	int				buck2_default_idx;
114 	int				buck3_default_idx;
115 	int				buck4_default_idx;
116 
117 	int				buck_ramp_delay;
118 
119 	int				buck2_ramp_delay;
120 	int				buck34_ramp_delay;
121 	int				buck5_ramp_delay;
122 	int				buck16_ramp_delay;
123 	int				buck7810_ramp_delay;
124 	int				buck9_ramp_delay;
125 	int				buck24_ramp_delay;
126 	int				buck3_ramp_delay;
127 	int				buck7_ramp_delay;
128 	int				buck8910_ramp_delay;
129 
130 	bool				buck1_ramp_enable;
131 	bool				buck2_ramp_enable;
132 	bool				buck3_ramp_enable;
133 	bool				buck4_ramp_enable;
134 	bool				buck6_ramp_enable;
135 
136 	int				buck2_init;
137 	int				buck3_init;
138 	int				buck4_init;
139 	/* Whether or not manually set PWRHOLD to low during shutdown. */
140 	bool				manual_poweroff;
141 	/* Disable the WRSTBI (buck voltage warm reset) when probing? */
142 	bool				disable_wrstbi;
143 };
144 
145 /**
146  * sec_regulator_data - regulator data
147  * @id: regulator id
148  * @initdata: regulator init data (contraints, supplies, ...)
149  */
150 struct sec_regulator_data {
151 	int				id;
152 	struct regulator_init_data	*initdata;
153 	struct device_node		*reg_node;
154 	int				ext_control_gpio;
155 };
156 
157 /*
158  * sec_opmode_data - regulator operation mode data
159  * @id: regulator id
160  * @mode: regulator operation mode
161  */
162 struct sec_opmode_data {
163 	int id;
164 	unsigned int mode;
165 };
166 
167 /*
168  * samsung regulator operation mode
169  * SEC_OPMODE_OFF	Regulator always OFF
170  * SEC_OPMODE_ON	Regulator always ON
171  * SEC_OPMODE_LOWPOWER  Regulator is on in low-power mode
172  * SEC_OPMODE_SUSPEND   Regulator is changed by PWREN pin
173  *			If PWREN is high, regulator is on
174  *			If PWREN is low, regulator is off
175  */
176 
177 enum sec_opmode {
178 	SEC_OPMODE_OFF,
179 	SEC_OPMODE_ON,
180 	SEC_OPMODE_LOWPOWER,
181 	SEC_OPMODE_SUSPEND,
182 };
183 
184 #endif /*  __LINUX_MFD_SEC_CORE_H */
185