riot-ci/RIOT
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

drivers/isl29125: update parameter definition scheme

Browse Source
This commit is contained in:
Michel Rottleuthner 2018-06-21 14:31:46 +02:00 committed by dylad
parent 3f34e32617
commit e5976ad497
4 changed files with 132 additions and 65 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
drivers/include/isl29125.h
View File

@ -100,13 +100,21 @@ typedef enum {
} isl29125_resolution_t;
/**
* @brief Device descriptor for ISL29125 sensors
* @brief Device parameters for ISL29125 sensors
*/
typedef struct {
i2c_t i2c; /**< I2C device the sensor is connected to */
gpio_t gpio; /**< GPIO pin for interrupt/sync mode */
isl29125_range_t range; /**< sensor range */
isl29125_resolution_t res; /**< sensor resolution */
isl29125_range_t range; /**< measurement range */
isl29125_mode_t mode; /**< AD conversion mode */
isl29125_resolution_t res; /**< AD conversion resolution */
} isl29125_params_t;
/**
* @brief Device descriptor for ISL29125 sensors
*/
typedef struct {
isl29125_params_t params; /**< device parameters */
} isl29125_t;
/**
@ -141,18 +149,12 @@ typedef enum {
* @brief Initialize a new ISL29125 device
*
* @param[in] dev device descriptor of an ISL29125 device
* @param[in] i2c I2C device the sensor is connected to
* @param[in] gpio GPIO pin for interrupt/sync mode (currently unused)
* @param[in] mode operation mode
* @param[in] range measurement range
* @param[in] resolution AD conversion resolution
* @param[in] params initialization parameters
*
* @return 0 on success
* @return -1 on error
* @return 0 on success
* @return -1 on error
*/
int isl29125_init(isl29125_t *dev, i2c_t i2c, gpio_t gpio,
isl29125_mode_t mode, isl29125_range_t range,
isl29125_resolution_t resolution);
int isl29125_init(isl29125_t *dev, const isl29125_params_t *params);
/**
* @brief Initialize interrupts

73
drivers/isl29125/include/isl29125_params.h Normal file
View File

@ -0,0 +1,73 @@
/*
* Copyright (C) 2017 Freie Universität Berlin
* Copyright (C) 2018 HAW-Hamburg
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup drivers_isl29125
*
* @{
* @file
* @brief Default configuration for ISL29125 devices
*
* @author Hauke Petersen <hauke.petersen@fu-berlin.de>
* @author Michel Rottleuthner <michel.rottleuthner@haw-hamburg.de>
*/
#ifndef ISL29125_PARAMS_H
#define ISL29125_PARAMS_H
#include "board.h"
#include "isl29125.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Set default configuration parameters
* @{
*/
#ifndef ISL29125_PARAM_I2C
#define ISL29125_PARAM_I2C I2C_DEV(0)
#endif
#ifndef ISL29125_PARAM_GPIO
#define ISL29125_PARAM_GPIO (GPIO_PIN(0, 0))
#endif
#ifndef ISL29125_PARAM_RANGE
#define ISL29125_PARAM_RANGE (ISL29125_RANGE_10K)
#endif
#ifndef ISL29125_PARAM_MODE
#define ISL29125_PARAM_MODE (ISL29125_MODE_RGB)
#endif
#ifndef ISL29125_PARAM_RES
#define ISL29125_PARAM_RES (ISL29125_RESOLUTION_16)
#endif
#ifndef ISL29125_PARAMS
#define ISL29125_PARAMS { .i2c = ISL29125_PARAM_I2C, \
.gpio = ISL29125_PARAM_GPIO, \
.range = ISL29125_PARAM_RANGE, \
.mode = ISL29125_PARAM_MODE, \
.res = ISL29125_PARAM_RES }
#endif
/**@}*/
/**
* @brief Allocate some memory to store the actual configuration
*/
static const isl29125_params_t isl29125_params[] =
{
ISL29125_PARAMS
};
#ifdef __cplusplus
}
#endif
#endif /* ISL29125_PARAMS_H */
/** @} */

81
drivers/isl29125/isl29125.c
View File

@ -32,62 +32,63 @@
#define ENABLE_DEBUG (0)
#include "debug.h"
#define DEV_I2C (dev->params.i2c)
#define DEV_GPIO (dev->params.gpio)
#define DEV_RANGE (dev->params.range)
#define DEV_MODE (dev->params.mode)
#define DEV_RES (dev->params.res)
/***********************************************************************
* public API implementation
**********************************************************************/
int isl29125_init(isl29125_t *dev, i2c_t i2c, gpio_t gpio,
isl29125_mode_t mode, isl29125_range_t range,
isl29125_resolution_t resolution)
int isl29125_init(isl29125_t *dev, const isl29125_params_t *params)
{
DEBUG("isl29125_init\n");
/* initialize device descriptor */
dev->i2c = i2c;
dev->res = resolution;
dev->range = range;
dev->gpio = gpio;
dev->params = *params;
/* configuration 1: operation mode, range, resolution */
uint8_t conf1 = 0x00;
conf1 |= mode;
conf1 |= range;
conf1 |= resolution;
conf1 |= DEV_MODE;
conf1 |= DEV_RANGE;
conf1 |= DEV_RES;
conf1 |= ISL29125_CON1_SYNCOFF; /* TODO: implement SYNC mode configuration */
/* TODO: implement configuration 2: infrared compensation configuration */
/* acquire exclusive access to the bus */
DEBUG("isl29125_init: i2c_acquire\n");
(void) i2c_acquire(dev->i2c);
(void) i2c_acquire(DEV_I2C);
/* initialize the I2C bus */
DEBUG("isl29125_init: i2c_init_master\n");
(void) i2c_init_master(i2c, I2C_SPEED_NORMAL);
(void) i2c_init_master(DEV_I2C, I2C_SPEED_NORMAL);
/* verify the device ID */
DEBUG("isl29125_init: i2c_read_reg\n");
uint8_t reg_id;
int ret = i2c_read_reg(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_ID, &reg_id);
int ret = i2c_read_reg(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_ID, &reg_id);
if ((reg_id == ISL29125_ID) && (ret == 1)) {
DEBUG("isl29125_init: ID successfully verified\n");
}
else {
DEBUG("isl29125_init: ID could not be verified, ret: %i\n", ret);
(void) i2c_release(dev->i2c);
(void) i2c_release(DEV_I2C);
return -1;
}
/* configure and enable the sensor */
DEBUG("isl29125_init: i2c_write_reg(ISL29125_REG_RESET)\n");
(void) i2c_write_reg(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_RESET, ISL29125_CMD_RESET);
(void) i2c_write_reg(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_RESET, ISL29125_CMD_RESET);
DEBUG("isl29125_init: i2c_write_reg(ISL29125_REG_CONF1)\n");
(void) i2c_write_reg(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_CONF1, conf1);
(void) i2c_write_reg(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_CONF1, conf1);
/* release the I2C bus */
DEBUG("isl29125_init: i2c_release\n");
(void) i2c_release(dev->i2c);
(void) i2c_release(DEV_I2C);
DEBUG("isl29125_init: success\n");
return 0;
@ -112,7 +113,7 @@ int isl29125_init_int(isl29125_t *dev, isl29125_interrupt_status_t interrupt_sta
uint8_t hthhb = 0x00;
uint16_t max_range = 10000;
if (dev->range == 0x00) {
if (DEV_RANGE == 0x00) {
max_range = 375;
}
@ -126,21 +127,21 @@ int isl29125_init_int(isl29125_t *dev, isl29125_interrupt_status_t interrupt_sta
}
DEBUG("isl29125_init: i2c_write_reg(ISL29125_REG_CONF3)\n");
(void) i2c_write_reg(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_CONF3, conf3);
(void) i2c_write_reg(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_CONF3, conf3);
DEBUG("isl29125_init: i2c_write_reg(ISL29125_REG_LTHLB)\n");
(void) i2c_write_reg(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_LTHLB, lthlb);
(void) i2c_write_reg(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_LTHLB, lthlb);
DEBUG("isl29125_init: i2c_write_reg(ISL29125_REG_LTHHB)\n");
(void) i2c_write_reg(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_LTHHB, lthhb);
(void) i2c_write_reg(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_LTHHB, lthhb);
DEBUG("isl29125_init: i2c_write_reg(ISL29125_REG_HTHLB)\n");
(void) i2c_write_reg(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_HTHLB, hthlb);
(void) i2c_write_reg(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_HTHLB, hthlb);
DEBUG("isl29125_init: i2c_write_reg(ISL29125_REG_HTHHB)\n");
(void) i2c_write_reg(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_HTHHB, hthhb);
(void) i2c_write_reg(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_HTHHB, hthhb);
if (gpio_init_int(dev->gpio, GPIO_IN, GPIO_FALLING, cb, arg) < 0) {
if (gpio_init_int(DEV_GPIO, GPIO_IN, GPIO_FALLING, cb, arg) < 0) {
DEBUG("error: gpio_init_int failed\n");
return -1;
}
@ -151,17 +152,17 @@ int isl29125_init_int(isl29125_t *dev, isl29125_interrupt_status_t interrupt_sta
void isl29125_read_rgb_lux(const isl29125_t *dev, isl29125_rgb_t *dest)
{
/* acquire exclusive access to the bus */
(void) i2c_acquire(dev->i2c);
(void) i2c_acquire(DEV_I2C);
/* read values */
uint8_t bytes[6];
(void) i2c_read_regs(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_GDLB, bytes, 6);
(void) i2c_read_regs(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_GDLB, bytes, 6);
/* release the I2C bus */
(void) i2c_release(dev->i2c);
(void) i2c_release(DEV_I2C);
/* possibly shift by 4 to normalize 12 to 16 bit */
int resfactor = (dev->res == ISL29125_RESOLUTION_12) ? 4 : 0;
int resfactor = (DEV_RES == ISL29125_RESOLUTION_12) ? 4 : 0;
/* parse and normalize readings */
uint16_t green = (bytes[0] | (bytes[1] << 8)) << resfactor;
uint16_t red = (bytes[2] | (bytes[3] << 8)) << resfactor;
@ -170,7 +171,7 @@ void isl29125_read_rgb_lux(const isl29125_t *dev, isl29125_rgb_t *dest)
DEBUG("isl29125_read_rgb: adjusted, unconverted readings: (%5i / %5i / %5i) \n", red, green, blue);
/* convert readings to lux */
float luxfactor = (dev->range == ISL29125_RANGE_10K) ? 10000.0 / 65535.0 : 375.0 / 65535.0;
float luxfactor = (DEV_RANGE == ISL29125_RANGE_10K) ? 10000.0 / 65535.0 : 375.0 / 65535.0;
dest->red = red * luxfactor;
dest->green = green * luxfactor;
dest->blue = blue * luxfactor;
@ -179,17 +180,17 @@ void isl29125_read_rgb_lux(const isl29125_t *dev, isl29125_rgb_t *dest)
void isl29125_read_rgb_color(const isl29125_t *dev, color_rgb_t *dest)
{
/* acquire exclusive access to the bus */
(void) i2c_acquire(dev->i2c);
(void) i2c_acquire(DEV_I2C);
/* read values */
uint8_t bytes[6];
(void) i2c_read_regs(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_GDLB, bytes, 6);
(void) i2c_read_regs(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_GDLB, bytes, 6);
/* release the I2C bus */
(void) i2c_release(dev->i2c);
(void) i2c_release(DEV_I2C);
/* factor normalize 12 or 16 bit to 8 bit */
int normfactor = (dev->res == ISL29125_RESOLUTION_12) ? 4 : 8;
int normfactor = (DEV_RES == ISL29125_RESOLUTION_12) ? 4 : 8;
/* parse and normalize readings */
dest->g = (bytes[0] | (bytes[1] << 8)) >> normfactor;
dest->r = (bytes[2] | (bytes[3] << 8)) >> normfactor;
@ -200,27 +201,27 @@ void isl29125_set_mode(const isl29125_t *dev, isl29125_mode_t mode)
{
uint8_t conf1;
(void) i2c_acquire(dev->i2c);
(void) i2c_acquire(DEV_I2C);
(void) i2c_read_reg(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_CONF1, &conf1);
(void) i2c_read_reg(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_CONF1, &conf1);
conf1 &= ~ISL29125_CON1_MASK_MODE;
conf1 |= mode;
(void) i2c_write_reg(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_CONF1, conf1);
(void) i2c_write_reg(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_CONF1, conf1);
(void) i2c_release(dev->i2c);
(void) i2c_release(DEV_I2C);
}
int isl29125_read_irq_status(const isl29125_t *dev)
{
/* acquire exclusive access to the bus */
(void) i2c_acquire(dev->i2c);
(void) i2c_acquire(DEV_I2C);
/* read status register */
uint8_t irq_status;
(void) i2c_read_reg(dev->i2c, ISL29125_I2C_ADDRESS, ISL29125_REG_STATUS, &irq_status);
(void) i2c_read_reg(DEV_I2C, ISL29125_I2C_ADDRESS, ISL29125_REG_STATUS, &irq_status);
/* release the I2C bus */
(void) i2c_release(dev->i2c);
(void) i2c_release(DEV_I2C);
/* return bit 0 (RGBTHF)*/
return (irq_status & 0x01);

15
tests/driver_isl29125/main.c
View File

@ -21,19 +21,12 @@
* @}
*/
#ifndef TEST_ISL29125_I2C
#error "TEST_ISL29125_I2C not defined"
#endif
#ifndef TEST_ISL29125_IRQ_PIN
#error "ISL29125_IRQ_PIN not defined"
#endif
#include <stdio.h>
#include <string.h>
#include "xtimer.h"
#include "isl29125.h"
#include "isl29125_params.h"
#define SLEEP (250 * 1000U)
@ -55,10 +48,8 @@ int main(void)
uint16_t higher_threshold = 8000;
puts("ISL29125 light sensor test application\n");
printf("Initializing ISL29125 sensor at I2C_%i... ", TEST_ISL29125_I2C);
if (isl29125_init(&dev, TEST_ISL29125_I2C, TEST_ISL29125_IRQ_PIN,
ISL29125_MODE_RGB, ISL29125_RANGE_10K,
ISL29125_RESOLUTION_16) == 0) {
printf("Initializing ISL29125 sensor at I2C_%i... ", isl29125_params[0].i2c);
if (isl29125_init(&dev, &isl29125_params[0]) == 0) {
puts("[OK]\n");
}
else {