1 /*
2 * Common code for Freescale MMA955x Intelligent Sensor Platform drivers
3 * Copyright (c) 2014, Intel Corporation.
4 *
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms and conditions of the GNU General Public License,
7 * version 2, as published by the Free Software Foundation.
8 *
9 * This program is distributed in the hope it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
12 * more details.
13 */
14
15 #include <linux/module.h>
16 #include <linux/i2c.h>
17 #include <linux/delay.h>
18 #include <linux/iio/iio.h>
19 #include <linux/pm_runtime.h>
20 #include "mma9551_core.h"
21
22 /* Command masks for mailbox write command */
23 #define MMA9551_CMD_READ_VERSION_INFO 0x00
24 #define MMA9551_CMD_READ_CONFIG 0x10
25 #define MMA9551_CMD_WRITE_CONFIG 0x20
26 #define MMA9551_CMD_READ_STATUS 0x30
27
28 /* Mailbox read command */
29 #define MMA9551_RESPONSE_COCO BIT(7)
30
31 /* Error-Status codes returned in mailbox read command */
32 #define MMA9551_MCI_ERROR_NONE 0x00
33 #define MMA9551_MCI_ERROR_PARAM 0x04
34 #define MMA9551_MCI_INVALID_COUNT 0x19
35 #define MMA9551_MCI_ERROR_COMMAND 0x1C
36 #define MMA9551_MCI_ERROR_INVALID_LENGTH 0x21
37 #define MMA9551_MCI_ERROR_FIFO_BUSY 0x22
38 #define MMA9551_MCI_ERROR_FIFO_ALLOCATED 0x23
39 #define MMA9551_MCI_ERROR_FIFO_OVERSIZE 0x24
40
41 /* GPIO Application */
42 #define MMA9551_GPIO_POL_MSB 0x08
43 #define MMA9551_GPIO_POL_LSB 0x09
44
45 /* Sleep/Wake application */
46 #define MMA9551_SLEEP_CFG 0x06
47 #define MMA9551_SLEEP_CFG_SNCEN BIT(0)
48 #define MMA9551_SLEEP_CFG_FLEEN BIT(1)
49 #define MMA9551_SLEEP_CFG_SCHEN BIT(2)
50
51 /* AFE application */
52 #define MMA9551_AFE_X_ACCEL_REG 0x00
53 #define MMA9551_AFE_Y_ACCEL_REG 0x02
54 #define MMA9551_AFE_Z_ACCEL_REG 0x04
55
56 /* Reset/Suspend/Clear application */
57 #define MMA9551_RSC_RESET 0x00
58 #define MMA9551_RSC_OFFSET(mask) (3 - (ffs(mask) - 1) / 8)
59 #define MMA9551_RSC_VAL(mask) (mask >> (((ffs(mask) - 1) / 8) * 8))
60
61 /*
62 * A response is composed of:
63 * - control registers: MB0-3
64 * - data registers: MB4-31
65 *
66 * A request is composed of:
67 * - mbox to write to (always 0)
68 * - control registers: MB1-4
69 * - data registers: MB5-31
70 */
71 #define MMA9551_MAILBOX_CTRL_REGS 4
72 #define MMA9551_MAX_MAILBOX_DATA_REGS 28
73 #define MMA9551_MAILBOX_REGS 32
74
75 #define MMA9551_I2C_READ_RETRIES 5
76 #define MMA9551_I2C_READ_DELAY 50 /* us */
77
78 struct mma9551_mbox_request {
79 u8 start_mbox; /* Always 0. */
80 u8 app_id;
81 /*
82 * See Section 5.3.1 of the MMA955xL Software Reference Manual.
83 *
84 * Bit 7: reserved, always 0
85 * Bits 6-4: command
86 * Bits 3-0: upper bits of register offset
87 */
88 u8 cmd_off;
89 u8 lower_off;
90 u8 nbytes;
91 u8 buf[MMA9551_MAX_MAILBOX_DATA_REGS - 1];
92 } __packed;
93
94 struct mma9551_mbox_response {
95 u8 app_id;
96 /*
97 * See Section 5.3.3 of the MMA955xL Software Reference Manual.
98 *
99 * Bit 7: COCO
100 * Bits 6-0: Error code.
101 */
102 u8 coco_err;
103 u8 nbytes;
104 u8 req_bytes;
105 u8 buf[MMA9551_MAX_MAILBOX_DATA_REGS];
106 } __packed;
107
108 struct mma9551_version_info {
109 __be32 device_id;
110 u8 rom_version[2];
111 u8 fw_version[2];
112 u8 hw_version[2];
113 u8 fw_build[2];
114 };
115
mma9551_transfer(struct i2c_client * client,u8 app_id,u8 command,u16 offset,u8 * inbytes,int num_inbytes,u8 * outbytes,int num_outbytes)116 static int mma9551_transfer(struct i2c_client *client,
117 u8 app_id, u8 command, u16 offset,
118 u8 *inbytes, int num_inbytes,
119 u8 *outbytes, int num_outbytes)
120 {
121 struct mma9551_mbox_request req;
122 struct mma9551_mbox_response rsp;
123 struct i2c_msg in, out;
124 u8 req_len, err_code;
125 int ret, retries;
126
127 if (offset >= 1 << 12) {
128 dev_err(&client->dev, "register offset too large\n");
129 return -EINVAL;
130 }
131
132 req_len = 1 + MMA9551_MAILBOX_CTRL_REGS + num_inbytes;
133 req.start_mbox = 0;
134 req.app_id = app_id;
135 req.cmd_off = command | (offset >> 8);
136 req.lower_off = offset;
137
138 if (command == MMA9551_CMD_WRITE_CONFIG)
139 req.nbytes = num_inbytes;
140 else
141 req.nbytes = num_outbytes;
142 if (num_inbytes)
143 memcpy(req.buf, inbytes, num_inbytes);
144
145 out.addr = client->addr;
146 out.flags = 0;
147 out.len = req_len;
148 out.buf = (u8 *)&req;
149
150 ret = i2c_transfer(client->adapter, &out, 1);
151 if (ret < 0) {
152 dev_err(&client->dev, "i2c write failed\n");
153 return ret;
154 }
155
156 retries = MMA9551_I2C_READ_RETRIES;
157 do {
158 udelay(MMA9551_I2C_READ_DELAY);
159
160 in.addr = client->addr;
161 in.flags = I2C_M_RD;
162 in.len = sizeof(rsp);
163 in.buf = (u8 *)&rsp;
164
165 ret = i2c_transfer(client->adapter, &in, 1);
166 if (ret < 0) {
167 dev_err(&client->dev, "i2c read failed\n");
168 return ret;
169 }
170
171 if (rsp.coco_err & MMA9551_RESPONSE_COCO)
172 break;
173 } while (--retries > 0);
174
175 if (retries == 0) {
176 dev_err(&client->dev,
177 "timed out while waiting for command response\n");
178 return -ETIMEDOUT;
179 }
180
181 if (rsp.app_id != app_id) {
182 dev_err(&client->dev,
183 "app_id mismatch in response got %02x expected %02x\n",
184 rsp.app_id, app_id);
185 return -EINVAL;
186 }
187
188 err_code = rsp.coco_err & ~MMA9551_RESPONSE_COCO;
189 if (err_code != MMA9551_MCI_ERROR_NONE) {
190 dev_err(&client->dev, "read returned error %x\n", err_code);
191 return -EINVAL;
192 }
193
194 if (rsp.nbytes != rsp.req_bytes) {
195 dev_err(&client->dev,
196 "output length mismatch got %d expected %d\n",
197 rsp.nbytes, rsp.req_bytes);
198 return -EINVAL;
199 }
200
201 if (num_outbytes)
202 memcpy(outbytes, rsp.buf, num_outbytes);
203
204 return 0;
205 }
206
207 /**
208 * mma9551_read_config_byte() - read 1 configuration byte
209 * @client: I2C client
210 * @app_id: Application ID
211 * @reg: Application register
212 * @val: Pointer to store value read
213 *
214 * Read one configuration byte from the device using MMA955xL command format.
215 * Commands to the MMA955xL platform consist of a write followed
216 * by one or more reads.
217 *
218 * Locking note: This function must be called with the device lock held.
219 * Locking is not handled inside the function. Callers should ensure they
220 * serialize access to the HW.
221 *
222 * Returns: 0 on success, negative value on failure.
223 */
mma9551_read_config_byte(struct i2c_client * client,u8 app_id,u16 reg,u8 * val)224 int mma9551_read_config_byte(struct i2c_client *client, u8 app_id,
225 u16 reg, u8 *val)
226 {
227 return mma9551_transfer(client, app_id, MMA9551_CMD_READ_CONFIG,
228 reg, NULL, 0, val, 1);
229 }
230 EXPORT_SYMBOL(mma9551_read_config_byte);
231
232 /**
233 * mma9551_write_config_byte() - write 1 configuration byte
234 * @client: I2C client
235 * @app_id: Application ID
236 * @reg: Application register
237 * @val: Value to write
238 *
239 * Write one configuration byte from the device using MMA955xL command format.
240 * Commands to the MMA955xL platform consist of a write followed by one or
241 * more reads.
242 *
243 * Locking note: This function must be called with the device lock held.
244 * Locking is not handled inside the function. Callers should ensure they
245 * serialize access to the HW.
246 *
247 * Returns: 0 on success, negative value on failure.
248 */
mma9551_write_config_byte(struct i2c_client * client,u8 app_id,u16 reg,u8 val)249 int mma9551_write_config_byte(struct i2c_client *client, u8 app_id,
250 u16 reg, u8 val)
251 {
252 return mma9551_transfer(client, app_id, MMA9551_CMD_WRITE_CONFIG, reg,
253 &val, 1, NULL, 0);
254 }
255 EXPORT_SYMBOL(mma9551_write_config_byte);
256
257 /**
258 * mma9551_read_status_byte() - read 1 status byte
259 * @client: I2C client
260 * @app_id: Application ID
261 * @reg: Application register
262 * @val: Pointer to store value read
263 *
264 * Read one status byte from the device using MMA955xL command format.
265 * Commands to the MMA955xL platform consist of a write followed by one or
266 * more reads.
267 *
268 * Locking note: This function must be called with the device lock held.
269 * Locking is not handled inside the function. Callers should ensure they
270 * serialize access to the HW.
271 *
272 * Returns: 0 on success, negative value on failure.
273 */
mma9551_read_status_byte(struct i2c_client * client,u8 app_id,u16 reg,u8 * val)274 int mma9551_read_status_byte(struct i2c_client *client, u8 app_id,
275 u16 reg, u8 *val)
276 {
277 return mma9551_transfer(client, app_id, MMA9551_CMD_READ_STATUS,
278 reg, NULL, 0, val, 1);
279 }
280 EXPORT_SYMBOL(mma9551_read_status_byte);
281
282 /**
283 * mma9551_read_config_word() - read 1 config word
284 * @client: I2C client
285 * @app_id: Application ID
286 * @reg: Application register
287 * @val: Pointer to store value read
288 *
289 * Read one configuration word from the device using MMA955xL command format.
290 * Commands to the MMA955xL platform consist of a write followed by one or
291 * more reads.
292 *
293 * Locking note: This function must be called with the device lock held.
294 * Locking is not handled inside the function. Callers should ensure they
295 * serialize access to the HW.
296 *
297 * Returns: 0 on success, negative value on failure.
298 */
mma9551_read_config_word(struct i2c_client * client,u8 app_id,u16 reg,u16 * val)299 int mma9551_read_config_word(struct i2c_client *client, u8 app_id,
300 u16 reg, u16 *val)
301 {
302 int ret;
303 __be16 v;
304
305 ret = mma9551_transfer(client, app_id, MMA9551_CMD_READ_CONFIG,
306 reg, NULL, 0, (u8 *)&v, 2);
307 *val = be16_to_cpu(v);
308
309 return ret;
310 }
311 EXPORT_SYMBOL(mma9551_read_config_word);
312
313 /**
314 * mma9551_write_config_word() - write 1 config word
315 * @client: I2C client
316 * @app_id: Application ID
317 * @reg: Application register
318 * @val: Value to write
319 *
320 * Write one configuration word from the device using MMA955xL command format.
321 * Commands to the MMA955xL platform consist of a write followed by one or
322 * more reads.
323 *
324 * Locking note: This function must be called with the device lock held.
325 * Locking is not handled inside the function. Callers should ensure they
326 * serialize access to the HW.
327 *
328 * Returns: 0 on success, negative value on failure.
329 */
mma9551_write_config_word(struct i2c_client * client,u8 app_id,u16 reg,u16 val)330 int mma9551_write_config_word(struct i2c_client *client, u8 app_id,
331 u16 reg, u16 val)
332 {
333 __be16 v = cpu_to_be16(val);
334
335 return mma9551_transfer(client, app_id, MMA9551_CMD_WRITE_CONFIG, reg,
336 (u8 *)&v, 2, NULL, 0);
337 }
338 EXPORT_SYMBOL(mma9551_write_config_word);
339
340 /**
341 * mma9551_read_status_word() - read 1 status word
342 * @client: I2C client
343 * @app_id: Application ID
344 * @reg: Application register
345 * @val: Pointer to store value read
346 *
347 * Read one status word from the device using MMA955xL command format.
348 * Commands to the MMA955xL platform consist of a write followed by one or
349 * more reads.
350 *
351 * Locking note: This function must be called with the device lock held.
352 * Locking is not handled inside the function. Callers should ensure they
353 * serialize access to the HW.
354 *
355 * Returns: 0 on success, negative value on failure.
356 */
mma9551_read_status_word(struct i2c_client * client,u8 app_id,u16 reg,u16 * val)357 int mma9551_read_status_word(struct i2c_client *client, u8 app_id,
358 u16 reg, u16 *val)
359 {
360 int ret;
361 __be16 v;
362
363 ret = mma9551_transfer(client, app_id, MMA9551_CMD_READ_STATUS,
364 reg, NULL, 0, (u8 *)&v, 2);
365 *val = be16_to_cpu(v);
366
367 return ret;
368 }
369 EXPORT_SYMBOL(mma9551_read_status_word);
370
371 /**
372 * mma9551_read_config_words() - read multiple config words
373 * @client: I2C client
374 * @app_id: Application ID
375 * @reg: Application register
376 * @len: Length of array to read (in words)
377 * @buf: Array of words to read
378 *
379 * Read multiple configuration registers (word-sized registers).
380 *
381 * Locking note: This function must be called with the device lock held.
382 * Locking is not handled inside the function. Callers should ensure they
383 * serialize access to the HW.
384 *
385 * Returns: 0 on success, negative value on failure.
386 */
mma9551_read_config_words(struct i2c_client * client,u8 app_id,u16 reg,u8 len,u16 * buf)387 int mma9551_read_config_words(struct i2c_client *client, u8 app_id,
388 u16 reg, u8 len, u16 *buf)
389 {
390 int ret, i;
391 __be16 be_buf[MMA9551_MAX_MAILBOX_DATA_REGS / 2];
392
393 if (len > ARRAY_SIZE(be_buf)) {
394 dev_err(&client->dev, "Invalid buffer size %d\n", len);
395 return -EINVAL;
396 }
397
398 ret = mma9551_transfer(client, app_id, MMA9551_CMD_READ_CONFIG,
399 reg, NULL, 0, (u8 *)be_buf, len * sizeof(u16));
400 if (ret < 0)
401 return ret;
402
403 for (i = 0; i < len; i++)
404 buf[i] = be16_to_cpu(be_buf[i]);
405
406 return 0;
407 }
408 EXPORT_SYMBOL(mma9551_read_config_words);
409
410 /**
411 * mma9551_read_status_words() - read multiple status words
412 * @client: I2C client
413 * @app_id: Application ID
414 * @reg: Application register
415 * @len: Length of array to read (in words)
416 * @buf: Array of words to read
417 *
418 * Read multiple status registers (word-sized registers).
419 *
420 * Locking note: This function must be called with the device lock held.
421 * Locking is not handled inside the function. Callers should ensure they
422 * serialize access to the HW.
423 *
424 * Returns: 0 on success, negative value on failure.
425 */
mma9551_read_status_words(struct i2c_client * client,u8 app_id,u16 reg,u8 len,u16 * buf)426 int mma9551_read_status_words(struct i2c_client *client, u8 app_id,
427 u16 reg, u8 len, u16 *buf)
428 {
429 int ret, i;
430 __be16 be_buf[MMA9551_MAX_MAILBOX_DATA_REGS / 2];
431
432 if (len > ARRAY_SIZE(be_buf)) {
433 dev_err(&client->dev, "Invalid buffer size %d\n", len);
434 return -EINVAL;
435 }
436
437 ret = mma9551_transfer(client, app_id, MMA9551_CMD_READ_STATUS,
438 reg, NULL, 0, (u8 *)be_buf, len * sizeof(u16));
439 if (ret < 0)
440 return ret;
441
442 for (i = 0; i < len; i++)
443 buf[i] = be16_to_cpu(be_buf[i]);
444
445 return 0;
446 }
447 EXPORT_SYMBOL(mma9551_read_status_words);
448
449 /**
450 * mma9551_write_config_words() - write multiple config words
451 * @client: I2C client
452 * @app_id: Application ID
453 * @reg: Application register
454 * @len: Length of array to write (in words)
455 * @buf: Array of words to write
456 *
457 * Write multiple configuration registers (word-sized registers).
458 *
459 * Locking note: This function must be called with the device lock held.
460 * Locking is not handled inside the function. Callers should ensure they
461 * serialize access to the HW.
462 *
463 * Returns: 0 on success, negative value on failure.
464 */
mma9551_write_config_words(struct i2c_client * client,u8 app_id,u16 reg,u8 len,u16 * buf)465 int mma9551_write_config_words(struct i2c_client *client, u8 app_id,
466 u16 reg, u8 len, u16 *buf)
467 {
468 int i;
469 __be16 be_buf[(MMA9551_MAX_MAILBOX_DATA_REGS - 1) / 2];
470
471 if (len > ARRAY_SIZE(be_buf)) {
472 dev_err(&client->dev, "Invalid buffer size %d\n", len);
473 return -EINVAL;
474 }
475
476 for (i = 0; i < len; i++)
477 be_buf[i] = cpu_to_be16(buf[i]);
478
479 return mma9551_transfer(client, app_id, MMA9551_CMD_WRITE_CONFIG,
480 reg, (u8 *)be_buf, len * sizeof(u16), NULL, 0);
481 }
482 EXPORT_SYMBOL(mma9551_write_config_words);
483
484 /**
485 * mma9551_update_config_bits() - update bits in register
486 * @client: I2C client
487 * @app_id: Application ID
488 * @reg: Application register
489 * @mask: Mask for the bits to update
490 * @val: Value of the bits to update
491 *
492 * Update bits in the given register using a bit mask.
493 *
494 * Locking note: This function must be called with the device lock held.
495 * Locking is not handled inside the function. Callers should ensure they
496 * serialize access to the HW.
497 *
498 * Returns: 0 on success, negative value on failure.
499 */
mma9551_update_config_bits(struct i2c_client * client,u8 app_id,u16 reg,u8 mask,u8 val)500 int mma9551_update_config_bits(struct i2c_client *client, u8 app_id,
501 u16 reg, u8 mask, u8 val)
502 {
503 int ret;
504 u8 tmp, orig;
505
506 ret = mma9551_read_config_byte(client, app_id, reg, &orig);
507 if (ret < 0)
508 return ret;
509
510 tmp = orig & ~mask;
511 tmp |= val & mask;
512
513 if (tmp == orig)
514 return 0;
515
516 return mma9551_write_config_byte(client, app_id, reg, tmp);
517 }
518 EXPORT_SYMBOL(mma9551_update_config_bits);
519
520 /**
521 * mma9551_gpio_config() - configure gpio
522 * @client: I2C client
523 * @pin: GPIO pin to configure
524 * @app_id: Application ID
525 * @bitnum: Bit number of status register being assigned to the GPIO pin.
526 * @polarity: The polarity parameter is described in section 6.2.2, page 66,
527 * of the Software Reference Manual. Basically, polarity=0 means
528 * the interrupt line has the same value as the selected bit,
529 * while polarity=1 means the line is inverted.
530 *
531 * Assign a bit from an application’s status register to a specific GPIO pin.
532 *
533 * Locking note: This function must be called with the device lock held.
534 * Locking is not handled inside the function. Callers should ensure they
535 * serialize access to the HW.
536 *
537 * Returns: 0 on success, negative value on failure.
538 */
mma9551_gpio_config(struct i2c_client * client,enum mma9551_gpio_pin pin,u8 app_id,u8 bitnum,int polarity)539 int mma9551_gpio_config(struct i2c_client *client, enum mma9551_gpio_pin pin,
540 u8 app_id, u8 bitnum, int polarity)
541 {
542 u8 reg, pol_mask, pol_val;
543 int ret;
544
545 if (pin > mma9551_gpio_max) {
546 dev_err(&client->dev, "bad GPIO pin\n");
547 return -EINVAL;
548 }
549
550 /*
551 * Pin 6 is configured by regs 0x00 and 0x01, pin 7 by 0x02 and
552 * 0x03, and so on.
553 */
554 reg = pin * 2;
555
556 ret = mma9551_write_config_byte(client, MMA9551_APPID_GPIO,
557 reg, app_id);
558 if (ret < 0) {
559 dev_err(&client->dev, "error setting GPIO app_id\n");
560 return ret;
561 }
562
563 ret = mma9551_write_config_byte(client, MMA9551_APPID_GPIO,
564 reg + 1, bitnum);
565 if (ret < 0) {
566 dev_err(&client->dev, "error setting GPIO bit number\n");
567 return ret;
568 }
569
570 switch (pin) {
571 case mma9551_gpio6:
572 reg = MMA9551_GPIO_POL_LSB;
573 pol_mask = 1 << 6;
574 break;
575 case mma9551_gpio7:
576 reg = MMA9551_GPIO_POL_LSB;
577 pol_mask = 1 << 7;
578 break;
579 case mma9551_gpio8:
580 reg = MMA9551_GPIO_POL_MSB;
581 pol_mask = 1 << 0;
582 break;
583 case mma9551_gpio9:
584 reg = MMA9551_GPIO_POL_MSB;
585 pol_mask = 1 << 1;
586 break;
587 }
588 pol_val = polarity ? pol_mask : 0;
589
590 ret = mma9551_update_config_bits(client, MMA9551_APPID_GPIO, reg,
591 pol_mask, pol_val);
592 if (ret < 0)
593 dev_err(&client->dev, "error setting GPIO polarity\n");
594
595 return ret;
596 }
597 EXPORT_SYMBOL(mma9551_gpio_config);
598
599 /**
600 * mma9551_read_version() - read device version information
601 * @client: I2C client
602 *
603 * Read version information and print device id and firmware version.
604 *
605 * Locking note: This function must be called with the device lock held.
606 * Locking is not handled inside the function. Callers should ensure they
607 * serialize access to the HW.
608 *
609 * Returns: 0 on success, negative value on failure.
610 */
mma9551_read_version(struct i2c_client * client)611 int mma9551_read_version(struct i2c_client *client)
612 {
613 struct mma9551_version_info info;
614 int ret;
615
616 ret = mma9551_transfer(client, MMA9551_APPID_VERSION, 0x00, 0x00,
617 NULL, 0, (u8 *)&info, sizeof(info));
618 if (ret < 0)
619 return ret;
620
621 dev_info(&client->dev, "device ID 0x%x, firmware version %02x.%02x\n",
622 be32_to_cpu(info.device_id), info.fw_version[0],
623 info.fw_version[1]);
624
625 return 0;
626 }
627 EXPORT_SYMBOL(mma9551_read_version);
628
629 /**
630 * mma9551_set_device_state() - sets HW power mode
631 * @client: I2C client
632 * @enable: Use true to power on device, false to cause the device
633 * to enter sleep.
634 *
635 * Set power on/off for device using the Sleep/Wake Application.
636 * When enable is true, power on chip and enable doze mode.
637 * When enable is false, enter sleep mode (device remains in the
638 * lowest-power mode).
639 *
640 * Locking note: This function must be called with the device lock held.
641 * Locking is not handled inside the function. Callers should ensure they
642 * serialize access to the HW.
643 *
644 * Returns: 0 on success, negative value on failure.
645 */
mma9551_set_device_state(struct i2c_client * client,bool enable)646 int mma9551_set_device_state(struct i2c_client *client, bool enable)
647 {
648 return mma9551_update_config_bits(client, MMA9551_APPID_SLEEP_WAKE,
649 MMA9551_SLEEP_CFG,
650 MMA9551_SLEEP_CFG_SNCEN |
651 MMA9551_SLEEP_CFG_FLEEN |
652 MMA9551_SLEEP_CFG_SCHEN,
653 enable ? MMA9551_SLEEP_CFG_SCHEN |
654 MMA9551_SLEEP_CFG_FLEEN :
655 MMA9551_SLEEP_CFG_SNCEN);
656 }
657 EXPORT_SYMBOL(mma9551_set_device_state);
658
659 /**
660 * mma9551_set_power_state() - sets runtime PM state
661 * @client: I2C client
662 * @on: Use true to power on device, false to power off
663 *
664 * Resume or suspend the device using Runtime PM.
665 * The device will suspend after the autosuspend delay.
666 *
667 * Returns: 0 on success, negative value on failure.
668 */
mma9551_set_power_state(struct i2c_client * client,bool on)669 int mma9551_set_power_state(struct i2c_client *client, bool on)
670 {
671 #ifdef CONFIG_PM
672 int ret;
673
674 if (on)
675 ret = pm_runtime_get_sync(&client->dev);
676 else {
677 pm_runtime_mark_last_busy(&client->dev);
678 ret = pm_runtime_put_autosuspend(&client->dev);
679 }
680
681 if (ret < 0) {
682 dev_err(&client->dev,
683 "failed to change power state to %d\n", on);
684 if (on)
685 pm_runtime_put_noidle(&client->dev);
686
687 return ret;
688 }
689 #endif
690
691 return 0;
692 }
693 EXPORT_SYMBOL(mma9551_set_power_state);
694
695 /**
696 * mma9551_sleep() - sleep
697 * @freq: Application frequency
698 *
699 * Firmware applications run at a certain frequency on the
700 * device. Sleep for one application cycle to make sure the
701 * application had time to run once and initialize set values.
702 */
mma9551_sleep(int freq)703 void mma9551_sleep(int freq)
704 {
705 int sleep_val = 1000 / freq;
706
707 if (sleep_val < 20)
708 usleep_range(sleep_val * 1000, 20000);
709 else
710 msleep_interruptible(sleep_val);
711 }
712 EXPORT_SYMBOL(mma9551_sleep);
713
714 /**
715 * mma9551_read_accel_chan() - read accelerometer channel
716 * @client: I2C client
717 * @chan: IIO channel
718 * @val: Pointer to the accelerometer value read
719 * @val2: Unused
720 *
721 * Read accelerometer value for the specified channel.
722 *
723 * Locking note: This function must be called with the device lock held.
724 * Locking is not handled inside the function. Callers should ensure they
725 * serialize access to the HW.
726 *
727 * Returns: IIO_VAL_INT on success, negative value on failure.
728 */
mma9551_read_accel_chan(struct i2c_client * client,const struct iio_chan_spec * chan,int * val,int * val2)729 int mma9551_read_accel_chan(struct i2c_client *client,
730 const struct iio_chan_spec *chan,
731 int *val, int *val2)
732 {
733 u16 reg_addr;
734 s16 raw_accel;
735 int ret;
736
737 switch (chan->channel2) {
738 case IIO_MOD_X:
739 reg_addr = MMA9551_AFE_X_ACCEL_REG;
740 break;
741 case IIO_MOD_Y:
742 reg_addr = MMA9551_AFE_Y_ACCEL_REG;
743 break;
744 case IIO_MOD_Z:
745 reg_addr = MMA9551_AFE_Z_ACCEL_REG;
746 break;
747 default:
748 return -EINVAL;
749 }
750
751 ret = mma9551_set_power_state(client, true);
752 if (ret < 0)
753 return ret;
754
755 ret = mma9551_read_status_word(client, MMA9551_APPID_AFE,
756 reg_addr, &raw_accel);
757 if (ret < 0)
758 goto out_poweroff;
759
760 *val = raw_accel;
761
762 ret = IIO_VAL_INT;
763
764 out_poweroff:
765 mma9551_set_power_state(client, false);
766 return ret;
767 }
768 EXPORT_SYMBOL(mma9551_read_accel_chan);
769
770 /**
771 * mma9551_read_accel_scale() - read accelerometer scale
772 * @val: Pointer to the accelerometer scale (int value)
773 * @val2: Pointer to the accelerometer scale (micro value)
774 *
775 * Read accelerometer scale.
776 *
777 * Returns: IIO_VAL_INT_PLUS_MICRO.
778 */
mma9551_read_accel_scale(int * val,int * val2)779 int mma9551_read_accel_scale(int *val, int *val2)
780 {
781 *val = 0;
782 *val2 = 2440;
783
784 return IIO_VAL_INT_PLUS_MICRO;
785 }
786 EXPORT_SYMBOL(mma9551_read_accel_scale);
787
788 /**
789 * mma9551_app_reset() - reset application
790 * @client: I2C client
791 * @app_mask: Application to reset
792 *
793 * Reset the given application (using the Reset/Suspend/Clear
794 * Control Application)
795 *
796 * Returns: 0 on success, negative value on failure.
797 */
mma9551_app_reset(struct i2c_client * client,u32 app_mask)798 int mma9551_app_reset(struct i2c_client *client, u32 app_mask)
799 {
800 return mma9551_write_config_byte(client, MMA9551_APPID_RSC,
801 MMA9551_RSC_RESET +
802 MMA9551_RSC_OFFSET(app_mask),
803 MMA9551_RSC_VAL(app_mask));
804 }
805 EXPORT_SYMBOL(mma9551_app_reset);
806
807 MODULE_AUTHOR("Irina Tirdea <irina.tirdea@intel.com>");
808 MODULE_AUTHOR("Vlad Dogaru <vlad.dogaru@intel.com>");
809 MODULE_LICENSE("GPL v2");
810 MODULE_DESCRIPTION("MMA955xL sensors core");
811