forked from kcozens/avrlib-2014
-
Notifications
You must be signed in to change notification settings - Fork 0
/
lis3l02.h
127 lines (111 loc) · 6.2 KB
/
lis3l02.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
/*! \file lis3l02.h \brief ST LIS3L02 3-axis I2C Accelerometer Library. */
//*****************************************************************************
//
// File Name : 'lis3l02.h'
// Title : ST LIS3L02 3-axis I2C Accelerometer Library
// Author : Pascal Stang - Copyright (C) 2004
// Created : 2004.10.23
// Revised : 2004.12.14
// Version : 0.1
// Target MCU : Atmel AVR Series
// Editor Tabs : 4
//
// NOTE: This code is currently below version 1.0, and therefore is considered
// to be lacking in some functionality or documentation, or may not be fully
// tested. Nonetheless, you can expect most functions to work.
//
/// \ingroup driver_hw
/// \defgroup lis3l02 ST LIS3L02 3-axis I2C Accelerometer Library (lis3l02.c)
/// \code #include "lis3l02.h" \endcode
/// \par Overview
/// This library provides an interface to the ST LIS3L02 integrated 3-axis
/// accelerometer. The LIS3L02 has a built-in A/D converter to capture analog
/// acceleration data and make it available over an I2C interface.
//
// This code is distributed under the GNU Public License
// which can be found at http://www.gnu.org/licenses/gpl.txt
//
//*****************************************************************************
#ifndef LIS3L02_H
#define LIS3L02_H
#include "global.h"
// constants/macros/typdefs
#define LIS3L02_I2C_ADDR 0x3A ///< Base I2C address of LIS3L02 device
// LIS3L02 register address defines
#define LIS3L02_REG_OFFSETX 0x16 ///< LIS3L02 X-axis digital offset trim
#define LIS3L02_REG_OFFSETY 0x17 ///< LIS3L02 Y-axis digital offset trim
#define LIS3L02_REG_OFFSETZ 0x18 ///< LIS3L02 Z-axis digital offset trim
#define LIS3L02_REG_GAINX 0x19 ///< LIS3L02 X-axis digital gain trim
#define LIS3L02_REG_GAINY 0x1A ///< LIS3L02 Y-axis digital gain trim
#define LIS3L02_REG_GAINZ 0x1B ///< LIS3L02 Z-axis digital gain trim
#define LIS3L02_REG_CTRLREG1 0x20 ///< LIS3L02 interface/operation control
#define LIS3L02_REG_CTRLREG2 0x21 ///< LIS3L02 interface/operation control
#define LIS3L02_REG_WAKEUPCFG 0x23 ///< LIS3L02 interrupt/wakeup config
#define LIS3L02_REG_WAKEUPSRC 0x24 ///< LIS3L02 interrupt/wakeup source indicator
#define LIS3L02_REG_WAKEUPACK 0x25 ///< LIS3L02 wakeup source clear
#define LIS3L02_REG_STATUS 0x27 ///< LIS3L02 Accelerometer Status
#define LIS3L02_REG_OUTXL 0x28 ///< LIS3L02 Accelerometer X Output Low-byte
#define LIS3L02_REG_OUTXH 0x29 ///< LIS3L02 Accelerometer X Output High-byte
#define LIS3L02_REG_OUTYL 0x2A ///< LIS3L02 Accelerometer Y Output Low-byte
#define LIS3L02_REG_OUTYH 0x2B ///< LIS3L02 Accelerometer Y Output High-byte
#define LIS3L02_REG_OUTZL 0x2C ///< LIS3L02 Accelerometer Z Output Low-byte
#define LIS3L02_REG_OUTZH 0x2D ///< LIS3L02 Accelerometer Z Output High-byte
#define LIS3L02_REG_THSL 0x2E ///< LIS3L02 Accelerometer Threshold Low-byte
#define LIS3L02_REG_THSH 0x2F ///< LIS3L02 Accelerometer Threshold High-byte
#define LIS3L02_REG_MULTIREAD 0x80 ///< LIS3L02 Mutliple Read Bit
// LIS3L02 control register 1 bit defines
#define LIS3L02_CTRLREG1_XEN 0x01 ///< LIS3L02 CtrlReg1 X-axis Enable
#define LIS3L02_CTRLREG1_YEN 0x02 ///< LIS3L02 CtrlReg1 Y-axis Enable
#define LIS3L02_CTRLREG1_ZEN 0x04 ///< LIS3L02 CtrlReg1 Z-axis Enable
#define LIS3L02_CTRLREG1_ST 0x08 ///< LIS3L02 CtrlReg1 Self-Test Enable
#define LIS3L02_CTRLREG1_DF0 0x10 ///< LIS3L02 CtrlReg1 Decimation Factor 0
#define LIS3L02_CTRLREG1_DF1 0x20 ///< LIS3L02 CtrlReg1 Decimation Factor 0
#define LIS3L02_CTRLREG1_PD0 0x40 ///< LIS3L02 CtrlReg1 Power-down Control 0
#define LIS3L02_CTRLREG1_PD1 0x80 ///< LIS3L02 CtrlReg1 Power-down Control 1
// LIS3L02 control register 2 bit defines
#define LIS3L02_CTRLREG2_DAS 0x01 ///< LIS3L02 CtrlReg2 Data Alignment Selection
#define LIS3L02_CTRLREG2_SIM 0x02 ///< LIS3L02 CtrlReg2 SPI Mode Select
#define LIS3L02_CTRLREG2_DRDY 0x04 ///< LIS3L02 CtrlReg2 Enable Data-Ready generation
#define LIS3L02_CTRLREG2_IEN 0x08 ///< LIS3L02 CtrlReg2 Interrupt Enable
#define LIS3L02_CTRLREG2_BOOT 0x10 ///< LIS3L02 CtrlReg2 Reboot from memory
#define LIS3L02_CTRLREG2_FS 0x80 ///< LIS3L02 CtrlReg2 Full-scale Select (0=2g, 1=6g)
// LIS3L02 WAKEUPCFG register bit defines
#define LIS3L02_WAKEUPCFG_MXL 0x01 ///< LIS3L02 WAKEUPCFG Mask X Low Interrupt
#define LIS3L02_WAKEUPCFG_MXH 0x02 ///< LIS3L02 WAKEUPCFG Mask X High Interrupt
#define LIS3L02_WAKEUPCFG_MYL 0x04 ///< LIS3L02 WAKEUPCFG Mask Y Low Interrupt
#define LIS3L02_WAKEUPCFG_MYH 0x08 ///< LIS3L02 WAKEUPCFG Mask Y High Interrupt
#define LIS3L02_WAKEUPCFG_MZL 0x10 ///< LIS3L02 WAKEUPCFG Mask Z Low Interrupt
#define LIS3L02_WAKEUPCFG_MZH 0x20 ///< LIS3L02 WAKEUPCFG Mask Z High Interrupt
#define LIS3L02_WAKEUPCFG_LIR 0x40 ///< LIS3L02 WAKEUPCFG Latch Intr Request
// LIS3L02 WAKEUPSRC register bit defines
#define LIS3L02_WAKEUPSRC_XL 0x01 ///< LIS3L02 WAKEUPSRC X Low Interrupt
#define LIS3L02_WAKEUPSRC_XH 0x02 ///< LIS3L02 WAKEUPSRC X High Interrupt
#define LIS3L02_WAKEUPSRC_YL 0x04 ///< LIS3L02 WAKEUPSRC Y Low Interrupt
#define LIS3L02_WAKEUPSRC_YH 0x08 ///< LIS3L02 WAKEUPSRC Y High Interrupt
#define LIS3L02_WAKEUPSRC_ZL 0x10 ///< LIS3L02 WAKEUPSRC Z Low Interrupt
#define LIS3L02_WAKEUPSRC_ZH 0x20 ///< LIS3L02 WAKEUPSRC Z High Interrupt
#define LIS3L02_WAKEUPSRC_IA 0x40 ///< LIS3L02 WAKEUPSRC Interrupt Active
// LIS3L02 WAKEUPSRC register bit defines
#define LIS3L02_STATUS_XDA 0x01 ///< LIS3L02 STATUS X New Data Available
#define LIS3L02_STATUS_YDA 0x02 ///< LIS3L02 STATUS Y New Data Available
#define LIS3L02_STATUS_ZDA 0x04 ///< LIS3L02 STATUS Z New Data Available
#define LIS3L02_STATUS_ZYXDA 0x08 ///< LIS3L02 STATUS XYZ New Data Available
#define LIS3L02_STATUS_XOR 0x10 ///< LIS3L02 STATUS X-axis Data Overrun
#define LIS3L02_STATUS_YOR 0x20 ///< LIS3L02 STATUS Y-axis Data Overrun
#define LIS3L02_STATUS_ZOR 0x40 ///< LIS3L02 STATUS Z-axis Data Overrun
#define LIS3L02_STATUS_ZYXOR 0x80 ///< LIS3L02 STATUS XYZ-axis Data Overrun
// functions
//! Initialize the LIS3L02 chip.
/// returns:
/// 0 if successful,
/// non-zero if unsuccessful (chip not present).
u08 lis3l02Init(void);
//! Reset the LIS3L02 chip.
u08 lis3l02Reset(void);
//! Read a LIS3L02 register.
u08 lis3l02ReadReg(u08 reg);
//! Write a LIS3L02 register.
u08 lis3l02WriteReg(u08 reg, u08 data);
//! Get an acceleration reading from the LIS3L02 sensor.
s16 lis3l02GetAccel(u08 chxyz);
#endif