#include #include #include "lis3dh.h" #include "registers.h" /* reset user regs and reload trim params */ static int lis3dh_reset(lis3dh_t *lis3dh) { int err = 0; /* set BOOT bit so device reloads internal trim parameters */ err |= lis3dh->dev.write(REG_CTRL_REG5, 0x80); /* write default values to rw regs */ err |= lis3dh->dev.write(REG_CTRL_REG0, 0x10); err |= lis3dh->dev.write(REG_CTRL_REG1, 0x07); err |= lis3dh->dev.write(REG_CTRL_REG2, 0x00); err |= lis3dh->dev.write(REG_CTRL_REG3, 0x00); err |= lis3dh->dev.write(REG_CTRL_REG4, 0x00); err |= lis3dh->dev.write(REG_CTRL_REG5, 0x00); err |= lis3dh->dev.write(REG_CTRL_REG6, 0x00); err |= lis3dh->dev.write(REG_FIFO_CTRL_REG, 0x00); err |= lis3dh->dev.write(REG_INT1_CFG, 0x00); err |= lis3dh->dev.write(REG_INT1_THS, 0x00); err |= lis3dh->dev.write(REG_INT1_DURATION, 0x00); err |= lis3dh->dev.write(REG_INT2_CFG, 0x00); err |= lis3dh->dev.write(REG_INT2_THS, 0x00); err |= lis3dh->dev.write(REG_INT2_DURATION, 0x00); err |= lis3dh->dev.write(REG_CLICK_CFG, 0x00); err |= lis3dh->dev.write(REG_CLICK_THS, 0x00); err |= lis3dh->dev.write(REG_TIME_LIMIT, 0x00); err |= lis3dh->dev.write(REG_TIME_LATENCY, 0x00); err |= lis3dh->dev.write(REG_TIME_WINDOW, 0x00); err |= lis3dh->dev.write(REG_ACT_THS, 0x00); err |= lis3dh->dev.write(REG_ACT_DUR, 0x00); return err; } int lis3dh_init(lis3dh_t *lis3dh) { uint8_t result; int err = 0; /* if init has been given, check it */ if (lis3dh->dev.init != NULL) { if (lis3dh->dev.init() != 0) { return 1; } } err |= lis3dh->dev.read(REG_WHO_AM_I, &result, 1); if (result != 0x33) { return 1; } /* zero struct */ lis3dh->acc.x = 0.0; lis3dh->acc.y = 0.0; lis3dh->acc.z = 0.0; lis3dh->cfg.rate = 0; lis3dh->cfg.range = 0; lis3dh->cfg.mode = 0; lis3dh->cfg.fifo.mode = 0xFF; /* in use if neq 0xFF */ lis3dh->cfg.fifo.trig = 0; lis3dh->cfg.fifo.fth = 31; /* default watermark level. */ lis3dh->cfg.filter.mode = 0xFF; /* in use if neq 0xFF */ lis3dh->cfg.filter.cutoff = 0; lis3dh->cfg.filter.fds = 1; /* bypass OFF by default */ lis3dh->cfg.filter.click = 0; lis3dh->cfg.filter.ia1 = 0; lis3dh->cfg.filter.ia2 = 0; lis3dh->cfg.int1.click = 0; lis3dh->cfg.int1.ia1 = 0; lis3dh->cfg.int1.ia2 = 0; lis3dh->cfg.int1.drdy_zyxda = 0; lis3dh->cfg.int1.drdy_321 = 0; lis3dh->cfg.int1.wtm = 0; lis3dh->cfg.int1.overrun = 0; lis3dh->cfg.int1.latch = 0; lis3dh->cfg.int2.click = 0; lis3dh->cfg.int2.ia1 = 0; lis3dh->cfg.int2.ia2 = 0; lis3dh->cfg.int2.boot = 0; lis3dh->cfg.int2.act = 0; lis3dh->cfg.int2.polarity = 0; lis3dh->cfg.int2.latch = 0; err |= lis3dh_reset(lis3dh); return err; } int lis3dh_configure(lis3dh_t *lis3dh) { uint8_t ctrl_reg1, ctrl_reg2, ctrl_reg3; uint8_t ctrl_reg4, ctrl_reg5, ctrl_reg6; uint8_t fifo_ctrl_reg; uint8_t ref; /* dummy */ int err = 0; /* the 0x07 enables Z, Y and X axis in that order */ ctrl_reg1 = (lis3dh->cfg.rate << 4) | 0x07; ctrl_reg2 = 0; ctrl_reg3 = 0; ctrl_reg4 = (lis3dh->cfg.range << 4); ctrl_reg5 = 0; ctrl_reg6 = 0; fifo_ctrl_reg = 0; /* set interrupt registers */ ctrl_reg3 |= (lis3dh->cfg.int1.click & 1) << 7; ctrl_reg3 |= (lis3dh->cfg.int1.ia1 & 1) << 6; ctrl_reg3 |= (lis3dh->cfg.int1.ia2 & 1) << 5; ctrl_reg3 |= (lis3dh->cfg.int1.drdy_zyxda & 1) << 4; ctrl_reg3 |= (lis3dh->cfg.int1.drdy_321 & 1) << 3; ctrl_reg3 |= (lis3dh->cfg.int1.wtm & 1) << 2; ctrl_reg3 |= (lis3dh->cfg.int1.overrun & 1) << 1; ctrl_reg6 |= (lis3dh->cfg.int2.click & 1) << 7; ctrl_reg6 |= (lis3dh->cfg.int2.ia1 & 1) << 6; ctrl_reg6 |= (lis3dh->cfg.int2.ia2 & 1) << 5; ctrl_reg6 |= (lis3dh->cfg.int2.boot & 1) << 4; ctrl_reg6 |= (lis3dh->cfg.int2.act & 1) << 3; ctrl_reg6 |= (lis3dh->cfg.int2.polarity & 1) << 1; ctrl_reg5 |= (lis3dh->cfg.int1.latch & 1) << 3; ctrl_reg5 |= (lis3dh->cfg.int2.latch & 1) << 1; /* set enable FIFO */ if (lis3dh->cfg.fifo.mode != 0xFF) { ctrl_reg5 |= 0x40; /* bit FIFO_EN */ /* restrict maximum fifo size */ if (lis3dh->cfg.fifo.fth > 32) { lis3dh->cfg.fifo.fth = 32; } fifo_ctrl_reg |= (lis3dh->cfg.fifo.fth); fifo_ctrl_reg |= (lis3dh->cfg.fifo.mode << 6); fifo_ctrl_reg |= ((lis3dh->cfg.fifo.trig & 1) << 5); } /* set enable filter */ if (lis3dh->cfg.filter.mode != 0xFF) { ctrl_reg2 |= ((lis3dh->cfg.filter.mode & 0x03) << 6); ctrl_reg2 |= ((lis3dh->cfg.filter.cutoff & 0x03) << 4); ctrl_reg2 |= ((lis3dh->cfg.filter.fds & 1) << 3); ctrl_reg2 |= ((lis3dh->cfg.filter.click & 1) << 2); ctrl_reg2 |= ((lis3dh->cfg.filter.ia1 & 1) << 1); ctrl_reg2 |= (lis3dh->cfg.filter.ia2 & 1); } /* always set block update */ ctrl_reg4 |= 0x80; /* set high resolution */ if (lis3dh->cfg.mode == LIS3DH_MODE_HR) { ctrl_reg4 |= 0x08; } /* set LPen */ if (lis3dh->cfg.mode == LIS3DH_MODE_LP) { ctrl_reg1 |= 0x08; } err |= lis3dh->dev.write(REG_CTRL_REG1, ctrl_reg1); err |= lis3dh->dev.write(REG_CTRL_REG2, ctrl_reg2); err |= lis3dh->dev.write(REG_CTRL_REG3, ctrl_reg3); err |= lis3dh->dev.write(REG_CTRL_REG4, ctrl_reg4); err |= lis3dh->dev.write(REG_CTRL_REG5, ctrl_reg5); err |= lis3dh->dev.write(REG_CTRL_REG6, ctrl_reg6); err |= lis3dh->dev.write(REG_FIFO_CTRL_REG, fifo_ctrl_reg); /* read REFERENCE to clear internal filter struct */ err |= lis3dh->dev.read(REG_REFERENCE, &ref, 1); /* sleep for a period TBD ~ ODR */ lis3dh->dev.sleep(50000); /* 50 ms */ return err; } int lis3dh_poll(lis3dh_t *lis3dh) { uint8_t status; int err = 0; do { lis3dh->dev.sleep(1000); /* 1 ms */ err |= lis3dh->dev.read(REG_STATUS_REG, &status, 1); } while (!err && !((status >> 3) & 1)); return err; } int lis3dh_poll_fifo(lis3dh_t *lis3dh) { uint8_t src; int err = 0; do { lis3dh->dev.sleep(1000); /* 1 ms */ err |= lis3dh->dev.read(REG_FIFO_SRC_REG, &src, 1); } while (!err && !(src >> 6)); return err; } /* the real size of the int you get back from reading the acc u16 depends on the power mode. shift down the 16 bit word by this amount: */ static uint8_t acc_shift(uint8_t mode) { switch (mode) { case LIS3DH_MODE_HR: return 4; /* i12 */ case LIS3DH_MODE_NORMAL: return 6; /* i10 */ case LIS3DH_MODE_LP: return 8; /* i8 */ default: return 0; } } /* returns a scalar that when multiplied with axis reading turns it to a multiple of mg. */ static uint8_t acc_sensitivity(uint8_t mode, uint8_t range) { switch (range) { case LIS3DH_FS_2G: return (mode == LIS3DH_MODE_LP) ? 16 : (mode == LIS3DH_MODE_NORMAL) ? 4 : 1; case LIS3DH_FS_4G: return (mode == LIS3DH_MODE_LP) ? 32 : (mode == LIS3DH_MODE_NORMAL) ? 8 : 2; case LIS3DH_FS_8G: return (mode == LIS3DH_MODE_LP) ? 64 : (mode == LIS3DH_MODE_NORMAL) ? 16 : 4; case LIS3DH_FS_16G: return (mode == LIS3DH_MODE_LP) ? 192 : (mode == LIS3DH_MODE_NORMAL) ? 48 : 12; default: return 0; } } int lis3dh_read(lis3dh_t *lis3dh) { uint8_t data[6]; int32_t x, y, z; uint8_t scale, sens; int err = 0; scale = acc_shift(lis3dh->cfg.mode); sens = acc_sensitivity(lis3dh->cfg.mode, lis3dh->cfg.range); /* must set MSbit of the address to multi-read and have the device auto-increment the address. */ err |= lis3dh->dev.read(REG_OUT_X_L | 0x80, data, 6); /* x,y,z are now in mg */ x = (((int16_t)((data[0] << 8) | data[1])) >> scale) * sens; y = (((int16_t)((data[2] << 8) | data[3])) >> scale) * sens; z = (((int16_t)((data[4] << 8) | data[5])) >> scale) * sens; lis3dh->acc.x = ((float)x) / 1000.0; lis3dh->acc.y = ((float)y) / 1000.0; lis3dh->acc.z = ((float)z) / 1000.0; return err; } int lis3dh_read_fifo(lis3dh_t *lis3dh, struct lis3dh_fifo_data *fifo) { int32_t x, y, z; uint8_t scale, sens; uint8_t data[192]; /* max size */ int err = 0; int i, idx; /* FIFO is always 10-bit */ scale = 6; sens = acc_sensitivity(lis3dh->cfg.mode, lis3dh->cfg.range); /* fifo buffer is max 32 */ fifo->size = lis3dh->cfg.fifo.fth > 32 ? 32 : lis3dh->cfg.fifo.fth; /* must set MSbit of the address to multi-read and have the device auto-increment the address. see 5.1.5 in datasheet. */ err |= lis3dh->dev.read(REG_OUT_X_L | 0x80, data, 192); for (i=0, idx=0; isize * 6; i+=6, idx++) { x = (((int16_t)((data[i + 0] << 8) | data[i + 1])) >> scale) * sens; y = (((int16_t)((data[i + 2] << 8) | data[i + 3])) >> scale) * sens; z = (((int16_t)((data[i + 4] << 8) | data[i + 5])) >> scale) * sens; fifo->x[idx] = ((float)x) / 1000.0; fifo->y[idx] = ((float)y) / 1000.0; fifo->z[idx] = ((float)z) / 1000.0; } return err; } /* if NULL, this function doesn't have to be called */ int lis3dh_deinit(lis3dh_t *lis3dh) { if (lis3dh->dev.deinit != NULL) { return lis3dh->dev.deinit(); } return 0; } /* read INT1_SRC to clear latched INT1 irq */ int lis3dh_clear_int1(lis3dh_t *lis3dh) { uint8_t res; return lis3dh->dev.read(REG_INT1_SRC, &res, 1); } /* read INT2_SRC to clear latched INT2 irq */ int lis3dh_clear_int2(lis3dh_t *lis3dh) { uint8_t res; return lis3dh->dev.read(REG_INT2_SRC, &res, 1); } /* read REFERENCE reg to reset HP filter in REFERENCE mode it uses the --current-- acceleration as the base in the filter */ int lis3dh_reference(lis3dh_t *lis3dh) { uint8_t res; return lis3dh->dev.read(REG_REFERENCE, &res, 1); }