1 // SPDX-License-Identifier: GPL-2.0-only
3 * Core driver for STw4810/STw4811
5 * Copyright (C) 2013 ST-Ericsson SA
6 * Written on behalf of Linaro for ST-Ericsson
8 * Author: Linus Walleij <linus.walleij@linaro.org>
11 #include <linux/err.h>
12 #include <linux/i2c.h>
13 #include <linux/init.h>
14 #include <linux/mfd/core.h>
15 #include <linux/mfd/stw481x.h>
16 #include <linux/module.h>
17 #include <linux/regmap.h>
18 #include <linux/spinlock.h>
19 #include <linux/slab.h>
22 * This driver can only access the non-USB portions of STw4811, the register
23 * range 0x00-0x10 dealing with USB is bound to the two special I2C pins used
27 /* Registers inside the power control address space */
28 #define STW_PC_VCORE_SEL 0x05U
29 #define STW_PC_VAUX_SEL 0x06U
30 #define STW_PC_VPLL_SEL 0x07U
33 * stw481x_get_pctl_reg() - get a power control register
34 * @stw481x: handle to the stw481x chip
35 * @reg: power control register to fetch
37 * The power control registers is a set of one-time-programmable registers
38 * in its own register space, accessed by writing addess bits to these
39 * two registers: bits 7,6,5 of PCTL_REG_LO corresponds to the 3 LSBs of
40 * the address and bits 8,9 of PCTL_REG_HI corresponds to the 2 MSBs of
41 * the address, forming an address space of 5 bits, i.e. 32 registers
42 * 0x00 ... 0x1f can be obtained.
44 static int stw481x_get_pctl_reg(struct stw481x
*stw481x
, u8 reg
)
46 u8 msb
= (reg
>> 3) & 0x03;
47 u8 lsb
= (reg
<< 5) & 0xe0;
52 ret
= regmap_write(stw481x
->map
, STW_PCTL_REG_HI
, msb
);
55 ret
= regmap_write(stw481x
->map
, STW_PCTL_REG_LO
, lsb
);
58 ret
= regmap_read(stw481x
->map
, STW_PCTL_REG_HI
, &val
);
61 vrfy
= (val
& 0x03) << 3;
62 ret
= regmap_read(stw481x
->map
, STW_PCTL_REG_LO
, &val
);
65 vrfy
|= ((val
>> 5) & 0x07);
68 return (val
>> 1) & 0x0f;
71 static int stw481x_startup(struct stw481x
*stw481x
)
73 /* Voltages multiplied by 100 */
74 static const u8 vcore_val
[] = {
75 100, 105, 110, 115, 120, 122, 124, 126, 128,
76 130, 132, 134, 136, 138, 140, 145
78 static const u8 vpll_val
[] = { 105, 120, 130, 180 };
79 static const u8 vaux_val
[] = { 15, 18, 25, 28 };
89 ret
= regmap_read(stw481x
->map
, STW_CONF1
, &val
);
92 vaux_en
= !!(val
& STW_CONF1_PDN_VAUX
);
93 it_warn
= !!(val
& STW_CONF1_IT_WARN
);
95 dev_info(&stw481x
->client
->dev
, "voltages %s\n",
96 (val
& STW_CONF1_V_MONITORING
) ? "OK" : "LOW");
97 dev_info(&stw481x
->client
->dev
, "MMC level shifter %s\n",
98 (val
& STW_CONF1_MMC_LS_STATUS
) ? "high impedance" : "ON");
99 dev_info(&stw481x
->client
->dev
, "VMMC: %s\n",
100 (val
& STW_CONF1_PDN_VMMC
) ? "ON" : "disabled");
102 dev_info(&stw481x
->client
->dev
, "STw481x power control registers:\n");
104 ret
= stw481x_get_pctl_reg(stw481x
, STW_PC_VCORE_SEL
);
109 ret
= stw481x_get_pctl_reg(stw481x
, STW_PC_VAUX_SEL
);
112 vaux
= (ret
>> 2) & 3;
113 vpll
= (ret
>> 4) & 1; /* Save bit 4 */
115 ret
= stw481x_get_pctl_reg(stw481x
, STW_PC_VPLL_SEL
);
118 vpll
|= (ret
>> 1) & 2;
120 dev_info(&stw481x
->client
->dev
, "VCORE: %u.%uV %s\n",
121 vcore_val
[vcore
] / 100, vcore_val
[vcore
] % 100,
122 (ret
& 4) ? "ON" : "OFF");
124 dev_info(&stw481x
->client
->dev
, "VPLL: %u.%uV %s\n",
125 vpll_val
[vpll
] / 100, vpll_val
[vpll
] % 100,
126 (ret
& 0x10) ? "ON" : "OFF");
128 dev_info(&stw481x
->client
->dev
, "VAUX: %u.%uV %s\n",
129 vaux_val
[vaux
] / 10, vaux_val
[vaux
] % 10,
130 vaux_en
? "ON" : "OFF");
132 ret
= regmap_read(stw481x
->map
, STW_CONF2
, &val
);
136 dev_info(&stw481x
->client
->dev
, "TWARN: %s threshold, %s\n",
137 it_warn
? "below" : "above",
138 (val
& STW_CONF2_MASK_TWARN
) ?
139 "enabled" : "mask through VDDOK");
140 dev_info(&stw481x
->client
->dev
, "VMMC: %s\n",
141 (val
& STW_CONF2_VMMC_EXT
) ? "internal" : "external");
142 dev_info(&stw481x
->client
->dev
, "IT WAKE UP: %s\n",
143 (val
& STW_CONF2_MASK_IT_WAKE_UP
) ? "enabled" : "masked");
144 dev_info(&stw481x
->client
->dev
, "GPO1: %s\n",
145 (val
& STW_CONF2_GPO1
) ? "low" : "high impedance");
146 dev_info(&stw481x
->client
->dev
, "GPO2: %s\n",
147 (val
& STW_CONF2_GPO2
) ? "low" : "high impedance");
149 ret
= regmap_read(stw481x
->map
, STW_VCORE_SLEEP
, &val
);
152 vcore_slp
= val
& 0x0f;
153 dev_info(&stw481x
->client
->dev
, "VCORE SLEEP: %u.%uV\n",
154 vcore_val
[vcore_slp
] / 100, vcore_val
[vcore_slp
] % 100);
160 * MFD cells - we have one cell which is selected operation
161 * mode, and we always have a GPIO cell.
163 static struct mfd_cell stw481x_cells
[] = {
165 .of_compatible
= "st,stw481x-vmmc",
166 .name
= "stw481x-vmmc-regulator",
171 static const struct regmap_config stw481x_regmap_config
= {
176 static int stw481x_probe(struct i2c_client
*client
,
177 const struct i2c_device_id
*id
)
179 struct stw481x
*stw481x
;
183 stw481x
= devm_kzalloc(&client
->dev
, sizeof(*stw481x
), GFP_KERNEL
);
187 i2c_set_clientdata(client
, stw481x
);
188 stw481x
->client
= client
;
189 stw481x
->map
= devm_regmap_init_i2c(client
, &stw481x_regmap_config
);
190 if (IS_ERR(stw481x
->map
)) {
191 ret
= PTR_ERR(stw481x
->map
);
192 dev_err(&client
->dev
, "Failed to allocate register map: %d\n",
197 ret
= stw481x_startup(stw481x
);
199 dev_err(&client
->dev
, "chip initialization failed\n");
203 /* Set up and register the platform devices. */
204 for (i
= 0; i
< ARRAY_SIZE(stw481x_cells
); i
++) {
205 /* One state holder for all drivers, this is simple */
206 stw481x_cells
[i
].platform_data
= stw481x
;
207 stw481x_cells
[i
].pdata_size
= sizeof(*stw481x
);
210 ret
= devm_mfd_add_devices(&client
->dev
, 0, stw481x_cells
,
211 ARRAY_SIZE(stw481x_cells
), NULL
, 0, NULL
);
215 dev_info(&client
->dev
, "initialized STw481x device\n");
221 * This ID table is completely unused, as this is a pure
222 * device-tree probed driver, but it has to be here due to
223 * the structure of the I2C core.
225 static const struct i2c_device_id stw481x_id
[] = {
229 MODULE_DEVICE_TABLE(i2c
, stw481x_id
);
231 static const struct of_device_id stw481x_match
[] = {
232 { .compatible
= "st,stw4810", },
233 { .compatible
= "st,stw4811", },
236 MODULE_DEVICE_TABLE(of
, stw481x_match
);
238 static struct i2c_driver stw481x_driver
= {
241 .of_match_table
= stw481x_match
,
243 .probe
= stw481x_probe
,
244 .id_table
= stw481x_id
,
247 module_i2c_driver(stw481x_driver
);
249 MODULE_AUTHOR("Linus Walleij");
250 MODULE_DESCRIPTION("STw481x PMIC driver");
251 MODULE_LICENSE("GPL v2");