/*
$License:
Copyright (C) 2011 InvenSense Corporation, All Rights Reserved.
This program 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 2 of the License, or
(at your option) any later version.
This program 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 .
$
*/
/*
* @addtogroup ACCELDL
* @brief Provides the interface to setup and handle an accelerometer.
*
* @{
* @file bma222.c
* @brief Accelerometer setup and handling methods for Bosch BMA222.
*/
/* ------------------ */
/* - Include Files. - */
/* ------------------ */
#include
#include
#include
#include
#include
#include
#include
#include "mpu-dev.h"
#include
#include "mlsl.h"
#include "mldl_cfg.h"
/* -------------------------------------------------------------------------- */
#define BMA222_STATUS_REG (0x0A)
#define BMA222_FSR_REG (0x0F)
#define ADXL34X_ODR_REG (0x10)
#define BMA222_PWR_REG (0x11)
#define BMA222_SOFTRESET_REG (0x14)
#define BMA222_STATUS_RDY_MASK (0x80)
#define BMA222_FSR_MASK (0x0F)
#define BMA222_ODR_MASK (0x1F)
#define BMA222_PWR_SLEEP_MASK (0x80)
#define BMA222_PWR_AWAKE_MASK (0x00)
#define BMA222_SOFTRESET_MASK (0xB6)
#define BMA222_SOFTRESET_MASK (0xB6)
/* -------------------------------------------------------------------------- */
struct bma222_config {
unsigned int odr; /** < output data rate in mHz */
unsigned int fsr; /** < full scale range mg */
};
struct bma222_private_data {
struct bma222_config suspend; /** < suspend configuration */
struct bma222_config resume; /** < resume configuration */
};
/* -------------------------------------------------------------------------- */
/**
* @brief Set the output data rate for the particular configuration.
*
* @param mlsl_handle
* the handle to the serial channel the device is connected to.
* @param pdata
* a pointer to the slave platform data.
* @param config
* Config to modify with new ODR.
* @param apply
* whether to apply immediately or save the settings to be applied
* at the next resume.
* @param odr
* Output data rate in units of 1/1000Hz (mHz).
*
* @return INV_SUCCESS if successful or a non-zero error code.
*/
static int bma222_set_odr(void *mlsl_handle,
struct ext_slave_platform_data *pdata,
struct bma222_config *config,
int apply,
long odr)
{
int result = INV_SUCCESS;
unsigned char reg_odr;
if (odr >= 1000000) {
reg_odr = 0x0F;
config->odr = 1000000;
} else if (odr >= 500000) {
reg_odr = 0x0E;
config->odr = 500000;
} else if (odr >= 250000) {
reg_odr = 0x0D;
config->odr = 250000;
} else if (odr >= 125000) {
reg_odr = 0x0C;
config->odr = 125000;
} else if (odr >= 62500) {
reg_odr = 0x0B;
config->odr = 62500;
} else if (odr >= 32000) {
reg_odr = 0x0A;
config->odr = 32000;
} else if (odr >= 16000) {
reg_odr = 0x09;
config->odr = 16000;
} else {
reg_odr = 0x08;
config->odr = 8000;
}
if (apply) {
MPL_LOGV("ODR: %d\n", config->odr);
result = inv_serial_single_write(mlsl_handle, pdata->address,
ADXL34X_ODR_REG, reg_odr);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
}
return result;
}
/**
* @brief Set the full scale range of the accels
*
* @param mlsl_handle
* the handle to the serial channel the device is connected to.
* @param pdata
* a pointer to the slave platform data.
* @param config
* pointer to configuration.
* @param apply
* whether to apply immediately or save the settings to be applied
* at the next resume.
* @param fsr
* requested full scale range.
*
* @return INV_SUCCESS if successful or a non-zero error code.
*/
static int bma222_set_fsr(void *mlsl_handle,
struct ext_slave_platform_data *pdata,
struct bma222_config *config,
int apply,
long fsr)
{
int result = INV_SUCCESS;
unsigned char reg_fsr_mask;
if (fsr <= 2000) {
reg_fsr_mask = 0x03;
config->fsr = 2000;
} else if (fsr <= 4000) {
reg_fsr_mask = 0x05;
config->fsr = 4000;
} else if (fsr <= 8000) {
reg_fsr_mask = 0x08;
config->fsr = 8000;
} else { /* 8001 -> oo */
reg_fsr_mask = 0x0C;
config->fsr = 16000;
}
if (apply) {
MPL_LOGV("FSR: %d\n", config->fsr);
result = inv_serial_single_write(mlsl_handle, pdata->address,
BMA222_FSR_REG, reg_fsr_mask);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
}
return result;
}
/**
* @brief one-time device driver initialization function.
* If the driver is built as a kernel module, this function will be
* called when the module is loaded in the kernel.
* If the driver is built-in in the kernel, this function will be
* called at boot time.
*
* @param mlsl_handle
* the handle to the serial channel the device is connected to.
* @param slave
* a pointer to the slave descriptor data structure.
* @param pdata
* a pointer to the slave platform data.
*
* @return INV_SUCCESS if successful or a non-zero error code.
*/
static int bma222_init(void *mlsl_handle,
struct ext_slave_descr *slave,
struct ext_slave_platform_data *pdata)
{
int result;
struct bma222_private_data *private_data;
private_data = (struct bma222_private_data *)
kzalloc(sizeof(struct bma222_private_data), GFP_KERNEL);
if (!private_data)
return INV_ERROR_MEMORY_EXAUSTED;
pdata->private_data = private_data;
result = inv_serial_single_write(mlsl_handle, pdata->address,
BMA222_SOFTRESET_REG, BMA222_SOFTRESET_MASK);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
msleep(1);
result = bma222_set_odr(mlsl_handle, pdata, &private_data->suspend,
false, 0);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
result = bma222_set_odr(mlsl_handle, pdata, &private_data->resume,
false, 200000);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
result = bma222_set_fsr(mlsl_handle, pdata, &private_data->suspend,
false, 2000);
result = bma222_set_fsr(mlsl_handle, pdata, &private_data->resume,
false, 2000);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
result = inv_serial_single_write(mlsl_handle, pdata->address,
BMA222_PWR_REG, BMA222_PWR_SLEEP_MASK);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
return result;
}
/**
* @brief one-time device driver exit function.
* If the driver is built as a kernel module, this function will be
* called when the module is removed from the kernel.
*
* @param mlsl_handle
* the handle to the serial channel the device is connected to.
* @param slave
* a pointer to the slave descriptor data structure.
* @param pdata
* a pointer to the slave platform data.
*
* @return INV_SUCCESS if successful or a non-zero error code.
*/
static int bma222_exit(void *mlsl_handle,
struct ext_slave_descr *slave,
struct ext_slave_platform_data *pdata)
{
kfree(pdata->private_data);
return INV_SUCCESS;
}
/**
* @brief facility to retrieve the device configuration.
*
* @param mlsl_handle
* the handle to the serial channel the device is connected to.
* @param slave
* a pointer to the slave descriptor data structure.
* @param pdata
* a pointer to the slave platform data.
* @param data
* a pointer to store the returned configuration data structure.
*
* @return INV_SUCCESS if successful or a non-zero error code.
*/
static int bma222_get_config(void *mlsl_handle,
struct ext_slave_descr *slave,
struct ext_slave_platform_data *pdata,
struct ext_slave_config *data)
{
struct bma222_private_data *private_data =
(struct bma222_private_data *)(pdata->private_data);
if (!data->data)
return INV_ERROR_INVALID_PARAMETER;
switch (data->key) {
case MPU_SLAVE_CONFIG_ODR_SUSPEND:
(*(unsigned long *)data->data) =
(unsigned long) private_data->suspend.odr;
break;
case MPU_SLAVE_CONFIG_ODR_RESUME:
(*(unsigned long *)data->data) =
(unsigned long) private_data->resume.odr;
break;
case MPU_SLAVE_CONFIG_FSR_SUSPEND:
(*(unsigned long *)data->data) =
(unsigned long) private_data->suspend.fsr;
break;
case MPU_SLAVE_CONFIG_FSR_RESUME:
(*(unsigned long *)data->data) =
(unsigned long) private_data->resume.fsr;
break;
case MPU_SLAVE_CONFIG_IRQ_SUSPEND:
case MPU_SLAVE_CONFIG_IRQ_RESUME:
default:
return INV_ERROR_FEATURE_NOT_IMPLEMENTED;
};
return INV_SUCCESS;
}
/**
* @brief device configuration facility.
*
* @param mlsl_handle
* the handle to the serial channel the device is connected to.
* @param slave
* a pointer to the slave descriptor data structure.
* @param pdata
* a pointer to the slave platform data.
* @param data
* a pointer to the configuration data structure.
*
* @return INV_SUCCESS if successful or a non-zero error code.
*/
static int bma222_config(void *mlsl_handle,
struct ext_slave_descr *slave,
struct ext_slave_platform_data *pdata,
struct ext_slave_config *data)
{
struct bma222_private_data *private_data =
(struct bma222_private_data *)(pdata->private_data);
if (!data->data)
return INV_ERROR_INVALID_PARAMETER;
switch (data->key) {
case MPU_SLAVE_CONFIG_ODR_SUSPEND:
return bma222_set_odr(mlsl_handle, pdata,
&private_data->suspend,
data->apply,
*((long *)data->data));
case MPU_SLAVE_CONFIG_ODR_RESUME:
return bma222_set_odr(mlsl_handle, pdata,
&private_data->resume,
data->apply,
*((long *)data->data));
case MPU_SLAVE_CONFIG_FSR_SUSPEND:
return bma222_set_fsr(mlsl_handle, pdata,
&private_data->suspend,
data->apply,
*((long *)data->data));
case MPU_SLAVE_CONFIG_FSR_RESUME:
return bma222_set_fsr(mlsl_handle, pdata,
&private_data->resume,
data->apply,
*((long *)data->data));
case MPU_SLAVE_CONFIG_IRQ_SUSPEND:
case MPU_SLAVE_CONFIG_IRQ_RESUME:
default:
return INV_ERROR_FEATURE_NOT_IMPLEMENTED;
};
return INV_SUCCESS;
}
/**
* @brief suspends the device to put it in its lowest power mode.
*
* @param mlsl_handle
* the handle to the serial channel the device is connected to.
* @param slave
* a pointer to the slave descriptor data structure.
* @param pdata
* a pointer to the slave platform data.
*
* @return INV_SUCCESS if successful or a non-zero error code.
*/
static int bma222_suspend(void *mlsl_handle,
struct ext_slave_descr *slave,
struct ext_slave_platform_data *pdata)
{
int result;
struct bma222_config *suspend_config =
&((struct bma222_private_data *)pdata->private_data)->suspend;
result = bma222_set_odr(mlsl_handle, pdata, suspend_config,
true, suspend_config->odr);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
result = bma222_set_fsr(mlsl_handle, pdata, suspend_config,
true, suspend_config->fsr);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
result = inv_serial_single_write(mlsl_handle, pdata->address,
BMA222_PWR_REG, BMA222_PWR_SLEEP_MASK);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
msleep(3); /* 3 ms powerup time maximum */
return result;
}
/**
* @brief resume the device in the proper power state given the configuration
* chosen.
*
* @param mlsl_handle
* the handle to the serial channel the device is connected to.
* @param slave
* a pointer to the slave descriptor data structure.
* @param pdata
* a pointer to the slave platform data.
*
* @return INV_SUCCESS if successful or a non-zero error code.
*/
static int bma222_resume(void *mlsl_handle,
struct ext_slave_descr *slave,
struct ext_slave_platform_data *pdata)
{
int result;
struct bma222_config *resume_config =
&((struct bma222_private_data *)pdata->private_data)->resume;
/* Soft reset */
result = inv_serial_single_write(mlsl_handle, pdata->address,
BMA222_SOFTRESET_REG, BMA222_SOFTRESET_MASK);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
msleep(10);
result = bma222_set_odr(mlsl_handle, pdata, resume_config,
true, resume_config->odr);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
result = bma222_set_fsr(mlsl_handle, pdata, resume_config,
true, resume_config->fsr);
if (result) {
LOG_RESULT_LOCATION(result);
return result;
}
return result;
}
/**
* @brief read the sensor data from the device.
*
* @param mlsl_handle
* the handle to the serial channel the device is connected to.
* @param slave
* a pointer to the slave descriptor data structure.
* @param pdata
* a pointer to the slave platform data.
* @param data
* a buffer to store the data read.
*
* @return INV_SUCCESS if successful or a non-zero error code.
*/
static int bma222_read(void *mlsl_handle,
struct ext_slave_descr *slave,
struct ext_slave_platform_data *pdata,
unsigned char *data)
{
int result = INV_SUCCESS;
result = inv_serial_read(mlsl_handle, pdata->address,
BMA222_STATUS_REG, 1, data);
if (data[0] & BMA222_STATUS_RDY_MASK) {
result = inv_serial_read(mlsl_handle, pdata->address,
slave->read_reg, slave->read_len, data);
return result;
} else
return INV_ERROR_ACCEL_DATA_NOT_READY;
}
static struct ext_slave_descr bma222_descr = {
.init = bma222_init,
.exit = bma222_exit,
.suspend = bma222_suspend,
.resume = bma222_resume,
.read = bma222_read,
.config = bma222_config,
.get_config = bma222_get_config,
.name = "bma222",
.type = EXT_SLAVE_TYPE_ACCEL,
.id = ACCEL_ID_BMA222,
.read_reg = 0x02,
.read_len = 6,
.endian = EXT_SLAVE_LITTLE_ENDIAN,
.range = {2, 0},
.trigger = NULL,
};
static
struct ext_slave_descr *bma222_get_slave_descr(void)
{
return &bma222_descr;
}
/* -------------------------------------------------------------------------- */
struct bma222_mod_private_data {
struct i2c_client *client;
struct ext_slave_platform_data *pdata;
};
static unsigned short normal_i2c[] = { I2C_CLIENT_END };
static int bma222_mod_probe(struct i2c_client *client,
const struct i2c_device_id *devid)
{
struct ext_slave_platform_data *pdata;
struct bma222_mod_private_data *private_data;
int result = 0;
dev_info(&client->adapter->dev, "%s: %s\n", __func__, devid->name);
if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C)) {
result = -ENODEV;
goto out_no_free;
}
pdata = client->dev.platform_data;
if (!pdata) {
dev_err(&client->adapter->dev,
"Missing platform data for slave %s\n", devid->name);
result = -EFAULT;
goto out_no_free;
}
private_data = kzalloc(sizeof(*private_data), GFP_KERNEL);
if (!private_data) {
result = -ENOMEM;
goto out_no_free;
}
i2c_set_clientdata(client, private_data);
private_data->client = client;
private_data->pdata = pdata;
result = inv_mpu_register_slave(THIS_MODULE, client, pdata,
bma222_get_slave_descr);
if (result) {
dev_err(&client->adapter->dev,
"Slave registration failed: %s, %d\n",
devid->name, result);
goto out_free_memory;
}
return result;
out_free_memory:
kfree(private_data);
out_no_free:
dev_err(&client->adapter->dev, "%s failed %d\n", __func__, result);
return result;
}
static int bma222_mod_remove(struct i2c_client *client)
{
struct bma222_mod_private_data *private_data =
i2c_get_clientdata(client);
dev_dbg(&client->adapter->dev, "%s\n", __func__);
inv_mpu_unregister_slave(client, private_data->pdata,
bma222_get_slave_descr);
kfree(private_data);
return 0;
}
static const struct i2c_device_id bma222_mod_id[] = {
{ "bma222", ACCEL_ID_BMA222 },
{}
};
MODULE_DEVICE_TABLE(i2c, bma222_mod_id);
static struct i2c_driver bma222_mod_driver = {
.class = I2C_CLASS_HWMON,
.probe = bma222_mod_probe,
.remove = bma222_mod_remove,
.id_table = bma222_mod_id,
.driver = {
.owner = THIS_MODULE,
.name = "bma222_mod",
},
.address_list = normal_i2c,
};
static int __init bma222_mod_init(void)
{
int res = i2c_add_driver(&bma222_mod_driver);
pr_info("%s: Probe name %s\n", __func__, "bma222_mod");
if (res)
pr_err("%s failed\n", __func__);
return res;
}
static void __exit bma222_mod_exit(void)
{
pr_info("%s\n", __func__);
i2c_del_driver(&bma222_mod_driver);
}
module_init(bma222_mod_init);
module_exit(bma222_mod_exit);
MODULE_AUTHOR("Invensense Corporation");
MODULE_DESCRIPTION("Driver to integrate BMA222 sensor with the MPU");
MODULE_LICENSE("GPL");
MODULE_ALIAS("bma222_mod");
/**
* @}
*/