| /* SPDX-License-Identifier: GPL-2.0-or-later */ |
| /* |
| * lis3lv02d.h - ST LIS3LV02DL accelerometer driver |
| * |
| * Copyright (C) 2007-2008 Yan Burman |
| * Copyright (C) 2008-2009 Eric Piel |
| */ |
| #include <linux/platform_device.h> |
| #include <linux/input-polldev.h> |
| #include <linux/regulator/consumer.h> |
| #include <linux/miscdevice.h> |
| |
| /* |
| * This driver tries to support the "digital" accelerometer chips from |
| * STMicroelectronics such as LIS3LV02DL, LIS302DL, LIS3L02DQ, LIS331DL, |
| * LIS331DLH, LIS35DE, or LIS202DL. They are very similar in terms of |
| * programming, with almost the same registers. In addition to differing |
| * on physical properties, they differ on the number of axes (2/3), |
| * precision (8/12 bits), and special features (freefall detection, |
| * click...). Unfortunately, not all the differences can be probed via |
| * a register. They can be connected either via I²C or SPI. |
| */ |
| |
| #include <linux/lis3lv02d.h> |
| |
| enum lis3_reg { |
| WHO_AM_I = 0x0F, |
| OFFSET_X = 0x16, |
| OFFSET_Y = 0x17, |
| OFFSET_Z = 0x18, |
| GAIN_X = 0x19, |
| GAIN_Y = 0x1A, |
| GAIN_Z = 0x1B, |
| CTRL_REG1 = 0x20, |
| CTRL_REG2 = 0x21, |
| CTRL_REG3 = 0x22, |
| CTRL_REG4 = 0x23, |
| HP_FILTER_RESET = 0x23, |
| STATUS_REG = 0x27, |
| OUTX_L = 0x28, |
| OUTX_H = 0x29, |
| OUTX = 0x29, |
| OUTY_L = 0x2A, |
| OUTY_H = 0x2B, |
| OUTY = 0x2B, |
| OUTZ_L = 0x2C, |
| OUTZ_H = 0x2D, |
| OUTZ = 0x2D, |
| }; |
| |
| enum lis302d_reg { |
| FF_WU_CFG_1 = 0x30, |
| FF_WU_SRC_1 = 0x31, |
| FF_WU_THS_1 = 0x32, |
| FF_WU_DURATION_1 = 0x33, |
| FF_WU_CFG_2 = 0x34, |
| FF_WU_SRC_2 = 0x35, |
| FF_WU_THS_2 = 0x36, |
| FF_WU_DURATION_2 = 0x37, |
| CLICK_CFG = 0x38, |
| CLICK_SRC = 0x39, |
| CLICK_THSY_X = 0x3B, |
| CLICK_THSZ = 0x3C, |
| CLICK_TIMELIMIT = 0x3D, |
| CLICK_LATENCY = 0x3E, |
| CLICK_WINDOW = 0x3F, |
| }; |
| |
| enum lis3lv02d_reg { |
| FF_WU_CFG = 0x30, |
| FF_WU_SRC = 0x31, |
| FF_WU_ACK = 0x32, |
| FF_WU_THS_L = 0x34, |
| FF_WU_THS_H = 0x35, |
| FF_WU_DURATION = 0x36, |
| DD_CFG = 0x38, |
| DD_SRC = 0x39, |
| DD_ACK = 0x3A, |
| DD_THSI_L = 0x3C, |
| DD_THSI_H = 0x3D, |
| DD_THSE_L = 0x3E, |
| DD_THSE_H = 0x3F, |
| }; |
| |
| enum lis3_who_am_i { |
| WAI_3DLH = 0x32, /* 16 bits: LIS331DLH */ |
| WAI_3DC = 0x33, /* 8 bits: LIS3DC, HP3DC */ |
| WAI_12B = 0x3A, /* 12 bits: LIS3LV02D[LQ]... */ |
| WAI_8B = 0x3B, /* 8 bits: LIS[23]02D[LQ]... */ |
| WAI_6B = 0x52, /* 6 bits: LIS331DLF - not supported */ |
| }; |
| |
| enum lis3_type { |
| LIS3LV02D, |
| LIS3DC, |
| HP3DC, |
| LIS2302D, |
| LIS331DLF, |
| LIS331DLH, |
| }; |
| |
| enum lis3lv02d_ctrl1_12b { |
| CTRL1_Xen = 0x01, |
| CTRL1_Yen = 0x02, |
| CTRL1_Zen = 0x04, |
| CTRL1_ST = 0x08, |
| CTRL1_DF0 = 0x10, |
| CTRL1_DF1 = 0x20, |
| CTRL1_PD0 = 0x40, |
| CTRL1_PD1 = 0x80, |
| }; |
| |
| /* Delta to ctrl1_12b version */ |
| enum lis3lv02d_ctrl1_8b { |
| CTRL1_STM = 0x08, |
| CTRL1_STP = 0x10, |
| CTRL1_FS = 0x20, |
| CTRL1_PD = 0x40, |
| CTRL1_DR = 0x80, |
| }; |
| |
| enum lis3lv02d_ctrl1_3dc { |
| CTRL1_ODR0 = 0x10, |
| CTRL1_ODR1 = 0x20, |
| CTRL1_ODR2 = 0x40, |
| CTRL1_ODR3 = 0x80, |
| }; |
| |
| enum lis331dlh_ctrl1 { |
| CTRL1_DR0 = 0x08, |
| CTRL1_DR1 = 0x10, |
| CTRL1_PM0 = 0x20, |
| CTRL1_PM1 = 0x40, |
| CTRL1_PM2 = 0x80, |
| }; |
| |
| enum lis331dlh_ctrl2 { |
| CTRL2_HPEN1 = 0x04, |
| CTRL2_HPEN2 = 0x08, |
| CTRL2_FDS_3DLH = 0x10, |
| CTRL2_BOOT_3DLH = 0x80, |
| }; |
| |
| enum lis331dlh_ctrl4 { |
| CTRL4_STSIGN = 0x08, |
| CTRL4_BLE = 0x40, |
| CTRL4_BDU = 0x80, |
| }; |
| |
| enum lis3lv02d_ctrl2 { |
| CTRL2_DAS = 0x01, |
| CTRL2_SIM = 0x02, |
| CTRL2_DRDY = 0x04, |
| CTRL2_IEN = 0x08, |
| CTRL2_BOOT = 0x10, |
| CTRL2_BLE = 0x20, |
| CTRL2_BDU = 0x40, /* Block Data Update */ |
| CTRL2_FS = 0x80, /* Full Scale selection */ |
| }; |
| |
| enum lis3lv02d_ctrl4_3dc { |
| CTRL4_SIM = 0x01, |
| CTRL4_ST0 = 0x02, |
| CTRL4_ST1 = 0x04, |
| CTRL4_FS0 = 0x10, |
| CTRL4_FS1 = 0x20, |
| }; |
| |
| enum lis302d_ctrl2 { |
| HP_FF_WU2 = 0x08, |
| HP_FF_WU1 = 0x04, |
| CTRL2_BOOT_8B = 0x40, |
| }; |
| |
| enum lis3lv02d_ctrl3 { |
| CTRL3_CFS0 = 0x01, |
| CTRL3_CFS1 = 0x02, |
| CTRL3_FDS = 0x10, |
| CTRL3_HPFF = 0x20, |
| CTRL3_HPDD = 0x40, |
| CTRL3_ECK = 0x80, |
| }; |
| |
| enum lis3lv02d_status_reg { |
| STATUS_XDA = 0x01, |
| STATUS_YDA = 0x02, |
| STATUS_ZDA = 0x04, |
| STATUS_XYZDA = 0x08, |
| STATUS_XOR = 0x10, |
| STATUS_YOR = 0x20, |
| STATUS_ZOR = 0x40, |
| STATUS_XYZOR = 0x80, |
| }; |
| |
| enum lis3lv02d_ff_wu_cfg { |
| FF_WU_CFG_XLIE = 0x01, |
| FF_WU_CFG_XHIE = 0x02, |
| FF_WU_CFG_YLIE = 0x04, |
| FF_WU_CFG_YHIE = 0x08, |
| FF_WU_CFG_ZLIE = 0x10, |
| FF_WU_CFG_ZHIE = 0x20, |
| FF_WU_CFG_LIR = 0x40, |
| FF_WU_CFG_AOI = 0x80, |
| }; |
| |
| enum lis3lv02d_ff_wu_src { |
| FF_WU_SRC_XL = 0x01, |
| FF_WU_SRC_XH = 0x02, |
| FF_WU_SRC_YL = 0x04, |
| FF_WU_SRC_YH = 0x08, |
| FF_WU_SRC_ZL = 0x10, |
| FF_WU_SRC_ZH = 0x20, |
| FF_WU_SRC_IA = 0x40, |
| }; |
| |
| enum lis3lv02d_dd_cfg { |
| DD_CFG_XLIE = 0x01, |
| DD_CFG_XHIE = 0x02, |
| DD_CFG_YLIE = 0x04, |
| DD_CFG_YHIE = 0x08, |
| DD_CFG_ZLIE = 0x10, |
| DD_CFG_ZHIE = 0x20, |
| DD_CFG_LIR = 0x40, |
| DD_CFG_IEND = 0x80, |
| }; |
| |
| enum lis3lv02d_dd_src { |
| DD_SRC_XL = 0x01, |
| DD_SRC_XH = 0x02, |
| DD_SRC_YL = 0x04, |
| DD_SRC_YH = 0x08, |
| DD_SRC_ZL = 0x10, |
| DD_SRC_ZH = 0x20, |
| DD_SRC_IA = 0x40, |
| }; |
| |
| enum lis3lv02d_click_src_8b { |
| CLICK_SINGLE_X = 0x01, |
| CLICK_DOUBLE_X = 0x02, |
| CLICK_SINGLE_Y = 0x04, |
| CLICK_DOUBLE_Y = 0x08, |
| CLICK_SINGLE_Z = 0x10, |
| CLICK_DOUBLE_Z = 0x20, |
| CLICK_IA = 0x40, |
| }; |
| |
| enum lis3lv02d_reg_state { |
| LIS3_REG_OFF = 0x00, |
| LIS3_REG_ON = 0x01, |
| }; |
| |
| union axis_conversion { |
| struct { |
| int x, y, z; |
| }; |
| int as_array[3]; |
| |
| }; |
| |
| struct lis3lv02d { |
| void *bus_priv; /* used by the bus layer only */ |
| struct device *pm_dev; /* for pm_runtime purposes */ |
| int (*init) (struct lis3lv02d *lis3); |
| int (*write) (struct lis3lv02d *lis3, int reg, u8 val); |
| int (*read) (struct lis3lv02d *lis3, int reg, u8 *ret); |
| int (*blkread) (struct lis3lv02d *lis3, int reg, int len, u8 *ret); |
| int (*reg_ctrl) (struct lis3lv02d *lis3, bool state); |
| |
| int *odrs; /* Supported output data rates */ |
| u8 *regs; /* Regs to store / restore */ |
| int regs_size; |
| u8 *reg_cache; |
| bool regs_stored; |
| bool init_required; |
| u8 odr_mask; /* ODR bit mask */ |
| u8 whoami; /* indicates measurement precision */ |
| s16 (*read_data) (struct lis3lv02d *lis3, int reg); |
| int mdps_max_val; |
| int pwron_delay; |
| int scale; /* |
| * relationship between 1 LBS and mG |
| * (1/1000th of earth gravity) |
| */ |
| |
| struct input_polled_dev *idev; /* input device */ |
| struct platform_device *pdev; /* platform device */ |
| struct regulator_bulk_data regulators[2]; |
| atomic_t count; /* interrupt count after last read */ |
| union axis_conversion ac; /* hw -> logical axis */ |
| int mapped_btns[3]; |
| |
| u32 irq; /* IRQ number */ |
| struct fasync_struct *async_queue; /* queue for the misc device */ |
| wait_queue_head_t misc_wait; /* Wait queue for the misc device */ |
| unsigned long misc_opened; /* bit0: whether the device is open */ |
| struct miscdevice miscdev; |
| |
| int data_ready_count[2]; |
| atomic_t wake_thread; |
| unsigned char irq_cfg; |
| unsigned int shift_adj; |
| |
| struct lis3lv02d_platform_data *pdata; /* for passing board config */ |
| struct mutex mutex; /* Serialize poll and selftest */ |
| |
| #ifdef CONFIG_OF |
| struct device_node *of_node; |
| #endif |
| }; |
| |
| int lis3lv02d_init_device(struct lis3lv02d *lis3); |
| int lis3lv02d_joystick_enable(struct lis3lv02d *lis3); |
| void lis3lv02d_joystick_disable(struct lis3lv02d *lis3); |
| void lis3lv02d_poweroff(struct lis3lv02d *lis3); |
| int lis3lv02d_poweron(struct lis3lv02d *lis3); |
| int lis3lv02d_remove_fs(struct lis3lv02d *lis3); |
| int lis3lv02d_init_dt(struct lis3lv02d *lis3); |
| |
| extern struct lis3lv02d lis3_dev; |
