mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
228 lines
7.3 KiB
C
228 lines
7.3 KiB
C
/*
|
|
* Copyright 2015 Ludwig Knüpfer
|
|
* Copyright 2017 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 driver_isl29125
|
|
* @{
|
|
*
|
|
* @file
|
|
* @brief Device driver implementation for the ISL29125 RGB light sensor
|
|
*
|
|
* @author Ludwig Knüpfer <ludwig.knuepfer@fu-berlin.de>
|
|
* @author Martin Heusmann <martin.heusmann@haw-hamburg.de>
|
|
* @author Cenk Gündoğan <mail-github@cgundogan.de>
|
|
*
|
|
* @}
|
|
*/
|
|
|
|
#include <stdint.h>
|
|
|
|
#include "isl29125.h"
|
|
#include "isl29125-internal.h"
|
|
#include "periph/i2c.h"
|
|
#include "periph/gpio.h"
|
|
#include "color.h"
|
|
|
|
#define ENABLE_DEBUG (0)
|
|
#include "debug.h"
|
|
|
|
/***********************************************************************
|
|
* 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)
|
|
{
|
|
DEBUG("isl29125_init\n");
|
|
|
|
/* initialize device descriptor */
|
|
dev->i2c = i2c;
|
|
dev->res = resolution;
|
|
dev->range = range;
|
|
dev->gpio = gpio;
|
|
|
|
/* configuration 1: operation mode, range, resolution */
|
|
uint8_t conf1 = 0x00;
|
|
conf1 |= mode;
|
|
conf1 |= range;
|
|
conf1 |= resolution;
|
|
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);
|
|
|
|
/* initialize the I2C bus */
|
|
DEBUG("isl29125_init: i2c_init_master\n");
|
|
(void) i2c_init_master(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, ®_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);
|
|
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);
|
|
|
|
DEBUG("isl29125_init: i2c_write_reg(ISL29125_REG_CONF1)\n");
|
|
(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);
|
|
|
|
DEBUG("isl29125_init: success\n");
|
|
return 0;
|
|
}
|
|
|
|
int isl29125_init_int(isl29125_t *dev, isl29125_interrupt_status_t interrupt_status,
|
|
isl29125_interrupt_persist_t interrupt_persist,
|
|
isl29125_interrupt_conven_t interrupt_conven,
|
|
uint16_t lower_threshold, uint16_t higher_threshold,
|
|
gpio_cb_t cb, void *arg)
|
|
{
|
|
/* configuration 3: interrupt mode configuration */
|
|
uint8_t conf3 = 0x00;
|
|
conf3 |= interrupt_status;
|
|
conf3 |= interrupt_persist;
|
|
conf3 |= interrupt_conven;
|
|
|
|
/* Lower and higher interrupt threshold registers. */
|
|
uint8_t lthlb = 0x00;
|
|
uint8_t lthhb = 0x00;
|
|
uint8_t hthlb = 0x00;
|
|
uint8_t hthhb = 0x00;
|
|
uint16_t max_range = 10000;
|
|
|
|
if (dev->range == 0x00) {
|
|
max_range = 375;
|
|
}
|
|
|
|
if ((higher_threshold <= max_range) && (lower_threshold < higher_threshold)) {
|
|
lower_threshold *= (uint16_t) (65535 / max_range);
|
|
lthlb = (uint8_t)(lower_threshold & 0xff);
|
|
lthhb = (uint8_t)(lower_threshold >> 8);
|
|
higher_threshold *= (uint16_t) (65535 / max_range);
|
|
hthlb = (uint8_t)(higher_threshold & 0xff);
|
|
hthhb = (uint8_t)(higher_threshold >> 8);
|
|
}
|
|
|
|
DEBUG("isl29125_init: i2c_write_reg(ISL29125_REG_CONF3)\n");
|
|
(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);
|
|
|
|
DEBUG("isl29125_init: i2c_write_reg(ISL29125_REG_LTHHB)\n");
|
|
(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);
|
|
|
|
DEBUG("isl29125_init: i2c_write_reg(ISL29125_REG_HTHHB)\n");
|
|
(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) {
|
|
DEBUG("error: gpio_init_int failed\n");
|
|
return -1;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
void isl29125_read_rgb_lux(isl29125_t *dev, isl29125_rgb_t *dest)
|
|
{
|
|
/* acquire exclusive access to the bus */
|
|
(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);
|
|
|
|
/* release the I2C bus */
|
|
(void) i2c_release(dev->i2c);
|
|
|
|
/* possibly shift by 4 to normalize 12 to 16 bit */
|
|
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;
|
|
uint16_t blue = (bytes[4] | (bytes[5] << 8)) << resfactor;
|
|
|
|
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;
|
|
dest->red = red * luxfactor;
|
|
dest->green = green * luxfactor;
|
|
dest->blue = blue * luxfactor;
|
|
}
|
|
|
|
void isl29125_read_rgb_color(isl29125_t *dev, color_rgb_t *dest)
|
|
{
|
|
/* acquire exclusive access to the bus */
|
|
(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);
|
|
|
|
/* release the I2C bus */
|
|
(void) i2c_release(dev->i2c);
|
|
|
|
/* factor normalize 12 or 16 bit to 8 bit */
|
|
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;
|
|
dest->b = (bytes[4] | (bytes[5] << 8)) >> normfactor;
|
|
}
|
|
|
|
void isl29125_set_mode(isl29125_t *dev, isl29125_mode_t mode)
|
|
{
|
|
uint8_t conf1;
|
|
|
|
(void) i2c_acquire(dev->i2c);
|
|
|
|
(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_release(dev->i2c);
|
|
}
|
|
|
|
int isl29125_read_irq_status(isl29125_t *dev)
|
|
{
|
|
/* acquire exclusive access to the bus */
|
|
(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);
|
|
|
|
/* release the I2C bus */
|
|
(void) i2c_release(dev->i2c);
|
|
|
|
/* return bit 0 (RGBTHF)*/
|
|
return (irq_status & 0x01);
|
|
}
|