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 */
23enum 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
62struct max8997_regulator_data {
63 int id;
64 struct regulator_init_data *initdata;
65 struct device_node *reg_node;
66};
67
68struct 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 */
79struct 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
94enum max8997_haptic_motor_type {
95 MAX8997_HAPTIC_ERM,
96 MAX8997_HAPTIC_LRA,
97};
98
99enum max8997_haptic_pulse_mode {
100 MAX8997_EXTERNAL_MODE,
101 MAX8997_INTERNAL_MODE,
102};
103
104enum 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 */
128struct 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
140enum 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 */
157struct max8997_led_platform_data {
158 enum max8997_led_mode mode[2];
159 u8 brightness[2];
160};
161
162struct 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_gpios[3]; /* GPIO of [0]SET1, [1]SET2, [2]SET3 */
182 int buck125_default_idx; /* Default value of SET1, 2, 3 */
183 unsigned int buck1_voltage[8]; /* buckx_voltage in uV */
184 bool buck1_gpiodvs;
185 unsigned int buck2_voltage[8];
186 bool buck2_gpiodvs;
187 unsigned int buck5_voltage[8];
188 bool buck5_gpiodvs;
189
190 /* ---- Charger control ---- */
191 /* eoc stands for 'end of charge' */
192 int eoc_mA; /* 50 ~ 200mA by 10mA step */
193 /* charge Full Timeout */
194 int timeout; /* 0 (no timeout), 5, 6, 7 hours */
195
196 /* ---- MUIC ---- */
197 struct max8997_muic_platform_data *muic_pdata;
198
199 /* ---- HAPTIC ---- */
200 struct max8997_haptic_platform_data *haptic_pdata;
201
202 /* RTC: Not implemented */
203 /* ---- LED ---- */
204 struct max8997_led_platform_data *led_pdata;
205};
206
207#endif /* __LINUX_MFD_MAX8997_H */
208

source code of linux/include/linux/mfd/max8997.h