incubator-nuttx/drivers/sensors/adxl345_base.c

458 lines
13 KiB
C

/****************************************************************************
* drivers/sensors/adxl345_base.c
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership. The
* ASF licenses this file to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*
****************************************************************************/
/****************************************************************************
* Included Files
****************************************************************************/
#include <nuttx/config.h>
#include <unistd.h>
#include <errno.h>
#include <debug.h>
#include <stdio.h>
#include <nuttx/kmalloc.h>
#include <nuttx/signal.h>
#include <nuttx/random.h>
#include <nuttx/sensors/adxl345.h>
#include "adxl345.h"
#if defined(CONFIG_SENSORS_ADXL345)
/****************************************************************************
* Private Types
****************************************************************************/
/****************************************************************************
* Private Functions
****************************************************************************/
/* Character driver methods */
static int adxl345_open(FAR struct file *filep);
static int adxl345_close(FAR struct file *filep);
static ssize_t adxl345_read(FAR struct file *filep, FAR char *buffer,
size_t len);
/****************************************************************************
* Private Data
****************************************************************************/
/* This the vtable that supports the character driver interface */
static const struct file_operations g_adxl345fops =
{
adxl345_open, /* open */
adxl345_close, /* close */
adxl345_read, /* read */
0, /* write */
0, /* seek */
0, /* ioctl */
};
/****************************************************************************
* Name: adxl345_open
*
* Description:
* Standard character driver open method.
*
****************************************************************************/
static int adxl345_open(FAR struct file *filep)
{
return OK;
}
/****************************************************************************
* Name: adxl345_close
*
* Description:
* Standard character driver close method.
*
****************************************************************************/
static int adxl345_close(FAR struct file *filep)
{
return OK;
}
/****************************************************************************
* Name: adxl345_read
*
* Description:
* Standard character driver read method.
*
****************************************************************************/
static ssize_t adxl345_read(FAR struct file *filep,
FAR char *buffer, size_t len)
{
FAR struct inode *inode;
FAR struct adxl345_dev_s *priv;
struct adxl345_sample_s sample;
int ret;
sninfo("len=%d\n", len);
DEBUGASSERT(filep);
inode = filep->f_inode;
DEBUGASSERT(inode && inode->i_private);
priv = (FAR struct adxl345_dev_s *)inode->i_private;
/* Verify that the caller has provided a buffer large enough to receive
* the accelerometer data.
*/
if (len < sizeof(struct adxl345_sample_s))
{
/* We could provide logic to break up a sample into segments and
* handle smaller reads... but why?
*/
return -ENOSYS;
}
/* Get exclusive access to the driver data structure */
ret = nxsem_wait(&priv->exclsem);
if (ret < 0)
{
return ret;
}
/* Read accelerometer X Y Z axes */
sample.data_x = adxl345_getreg8(priv, ADXL345_DATAX1);
sample.data_x = (sample.data_x << 8) |
adxl345_getreg8(priv, ADXL345_DATAX0);
sample.data_y = adxl345_getreg8(priv, ADXL345_DATAY1);
sample.data_y = (sample.data_y << 8) |
adxl345_getreg8(priv, ADXL345_DATAY0);
sample.data_z = adxl345_getreg8(priv, ADXL345_DATAZ1);
sample.data_z = (sample.data_z << 8) |
adxl345_getreg8(priv, ADXL345_DATAZ0);
add_sensor_randomness(sample.data_x);
add_sensor_randomness((sample.data_z << 16) | sample.data_y);
/* Return read sample */
buffer = (FAR char *) &sample;
nxsem_post(&priv->exclsem);
return sizeof(struct adxl345_sample_s);
}
/****************************************************************************
* Name: adxl345_register
*
* Description:
* This function will register the accelerometer driver as /dev/accelN where
* N is the minor device number
*
* Input Parameters:
* handle - The handle previously returned by adxl345_register
* minor - The input device minor number
*
* Returned Value:
* Zero is returned on success. Otherwise, a negated errno value is
* returned to indicate the nature of the failure.
*
****************************************************************************/
int adxl345_register(ADXL345_HANDLE handle, int minor)
{
FAR struct adxl345_dev_s *priv = (FAR struct adxl345_dev_s *)handle;
char devname[DEV_NAMELEN];
int ret;
sninfo("handle=%p minor=%d\n", handle, minor);
DEBUGASSERT(priv);
/* Get exclusive access to the device structure */
ret = nxsem_wait(&priv->exclsem);
if (ret < 0)
{
snerr("ERROR: nxsem_wait failed: %d\n", ret);
return ret;
}
/* Initialize the structure fields to their default values */
priv->ofsx = 0;
priv->ofsy = 0;
priv->ofsz = 0;
/* Register the character driver */
snprintf(devname, DEV_NAMELEN, DEV_FORMAT, minor);
ret = register_driver(devname, &g_adxl345fops, 0666, priv);
if (ret < 0)
{
snerr("ERROR: Failed to register driver %s: %d\n", devname, ret);
nxsem_post(&priv->exclsem);
return ret;
}
/* Indicate that the accelerometer was successfully initialized */
priv->status |= ADXL345_STAT_INITIALIZED; /* Accelerometer is initialized */
nxsem_post(&priv->exclsem);
return ret;
}
/****************************************************************************
* Name: adxl345_worker
*
* Description:
* This is the "bottom half" of the ADXL345 interrupt handler
*
****************************************************************************/
static void adxl345_worker(FAR void *arg)
{
FAR struct adxl345_dev_s *priv = (FAR struct adxl345_dev_s *)arg;
uint8_t regval;
DEBUGASSERT(priv && priv->config);
/* Get the global interrupt status */
regval = adxl345_getreg8(priv, ADXL345_INT_SOURCE);
/* Check for a data ready interrupt */
if ((regval & INT_DATA_READY) != 0)
{
/* Read accelerometer data to sample */
priv->sample.data_x = adxl345_getreg8(priv, ADXL345_DATAX1);
priv->sample.data_x = (priv->sample.data_x << 8) |
adxl345_getreg8(priv, ADXL345_DATAX0);
priv->sample.data_y = adxl345_getreg8(priv, ADXL345_DATAY1);
priv->sample.data_y = (priv->sample.data_y << 8) |
adxl345_getreg8(priv, ADXL345_DATAY0);
priv->sample.data_z = adxl345_getreg8(priv, ADXL345_DATAZ1);
priv->sample.data_z = (priv->sample.data_z << 8) |
adxl345_getreg8(priv, ADXL345_DATAZ0);
}
/* Re-enable the ADXL345 GPIO interrupt */
priv->config->enable(priv->config, true);
}
/****************************************************************************
* Name: adxl345_interrupt
*
* Description:
* The ADXL345 interrupt handler
*
****************************************************************************/
static void adxl345_interrupt(FAR struct adxl345_config_s *config,
FAR void *arg)
{
FAR struct adxl345_dev_s *priv = (FAR struct adxl345_dev_s *)arg;
int ret;
DEBUGASSERT(priv && priv->config == config);
/* Disable further interrupts */
config->enable(config, false);
/* Check if interrupt work is already queue. If it is already busy, then
* we already have interrupt processing in the pipeline and we need to do
* nothing more.
*/
if (work_available(&priv->work))
{
/* Yes.. Transfer processing to the worker thread. Since ADXL345
* interrupts are disabled while the work is pending, no special
* action should be required to protect the work queue.
*/
ret = work_queue(HPWORK, &priv->work, adxl345_worker, priv, 0);
if (ret != 0)
{
snerr("ERROR: Failed to queue work: %d\n", ret);
}
}
/* Clear any pending interrupts and return success */
config->clear(config);
}
/****************************************************************************
* Name: adxl345_checkid
*
* Description:
* Read and verify the ADXL345 chip ID
*
****************************************************************************/
static int adxl345_checkid(FAR struct adxl345_dev_s *priv)
{
uint8_t devid = 0;
/* Read device ID */
devid = adxl345_getreg8(priv, ADXL345_DEVID);
sninfo("devid: %04x\n", devid);
if (devid != (uint16_t) DEVID)
{
/* ID is not Correct */
return -ENODEV;
}
return OK;
}
/****************************************************************************
* Name: adxl345_reset
*
* Description:
* Reset the ADXL345
*
****************************************************************************/
static void adxl345_reset(FAR struct adxl345_dev_s *priv)
{
/* ADXL345 doesn't have software reset */
/* Wait a bit to make the GOD of TIME happy */
nxsig_usleep(20 * 1000);
}
/****************************************************************************
* Public Functions
****************************************************************************/
/****************************************************************************
* Name: adxl345_instantiate
*
* Description:
* Instantiate and configure the ADXL345 device driver to use the provided
* I2C or SPIdevice instance.
*
* Input Parameters:
* dev - An I2C or SPI driver instance
* config - Persistent board configuration data
*
* Returned Value:
* A non-zero handle is returned on success. This handle may then be used
* to configure the ADXL345 driver as necessary. A NULL handle value is
* returned on failure.
*
****************************************************************************/
#ifdef CONFIG_ADXL345_SPI
ADXL345_HANDLE adxl345_instantiate(FAR struct spi_dev_s *dev,
FAR struct adxl345_config_s *config)
#else
ADXL345_HANDLE adxl345_instantiate(FAR struct i2c_master_s *dev,
FAR struct adxl345_config_s *config)
#endif
{
FAR struct adxl345_dev_s *priv;
uint8_t regval;
int ret;
/* Allocate the ADXL345 driver instance */
priv = (FAR struct adxl345_dev_s *)
kmm_zalloc(sizeof(struct adxl345_dev_s));
if (!priv)
{
snerr("ERROR: Failed to allocate the device structure!\n");
return NULL;
}
/* Initialize the device state structure */
nxsem_init(&priv->exclsem, 0, 1);
priv->config = config;
#ifdef CONFIG_ADXL345_SPI
priv->spi = dev;
#else
priv->i2c = dev;
#endif
/* Read and verify the ADXL345 device ID */
ret = adxl345_checkid(priv);
if (ret < 0)
{
snerr("ERROR: Wrong Device ID!\n");
kmm_free(priv);
return NULL;
}
/* Generate ADXL345 Software reset */
adxl345_reset(priv);
/* Configure the interrupt output pin to generate interrupts on high or low
* level.
*/
regval = adxl345_getreg8(priv, ADXL345_DATA_FORMAT);
#ifdef CONFIG_ADXL345_ACTIVELOW
regval |= DATA_FMT_INT_INVERT; /* Pin polarity: Active low / falling edge */
#else
regval &= ~DATA_FMT_INT_INVERT; /* Pin polarity: Active high / rising edge */
#endif
adxl345_putreg8(priv, ADXL345_DATA_FORMAT, regval);
/* Attach the ADXL345 interrupt handler. */
config->attach(config,
(adxl345_handler_t)adxl345_interrupt,
(FAR void *)priv);
/* Leave standby mode */
adxl345_putreg8(priv, ADXL345_POWER_CTL, POWER_CTL_MEASURE);
config->clear(config);
config->enable(config, true);
/* Enable interrupts */
adxl345_putreg8(priv, ADXL345_INT_ENABLE, INT_DATA_READY);
/* Return our private data structure as an opaque handle */
return (ADXL345_HANDLE)priv;
}
#endif /* CONFIG_SENSORS_ADXL345 */