xref: /openbmc/linux/drivers/iio/accel/mma9551_core.c (revision 9a87ffc99ec8eb8d35eed7c4f816d75f5cc9662e)
12025cf9eSThomas Gleixner // SPDX-License-Identifier: GPL-2.0-only
2d5b97f5cSIrina Tirdea /*
3d5b97f5cSIrina Tirdea  * Common code for Freescale MMA955x Intelligent Sensor Platform drivers
4d5b97f5cSIrina Tirdea  * Copyright (c) 2014, Intel Corporation.
5d5b97f5cSIrina Tirdea  */
6d5b97f5cSIrina Tirdea 
7d5b97f5cSIrina Tirdea #include <linux/module.h>
8d5b97f5cSIrina Tirdea #include <linux/i2c.h>
9d5b97f5cSIrina Tirdea #include <linux/delay.h>
10d5b97f5cSIrina Tirdea #include <linux/iio/iio.h>
11d5b97f5cSIrina Tirdea #include <linux/pm_runtime.h>
12d5b97f5cSIrina Tirdea #include "mma9551_core.h"
13d5b97f5cSIrina Tirdea 
14d5b97f5cSIrina Tirdea /* Command masks for mailbox write command */
15d5b97f5cSIrina Tirdea #define MMA9551_CMD_READ_VERSION_INFO	0x00
16d5b97f5cSIrina Tirdea #define MMA9551_CMD_READ_CONFIG		0x10
17d5b97f5cSIrina Tirdea #define MMA9551_CMD_WRITE_CONFIG	0x20
18d5b97f5cSIrina Tirdea #define MMA9551_CMD_READ_STATUS		0x30
19d5b97f5cSIrina Tirdea 
20d5b97f5cSIrina Tirdea /* Mailbox read command */
21d5b97f5cSIrina Tirdea #define MMA9551_RESPONSE_COCO		BIT(7)
22d5b97f5cSIrina Tirdea 
23d5b97f5cSIrina Tirdea /* Error-Status codes returned in mailbox read command */
24d5b97f5cSIrina Tirdea #define MMA9551_MCI_ERROR_NONE			0x00
25d5b97f5cSIrina Tirdea #define MMA9551_MCI_ERROR_PARAM			0x04
26d5b97f5cSIrina Tirdea #define MMA9551_MCI_INVALID_COUNT		0x19
27d5b97f5cSIrina Tirdea #define MMA9551_MCI_ERROR_COMMAND		0x1C
28d5b97f5cSIrina Tirdea #define MMA9551_MCI_ERROR_INVALID_LENGTH	0x21
29d5b97f5cSIrina Tirdea #define MMA9551_MCI_ERROR_FIFO_BUSY		0x22
30d5b97f5cSIrina Tirdea #define MMA9551_MCI_ERROR_FIFO_ALLOCATED	0x23
31d5b97f5cSIrina Tirdea #define MMA9551_MCI_ERROR_FIFO_OVERSIZE		0x24
32d5b97f5cSIrina Tirdea 
33d5b97f5cSIrina Tirdea /* GPIO Application */
34d5b97f5cSIrina Tirdea #define MMA9551_GPIO_POL_MSB		0x08
35d5b97f5cSIrina Tirdea #define MMA9551_GPIO_POL_LSB		0x09
36d5b97f5cSIrina Tirdea 
37d5b97f5cSIrina Tirdea /* Sleep/Wake application */
38d5b97f5cSIrina Tirdea #define MMA9551_SLEEP_CFG		0x06
39d5b97f5cSIrina Tirdea #define MMA9551_SLEEP_CFG_SNCEN		BIT(0)
40d5b97f5cSIrina Tirdea #define MMA9551_SLEEP_CFG_FLEEN		BIT(1)
41d5b97f5cSIrina Tirdea #define MMA9551_SLEEP_CFG_SCHEN		BIT(2)
42d5b97f5cSIrina Tirdea 
43d5b97f5cSIrina Tirdea /* AFE application */
44d5b97f5cSIrina Tirdea #define MMA9551_AFE_X_ACCEL_REG		0x00
45d5b97f5cSIrina Tirdea #define MMA9551_AFE_Y_ACCEL_REG		0x02
46d5b97f5cSIrina Tirdea #define MMA9551_AFE_Z_ACCEL_REG		0x04
47d5b97f5cSIrina Tirdea 
4840cb7613SIrina Tirdea /* Reset/Suspend/Clear application */
4940cb7613SIrina Tirdea #define MMA9551_RSC_RESET		0x00
5040cb7613SIrina Tirdea #define MMA9551_RSC_OFFSET(mask)	(3 - (ffs(mask) - 1) / 8)
5140cb7613SIrina Tirdea #define MMA9551_RSC_VAL(mask)		(mask >> (((ffs(mask) - 1) / 8) * 8))
5240cb7613SIrina Tirdea 
53d5b97f5cSIrina Tirdea /*
54d5b97f5cSIrina Tirdea  * A response is composed of:
55d5b97f5cSIrina Tirdea  * - control registers: MB0-3
56d5b97f5cSIrina Tirdea  * - data registers: MB4-31
57d5b97f5cSIrina Tirdea  *
58d5b97f5cSIrina Tirdea  * A request is composed of:
59d5b97f5cSIrina Tirdea  * - mbox to write to (always 0)
60d5b97f5cSIrina Tirdea  * - control registers: MB1-4
61d5b97f5cSIrina Tirdea  * - data registers: MB5-31
62d5b97f5cSIrina Tirdea  */
63d5b97f5cSIrina Tirdea #define MMA9551_MAILBOX_CTRL_REGS	4
64d5b97f5cSIrina Tirdea #define MMA9551_MAX_MAILBOX_DATA_REGS	28
65d5b97f5cSIrina Tirdea #define MMA9551_MAILBOX_REGS		32
66d5b97f5cSIrina Tirdea 
67d5b97f5cSIrina Tirdea #define MMA9551_I2C_READ_RETRIES	5
68d5b97f5cSIrina Tirdea #define MMA9551_I2C_READ_DELAY	50	/* us */
69d5b97f5cSIrina Tirdea 
70d5b97f5cSIrina Tirdea struct mma9551_mbox_request {
71d5b97f5cSIrina Tirdea 	u8 start_mbox;		/* Always 0. */
72d5b97f5cSIrina Tirdea 	u8 app_id;
73d5b97f5cSIrina Tirdea 	/*
74d5b97f5cSIrina Tirdea 	 * See Section 5.3.1 of the MMA955xL Software Reference Manual.
75d5b97f5cSIrina Tirdea 	 *
76d5b97f5cSIrina Tirdea 	 * Bit 7: reserved, always 0
77d5b97f5cSIrina Tirdea 	 * Bits 6-4: command
78d5b97f5cSIrina Tirdea 	 * Bits 3-0: upper bits of register offset
79d5b97f5cSIrina Tirdea 	 */
80d5b97f5cSIrina Tirdea 	u8 cmd_off;
81d5b97f5cSIrina Tirdea 	u8 lower_off;
82d5b97f5cSIrina Tirdea 	u8 nbytes;
83d5b97f5cSIrina Tirdea 	u8 buf[MMA9551_MAX_MAILBOX_DATA_REGS - 1];
84d5b97f5cSIrina Tirdea } __packed;
85d5b97f5cSIrina Tirdea 
86d5b97f5cSIrina Tirdea struct mma9551_mbox_response {
87d5b97f5cSIrina Tirdea 	u8 app_id;
88d5b97f5cSIrina Tirdea 	/*
89d5b97f5cSIrina Tirdea 	 * See Section 5.3.3 of the MMA955xL Software Reference Manual.
90d5b97f5cSIrina Tirdea 	 *
91d5b97f5cSIrina Tirdea 	 * Bit 7: COCO
92d5b97f5cSIrina Tirdea 	 * Bits 6-0: Error code.
93d5b97f5cSIrina Tirdea 	 */
94d5b97f5cSIrina Tirdea 	u8 coco_err;
95d5b97f5cSIrina Tirdea 	u8 nbytes;
96d5b97f5cSIrina Tirdea 	u8 req_bytes;
97d5b97f5cSIrina Tirdea 	u8 buf[MMA9551_MAX_MAILBOX_DATA_REGS];
98d5b97f5cSIrina Tirdea } __packed;
99d5b97f5cSIrina Tirdea 
100d5b97f5cSIrina Tirdea struct mma9551_version_info {
101d5b97f5cSIrina Tirdea 	__be32 device_id;
102d5b97f5cSIrina Tirdea 	u8 rom_version[2];
103d5b97f5cSIrina Tirdea 	u8 fw_version[2];
104d5b97f5cSIrina Tirdea 	u8 hw_version[2];
105d5b97f5cSIrina Tirdea 	u8 fw_build[2];
106d5b97f5cSIrina Tirdea };
107d5b97f5cSIrina Tirdea 
mma9551_transfer(struct i2c_client * client,u8 app_id,u8 command,u16 offset,u8 * inbytes,int num_inbytes,u8 * outbytes,int num_outbytes)108d5b97f5cSIrina Tirdea static int mma9551_transfer(struct i2c_client *client,
109d5b97f5cSIrina Tirdea 			    u8 app_id, u8 command, u16 offset,
110d5b97f5cSIrina Tirdea 			    u8 *inbytes, int num_inbytes,
111d5b97f5cSIrina Tirdea 			    u8 *outbytes, int num_outbytes)
112d5b97f5cSIrina Tirdea {
113d5b97f5cSIrina Tirdea 	struct mma9551_mbox_request req;
114d5b97f5cSIrina Tirdea 	struct mma9551_mbox_response rsp;
115d5b97f5cSIrina Tirdea 	struct i2c_msg in, out;
116d5b97f5cSIrina Tirdea 	u8 req_len, err_code;
117d5b97f5cSIrina Tirdea 	int ret, retries;
118d5b97f5cSIrina Tirdea 
119d5b97f5cSIrina Tirdea 	if (offset >= 1 << 12) {
120d5b97f5cSIrina Tirdea 		dev_err(&client->dev, "register offset too large\n");
121d5b97f5cSIrina Tirdea 		return -EINVAL;
122d5b97f5cSIrina Tirdea 	}
123d5b97f5cSIrina Tirdea 
124d5b97f5cSIrina Tirdea 	req_len = 1 + MMA9551_MAILBOX_CTRL_REGS + num_inbytes;
125d5b97f5cSIrina Tirdea 	req.start_mbox = 0;
126d5b97f5cSIrina Tirdea 	req.app_id = app_id;
127d5b97f5cSIrina Tirdea 	req.cmd_off = command | (offset >> 8);
128d5b97f5cSIrina Tirdea 	req.lower_off = offset;
129d5b97f5cSIrina Tirdea 
130d5b97f5cSIrina Tirdea 	if (command == MMA9551_CMD_WRITE_CONFIG)
131d5b97f5cSIrina Tirdea 		req.nbytes = num_inbytes;
132d5b97f5cSIrina Tirdea 	else
133d5b97f5cSIrina Tirdea 		req.nbytes = num_outbytes;
134d5b97f5cSIrina Tirdea 	if (num_inbytes)
135d5b97f5cSIrina Tirdea 		memcpy(req.buf, inbytes, num_inbytes);
136d5b97f5cSIrina Tirdea 
137d5b97f5cSIrina Tirdea 	out.addr = client->addr;
138d5b97f5cSIrina Tirdea 	out.flags = 0;
139d5b97f5cSIrina Tirdea 	out.len = req_len;
140d5b97f5cSIrina Tirdea 	out.buf = (u8 *)&req;
141d5b97f5cSIrina Tirdea 
142d5b97f5cSIrina Tirdea 	ret = i2c_transfer(client->adapter, &out, 1);
143d5b97f5cSIrina Tirdea 	if (ret < 0) {
144d5b97f5cSIrina Tirdea 		dev_err(&client->dev, "i2c write failed\n");
145d5b97f5cSIrina Tirdea 		return ret;
146d5b97f5cSIrina Tirdea 	}
147d5b97f5cSIrina Tirdea 
148d5b97f5cSIrina Tirdea 	retries = MMA9551_I2C_READ_RETRIES;
149d5b97f5cSIrina Tirdea 	do {
150d5b97f5cSIrina Tirdea 		udelay(MMA9551_I2C_READ_DELAY);
151d5b97f5cSIrina Tirdea 
152d5b97f5cSIrina Tirdea 		in.addr = client->addr;
153d5b97f5cSIrina Tirdea 		in.flags = I2C_M_RD;
154d5b97f5cSIrina Tirdea 		in.len = sizeof(rsp);
155d5b97f5cSIrina Tirdea 		in.buf = (u8 *)&rsp;
156d5b97f5cSIrina Tirdea 
157d5b97f5cSIrina Tirdea 		ret = i2c_transfer(client->adapter, &in, 1);
158d5b97f5cSIrina Tirdea 		if (ret < 0) {
159d5b97f5cSIrina Tirdea 			dev_err(&client->dev, "i2c read failed\n");
160d5b97f5cSIrina Tirdea 			return ret;
161d5b97f5cSIrina Tirdea 		}
162d5b97f5cSIrina Tirdea 
163d5b97f5cSIrina Tirdea 		if (rsp.coco_err & MMA9551_RESPONSE_COCO)
164d5b97f5cSIrina Tirdea 			break;
165d5b97f5cSIrina Tirdea 	} while (--retries > 0);
166d5b97f5cSIrina Tirdea 
167d5b97f5cSIrina Tirdea 	if (retries == 0) {
168d5b97f5cSIrina Tirdea 		dev_err(&client->dev,
169d5b97f5cSIrina Tirdea 			"timed out while waiting for command response\n");
170d5b97f5cSIrina Tirdea 		return -ETIMEDOUT;
171d5b97f5cSIrina Tirdea 	}
172d5b97f5cSIrina Tirdea 
173d5b97f5cSIrina Tirdea 	if (rsp.app_id != app_id) {
174d5b97f5cSIrina Tirdea 		dev_err(&client->dev,
175d5b97f5cSIrina Tirdea 			"app_id mismatch in response got %02x expected %02x\n",
176d5b97f5cSIrina Tirdea 			rsp.app_id, app_id);
177d5b97f5cSIrina Tirdea 		return -EINVAL;
178d5b97f5cSIrina Tirdea 	}
179d5b97f5cSIrina Tirdea 
180d5b97f5cSIrina Tirdea 	err_code = rsp.coco_err & ~MMA9551_RESPONSE_COCO;
181d5b97f5cSIrina Tirdea 	if (err_code != MMA9551_MCI_ERROR_NONE) {
182d5b97f5cSIrina Tirdea 		dev_err(&client->dev, "read returned error %x\n", err_code);
183d5b97f5cSIrina Tirdea 		return -EINVAL;
184d5b97f5cSIrina Tirdea 	}
185d5b97f5cSIrina Tirdea 
186d5b97f5cSIrina Tirdea 	if (rsp.nbytes != rsp.req_bytes) {
187d5b97f5cSIrina Tirdea 		dev_err(&client->dev,
188d5b97f5cSIrina Tirdea 			"output length mismatch got %d expected %d\n",
189d5b97f5cSIrina Tirdea 			rsp.nbytes, rsp.req_bytes);
190d5b97f5cSIrina Tirdea 		return -EINVAL;
191d5b97f5cSIrina Tirdea 	}
192d5b97f5cSIrina Tirdea 
193d5b97f5cSIrina Tirdea 	if (num_outbytes)
194d5b97f5cSIrina Tirdea 		memcpy(outbytes, rsp.buf, num_outbytes);
195d5b97f5cSIrina Tirdea 
196d5b97f5cSIrina Tirdea 	return 0;
197d5b97f5cSIrina Tirdea }
198d5b97f5cSIrina Tirdea 
199d5b97f5cSIrina Tirdea /**
200d5b97f5cSIrina Tirdea  * mma9551_read_config_byte() - read 1 configuration byte
201d5b97f5cSIrina Tirdea  * @client:	I2C client
202d5b97f5cSIrina Tirdea  * @app_id:	Application ID
203d5b97f5cSIrina Tirdea  * @reg:	Application register
204d5b97f5cSIrina Tirdea  * @val:	Pointer to store value read
205d5b97f5cSIrina Tirdea  *
206d5b97f5cSIrina Tirdea  * Read one configuration byte from the device using MMA955xL command format.
207d5b97f5cSIrina Tirdea  * Commands to the MMA955xL platform consist of a write followed
208d5b97f5cSIrina Tirdea  * by one or more reads.
209d5b97f5cSIrina Tirdea  *
210d5b97f5cSIrina Tirdea  * Locking note: This function must be called with the device lock held.
211d5b97f5cSIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
212d5b97f5cSIrina Tirdea  * serialize access to the HW.
213d5b97f5cSIrina Tirdea  *
214d5b97f5cSIrina Tirdea  * Returns: 0 on success, negative value on failure.
215d5b97f5cSIrina Tirdea  */
mma9551_read_config_byte(struct i2c_client * client,u8 app_id,u16 reg,u8 * val)216d5b97f5cSIrina Tirdea int mma9551_read_config_byte(struct i2c_client *client, u8 app_id,
217d5b97f5cSIrina Tirdea 			     u16 reg, u8 *val)
218d5b97f5cSIrina Tirdea {
219d5b97f5cSIrina Tirdea 	return mma9551_transfer(client, app_id, MMA9551_CMD_READ_CONFIG,
220d5b97f5cSIrina Tirdea 				reg, NULL, 0, val, 1);
221d5b97f5cSIrina Tirdea }
2224205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_read_config_byte, IIO_MMA9551);
223d5b97f5cSIrina Tirdea 
224d5b97f5cSIrina Tirdea /**
225d5b97f5cSIrina Tirdea  * mma9551_write_config_byte() - write 1 configuration byte
226d5b97f5cSIrina Tirdea  * @client:	I2C client
227d5b97f5cSIrina Tirdea  * @app_id:	Application ID
228d5b97f5cSIrina Tirdea  * @reg:	Application register
229d5b97f5cSIrina Tirdea  * @val:	Value to write
230d5b97f5cSIrina Tirdea  *
231d5b97f5cSIrina Tirdea  * Write one configuration byte from the device using MMA955xL command format.
232d5b97f5cSIrina Tirdea  * Commands to the MMA955xL platform consist of a write followed by one or
233d5b97f5cSIrina Tirdea  * more reads.
234d5b97f5cSIrina Tirdea  *
235d5b97f5cSIrina Tirdea  * Locking note: This function must be called with the device lock held.
236d5b97f5cSIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
237d5b97f5cSIrina Tirdea  * serialize access to the HW.
238d5b97f5cSIrina Tirdea  *
239d5b97f5cSIrina Tirdea  * Returns: 0 on success, negative value on failure.
240d5b97f5cSIrina Tirdea  */
mma9551_write_config_byte(struct i2c_client * client,u8 app_id,u16 reg,u8 val)241d5b97f5cSIrina Tirdea int mma9551_write_config_byte(struct i2c_client *client, u8 app_id,
242d5b97f5cSIrina Tirdea 			      u16 reg, u8 val)
243d5b97f5cSIrina Tirdea {
244d5b97f5cSIrina Tirdea 	return mma9551_transfer(client, app_id, MMA9551_CMD_WRITE_CONFIG, reg,
245d5b97f5cSIrina Tirdea 				&val, 1, NULL, 0);
246d5b97f5cSIrina Tirdea }
2474205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_write_config_byte, IIO_MMA9551);
248d5b97f5cSIrina Tirdea 
249d5b97f5cSIrina Tirdea /**
250d5b97f5cSIrina Tirdea  * mma9551_read_status_byte() - read 1 status byte
251d5b97f5cSIrina Tirdea  * @client:	I2C client
252d5b97f5cSIrina Tirdea  * @app_id:	Application ID
253d5b97f5cSIrina Tirdea  * @reg:	Application register
254d5b97f5cSIrina Tirdea  * @val:	Pointer to store value read
255d5b97f5cSIrina Tirdea  *
256d5b97f5cSIrina Tirdea  * Read one status byte from the device using MMA955xL command format.
257d5b97f5cSIrina Tirdea  * Commands to the MMA955xL platform consist of a write followed by one or
258d5b97f5cSIrina Tirdea  * more reads.
259d5b97f5cSIrina Tirdea  *
260d5b97f5cSIrina Tirdea  * Locking note: This function must be called with the device lock held.
261d5b97f5cSIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
262d5b97f5cSIrina Tirdea  * serialize access to the HW.
263d5b97f5cSIrina Tirdea  *
264d5b97f5cSIrina Tirdea  * Returns: 0 on success, negative value on failure.
265d5b97f5cSIrina Tirdea  */
mma9551_read_status_byte(struct i2c_client * client,u8 app_id,u16 reg,u8 * val)266d5b97f5cSIrina Tirdea int mma9551_read_status_byte(struct i2c_client *client, u8 app_id,
267d5b97f5cSIrina Tirdea 			     u16 reg, u8 *val)
268d5b97f5cSIrina Tirdea {
269d5b97f5cSIrina Tirdea 	return mma9551_transfer(client, app_id, MMA9551_CMD_READ_STATUS,
270d5b97f5cSIrina Tirdea 				reg, NULL, 0, val, 1);
271d5b97f5cSIrina Tirdea }
2724205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_read_status_byte, IIO_MMA9551);
273d5b97f5cSIrina Tirdea 
274d5b97f5cSIrina Tirdea /**
27540cb7613SIrina Tirdea  * mma9551_read_config_word() - read 1 config word
27640cb7613SIrina Tirdea  * @client:	I2C client
27740cb7613SIrina Tirdea  * @app_id:	Application ID
27840cb7613SIrina Tirdea  * @reg:	Application register
27940cb7613SIrina Tirdea  * @val:	Pointer to store value read
28040cb7613SIrina Tirdea  *
28140cb7613SIrina Tirdea  * Read one configuration word from the device using MMA955xL command format.
28240cb7613SIrina Tirdea  * Commands to the MMA955xL platform consist of a write followed by one or
28340cb7613SIrina Tirdea  * more reads.
28440cb7613SIrina Tirdea  *
28540cb7613SIrina Tirdea  * Locking note: This function must be called with the device lock held.
28640cb7613SIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
28740cb7613SIrina Tirdea  * serialize access to the HW.
28840cb7613SIrina Tirdea  *
28940cb7613SIrina Tirdea  * Returns: 0 on success, negative value on failure.
29040cb7613SIrina Tirdea  */
mma9551_read_config_word(struct i2c_client * client,u8 app_id,u16 reg,u16 * val)29140cb7613SIrina Tirdea int mma9551_read_config_word(struct i2c_client *client, u8 app_id,
29240cb7613SIrina Tirdea 			     u16 reg, u16 *val)
29340cb7613SIrina Tirdea {
29440cb7613SIrina Tirdea 	int ret;
29540cb7613SIrina Tirdea 	__be16 v;
29640cb7613SIrina Tirdea 
29740cb7613SIrina Tirdea 	ret = mma9551_transfer(client, app_id, MMA9551_CMD_READ_CONFIG,
29840cb7613SIrina Tirdea 			       reg, NULL, 0, (u8 *)&v, 2);
299*64a68158SHarshit Mogalapalli 	if (ret < 0)
300*64a68158SHarshit Mogalapalli 		return ret;
301*64a68158SHarshit Mogalapalli 
30240cb7613SIrina Tirdea 	*val = be16_to_cpu(v);
30340cb7613SIrina Tirdea 
304*64a68158SHarshit Mogalapalli 	return 0;
30540cb7613SIrina Tirdea }
3064205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_read_config_word, IIO_MMA9551);
30740cb7613SIrina Tirdea 
30840cb7613SIrina Tirdea /**
30940cb7613SIrina Tirdea  * mma9551_write_config_word() - write 1 config word
31040cb7613SIrina Tirdea  * @client:	I2C client
31140cb7613SIrina Tirdea  * @app_id:	Application ID
31240cb7613SIrina Tirdea  * @reg:	Application register
31340cb7613SIrina Tirdea  * @val:	Value to write
31440cb7613SIrina Tirdea  *
31540cb7613SIrina Tirdea  * Write one configuration word from the device using MMA955xL command format.
31640cb7613SIrina Tirdea  * Commands to the MMA955xL platform consist of a write followed by one or
31740cb7613SIrina Tirdea  * more reads.
31840cb7613SIrina Tirdea  *
31940cb7613SIrina Tirdea  * Locking note: This function must be called with the device lock held.
32040cb7613SIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
32140cb7613SIrina Tirdea  * serialize access to the HW.
32240cb7613SIrina Tirdea  *
32340cb7613SIrina Tirdea  * Returns: 0 on success, negative value on failure.
32440cb7613SIrina Tirdea  */
mma9551_write_config_word(struct i2c_client * client,u8 app_id,u16 reg,u16 val)32540cb7613SIrina Tirdea int mma9551_write_config_word(struct i2c_client *client, u8 app_id,
32640cb7613SIrina Tirdea 			      u16 reg, u16 val)
32740cb7613SIrina Tirdea {
32840cb7613SIrina Tirdea 	__be16 v = cpu_to_be16(val);
32940cb7613SIrina Tirdea 
33040cb7613SIrina Tirdea 	return mma9551_transfer(client, app_id, MMA9551_CMD_WRITE_CONFIG, reg,
33140cb7613SIrina Tirdea 				(u8 *)&v, 2, NULL, 0);
33240cb7613SIrina Tirdea }
3334205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_write_config_word, IIO_MMA9551);
33440cb7613SIrina Tirdea 
33540cb7613SIrina Tirdea /**
336d5b97f5cSIrina Tirdea  * mma9551_read_status_word() - read 1 status word
337d5b97f5cSIrina Tirdea  * @client:	I2C client
338d5b97f5cSIrina Tirdea  * @app_id:	Application ID
339d5b97f5cSIrina Tirdea  * @reg:	Application register
340d5b97f5cSIrina Tirdea  * @val:	Pointer to store value read
341d5b97f5cSIrina Tirdea  *
342d5b97f5cSIrina Tirdea  * Read one status word from the device using MMA955xL command format.
343d5b97f5cSIrina Tirdea  * Commands to the MMA955xL platform consist of a write followed by one or
344d5b97f5cSIrina Tirdea  * more reads.
345d5b97f5cSIrina Tirdea  *
346d5b97f5cSIrina Tirdea  * Locking note: This function must be called with the device lock held.
347d5b97f5cSIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
348d5b97f5cSIrina Tirdea  * serialize access to the HW.
349d5b97f5cSIrina Tirdea  *
350d5b97f5cSIrina Tirdea  * Returns: 0 on success, negative value on failure.
351d5b97f5cSIrina Tirdea  */
mma9551_read_status_word(struct i2c_client * client,u8 app_id,u16 reg,u16 * val)352d5b97f5cSIrina Tirdea int mma9551_read_status_word(struct i2c_client *client, u8 app_id,
353d5b97f5cSIrina Tirdea 			     u16 reg, u16 *val)
354d5b97f5cSIrina Tirdea {
355d5b97f5cSIrina Tirdea 	int ret;
356d5b97f5cSIrina Tirdea 	__be16 v;
357d5b97f5cSIrina Tirdea 
358d5b97f5cSIrina Tirdea 	ret = mma9551_transfer(client, app_id, MMA9551_CMD_READ_STATUS,
359d5b97f5cSIrina Tirdea 			       reg, NULL, 0, (u8 *)&v, 2);
360e56d2c34SHarshit Mogalapalli 	if (ret < 0)
361e56d2c34SHarshit Mogalapalli 		return ret;
362e56d2c34SHarshit Mogalapalli 
363d5b97f5cSIrina Tirdea 	*val = be16_to_cpu(v);
364d5b97f5cSIrina Tirdea 
365e56d2c34SHarshit Mogalapalli 	return 0;
366d5b97f5cSIrina Tirdea }
3674205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_read_status_word, IIO_MMA9551);
368d5b97f5cSIrina Tirdea 
369d5b97f5cSIrina Tirdea /**
37040cb7613SIrina Tirdea  * mma9551_read_config_words() - read multiple config words
37140cb7613SIrina Tirdea  * @client:	I2C client
37240cb7613SIrina Tirdea  * @app_id:	Application ID
37340cb7613SIrina Tirdea  * @reg:	Application register
374c0d901ccSIrina Tirdea  * @len:	Length of array to read (in words)
375b39f0c94SIrina Tirdea  * @buf:	Array of words to read
37640cb7613SIrina Tirdea  *
37740cb7613SIrina Tirdea  * Read multiple configuration registers (word-sized registers).
37840cb7613SIrina Tirdea  *
37940cb7613SIrina Tirdea  * Locking note: This function must be called with the device lock held.
38040cb7613SIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
38140cb7613SIrina Tirdea  * serialize access to the HW.
38240cb7613SIrina Tirdea  *
38340cb7613SIrina Tirdea  * Returns: 0 on success, negative value on failure.
38440cb7613SIrina Tirdea  */
mma9551_read_config_words(struct i2c_client * client,u8 app_id,u16 reg,u8 len,u16 * buf)38540cb7613SIrina Tirdea int mma9551_read_config_words(struct i2c_client *client, u8 app_id,
38640cb7613SIrina Tirdea 			      u16 reg, u8 len, u16 *buf)
38740cb7613SIrina Tirdea {
38840cb7613SIrina Tirdea 	int ret, i;
3892a4d2032SIrina Tirdea 	__be16 be_buf[MMA9551_MAX_MAILBOX_DATA_REGS / 2];
3902a4d2032SIrina Tirdea 
391c0d901ccSIrina Tirdea 	if (len > ARRAY_SIZE(be_buf)) {
3922a4d2032SIrina Tirdea 		dev_err(&client->dev, "Invalid buffer size %d\n", len);
3932a4d2032SIrina Tirdea 		return -EINVAL;
3942a4d2032SIrina Tirdea 	}
39540cb7613SIrina Tirdea 
39640cb7613SIrina Tirdea 	ret = mma9551_transfer(client, app_id, MMA9551_CMD_READ_CONFIG,
397c0d901ccSIrina Tirdea 			       reg, NULL, 0, (u8 *)be_buf, len * sizeof(u16));
39840cb7613SIrina Tirdea 	if (ret < 0)
39940cb7613SIrina Tirdea 		return ret;
40040cb7613SIrina Tirdea 
401c0d901ccSIrina Tirdea 	for (i = 0; i < len; i++)
40240cb7613SIrina Tirdea 		buf[i] = be16_to_cpu(be_buf[i]);
40340cb7613SIrina Tirdea 
40440cb7613SIrina Tirdea 	return 0;
40540cb7613SIrina Tirdea }
4064205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_read_config_words, IIO_MMA9551);
40740cb7613SIrina Tirdea 
40840cb7613SIrina Tirdea /**
40940cb7613SIrina Tirdea  * mma9551_read_status_words() - read multiple status words
41040cb7613SIrina Tirdea  * @client:	I2C client
41140cb7613SIrina Tirdea  * @app_id:	Application ID
41240cb7613SIrina Tirdea  * @reg:	Application register
413c0d901ccSIrina Tirdea  * @len:	Length of array to read (in words)
414b39f0c94SIrina Tirdea  * @buf:	Array of words to read
41540cb7613SIrina Tirdea  *
41640cb7613SIrina Tirdea  * Read multiple status registers (word-sized registers).
41740cb7613SIrina Tirdea  *
41840cb7613SIrina Tirdea  * Locking note: This function must be called with the device lock held.
41940cb7613SIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
42040cb7613SIrina Tirdea  * serialize access to the HW.
42140cb7613SIrina Tirdea  *
42240cb7613SIrina Tirdea  * Returns: 0 on success, negative value on failure.
42340cb7613SIrina Tirdea  */
mma9551_read_status_words(struct i2c_client * client,u8 app_id,u16 reg,u8 len,u16 * buf)42440cb7613SIrina Tirdea int mma9551_read_status_words(struct i2c_client *client, u8 app_id,
42540cb7613SIrina Tirdea 			      u16 reg, u8 len, u16 *buf)
42640cb7613SIrina Tirdea {
42740cb7613SIrina Tirdea 	int ret, i;
4282a4d2032SIrina Tirdea 	__be16 be_buf[MMA9551_MAX_MAILBOX_DATA_REGS / 2];
4292a4d2032SIrina Tirdea 
430c0d901ccSIrina Tirdea 	if (len > ARRAY_SIZE(be_buf)) {
4312a4d2032SIrina Tirdea 		dev_err(&client->dev, "Invalid buffer size %d\n", len);
4322a4d2032SIrina Tirdea 		return -EINVAL;
4332a4d2032SIrina Tirdea 	}
43440cb7613SIrina Tirdea 
43540cb7613SIrina Tirdea 	ret = mma9551_transfer(client, app_id, MMA9551_CMD_READ_STATUS,
436c0d901ccSIrina Tirdea 			       reg, NULL, 0, (u8 *)be_buf, len * sizeof(u16));
43740cb7613SIrina Tirdea 	if (ret < 0)
43840cb7613SIrina Tirdea 		return ret;
43940cb7613SIrina Tirdea 
440c0d901ccSIrina Tirdea 	for (i = 0; i < len; i++)
44140cb7613SIrina Tirdea 		buf[i] = be16_to_cpu(be_buf[i]);
44240cb7613SIrina Tirdea 
44340cb7613SIrina Tirdea 	return 0;
44440cb7613SIrina Tirdea }
4454205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_read_status_words, IIO_MMA9551);
44640cb7613SIrina Tirdea 
44740cb7613SIrina Tirdea /**
44840cb7613SIrina Tirdea  * mma9551_write_config_words() - write multiple config words
44940cb7613SIrina Tirdea  * @client:	I2C client
45040cb7613SIrina Tirdea  * @app_id:	Application ID
45140cb7613SIrina Tirdea  * @reg:	Application register
452c0d901ccSIrina Tirdea  * @len:	Length of array to write (in words)
453b39f0c94SIrina Tirdea  * @buf:	Array of words to write
45440cb7613SIrina Tirdea  *
45540cb7613SIrina Tirdea  * Write multiple configuration registers (word-sized registers).
45640cb7613SIrina Tirdea  *
45740cb7613SIrina Tirdea  * Locking note: This function must be called with the device lock held.
45840cb7613SIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
45940cb7613SIrina Tirdea  * serialize access to the HW.
46040cb7613SIrina Tirdea  *
46140cb7613SIrina Tirdea  * Returns: 0 on success, negative value on failure.
46240cb7613SIrina Tirdea  */
mma9551_write_config_words(struct i2c_client * client,u8 app_id,u16 reg,u8 len,u16 * buf)46340cb7613SIrina Tirdea int mma9551_write_config_words(struct i2c_client *client, u8 app_id,
46440cb7613SIrina Tirdea 			       u16 reg, u8 len, u16 *buf)
46540cb7613SIrina Tirdea {
46640cb7613SIrina Tirdea 	int i;
4672a4d2032SIrina Tirdea 	__be16 be_buf[(MMA9551_MAX_MAILBOX_DATA_REGS - 1) / 2];
4682a4d2032SIrina Tirdea 
469c0d901ccSIrina Tirdea 	if (len > ARRAY_SIZE(be_buf)) {
4702a4d2032SIrina Tirdea 		dev_err(&client->dev, "Invalid buffer size %d\n", len);
4712a4d2032SIrina Tirdea 		return -EINVAL;
4722a4d2032SIrina Tirdea 	}
47340cb7613SIrina Tirdea 
474c0d901ccSIrina Tirdea 	for (i = 0; i < len; i++)
47540cb7613SIrina Tirdea 		be_buf[i] = cpu_to_be16(buf[i]);
47640cb7613SIrina Tirdea 
47740cb7613SIrina Tirdea 	return mma9551_transfer(client, app_id, MMA9551_CMD_WRITE_CONFIG,
478c0d901ccSIrina Tirdea 				reg, (u8 *)be_buf, len * sizeof(u16), NULL, 0);
47940cb7613SIrina Tirdea }
4804205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_write_config_words, IIO_MMA9551);
48140cb7613SIrina Tirdea 
48240cb7613SIrina Tirdea /**
483d5b97f5cSIrina Tirdea  * mma9551_update_config_bits() - update bits in register
484d5b97f5cSIrina Tirdea  * @client:	I2C client
485d5b97f5cSIrina Tirdea  * @app_id:	Application ID
486d5b97f5cSIrina Tirdea  * @reg:	Application register
487d5b97f5cSIrina Tirdea  * @mask:	Mask for the bits to update
488d5b97f5cSIrina Tirdea  * @val:	Value of the bits to update
489d5b97f5cSIrina Tirdea  *
490d5b97f5cSIrina Tirdea  * Update bits in the given register using a bit mask.
491d5b97f5cSIrina Tirdea  *
492d5b97f5cSIrina Tirdea  * Locking note: This function must be called with the device lock held.
493d5b97f5cSIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
494d5b97f5cSIrina Tirdea  * serialize access to the HW.
495d5b97f5cSIrina Tirdea  *
496d5b97f5cSIrina Tirdea  * Returns: 0 on success, negative value on failure.
497d5b97f5cSIrina Tirdea  */
mma9551_update_config_bits(struct i2c_client * client,u8 app_id,u16 reg,u8 mask,u8 val)498d5b97f5cSIrina Tirdea int mma9551_update_config_bits(struct i2c_client *client, u8 app_id,
499d5b97f5cSIrina Tirdea 			       u16 reg, u8 mask, u8 val)
500d5b97f5cSIrina Tirdea {
501d5b97f5cSIrina Tirdea 	int ret;
502d5b97f5cSIrina Tirdea 	u8 tmp, orig;
503d5b97f5cSIrina Tirdea 
504d5b97f5cSIrina Tirdea 	ret = mma9551_read_config_byte(client, app_id, reg, &orig);
505d5b97f5cSIrina Tirdea 	if (ret < 0)
506d5b97f5cSIrina Tirdea 		return ret;
507d5b97f5cSIrina Tirdea 
508d5b97f5cSIrina Tirdea 	tmp = orig & ~mask;
509d5b97f5cSIrina Tirdea 	tmp |= val & mask;
510d5b97f5cSIrina Tirdea 
511d5b97f5cSIrina Tirdea 	if (tmp == orig)
512d5b97f5cSIrina Tirdea 		return 0;
513d5b97f5cSIrina Tirdea 
514d5b97f5cSIrina Tirdea 	return mma9551_write_config_byte(client, app_id, reg, tmp);
515d5b97f5cSIrina Tirdea }
5164205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_update_config_bits, IIO_MMA9551);
517d5b97f5cSIrina Tirdea 
518d5b97f5cSIrina Tirdea /**
519d5b97f5cSIrina Tirdea  * mma9551_gpio_config() - configure gpio
520d5b97f5cSIrina Tirdea  * @client:	I2C client
521d5b97f5cSIrina Tirdea  * @pin:	GPIO pin to configure
522d5b97f5cSIrina Tirdea  * @app_id:	Application ID
523d5b97f5cSIrina Tirdea  * @bitnum:	Bit number of status register being assigned to the GPIO pin.
524d5b97f5cSIrina Tirdea  * @polarity:	The polarity parameter is described in section 6.2.2, page 66,
525d5b97f5cSIrina Tirdea  *		of the Software Reference Manual.  Basically, polarity=0 means
526d5b97f5cSIrina Tirdea  *		the interrupt line has the same value as the selected bit,
527d5b97f5cSIrina Tirdea  *		while polarity=1 means the line is inverted.
528d5b97f5cSIrina Tirdea  *
529d5b97f5cSIrina Tirdea  * Assign a bit from an application’s status register to a specific GPIO pin.
530d5b97f5cSIrina Tirdea  *
531d5b97f5cSIrina Tirdea  * Locking note: This function must be called with the device lock held.
532d5b97f5cSIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
533d5b97f5cSIrina Tirdea  * serialize access to the HW.
534d5b97f5cSIrina Tirdea  *
535d5b97f5cSIrina Tirdea  * Returns: 0 on success, negative value on failure.
536d5b97f5cSIrina Tirdea  */
mma9551_gpio_config(struct i2c_client * client,enum mma9551_gpio_pin pin,u8 app_id,u8 bitnum,int polarity)537d5b97f5cSIrina Tirdea int mma9551_gpio_config(struct i2c_client *client, enum mma9551_gpio_pin pin,
538d5b97f5cSIrina Tirdea 			u8 app_id, u8 bitnum, int polarity)
539d5b97f5cSIrina Tirdea {
540d5b97f5cSIrina Tirdea 	u8 reg, pol_mask, pol_val;
541d5b97f5cSIrina Tirdea 	int ret;
542d5b97f5cSIrina Tirdea 
543d5b97f5cSIrina Tirdea 	if (pin > mma9551_gpio_max) {
544d5b97f5cSIrina Tirdea 		dev_err(&client->dev, "bad GPIO pin\n");
545d5b97f5cSIrina Tirdea 		return -EINVAL;
546d5b97f5cSIrina Tirdea 	}
547d5b97f5cSIrina Tirdea 
548d5b97f5cSIrina Tirdea 	/*
549d5b97f5cSIrina Tirdea 	 * Pin 6 is configured by regs 0x00 and 0x01, pin 7 by 0x02 and
550d5b97f5cSIrina Tirdea 	 * 0x03, and so on.
551d5b97f5cSIrina Tirdea 	 */
552d5b97f5cSIrina Tirdea 	reg = pin * 2;
553d5b97f5cSIrina Tirdea 
554d5b97f5cSIrina Tirdea 	ret = mma9551_write_config_byte(client, MMA9551_APPID_GPIO,
555d5b97f5cSIrina Tirdea 					reg, app_id);
556d5b97f5cSIrina Tirdea 	if (ret < 0) {
557d5b97f5cSIrina Tirdea 		dev_err(&client->dev, "error setting GPIO app_id\n");
558d5b97f5cSIrina Tirdea 		return ret;
559d5b97f5cSIrina Tirdea 	}
560d5b97f5cSIrina Tirdea 
561d5b97f5cSIrina Tirdea 	ret = mma9551_write_config_byte(client, MMA9551_APPID_GPIO,
562d5b97f5cSIrina Tirdea 					reg + 1, bitnum);
563d5b97f5cSIrina Tirdea 	if (ret < 0) {
564d5b97f5cSIrina Tirdea 		dev_err(&client->dev, "error setting GPIO bit number\n");
565d5b97f5cSIrina Tirdea 		return ret;
566d5b97f5cSIrina Tirdea 	}
567d5b97f5cSIrina Tirdea 
568d5b97f5cSIrina Tirdea 	switch (pin) {
569d5b97f5cSIrina Tirdea 	case mma9551_gpio6:
570d5b97f5cSIrina Tirdea 		reg = MMA9551_GPIO_POL_LSB;
571d5b97f5cSIrina Tirdea 		pol_mask = 1 << 6;
572d5b97f5cSIrina Tirdea 		break;
573d5b97f5cSIrina Tirdea 	case mma9551_gpio7:
574d5b97f5cSIrina Tirdea 		reg = MMA9551_GPIO_POL_LSB;
575d5b97f5cSIrina Tirdea 		pol_mask = 1 << 7;
576d5b97f5cSIrina Tirdea 		break;
577d5b97f5cSIrina Tirdea 	case mma9551_gpio8:
578d5b97f5cSIrina Tirdea 		reg = MMA9551_GPIO_POL_MSB;
579d5b97f5cSIrina Tirdea 		pol_mask = 1 << 0;
580d5b97f5cSIrina Tirdea 		break;
581d5b97f5cSIrina Tirdea 	case mma9551_gpio9:
582d5b97f5cSIrina Tirdea 		reg = MMA9551_GPIO_POL_MSB;
583d5b97f5cSIrina Tirdea 		pol_mask = 1 << 1;
584d5b97f5cSIrina Tirdea 		break;
585d5b97f5cSIrina Tirdea 	}
586d5b97f5cSIrina Tirdea 	pol_val = polarity ? pol_mask : 0;
587d5b97f5cSIrina Tirdea 
588d5b97f5cSIrina Tirdea 	ret = mma9551_update_config_bits(client, MMA9551_APPID_GPIO, reg,
589d5b97f5cSIrina Tirdea 					 pol_mask, pol_val);
590d5b97f5cSIrina Tirdea 	if (ret < 0)
591d5b97f5cSIrina Tirdea 		dev_err(&client->dev, "error setting GPIO polarity\n");
592d5b97f5cSIrina Tirdea 
593d5b97f5cSIrina Tirdea 	return ret;
594d5b97f5cSIrina Tirdea }
5954205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_gpio_config, IIO_MMA9551);
596d5b97f5cSIrina Tirdea 
597d5b97f5cSIrina Tirdea /**
598d5b97f5cSIrina Tirdea  * mma9551_read_version() - read device version information
599d5b97f5cSIrina Tirdea  * @client:	I2C client
600d5b97f5cSIrina Tirdea  *
601d5b97f5cSIrina Tirdea  * Read version information and print device id and firmware version.
602d5b97f5cSIrina Tirdea  *
603d5b97f5cSIrina Tirdea  * Locking note: This function must be called with the device lock held.
604d5b97f5cSIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
605d5b97f5cSIrina Tirdea  * serialize access to the HW.
606d5b97f5cSIrina Tirdea  *
607d5b97f5cSIrina Tirdea  * Returns: 0 on success, negative value on failure.
608d5b97f5cSIrina Tirdea  */
mma9551_read_version(struct i2c_client * client)609d5b97f5cSIrina Tirdea int mma9551_read_version(struct i2c_client *client)
610d5b97f5cSIrina Tirdea {
611d5b97f5cSIrina Tirdea 	struct mma9551_version_info info;
612d5b97f5cSIrina Tirdea 	int ret;
613d5b97f5cSIrina Tirdea 
614d5b97f5cSIrina Tirdea 	ret = mma9551_transfer(client, MMA9551_APPID_VERSION, 0x00, 0x00,
615d5b97f5cSIrina Tirdea 			       NULL, 0, (u8 *)&info, sizeof(info));
616d5b97f5cSIrina Tirdea 	if (ret < 0)
617d5b97f5cSIrina Tirdea 		return ret;
618d5b97f5cSIrina Tirdea 
619d5b97f5cSIrina Tirdea 	dev_info(&client->dev, "device ID 0x%x, firmware version %02x.%02x\n",
620d5b97f5cSIrina Tirdea 		 be32_to_cpu(info.device_id), info.fw_version[0],
621d5b97f5cSIrina Tirdea 		 info.fw_version[1]);
622d5b97f5cSIrina Tirdea 
623d5b97f5cSIrina Tirdea 	return 0;
624d5b97f5cSIrina Tirdea }
6254205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_read_version, IIO_MMA9551);
626d5b97f5cSIrina Tirdea 
627d5b97f5cSIrina Tirdea /**
628d5b97f5cSIrina Tirdea  * mma9551_set_device_state() - sets HW power mode
629d5b97f5cSIrina Tirdea  * @client:	I2C client
630d5b97f5cSIrina Tirdea  * @enable:	Use true to power on device, false to cause the device
631d5b97f5cSIrina Tirdea  *		to enter sleep.
632d5b97f5cSIrina Tirdea  *
633d5b97f5cSIrina Tirdea  * Set power on/off for device using the Sleep/Wake Application.
634d5b97f5cSIrina Tirdea  * When enable is true, power on chip and enable doze mode.
635d5b97f5cSIrina Tirdea  * When enable is false, enter sleep mode (device remains in the
636d5b97f5cSIrina Tirdea  * lowest-power mode).
637d5b97f5cSIrina Tirdea  *
638d5b97f5cSIrina Tirdea  * Locking note: This function must be called with the device lock held.
639d5b97f5cSIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
640d5b97f5cSIrina Tirdea  * serialize access to the HW.
641d5b97f5cSIrina Tirdea  *
642d5b97f5cSIrina Tirdea  * Returns: 0 on success, negative value on failure.
643d5b97f5cSIrina Tirdea  */
mma9551_set_device_state(struct i2c_client * client,bool enable)644d5b97f5cSIrina Tirdea int mma9551_set_device_state(struct i2c_client *client, bool enable)
645d5b97f5cSIrina Tirdea {
646d5b97f5cSIrina Tirdea 	return mma9551_update_config_bits(client, MMA9551_APPID_SLEEP_WAKE,
647d5b97f5cSIrina Tirdea 					  MMA9551_SLEEP_CFG,
648d5b97f5cSIrina Tirdea 					  MMA9551_SLEEP_CFG_SNCEN |
649d5b97f5cSIrina Tirdea 					  MMA9551_SLEEP_CFG_FLEEN |
650d5b97f5cSIrina Tirdea 					  MMA9551_SLEEP_CFG_SCHEN,
651d5b97f5cSIrina Tirdea 					  enable ? MMA9551_SLEEP_CFG_SCHEN |
652d5b97f5cSIrina Tirdea 					  MMA9551_SLEEP_CFG_FLEEN :
653d5b97f5cSIrina Tirdea 					  MMA9551_SLEEP_CFG_SNCEN);
654d5b97f5cSIrina Tirdea }
6554205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_set_device_state, IIO_MMA9551);
656d5b97f5cSIrina Tirdea 
657d5b97f5cSIrina Tirdea /**
658d5b97f5cSIrina Tirdea  * mma9551_set_power_state() - sets runtime PM state
659d5b97f5cSIrina Tirdea  * @client:	I2C client
660d5b97f5cSIrina Tirdea  * @on:		Use true to power on device, false to power off
661d5b97f5cSIrina Tirdea  *
662d5b97f5cSIrina Tirdea  * Resume or suspend the device using Runtime PM.
663d5b97f5cSIrina Tirdea  * The device will suspend after the autosuspend delay.
664d5b97f5cSIrina Tirdea  *
665d5b97f5cSIrina Tirdea  * Returns: 0 on success, negative value on failure.
666d5b97f5cSIrina Tirdea  */
mma9551_set_power_state(struct i2c_client * client,bool on)667d5b97f5cSIrina Tirdea int mma9551_set_power_state(struct i2c_client *client, bool on)
668d5b97f5cSIrina Tirdea {
669d5b97f5cSIrina Tirdea #ifdef CONFIG_PM
670d5b97f5cSIrina Tirdea 	int ret;
671d5b97f5cSIrina Tirdea 
672d5b97f5cSIrina Tirdea 	if (on)
6732d980d7eSJonathan Cameron 		ret = pm_runtime_resume_and_get(&client->dev);
674d5b97f5cSIrina Tirdea 	else {
675d5b97f5cSIrina Tirdea 		pm_runtime_mark_last_busy(&client->dev);
676d5b97f5cSIrina Tirdea 		ret = pm_runtime_put_autosuspend(&client->dev);
677d5b97f5cSIrina Tirdea 	}
678d5b97f5cSIrina Tirdea 
679d5b97f5cSIrina Tirdea 	if (ret < 0) {
680d5b97f5cSIrina Tirdea 		dev_err(&client->dev,
681d5b97f5cSIrina Tirdea 			"failed to change power state to %d\n", on);
682d5b97f5cSIrina Tirdea 
683d5b97f5cSIrina Tirdea 		return ret;
684d5b97f5cSIrina Tirdea 	}
685d5b97f5cSIrina Tirdea #endif
686d5b97f5cSIrina Tirdea 
687d5b97f5cSIrina Tirdea 	return 0;
688d5b97f5cSIrina Tirdea }
6894205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_set_power_state, IIO_MMA9551);
690d5b97f5cSIrina Tirdea 
691d5b97f5cSIrina Tirdea /**
692d5b97f5cSIrina Tirdea  * mma9551_sleep() - sleep
693d5b97f5cSIrina Tirdea  * @freq:	Application frequency
694d5b97f5cSIrina Tirdea  *
695d5b97f5cSIrina Tirdea  * Firmware applications run at a certain frequency on the
696d5b97f5cSIrina Tirdea  * device. Sleep for one application cycle to make sure the
697d5b97f5cSIrina Tirdea  * application had time to run once and initialize set values.
698d5b97f5cSIrina Tirdea  */
mma9551_sleep(int freq)699d5b97f5cSIrina Tirdea void mma9551_sleep(int freq)
700d5b97f5cSIrina Tirdea {
701d5b97f5cSIrina Tirdea 	int sleep_val = 1000 / freq;
702d5b97f5cSIrina Tirdea 
703d5b97f5cSIrina Tirdea 	if (sleep_val < 20)
704d5b97f5cSIrina Tirdea 		usleep_range(sleep_val * 1000, 20000);
705d5b97f5cSIrina Tirdea 	else
706d5b97f5cSIrina Tirdea 		msleep_interruptible(sleep_val);
707d5b97f5cSIrina Tirdea }
7084205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_sleep, IIO_MMA9551);
709d5b97f5cSIrina Tirdea 
710d5b97f5cSIrina Tirdea /**
711d5b97f5cSIrina Tirdea  * mma9551_read_accel_chan() - read accelerometer channel
712d5b97f5cSIrina Tirdea  * @client:	I2C client
713d5b97f5cSIrina Tirdea  * @chan:	IIO channel
714d5b97f5cSIrina Tirdea  * @val:	Pointer to the accelerometer value read
715d5b97f5cSIrina Tirdea  * @val2:	Unused
716d5b97f5cSIrina Tirdea  *
717d5b97f5cSIrina Tirdea  * Read accelerometer value for the specified channel.
718d5b97f5cSIrina Tirdea  *
719d5b97f5cSIrina Tirdea  * Locking note: This function must be called with the device lock held.
720d5b97f5cSIrina Tirdea  * Locking is not handled inside the function. Callers should ensure they
721d5b97f5cSIrina Tirdea  * serialize access to the HW.
722d5b97f5cSIrina Tirdea  *
723d5b97f5cSIrina Tirdea  * Returns: IIO_VAL_INT on success, negative value on failure.
724d5b97f5cSIrina Tirdea  */
mma9551_read_accel_chan(struct i2c_client * client,const struct iio_chan_spec * chan,int * val,int * val2)725d5b97f5cSIrina Tirdea int mma9551_read_accel_chan(struct i2c_client *client,
726d5b97f5cSIrina Tirdea 			    const struct iio_chan_spec *chan,
727d5b97f5cSIrina Tirdea 			    int *val, int *val2)
728d5b97f5cSIrina Tirdea {
729d5b97f5cSIrina Tirdea 	u16 reg_addr;
730d5b97f5cSIrina Tirdea 	s16 raw_accel;
731d5b97f5cSIrina Tirdea 	int ret;
732d5b97f5cSIrina Tirdea 
733d5b97f5cSIrina Tirdea 	switch (chan->channel2) {
734d5b97f5cSIrina Tirdea 	case IIO_MOD_X:
735d5b97f5cSIrina Tirdea 		reg_addr = MMA9551_AFE_X_ACCEL_REG;
736d5b97f5cSIrina Tirdea 		break;
737d5b97f5cSIrina Tirdea 	case IIO_MOD_Y:
738d5b97f5cSIrina Tirdea 		reg_addr = MMA9551_AFE_Y_ACCEL_REG;
739d5b97f5cSIrina Tirdea 		break;
740d5b97f5cSIrina Tirdea 	case IIO_MOD_Z:
741d5b97f5cSIrina Tirdea 		reg_addr = MMA9551_AFE_Z_ACCEL_REG;
742d5b97f5cSIrina Tirdea 		break;
743d5b97f5cSIrina Tirdea 	default:
744d5b97f5cSIrina Tirdea 		return -EINVAL;
745d5b97f5cSIrina Tirdea 	}
746d5b97f5cSIrina Tirdea 
747d5b97f5cSIrina Tirdea 	ret = mma9551_set_power_state(client, true);
748d5b97f5cSIrina Tirdea 	if (ret < 0)
749d5b97f5cSIrina Tirdea 		return ret;
750d5b97f5cSIrina Tirdea 
751d5b97f5cSIrina Tirdea 	ret = mma9551_read_status_word(client, MMA9551_APPID_AFE,
752d5b97f5cSIrina Tirdea 				       reg_addr, &raw_accel);
753d5b97f5cSIrina Tirdea 	if (ret < 0)
754d5b97f5cSIrina Tirdea 		goto out_poweroff;
755d5b97f5cSIrina Tirdea 
756d5b97f5cSIrina Tirdea 	*val = raw_accel;
757d5b97f5cSIrina Tirdea 
758d5b97f5cSIrina Tirdea 	ret = IIO_VAL_INT;
759d5b97f5cSIrina Tirdea 
760d5b97f5cSIrina Tirdea out_poweroff:
761d5b97f5cSIrina Tirdea 	mma9551_set_power_state(client, false);
762d5b97f5cSIrina Tirdea 	return ret;
763d5b97f5cSIrina Tirdea }
7644205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_read_accel_chan, IIO_MMA9551);
765d5b97f5cSIrina Tirdea 
766d5b97f5cSIrina Tirdea /**
767d5b97f5cSIrina Tirdea  * mma9551_read_accel_scale() - read accelerometer scale
768d5b97f5cSIrina Tirdea  * @val:	Pointer to the accelerometer scale (int value)
769d5b97f5cSIrina Tirdea  * @val2:	Pointer to the accelerometer scale (micro value)
770d5b97f5cSIrina Tirdea  *
771d5b97f5cSIrina Tirdea  * Read accelerometer scale.
772d5b97f5cSIrina Tirdea  *
773d5b97f5cSIrina Tirdea  * Returns: IIO_VAL_INT_PLUS_MICRO.
774d5b97f5cSIrina Tirdea  */
mma9551_read_accel_scale(int * val,int * val2)775d5b97f5cSIrina Tirdea int mma9551_read_accel_scale(int *val, int *val2)
776d5b97f5cSIrina Tirdea {
777d5b97f5cSIrina Tirdea 	*val = 0;
778d5b97f5cSIrina Tirdea 	*val2 = 2440;
779d5b97f5cSIrina Tirdea 
780d5b97f5cSIrina Tirdea 	return IIO_VAL_INT_PLUS_MICRO;
781d5b97f5cSIrina Tirdea }
7824205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_read_accel_scale, IIO_MMA9551);
783d5b97f5cSIrina Tirdea 
78440cb7613SIrina Tirdea /**
78540cb7613SIrina Tirdea  * mma9551_app_reset() - reset application
78640cb7613SIrina Tirdea  * @client:	I2C client
78740cb7613SIrina Tirdea  * @app_mask:	Application to reset
78840cb7613SIrina Tirdea  *
78940cb7613SIrina Tirdea  * Reset the given application (using the Reset/Suspend/Clear
79040cb7613SIrina Tirdea  * Control Application)
79140cb7613SIrina Tirdea  *
79240cb7613SIrina Tirdea  * Returns: 0 on success, negative value on failure.
79340cb7613SIrina Tirdea  */
mma9551_app_reset(struct i2c_client * client,u32 app_mask)79440cb7613SIrina Tirdea int mma9551_app_reset(struct i2c_client *client, u32 app_mask)
79540cb7613SIrina Tirdea {
796476c41a7SIrina Tirdea 	return mma9551_write_config_byte(client, MMA9551_APPID_RSC,
79740cb7613SIrina Tirdea 					 MMA9551_RSC_RESET +
79840cb7613SIrina Tirdea 					 MMA9551_RSC_OFFSET(app_mask),
79940cb7613SIrina Tirdea 					 MMA9551_RSC_VAL(app_mask));
80040cb7613SIrina Tirdea }
8014205a215SJonathan Cameron EXPORT_SYMBOL_NS(mma9551_app_reset, IIO_MMA9551);
80240cb7613SIrina Tirdea 
803d5b97f5cSIrina Tirdea MODULE_AUTHOR("Irina Tirdea <irina.tirdea@intel.com>");
804d5b97f5cSIrina Tirdea MODULE_AUTHOR("Vlad Dogaru <vlad.dogaru@intel.com>");
805d5b97f5cSIrina Tirdea MODULE_LICENSE("GPL v2");
806d5b97f5cSIrina Tirdea MODULE_DESCRIPTION("MMA955xL sensors core");
807