xref: /OK3568_Linux_fs/kernel/drivers/misc/lis3lv02d/lis3lv02d_i2c.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
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, &reg);
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, &reg);
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