1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-only
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * drivers/hwmon/lis3lv02d_i2c.c
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * Implements I2C interface for lis3lv02d (STMicroelectronics) accelerometer.
6*4882a593Smuzhiyun * Driver is based on corresponding SPI driver written by Daniel Mack
7*4882a593Smuzhiyun * (lis3lv02d_spi.c (C) 2009 Daniel Mack <daniel@caiaq.de> ).
8*4882a593Smuzhiyun *
9*4882a593Smuzhiyun * Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
10*4882a593Smuzhiyun *
11*4882a593Smuzhiyun * Contact: Samu Onkalo <samu.p.onkalo@nokia.com>
12*4882a593Smuzhiyun */
13*4882a593Smuzhiyun
14*4882a593Smuzhiyun #include <linux/module.h>
15*4882a593Smuzhiyun #include <linux/kernel.h>
16*4882a593Smuzhiyun #include <linux/err.h>
17*4882a593Smuzhiyun #include <linux/i2c.h>
18*4882a593Smuzhiyun #include <linux/pm_runtime.h>
19*4882a593Smuzhiyun #include <linux/delay.h>
20*4882a593Smuzhiyun #include <linux/of.h>
21*4882a593Smuzhiyun #include <linux/of_platform.h>
22*4882a593Smuzhiyun #include <linux/of_device.h>
23*4882a593Smuzhiyun
24*4882a593Smuzhiyun #include "lis3lv02d.h"
25*4882a593Smuzhiyun
26*4882a593Smuzhiyun #define DRV_NAME "lis3lv02d_i2c"
27*4882a593Smuzhiyun
28*4882a593Smuzhiyun static const char reg_vdd[] = "Vdd";
29*4882a593Smuzhiyun static const char reg_vdd_io[] = "Vdd_IO";
30*4882a593Smuzhiyun
lis3_reg_ctrl(struct lis3lv02d * lis3,bool state)31*4882a593Smuzhiyun static int lis3_reg_ctrl(struct lis3lv02d *lis3, bool state)
32*4882a593Smuzhiyun {
33*4882a593Smuzhiyun int ret;
34*4882a593Smuzhiyun if (state == LIS3_REG_OFF) {
35*4882a593Smuzhiyun ret = regulator_bulk_disable(ARRAY_SIZE(lis3->regulators),
36*4882a593Smuzhiyun lis3->regulators);
37*4882a593Smuzhiyun } else {
38*4882a593Smuzhiyun ret = regulator_bulk_enable(ARRAY_SIZE(lis3->regulators),
39*4882a593Smuzhiyun lis3->regulators);
40*4882a593Smuzhiyun /* Chip needs time to wakeup. Not mentioned in datasheet */
41*4882a593Smuzhiyun usleep_range(10000, 20000);
42*4882a593Smuzhiyun }
43*4882a593Smuzhiyun return ret;
44*4882a593Smuzhiyun }
45*4882a593Smuzhiyun
lis3_i2c_write(struct lis3lv02d * lis3,int reg,u8 value)46*4882a593Smuzhiyun static inline s32 lis3_i2c_write(struct lis3lv02d *lis3, int reg, u8 value)
47*4882a593Smuzhiyun {
48*4882a593Smuzhiyun struct i2c_client *c = lis3->bus_priv;
49*4882a593Smuzhiyun return i2c_smbus_write_byte_data(c, reg, value);
50*4882a593Smuzhiyun }
51*4882a593Smuzhiyun
lis3_i2c_read(struct lis3lv02d * lis3,int reg,u8 * v)52*4882a593Smuzhiyun static inline s32 lis3_i2c_read(struct lis3lv02d *lis3, int reg, u8 *v)
53*4882a593Smuzhiyun {
54*4882a593Smuzhiyun struct i2c_client *c = lis3->bus_priv;
55*4882a593Smuzhiyun *v = i2c_smbus_read_byte_data(c, reg);
56*4882a593Smuzhiyun return 0;
57*4882a593Smuzhiyun }
58*4882a593Smuzhiyun
lis3_i2c_blockread(struct lis3lv02d * lis3,int reg,int len,u8 * v)59*4882a593Smuzhiyun static inline s32 lis3_i2c_blockread(struct lis3lv02d *lis3, int reg, int len,
60*4882a593Smuzhiyun u8 *v)
61*4882a593Smuzhiyun {
62*4882a593Smuzhiyun struct i2c_client *c = lis3->bus_priv;
63*4882a593Smuzhiyun reg |= (1 << 7); /* 7th bit enables address auto incrementation */
64*4882a593Smuzhiyun return i2c_smbus_read_i2c_block_data(c, reg, len, v);
65*4882a593Smuzhiyun }
66*4882a593Smuzhiyun
lis3_i2c_init(struct lis3lv02d * lis3)67*4882a593Smuzhiyun static int lis3_i2c_init(struct lis3lv02d *lis3)
68*4882a593Smuzhiyun {
69*4882a593Smuzhiyun u8 reg;
70*4882a593Smuzhiyun int ret;
71*4882a593Smuzhiyun
72*4882a593Smuzhiyun lis3_reg_ctrl(lis3, LIS3_REG_ON);
73*4882a593Smuzhiyun
74*4882a593Smuzhiyun lis3->read(lis3, WHO_AM_I, ®);
75*4882a593Smuzhiyun if (reg != lis3->whoami)
76*4882a593Smuzhiyun printk(KERN_ERR "lis3: power on failure\n");
77*4882a593Smuzhiyun
78*4882a593Smuzhiyun /* power up the device */
79*4882a593Smuzhiyun ret = lis3->read(lis3, CTRL_REG1, ®);
80*4882a593Smuzhiyun if (ret < 0)
81*4882a593Smuzhiyun return ret;
82*4882a593Smuzhiyun
83*4882a593Smuzhiyun if (lis3->whoami == WAI_3DLH)
84*4882a593Smuzhiyun reg |= CTRL1_PM0 | CTRL1_Xen | CTRL1_Yen | CTRL1_Zen;
85*4882a593Smuzhiyun else
86*4882a593Smuzhiyun reg |= CTRL1_PD0 | CTRL1_Xen | CTRL1_Yen | CTRL1_Zen;
87*4882a593Smuzhiyun
88*4882a593Smuzhiyun return lis3->write(lis3, CTRL_REG1, reg);
89*4882a593Smuzhiyun }
90*4882a593Smuzhiyun
91*4882a593Smuzhiyun /* Default axis mapping but it can be overwritten by platform data */
92*4882a593Smuzhiyun static union axis_conversion lis3lv02d_axis_map =
93*4882a593Smuzhiyun { .as_array = { LIS3_DEV_X, LIS3_DEV_Y, LIS3_DEV_Z } };
94*4882a593Smuzhiyun
95*4882a593Smuzhiyun #ifdef CONFIG_OF
96*4882a593Smuzhiyun static const struct of_device_id lis3lv02d_i2c_dt_ids[] = {
97*4882a593Smuzhiyun { .compatible = "st,lis3lv02d" },
98*4882a593Smuzhiyun {}
99*4882a593Smuzhiyun };
100*4882a593Smuzhiyun MODULE_DEVICE_TABLE(of, lis3lv02d_i2c_dt_ids);
101*4882a593Smuzhiyun #endif
102*4882a593Smuzhiyun
lis3lv02d_i2c_probe(struct i2c_client * client,const struct i2c_device_id * id)103*4882a593Smuzhiyun static int lis3lv02d_i2c_probe(struct i2c_client *client,
104*4882a593Smuzhiyun const struct i2c_device_id *id)
105*4882a593Smuzhiyun {
106*4882a593Smuzhiyun int ret = 0;
107*4882a593Smuzhiyun struct lis3lv02d_platform_data *pdata = client->dev.platform_data;
108*4882a593Smuzhiyun
109*4882a593Smuzhiyun #ifdef CONFIG_OF
110*4882a593Smuzhiyun if (of_match_device(lis3lv02d_i2c_dt_ids, &client->dev)) {
111*4882a593Smuzhiyun lis3_dev.of_node = client->dev.of_node;
112*4882a593Smuzhiyun ret = lis3lv02d_init_dt(&lis3_dev);
113*4882a593Smuzhiyun if (ret)
114*4882a593Smuzhiyun return ret;
115*4882a593Smuzhiyun pdata = lis3_dev.pdata;
116*4882a593Smuzhiyun }
117*4882a593Smuzhiyun #endif
118*4882a593Smuzhiyun
119*4882a593Smuzhiyun if (pdata) {
120*4882a593Smuzhiyun if ((pdata->driver_features & LIS3_USE_BLOCK_READ) &&
121*4882a593Smuzhiyun (i2c_check_functionality(client->adapter,
122*4882a593Smuzhiyun I2C_FUNC_SMBUS_I2C_BLOCK)))
123*4882a593Smuzhiyun lis3_dev.blkread = lis3_i2c_blockread;
124*4882a593Smuzhiyun
125*4882a593Smuzhiyun if (pdata->axis_x)
126*4882a593Smuzhiyun lis3lv02d_axis_map.x = pdata->axis_x;
127*4882a593Smuzhiyun
128*4882a593Smuzhiyun if (pdata->axis_y)
129*4882a593Smuzhiyun lis3lv02d_axis_map.y = pdata->axis_y;
130*4882a593Smuzhiyun
131*4882a593Smuzhiyun if (pdata->axis_z)
132*4882a593Smuzhiyun lis3lv02d_axis_map.z = pdata->axis_z;
133*4882a593Smuzhiyun
134*4882a593Smuzhiyun if (pdata->setup_resources)
135*4882a593Smuzhiyun ret = pdata->setup_resources();
136*4882a593Smuzhiyun
137*4882a593Smuzhiyun if (ret)
138*4882a593Smuzhiyun goto fail;
139*4882a593Smuzhiyun }
140*4882a593Smuzhiyun
141*4882a593Smuzhiyun lis3_dev.regulators[0].supply = reg_vdd;
142*4882a593Smuzhiyun lis3_dev.regulators[1].supply = reg_vdd_io;
143*4882a593Smuzhiyun ret = regulator_bulk_get(&client->dev,
144*4882a593Smuzhiyun ARRAY_SIZE(lis3_dev.regulators),
145*4882a593Smuzhiyun lis3_dev.regulators);
146*4882a593Smuzhiyun if (ret < 0)
147*4882a593Smuzhiyun goto fail;
148*4882a593Smuzhiyun
149*4882a593Smuzhiyun lis3_dev.pdata = pdata;
150*4882a593Smuzhiyun lis3_dev.bus_priv = client;
151*4882a593Smuzhiyun lis3_dev.init = lis3_i2c_init;
152*4882a593Smuzhiyun lis3_dev.read = lis3_i2c_read;
153*4882a593Smuzhiyun lis3_dev.write = lis3_i2c_write;
154*4882a593Smuzhiyun lis3_dev.irq = client->irq;
155*4882a593Smuzhiyun lis3_dev.ac = lis3lv02d_axis_map;
156*4882a593Smuzhiyun lis3_dev.pm_dev = &client->dev;
157*4882a593Smuzhiyun
158*4882a593Smuzhiyun i2c_set_clientdata(client, &lis3_dev);
159*4882a593Smuzhiyun
160*4882a593Smuzhiyun /* Provide power over the init call */
161*4882a593Smuzhiyun lis3_reg_ctrl(&lis3_dev, LIS3_REG_ON);
162*4882a593Smuzhiyun
163*4882a593Smuzhiyun ret = lis3lv02d_init_device(&lis3_dev);
164*4882a593Smuzhiyun
165*4882a593Smuzhiyun lis3_reg_ctrl(&lis3_dev, LIS3_REG_OFF);
166*4882a593Smuzhiyun
167*4882a593Smuzhiyun if (ret)
168*4882a593Smuzhiyun goto fail2;
169*4882a593Smuzhiyun return 0;
170*4882a593Smuzhiyun
171*4882a593Smuzhiyun fail2:
172*4882a593Smuzhiyun regulator_bulk_free(ARRAY_SIZE(lis3_dev.regulators),
173*4882a593Smuzhiyun lis3_dev.regulators);
174*4882a593Smuzhiyun fail:
175*4882a593Smuzhiyun if (pdata && pdata->release_resources)
176*4882a593Smuzhiyun pdata->release_resources();
177*4882a593Smuzhiyun return ret;
178*4882a593Smuzhiyun }
179*4882a593Smuzhiyun
lis3lv02d_i2c_remove(struct i2c_client * client)180*4882a593Smuzhiyun static int lis3lv02d_i2c_remove(struct i2c_client *client)
181*4882a593Smuzhiyun {
182*4882a593Smuzhiyun struct lis3lv02d *lis3 = i2c_get_clientdata(client);
183*4882a593Smuzhiyun struct lis3lv02d_platform_data *pdata = client->dev.platform_data;
184*4882a593Smuzhiyun
185*4882a593Smuzhiyun if (pdata && pdata->release_resources)
186*4882a593Smuzhiyun pdata->release_resources();
187*4882a593Smuzhiyun
188*4882a593Smuzhiyun lis3lv02d_joystick_disable(lis3);
189*4882a593Smuzhiyun lis3lv02d_remove_fs(&lis3_dev);
190*4882a593Smuzhiyun
191*4882a593Smuzhiyun regulator_bulk_free(ARRAY_SIZE(lis3->regulators),
192*4882a593Smuzhiyun lis3_dev.regulators);
193*4882a593Smuzhiyun return 0;
194*4882a593Smuzhiyun }
195*4882a593Smuzhiyun
196*4882a593Smuzhiyun #ifdef CONFIG_PM_SLEEP
lis3lv02d_i2c_suspend(struct device * dev)197*4882a593Smuzhiyun static int lis3lv02d_i2c_suspend(struct device *dev)
198*4882a593Smuzhiyun {
199*4882a593Smuzhiyun struct i2c_client *client = to_i2c_client(dev);
200*4882a593Smuzhiyun struct lis3lv02d *lis3 = i2c_get_clientdata(client);
201*4882a593Smuzhiyun
202*4882a593Smuzhiyun if (!lis3->pdata || !lis3->pdata->wakeup_flags)
203*4882a593Smuzhiyun lis3lv02d_poweroff(lis3);
204*4882a593Smuzhiyun return 0;
205*4882a593Smuzhiyun }
206*4882a593Smuzhiyun
lis3lv02d_i2c_resume(struct device * dev)207*4882a593Smuzhiyun static int lis3lv02d_i2c_resume(struct device *dev)
208*4882a593Smuzhiyun {
209*4882a593Smuzhiyun struct i2c_client *client = to_i2c_client(dev);
210*4882a593Smuzhiyun struct lis3lv02d *lis3 = i2c_get_clientdata(client);
211*4882a593Smuzhiyun
212*4882a593Smuzhiyun /*
213*4882a593Smuzhiyun * pm_runtime documentation says that devices should always
214*4882a593Smuzhiyun * be powered on at resume. Pm_runtime turns them off after system
215*4882a593Smuzhiyun * wide resume is complete.
216*4882a593Smuzhiyun */
217*4882a593Smuzhiyun if (!lis3->pdata || !lis3->pdata->wakeup_flags ||
218*4882a593Smuzhiyun pm_runtime_suspended(dev))
219*4882a593Smuzhiyun lis3lv02d_poweron(lis3);
220*4882a593Smuzhiyun
221*4882a593Smuzhiyun return 0;
222*4882a593Smuzhiyun }
223*4882a593Smuzhiyun #endif /* CONFIG_PM_SLEEP */
224*4882a593Smuzhiyun
225*4882a593Smuzhiyun #ifdef CONFIG_PM
lis3_i2c_runtime_suspend(struct device * dev)226*4882a593Smuzhiyun static int lis3_i2c_runtime_suspend(struct device *dev)
227*4882a593Smuzhiyun {
228*4882a593Smuzhiyun struct i2c_client *client = to_i2c_client(dev);
229*4882a593Smuzhiyun struct lis3lv02d *lis3 = i2c_get_clientdata(client);
230*4882a593Smuzhiyun
231*4882a593Smuzhiyun lis3lv02d_poweroff(lis3);
232*4882a593Smuzhiyun return 0;
233*4882a593Smuzhiyun }
234*4882a593Smuzhiyun
lis3_i2c_runtime_resume(struct device * dev)235*4882a593Smuzhiyun static int lis3_i2c_runtime_resume(struct device *dev)
236*4882a593Smuzhiyun {
237*4882a593Smuzhiyun struct i2c_client *client = to_i2c_client(dev);
238*4882a593Smuzhiyun struct lis3lv02d *lis3 = i2c_get_clientdata(client);
239*4882a593Smuzhiyun
240*4882a593Smuzhiyun lis3lv02d_poweron(lis3);
241*4882a593Smuzhiyun return 0;
242*4882a593Smuzhiyun }
243*4882a593Smuzhiyun #endif /* CONFIG_PM */
244*4882a593Smuzhiyun
245*4882a593Smuzhiyun static const struct i2c_device_id lis3lv02d_id[] = {
246*4882a593Smuzhiyun {"lis3lv02d", LIS3LV02D},
247*4882a593Smuzhiyun {"lis331dlh", LIS331DLH},
248*4882a593Smuzhiyun {}
249*4882a593Smuzhiyun };
250*4882a593Smuzhiyun
251*4882a593Smuzhiyun MODULE_DEVICE_TABLE(i2c, lis3lv02d_id);
252*4882a593Smuzhiyun
253*4882a593Smuzhiyun static const struct dev_pm_ops lis3_pm_ops = {
254*4882a593Smuzhiyun SET_SYSTEM_SLEEP_PM_OPS(lis3lv02d_i2c_suspend,
255*4882a593Smuzhiyun lis3lv02d_i2c_resume)
256*4882a593Smuzhiyun SET_RUNTIME_PM_OPS(lis3_i2c_runtime_suspend,
257*4882a593Smuzhiyun lis3_i2c_runtime_resume,
258*4882a593Smuzhiyun NULL)
259*4882a593Smuzhiyun };
260*4882a593Smuzhiyun
261*4882a593Smuzhiyun static struct i2c_driver lis3lv02d_i2c_driver = {
262*4882a593Smuzhiyun .driver = {
263*4882a593Smuzhiyun .name = DRV_NAME,
264*4882a593Smuzhiyun .pm = &lis3_pm_ops,
265*4882a593Smuzhiyun .of_match_table = of_match_ptr(lis3lv02d_i2c_dt_ids),
266*4882a593Smuzhiyun },
267*4882a593Smuzhiyun .probe = lis3lv02d_i2c_probe,
268*4882a593Smuzhiyun .remove = lis3lv02d_i2c_remove,
269*4882a593Smuzhiyun .id_table = lis3lv02d_id,
270*4882a593Smuzhiyun };
271*4882a593Smuzhiyun
272*4882a593Smuzhiyun module_i2c_driver(lis3lv02d_i2c_driver);
273*4882a593Smuzhiyun
274*4882a593Smuzhiyun MODULE_AUTHOR("Nokia Corporation");
275*4882a593Smuzhiyun MODULE_DESCRIPTION("lis3lv02d I2C interface");
276*4882a593Smuzhiyun MODULE_LICENSE("GPL");
277