xref: /linux/include/linux/mfd/max8997.h (revision 79790b6818e96c58fe2bffee1b418c16e64e7b80)
1 /* SPDX-License-Identifier: GPL-2.0+ */
2 /*
3  * max8997.h - Driver for the Maxim 8997/8966
4  *
5  *  Copyright (C) 2009-2010 Samsung Electrnoics
6  *  MyungJoo Ham <myungjoo.ham@samsung.com>
7  *
8  * This driver is based on max8998.h
9  *
10  * MAX8997 has PMIC, MUIC, HAPTIC, RTC, FLASH, and Fuel Gauge devices.
11  * Except Fuel Gauge, every device shares the same I2C bus and included in
12  * this mfd driver. Although the fuel gauge is included in the chip, it is
13  * excluded from the driver because a) it has a different I2C bus from
14  * others and b) it can be enabled simply by using MAX17042 driver.
15  */
16 
17 #ifndef __LINUX_MFD_MAX8997_H
18 #define __LINUX_MFD_MAX8997_H
19 
20 #include <linux/regulator/consumer.h>
21 
22 /* MAX8997/8966 regulator IDs */
23 enum max8997_regulators {
24 	MAX8997_LDO1 = 0,
25 	MAX8997_LDO2,
26 	MAX8997_LDO3,
27 	MAX8997_LDO4,
28 	MAX8997_LDO5,
29 	MAX8997_LDO6,
30 	MAX8997_LDO7,
31 	MAX8997_LDO8,
32 	MAX8997_LDO9,
33 	MAX8997_LDO10,
34 	MAX8997_LDO11,
35 	MAX8997_LDO12,
36 	MAX8997_LDO13,
37 	MAX8997_LDO14,
38 	MAX8997_LDO15,
39 	MAX8997_LDO16,
40 	MAX8997_LDO17,
41 	MAX8997_LDO18,
42 	MAX8997_LDO21,
43 	MAX8997_BUCK1,
44 	MAX8997_BUCK2,
45 	MAX8997_BUCK3,
46 	MAX8997_BUCK4,
47 	MAX8997_BUCK5,
48 	MAX8997_BUCK6,
49 	MAX8997_BUCK7,
50 	MAX8997_EN32KHZ_AP,
51 	MAX8997_EN32KHZ_CP,
52 	MAX8997_ENVICHG,
53 	MAX8997_ESAFEOUT1,
54 	MAX8997_ESAFEOUT2,
55 	MAX8997_CHARGER_CV, /* control MBCCV of MBCCTRL3 */
56 	MAX8997_CHARGER, /* charger current, MBCCTRL4 */
57 	MAX8997_CHARGER_TOPOFF, /* MBCCTRL5 */
58 
59 	MAX8997_REG_MAX,
60 };
61 
62 struct max8997_regulator_data {
63 	int id;
64 	struct regulator_init_data *initdata;
65 	struct device_node *reg_node;
66 };
67 
68 struct max8997_muic_reg_data {
69 	u8 addr;
70 	u8 data;
71 };
72 
73 /**
74  * struct max8997_muic_platform_data
75  * @init_data: array of max8997_muic_reg_data
76  *	       used for initializing registers of MAX8997 MUIC device
77  * @num_init_data: array size of init_data
78  */
79 struct max8997_muic_platform_data {
80 	struct max8997_muic_reg_data *init_data;
81 	int num_init_data;
82 
83 	/* Check cable state after certain delay */
84 	int detcable_delay_ms;
85 
86 	/*
87 	 * Default usb/uart path whether UART/USB or AUX_UART/AUX_USB
88 	 * h/w path of COMP2/COMN1 on CONTROL1 register.
89 	 */
90 	int path_usb;
91 	int path_uart;
92 };
93 
94 enum max8997_haptic_motor_type {
95 	MAX8997_HAPTIC_ERM,
96 	MAX8997_HAPTIC_LRA,
97 };
98 
99 enum max8997_haptic_pulse_mode {
100 	MAX8997_EXTERNAL_MODE,
101 	MAX8997_INTERNAL_MODE,
102 };
103 
104 enum max8997_haptic_pwm_divisor {
105 	MAX8997_PWM_DIVISOR_32,
106 	MAX8997_PWM_DIVISOR_64,
107 	MAX8997_PWM_DIVISOR_128,
108 	MAX8997_PWM_DIVISOR_256,
109 };
110 
111 /**
112  * max8997_haptic_platform_data
113  * @pwm_period: period in nano second for PWM device
114  *		valid for MAX8997_EXTERNAL_MODE
115  * @type: motor type
116  * @mode: pulse mode
117  *     MAX8997_EXTERNAL_MODE: external PWM device is used to control motor
118  *     MAX8997_INTERNAL_MODE: internal pulse generator is used to control motor
119  * @pwm_divisor: divisor for external PWM device
120  * @internal_mode_pattern: internal mode pattern for internal mode
121  *     [0 - 3]: valid pattern number
122  * @pattern_cycle: the number of cycles of the waveform
123  *		   for the internal mode pattern
124  *     [0 - 15]: available cycles
125  * @pattern_signal_period: period of the waveform for the internal mode pattern
126  *     [0 - 255]: available period
127  */
128 struct max8997_haptic_platform_data {
129 	unsigned int pwm_period;
130 
131 	enum max8997_haptic_motor_type type;
132 	enum max8997_haptic_pulse_mode mode;
133 	enum max8997_haptic_pwm_divisor pwm_divisor;
134 
135 	unsigned int internal_mode_pattern;
136 	unsigned int pattern_cycle;
137 	unsigned int pattern_signal_period;
138 };
139 
140 enum max8997_led_mode {
141 	MAX8997_NONE,
142 	MAX8997_FLASH_MODE,
143 	MAX8997_MOVIE_MODE,
144 	MAX8997_FLASH_PIN_CONTROL_MODE,
145 	MAX8997_MOVIE_PIN_CONTROL_MODE,
146 };
147 
148 /**
149  *  struct max8997_led_platform_data
150  *  The number of LED devices for MAX8997 is two
151  *  @mode: LED mode for each LED device
152  *  @brightness: initial brightness for each LED device
153  *	range:
154  *	[0 - 31]: MAX8997_FLASH_MODE and MAX8997_FLASH_PIN_CONTROL_MODE
155  *	[0 - 15]: MAX8997_MOVIE_MODE and MAX8997_MOVIE_PIN_CONTROL_MODE
156  */
157 struct max8997_led_platform_data {
158 	enum max8997_led_mode mode[2];
159 	u8 brightness[2];
160 };
161 
162 struct max8997_platform_data {
163 	/* IRQ */
164 	int ono;
165 
166 	/* ---- PMIC ---- */
167 	struct max8997_regulator_data *regulators;
168 	int num_regulators;
169 
170 	/*
171 	 * SET1~3 DVS GPIOs control Buck1, 2, and 5 simultaneously. Therefore,
172 	 * With buckx_gpiodvs enabled, the buckx cannot be controlled
173 	 * independently. To control buckx (of 1, 2, and 5) independently,
174 	 * disable buckx_gpiodvs and control with BUCKxDVS1 register.
175 	 *
176 	 * When buckx_gpiodvs and bucky_gpiodvs are both enabled, set_voltage
177 	 * on buckx will change the voltage of bucky at the same time.
178 	 *
179 	 */
180 	bool ignore_gpiodvs_side_effect;
181 	int buck125_default_idx; /* Default value of SET1, 2, 3 */
182 	unsigned int buck1_voltage[8]; /* buckx_voltage in uV */
183 	bool buck1_gpiodvs;
184 	unsigned int buck2_voltage[8];
185 	bool buck2_gpiodvs;
186 	unsigned int buck5_voltage[8];
187 	bool buck5_gpiodvs;
188 
189 	/* ---- Charger control ---- */
190 	/* eoc stands for 'end of charge' */
191 	int eoc_mA; /* 50 ~ 200mA by 10mA step */
192 	/* charge Full Timeout */
193 	int timeout; /* 0 (no timeout), 5, 6, 7 hours */
194 
195 	/* ---- MUIC ---- */
196 	struct max8997_muic_platform_data *muic_pdata;
197 
198 	/* ---- HAPTIC ---- */
199 	struct max8997_haptic_platform_data *haptic_pdata;
200 
201 	/* RTC: Not implemented */
202 	/* ---- LED ---- */
203 	struct max8997_led_platform_data *led_pdata;
204 };
205 
206 #endif /* __LINUX_MFD_MAX8997_H */
207