aboutsummaryrefslogtreecommitdiffstats
path: root/os/various/devices_lib
diff options
context:
space:
mode:
authorgdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>2012-06-19 16:47:09 +0000
committergdisirio <gdisirio@35acf78f-673a-0410-8e92-d51de3d6d3f4>2012-06-19 16:47:09 +0000
commitde6bbbb9eff7592723d401c6340b9e4c78b24953 (patch)
tree7769b2a519686c3a817fbaa7658d7fbfd2f6e637 /os/various/devices_lib
parentcbfc9a5396c2924d6b8fa3c03e4ea8bbda386a15 (diff)
downloadChibiOS-de6bbbb9eff7592723d401c6340b9e4c78b24953.tar.gz
ChibiOS-de6bbbb9eff7592723d401c6340b9e4c78b24953.tar.bz2
ChibiOS-de6bbbb9eff7592723d401c6340b9e4c78b24953.zip
git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@4307 35acf78f-673a-0410-8e92-d51de3d6d3f4
Diffstat (limited to 'os/various/devices_lib')
-rw-r--r--os/various/devices_lib/accel/lis302dl.c123
-rw-r--r--os/various/devices_lib/accel/lis302dl.dox30
-rw-r--r--os/various/devices_lib/accel/lis302dl.h97
3 files changed, 250 insertions, 0 deletions
diff --git a/os/various/devices_lib/accel/lis302dl.c b/os/various/devices_lib/accel/lis302dl.c
new file mode 100644
index 000000000..6a4cb38a8
--- /dev/null
+++ b/os/various/devices_lib/accel/lis302dl.c
@@ -0,0 +1,123 @@
+/*
+ ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,
+ 2011,2012 Giovanni Di Sirio.
+
+ This file is part of ChibiOS/RT.
+
+ ChibiOS/RT is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 3 of the License, or
+ (at your option) any later version.
+
+ ChibiOS/RT is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+
+/**
+ * @file lis302dl.c
+ * @brief LIS302DL MEMS interface module through SPI code.
+ *
+ * @addtogroup lis302dl
+ * @{
+ */
+
+#include "ch.h"
+#include "hal.h"
+#include "lis302dl.h"
+
+/*===========================================================================*/
+/* Driver local definitions. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* Driver exported variables. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* Driver local variables. */
+/*===========================================================================*/
+
+static uint8_t txbuf[2];
+static uint8_t rxbuf[2];
+
+/*===========================================================================*/
+/* Driver local functions. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* Driver exported functions. */
+/*===========================================================================*/
+
+/**
+ * @brief Reads a register value.
+ * @pre The SPI interface must be initialized and the driver started.
+ *
+ * @param[in] spip pointer to the SPI initerface
+ * @param[in] reg register number
+ * @return The register value.
+ */
+uint8_t lis302dlReadRegister(SPIDriver *spip, uint8_t reg) {
+
+ spiSelect(spip);
+ txbuf[0] = 0x80 | reg;
+ txbuf[1] = 0xff;
+ spiExchange(spip, 2, txbuf, rxbuf);
+ spiUnselect(spip);
+ return rxbuf[1];
+}
+
+/**
+ * @brief Writes a value into a register.
+ * @pre The SPI interface must be initialized and the driver started.
+ *
+ * @param[in] spip pointer to the SPI initerface
+ * @param[in] reg register number
+ * @param[in] value the value to be written
+ */
+void lis302dlWriteRegister(SPIDriver *spip, uint8_t reg, uint8_t value) {
+
+ switch (reg) {
+ default:
+ /* Reserved register must not be written, according to the datasheet
+ this could permanently damage the device.*/
+ chDbgAssert(FALSE, "lis302dlWriteRegister(), #1", "reserved register");
+ case LIS302DL_WHO_AM_I:
+ case LIS302DL_HP_FILTER_RESET:
+ case LIS302DL_STATUS_REG:
+ case LIS302DL_OUTX:
+ case LIS302DL_OUTY:
+ case LIS302DL_OUTZ:
+ case LIS302DL_FF_WU_SRC1:
+ case LIS302DL_FF_WU_SRC2:
+ case LIS302DL_CLICK_SRC:
+ /* Read only registers cannot be written, the command is ignored.*/
+ return;
+ case LIS302DL_CTRL_REG1:
+ case LIS302DL_CTRL_REG2:
+ case LIS302DL_CTRL_REG3:
+ case LIS302DL_FF_WU_CFG1:
+ case LIS302DL_FF_WU_THS1:
+ case LIS302DL_FF_WU_DURATION1:
+ case LIS302DL_FF_WU_CFG2:
+ case LIS302DL_FF_WU_THS2:
+ case LIS302DL_FF_WU_DURATION2:
+ case LIS302DL_CLICK_CFG:
+ case LIS302DL_CLICK_THSY_X:
+ case LIS302DL_CLICK_THSZ:
+ case LIS302DL_CLICK_TIMELIMIT:
+ case LIS302DL_CLICK_LATENCY:
+ case LIS302DL_CLICK_WINDOW:
+ spiSelect(spip);
+ txbuf[0] = reg;
+ txbuf[1] = value;
+ spiSend(spip, 2, txbuf);
+ spiUnselect(spip);
+ }
+}
+
+/** @} */
diff --git a/os/various/devices_lib/accel/lis302dl.dox b/os/various/devices_lib/accel/lis302dl.dox
new file mode 100644
index 000000000..85745e4ae
--- /dev/null
+++ b/os/various/devices_lib/accel/lis302dl.dox
@@ -0,0 +1,30 @@
+*
+ ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,
+ 2011,2012 Giovanni Di Sirio.
+
+ This file is part of ChibiOS/RT.
+
+ ChibiOS/RT is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 3 of the License, or
+ (at your option) any later version.
+
+ ChibiOS/RT is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+
+/**
+ * @defgroup lis302dl Interface module for LIS302DL MEMS
+ *
+ * @brief Interface module for LIS302DL MEMS.
+ * @details This module implements a generic interface for the LIS302DL
+ * STMicroelectronics MEMS device. The communication is performed
+ * through a standard SPI driver.
+ *
+ * @ingroup accel
+ */
diff --git a/os/various/devices_lib/accel/lis302dl.h b/os/various/devices_lib/accel/lis302dl.h
new file mode 100644
index 000000000..4263c67e8
--- /dev/null
+++ b/os/various/devices_lib/accel/lis302dl.h
@@ -0,0 +1,97 @@
+/*
+ ChibiOS/RT - Copyright (C) 2006,2007,2008,2009,2010,
+ 2011,2012 Giovanni Di Sirio.
+
+ This file is part of ChibiOS/RT.
+
+ ChibiOS/RT is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 3 of the License, or
+ (at your option) any later version.
+
+ ChibiOS/RT is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+
+/**
+ * @file lis302dl.h
+ * @brief LIS302DL MEMS interface module through SPI header.
+ *
+ * @addtogroup lis302dl
+ * @{
+ */
+
+#ifndef _LIS302DL_H_
+#define _LIS302DL_H_
+
+/*===========================================================================*/
+/* Driver constants. */
+/*===========================================================================*/
+
+/**
+ * @name LIS302DL register names
+ * @{
+ */
+#define LIS302DL_WHO_AM_I 0x0F
+#define LIS302DL_CTRL_REG1 0x20
+#define LIS302DL_CTRL_REG2 0x21
+#define LIS302DL_CTRL_REG3 0x22
+#define LIS302DL_HP_FILTER_RESET 0x23
+#define LIS302DL_STATUS_REG 0x27
+#define LIS302DL_OUTX 0x29
+#define LIS302DL_OUTY 0x2B
+#define LIS302DL_OUTZ 0x2D
+#define LIS302DL_FF_WU_CFG1 0x30
+#define LIS302DL_FF_WU_SRC1 0x31
+#define LIS302DL_FF_WU_THS1 0x32
+#define LIS302DL_FF_WU_DURATION1 0x33
+#define LIS302DL_FF_WU_CFG2 0x34
+#define LIS302DL_FF_WU_SRC2 0x35
+#define LIS302DL_FF_WU_THS2 0x36
+#define LIS302DL_FF_WU_DURATION2 0x37
+#define LIS302DL_CLICK_CFG 0x38
+#define LIS302DL_CLICK_SRC 0x39
+#define LIS302DL_CLICK_THSY_X 0x3B
+#define LIS302DL_CLICK_THSZ 0x3C
+#define LIS302DL_CLICK_TIMELIMIT 0x3D
+#define LIS302DL_CLICK_LATENCY 0x3E
+#define LIS302DL_CLICK_WINDOW 0x3F
+/** @} */
+
+/*===========================================================================*/
+/* Driver pre-compile time settings. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* Derived constants and error checks. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* Driver data structures and types. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* Driver macros. */
+/*===========================================================================*/
+
+/*===========================================================================*/
+/* External declarations. */
+/*===========================================================================*/
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+ uint8_t lis302dlReadRegister(SPIDriver *spip, uint8_t reg);
+ void lis302dlWriteRegister(SPIDriver *spip, uint8_t reg, uint8_t value);
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _LIS302DL_H_ */
+
+/** @} */