xref: /linux-6.15/include/linux/mfd/wm831x/pdata.h (revision 565d76cb)
1 /*
2  * include/linux/mfd/wm831x/pdata.h -- Platform data for WM831x
3  *
4  * Copyright 2009 Wolfson Microelectronics PLC.
5  *
6  * Author: Mark Brown <[email protected]>
7  *
8  *  This program is free software; you can redistribute  it and/or modify it
9  *  under  the terms of  the GNU General  Public License as published by the
10  *  Free Software Foundation;  either version 2 of the  License, or (at your
11  *  option) any later version.
12  *
13  */
14 
15 #ifndef __MFD_WM831X_PDATA_H__
16 #define __MFD_WM831X_PDATA_H__
17 
18 struct wm831x;
19 struct regulator_init_data;
20 
21 struct wm831x_backlight_pdata {
22 	int isink;     /** ISINK to use, 1 or 2 */
23 	int max_uA;    /** Maximum current to allow */
24 };
25 
26 struct wm831x_backup_pdata {
27 	int charger_enable;
28 	int no_constant_voltage;  /** Disable constant voltage charging */
29 	int vlim;   /** Voltage limit in milivolts */
30 	int ilim;   /** Current limit in microamps */
31 };
32 
33 struct wm831x_battery_pdata {
34 	int enable;         /** Enable charging */
35 	int fast_enable;    /** Enable fast charging */
36 	int off_mask;       /** Mask OFF while charging */
37 	int trickle_ilim;   /** Trickle charge current limit, in mA */
38 	int vsel;           /** Target voltage, in mV */
39 	int eoc_iterm;      /** End of trickle charge current, in mA */
40 	int fast_ilim;      /** Fast charge current limit, in mA */
41 	int timeout;        /** Charge cycle timeout, in minutes */
42 };
43 
44 /**
45  * Configuration for the WM831x DC-DC BuckWise convertors.  This
46  * should be passed as driver_data in the regulator_init_data.
47  *
48  * Currently all the configuration is for the fast DVS switching
49  * support of the devices.  This allows MFPs on the device to be
50  * configured as an input to switch between two output voltages,
51  * allowing voltage transitions without the expense of an access over
52  * I2C or SPI buses.
53  */
54 struct wm831x_buckv_pdata {
55 	int dvs_gpio;        /** CPU GPIO to use for DVS switching */
56 	int dvs_control_src; /** Hardware DVS source to use (1 or 2) */
57 	int dvs_init_state;  /** DVS state to expect on startup */
58 	int dvs_state_gpio;  /** CPU GPIO to use for monitoring status */
59 };
60 
61 /* Sources for status LED configuration.  Values are register values
62  * plus 1 to allow for a zero default for preserve.
63  */
64 enum wm831x_status_src {
65 	WM831X_STATUS_PRESERVE = 0,  /* Keep the current hardware setting */
66 	WM831X_STATUS_OTP = 1,
67 	WM831X_STATUS_POWER = 2,
68 	WM831X_STATUS_CHARGER = 3,
69 	WM831X_STATUS_MANUAL = 4,
70 };
71 
72 struct wm831x_status_pdata {
73 	enum wm831x_status_src default_src;
74 	const char *name;
75 	const char *default_trigger;
76 };
77 
78 struct wm831x_touch_pdata {
79 	int fivewire;          /** 1 for five wire mode, 0 for 4 wire */
80 	int isel;              /** Current for pen down (uA) */
81 	int rpu;               /** Pen down sensitivity resistor divider */
82 	int pressure;          /** Report pressure (boolean) */
83 	unsigned int data_irq; /** Touch data ready IRQ */
84 	unsigned int pd_irq;   /** Touch pendown detect IRQ */
85 };
86 
87 enum wm831x_watchdog_action {
88 	WM831X_WDOG_NONE = 0,
89 	WM831X_WDOG_INTERRUPT = 1,
90 	WM831X_WDOG_RESET = 2,
91 	WM831X_WDOG_WAKE = 3,
92 };
93 
94 struct wm831x_watchdog_pdata {
95 	enum wm831x_watchdog_action primary, secondary;
96 	int update_gpio;
97 	unsigned int software:1;
98 };
99 
100 #define WM831X_MAX_STATUS 2
101 #define WM831X_MAX_DCDC   4
102 #define WM831X_MAX_EPE    2
103 #define WM831X_MAX_LDO    11
104 #define WM831X_MAX_ISINK  2
105 
106 struct wm831x_pdata {
107 	/** Called before subdevices are set up */
108 	int (*pre_init)(struct wm831x *wm831x);
109 	/** Called after subdevices are set up */
110 	int (*post_init)(struct wm831x *wm831x);
111 
112 	int irq_base;
113 	int gpio_base;
114 	struct wm831x_backlight_pdata *backlight;
115 	struct wm831x_backup_pdata *backup;
116 	struct wm831x_battery_pdata *battery;
117 	struct wm831x_touch_pdata *touch;
118 	struct wm831x_watchdog_pdata *watchdog;
119 
120 	/** LED1 = 0 and so on */
121 	struct wm831x_status_pdata *status[WM831X_MAX_STATUS];
122 	/** DCDC1 = 0 and so on */
123 	struct regulator_init_data *dcdc[WM831X_MAX_DCDC];
124 	/** EPE1 = 0 and so on */
125 	struct regulator_init_data *epe[WM831X_MAX_EPE];
126 	/** LDO1 = 0 and so on */
127 	struct regulator_init_data *ldo[WM831X_MAX_LDO];
128 	/** ISINK1 = 0 and so on*/
129 	struct regulator_init_data *isink[WM831X_MAX_ISINK];
130 };
131 
132 #endif
133