1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3 * max8973-regulator.h -- MAXIM 8973 regulator
4 *
5 * Interface for regulator driver for MAXIM 8973 DC-DC step-down
6 * switching regulator.
7 *
8 * Copyright (C) 2012 NVIDIA Corporation
9
10 * Author: Laxman Dewangan <ldewangan@nvidia.com>
11 */
12
13 #ifndef __LINUX_REGULATOR_MAX8973_H
14 #define __LINUX_REGULATOR_MAX8973_H
15
16 /*
17 * Control flags for configuration of the device.
18 * Client need to pass this information with ORed
19 */
20 #define MAX8973_CONTROL_REMOTE_SENSE_ENABLE 0x00000001
21 #define MAX8973_CONTROL_FALLING_SLEW_RATE_ENABLE 0x00000002
22 #define MAX8973_CONTROL_OUTPUT_ACTIVE_DISCH_ENABLE 0x00000004
23 #define MAX8973_CONTROL_BIAS_ENABLE 0x00000008
24 #define MAX8973_CONTROL_PULL_DOWN_ENABLE 0x00000010
25 #define MAX8973_CONTROL_FREQ_SHIFT_9PER_ENABLE 0x00000020
26
27 #define MAX8973_CONTROL_CLKADV_TRIP_DISABLED 0x00000000
28 #define MAX8973_CONTROL_CLKADV_TRIP_75mV_PER_US 0x00010000
29 #define MAX8973_CONTROL_CLKADV_TRIP_150mV_PER_US 0x00020000
30 #define MAX8973_CONTROL_CLKADV_TRIP_75mV_PER_US_HIST_DIS 0x00030000
31
32 #define MAX8973_CONTROL_INDUCTOR_VALUE_NOMINAL 0x00000000
33 #define MAX8973_CONTROL_INDUCTOR_VALUE_MINUS_30_PER 0x00100000
34 #define MAX8973_CONTROL_INDUCTOR_VALUE_PLUS_30_PER 0x00200000
35 #define MAX8973_CONTROL_INDUCTOR_VALUE_PLUS_60_PER 0x00300000
36
37 /*
38 * struct max8973_regulator_platform_data - max8973 regulator platform data.
39 *
40 * @reg_init_data: The regulator init data.
41 * @control_flags: Control flags which are ORed value of above flags to
42 * configure device.
43 * @junction_temp_warning: Junction temp in millicelcius on which warning need
44 * to be set. Thermal functionality is only supported on
45 * MAX77621. The threshold warning supported by MAX77621
46 * are 120C and 140C.
47 * @enable_ext_control: Enable the voltage enable/disable through external
48 * control signal from EN input pin. If it is false then
49 * voltage output will be enabled/disabled through EN bit of
50 * device register.
51 * @enable_gpio: Enable GPIO. If EN pin is controlled through GPIO from host
52 * then GPIO number can be provided. If no GPIO controlled then
53 * it should be -1.
54 * @dvs_gpio: GPIO for dvs. It should be -1 if this is tied with fixed logic.
55 * @dvs_def_state: Default state of dvs. 1 if it is high else 0.
56 */
57 struct max8973_regulator_platform_data {
58 struct regulator_init_data *reg_init_data;
59 unsigned long control_flags;
60 unsigned long junction_temp_warning;
61 bool enable_ext_control;
62 int enable_gpio;
63 int dvs_gpio;
64 unsigned dvs_def_state:1;
65 };
66
67 #endif /* __LINUX_REGULATOR_MAX8973_H */