1158 lines
30 KiB
C
1158 lines
30 KiB
C
/****************************************************************************
|
|
* drivers/sensors/vl53l1x.c
|
|
* Character driver for the ST vl53l1x distance.
|
|
*
|
|
* Copyright (C) 2019 Acutronics Robotics
|
|
* Author: Acutronics Robotics (Juan Flores Muñoz) <juan@erlerobotics.com>
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
* 3. Neither the name NuttX nor the names of its contributors may be
|
|
* used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <nuttx/config.h>
|
|
|
|
#include <stdlib.h>
|
|
#include <fixedmath.h>
|
|
#include <errno.h>
|
|
#include <debug.h>
|
|
|
|
#include <nuttx/kmalloc.h>
|
|
#include <nuttx/signal.h>
|
|
#include <nuttx/fs/fs.h>
|
|
#include <nuttx/i2c/i2c_master.h>
|
|
#include <nuttx/sensors/vl53l1x.h>
|
|
#include <nuttx/sensors/ioctl.h>
|
|
#include <nuttx/random.h>
|
|
|
|
#if defined(CONFIG_I2C) && defined(CONFIG_SENSORS_VL53L1X)
|
|
|
|
/****************************************************************************
|
|
* Pre-processor Definitions
|
|
****************************************************************************/
|
|
|
|
#define VL53L1X_FREQ 100000
|
|
#define VL53L1X_ADDR 0x29
|
|
|
|
/****************************************************************************
|
|
* Private Type Definitions
|
|
****************************************************************************/
|
|
|
|
struct vl53l1x_dev_s
|
|
{
|
|
FAR struct i2c_master_s *i2c; /* I2C interface */
|
|
uint8_t addr; /* VL53L0X I2C address */
|
|
int freq; /* VL53L0X Frequency */
|
|
};
|
|
|
|
/****************************************************************************
|
|
* Private Data
|
|
****************************************************************************/
|
|
|
|
static const uint8_t g_vl51l1x_default_config[] =
|
|
{
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x01,
|
|
0x02,
|
|
0x00,
|
|
0x02,
|
|
0x08,
|
|
0x00,
|
|
0x08,
|
|
0x10,
|
|
0x01,
|
|
0x01,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0xff,
|
|
0x00,
|
|
0x0f,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x20,
|
|
0x0b,
|
|
0x00,
|
|
0x00,
|
|
0x02,
|
|
0x0a,
|
|
0x21,
|
|
0x00,
|
|
0x00,
|
|
0x05,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0xc8,
|
|
0x00,
|
|
0x00,
|
|
0x38,
|
|
0xff,
|
|
0x01,
|
|
0x00,
|
|
0x08,
|
|
0x00,
|
|
0x00,
|
|
0x01,
|
|
0xdb,
|
|
0x0f,
|
|
0x01,
|
|
0xf1,
|
|
0x0d,
|
|
0x01,
|
|
0x68,
|
|
0x00,
|
|
0x80,
|
|
0x08,
|
|
0xb8,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x0f,
|
|
0x89,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x01,
|
|
0x0f,
|
|
0x0d,
|
|
0x0e,
|
|
0x0e,
|
|
0x00,
|
|
0x00,
|
|
0x02,
|
|
0xc7,
|
|
0xff,
|
|
0x9b,
|
|
0x00,
|
|
0x00,
|
|
0x00,
|
|
0x01,
|
|
0x00,
|
|
0x00
|
|
};
|
|
|
|
/****************************************************************************
|
|
* Private Function Prototypes
|
|
****************************************************************************/
|
|
|
|
/* I2C operations */
|
|
|
|
static uint8_t vl53l1x_getreg8(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t regaddr);
|
|
static uint16_t vl53l1x_getreg16(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t regaddr);
|
|
static uint32_t vl53l1x_getreg32(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t regaddr);
|
|
static void vl53l1x_putreg8(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t regaddr, uint8_t regval);
|
|
static void vl53l1x_putreg16(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t regaddr, uint16_t regval);
|
|
static void vl53l1x_putreg32(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t regaddr, uint32_t regval);
|
|
|
|
/* Basic driver operations */
|
|
|
|
static void vl53l1x_startranging(FAR struct vl53l1x_dev_s *priv);
|
|
static void vl53l1x_stopranging(FAR struct vl53l1x_dev_s *priv);
|
|
static void vl53l1x_sensorinit(FAR struct vl53l1x_dev_s *priv);
|
|
static void vl53l1x_getdistance(FAR struct vl53l1x_dev_s *priv,
|
|
FAR uint16_t *distance);
|
|
|
|
/* Set data operations */
|
|
|
|
static void vl53l1x_settimingbudget(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t ms_value);
|
|
static void vl53l1x_setdistancemode(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t mode);
|
|
|
|
/* Get data operations */
|
|
|
|
static void vl53l1x_gettimingbudget(FAR struct vl53l1x_dev_s *priv,
|
|
FAR uint16_t *ms_value);
|
|
static void vl53l1x_getdistancemode(FAR struct vl53l1x_dev_s *priv,
|
|
FAR uint16_t *dm);
|
|
static void vl53l1x_getid(FAR struct vl53l1x_dev_s *priv, FAR uint16_t *id);
|
|
static void vl53l1x_getoffset(FAR struct vl53l1x_dev_s *priv,
|
|
FAR int16_t *offset);
|
|
static void vl53l1x_getintstate(FAR struct vl53l1x_dev_s *priv,
|
|
FAR uint8_t *state);
|
|
|
|
/* Other operations */
|
|
|
|
static void vl53l1x_clearint(FAR struct vl53l1x_dev_s *priv);
|
|
static void vl53l1x_dataready(FAR struct vl53l1x_dev_s *priv,
|
|
FAR uint8_t *dataready);
|
|
static void vl53l1x_tempupdate(FAR struct vl53l1x_dev_s *priv);
|
|
static void vl53l1x_calibrateoffset(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t target_distance,
|
|
FAR int16_t *offset);
|
|
|
|
/* Character driver methods */
|
|
|
|
static void vl53l1x_read(FAR struct file *filep, FAR char *buffer,
|
|
size_t buflen);
|
|
static ssize_t vl53l1x_write(FAR struct file *filep, FAR const char *buffer,
|
|
size_t buflen);
|
|
static void vl53l1x_ioctl(FAR struct file *filep, int cmd, uint16_t arg);
|
|
|
|
/****************************************************************************
|
|
* Private Data
|
|
****************************************************************************/
|
|
|
|
static const struct file_operations g_vl53l1xfops =
|
|
{
|
|
NULL, /* open */
|
|
NULL, /* close */
|
|
vl53l1x_read, /* read */
|
|
vl53l1x_write, /* write */
|
|
NULL, /* seek */
|
|
vl53l1x_ioctl, /* ioctl */
|
|
};
|
|
|
|
/****************************************************************************
|
|
* Private Functions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_SensorInit
|
|
*
|
|
* Description:
|
|
* This function loads the 135 bytes default values to initialize the
|
|
* sensor.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_sensorinit(FAR struct vl53l1x_dev_s *priv)
|
|
{
|
|
uint8_t addr = 0x00;
|
|
uint8_t tmp = 0;
|
|
|
|
for (addr = 0x2d; addr <= 0x87; addr++)
|
|
{
|
|
vl53l1x_putreg8(priv, addr, g_vl51l1x_default_config[addr - 0x2d]);
|
|
}
|
|
|
|
vl53l1x_startranging(priv);
|
|
|
|
while (tmp == 0)
|
|
{
|
|
vl53l1x_dataready(priv, &tmp);
|
|
}
|
|
|
|
vl53l1x_clearint(priv);
|
|
vl53l1x_stopranging(priv);
|
|
vl53l1x_putreg8(priv, TIMEOUT_MACROP_LOOP_BOUND, 0x09);
|
|
vl53l1x_putreg8(priv, 0x0b, 0);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_clearint
|
|
*
|
|
* Description:
|
|
* This function clears the interrupt, to be called after a ranging data
|
|
* reading to arm the interrupt for the next data ready event.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_clearint(FAR struct vl53l1x_dev_s *priv)
|
|
{
|
|
vl53l1x_putreg8(priv, INTERRUPT_CLEAR, 0x01);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_startranging
|
|
*
|
|
* Description:
|
|
* This function starts the ranging distance operation. The ranging ops
|
|
* is continuous. The clear interrupt has to be done after each get data to
|
|
* allow the interrupt to raise when the next data is ready.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_startranging(FAR struct vl53l1x_dev_s *priv)
|
|
{
|
|
vl53l1x_putreg8(priv, SYSTEM_MODE, 0x40);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_StopRanging
|
|
*
|
|
* Description:
|
|
* This function stops the ranging.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_stopranging(FAR struct vl53l1x_dev_s *priv)
|
|
{
|
|
vl53l1x_putreg8(priv, SYSTEM_MODE, 0x00);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_dataready
|
|
*
|
|
* Description:
|
|
* This function checks if the new ranging data is available by polling the
|
|
* dedicated register.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_dataready(FAR struct vl53l1x_dev_s *priv,
|
|
FAR uint8_t *dataready)
|
|
{
|
|
uint8_t temp;
|
|
uint8_t intpol;
|
|
|
|
temp = vl53l1x_getreg8(priv, GPIO_STATUS);
|
|
vl53l1x_getintstate(priv, &intpol);
|
|
|
|
/* Read in the register to check if a new value is available */
|
|
|
|
if ((temp & 1) == intpol)
|
|
{
|
|
*dataready = 1;
|
|
}
|
|
else
|
|
{
|
|
*dataready = 0;
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_getinterruptstate
|
|
*
|
|
* Description:
|
|
* This function returns the current interrupt polarity.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_getintstate(FAR struct vl53l1x_dev_s *priv,
|
|
FAR uint8_t *state)
|
|
{
|
|
uint8_t temp;
|
|
|
|
temp = vl53l1x_getreg8(priv, GPIO_MUX_CTRL);
|
|
temp = temp & 0x10;
|
|
*state = !(temp >> 4);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: VL53L1X_GetTimingBudgetInMs
|
|
*
|
|
* Description:
|
|
* This function returns the timing budget in ms.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_gettimingbudget(FAR struct vl53l1x_dev_s *priv,
|
|
FAR uint16_t *ms_value)
|
|
{
|
|
uint16_t temp;
|
|
|
|
temp = vl53l1x_getreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI);
|
|
|
|
switch (temp)
|
|
{
|
|
case 0x001d:
|
|
*ms_value = 15;
|
|
break;
|
|
|
|
case 0x0051:
|
|
case 0x001e:
|
|
*ms_value = 20;
|
|
break;
|
|
|
|
case 0x00d6:
|
|
case 0x0060:
|
|
*ms_value = 33;
|
|
break;
|
|
|
|
case 0x1ae:
|
|
case 0x00ad:
|
|
*ms_value = 50;
|
|
break;
|
|
|
|
case 0x02e1:
|
|
case 0x01cc:
|
|
*ms_value = 100;
|
|
break;
|
|
|
|
case 0x03e1:
|
|
case 0x02d9:
|
|
*ms_value = 200;
|
|
break;
|
|
|
|
case 0x0591:
|
|
case 0x048f:
|
|
*ms_value = 500;
|
|
break;
|
|
|
|
default:
|
|
*ms_value = 0;
|
|
break;
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_settimingbudget
|
|
*
|
|
* Description:
|
|
* This function programs the timing budget in ms.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_settimingbudget(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t ms_value)
|
|
{
|
|
uint16_t dm;
|
|
vl53l1x_getdistancemode(priv, &dm);
|
|
|
|
/* Short Distance */
|
|
|
|
if (dm == 1)
|
|
{
|
|
switch (ms_value)
|
|
{
|
|
case 15:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x01d);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x0027);
|
|
}
|
|
break;
|
|
|
|
case 20:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x0051);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x006e);
|
|
}
|
|
break;
|
|
|
|
case 33:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x00d6);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x006e);
|
|
}
|
|
break;
|
|
|
|
case 50:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x1ae);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x01e8);
|
|
}
|
|
break;
|
|
|
|
case 100:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x02e1);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x0388);
|
|
}
|
|
break;
|
|
|
|
case 200:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x03e1);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x0496);
|
|
}
|
|
break;
|
|
|
|
case 500:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x0591);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x05c1);
|
|
}
|
|
break;
|
|
|
|
default:
|
|
break;
|
|
}
|
|
}
|
|
else
|
|
{
|
|
switch (ms_value)
|
|
{
|
|
case 20:
|
|
{
|
|
vl53l1x_putreg16(priv, PHASECAL_TIMEOUT_MACRO, 0x001e);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x0022);
|
|
}
|
|
break;
|
|
|
|
case 33:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x0060);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x006e);
|
|
}
|
|
break;
|
|
|
|
case 50:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x00ad);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x00c6);
|
|
}
|
|
break;
|
|
|
|
case 100:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x01cc);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x01ea);
|
|
}
|
|
break;
|
|
|
|
case 200:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x02d9);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x02f8);
|
|
}
|
|
break;
|
|
|
|
case 500:
|
|
{
|
|
vl53l1x_putreg16(priv, RANGE_CFG_TIMEOUT_MACRO_HI, 0x048f);
|
|
vl53l1x_putreg16(priv, RANGE_TIMEOUT_MACRO_HI, 0x04a4);
|
|
}
|
|
break;
|
|
|
|
default:
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_setdistancemode
|
|
*
|
|
* Description:
|
|
* This function programs the distance mode (1=short, 2=long(default)).
|
|
* Short mode max distance is limited to 1.3 m but better ambient immunity.
|
|
* Long mode can range up to 4 m in the dark with 200 ms timing budget.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_setdistancemode(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t dm)
|
|
{
|
|
uint16_t tb;
|
|
|
|
vl53l1x_gettimingbudget(priv, &tb);
|
|
switch (dm)
|
|
{
|
|
case 1:
|
|
{
|
|
vl53l1x_putreg8(priv, PHASECAL_TIMEOUT_MACRO, 0x14);
|
|
vl53l1x_putreg8(priv, RANGE_VCSEL_PERIOD_A, 0x07);
|
|
vl53l1x_putreg8(priv, RANGE_VCSEL_PERIOD_B, 0x05);
|
|
vl53l1x_putreg8(priv, RANGE_CFG_VALID_PHASE, 0x38);
|
|
vl53l1x_putreg16(priv, SD_CFG_WOI_SD0, 0x0705);
|
|
vl53l1x_putreg16(priv, SD_CFG_INIT_PHASE, 0x0606);
|
|
}
|
|
break;
|
|
|
|
case 2:
|
|
{
|
|
vl53l1x_putreg8(priv, PHASECAL_TIMEOUT_MACRO, 0x0a);
|
|
vl53l1x_putreg8(priv, RANGE_VCSEL_PERIOD_A, 0x0f);
|
|
vl53l1x_putreg8(priv, RANGE_VCSEL_PERIOD_B, 0x0d);
|
|
vl53l1x_putreg8(priv, RANGE_CFG_VALID_PHASE, 0xb8);
|
|
vl53l1x_putreg16(priv, SD_CFG_WOI_SD0, 0x0f0d);
|
|
vl53l1x_putreg16(priv, SD_CFG_INIT_PHASE, 0x0e0e);
|
|
}
|
|
break;
|
|
|
|
default:
|
|
break;
|
|
}
|
|
|
|
vl53l1x_settimingbudget(priv, tb);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_getdistancemode
|
|
*
|
|
* Description:
|
|
* This function returns the current distance mode (1=short, 2=long).
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_getdistancemode(FAR struct vl53l1x_dev_s *priv,
|
|
FAR uint16_t *dm)
|
|
{
|
|
uint8_t mode_read;
|
|
|
|
mode_read = vl53l1x_getreg8(priv, PHASECAL_TIMEOUT_MACRO);
|
|
if (mode_read == 0x14)
|
|
{
|
|
*dm = 1;
|
|
}
|
|
|
|
if (mode_read == 0x0a)
|
|
{
|
|
*dm = 2;
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_getid
|
|
*
|
|
* Description:
|
|
* This function returns the sensor id, sensor Id must be 0xeeac.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_getid(FAR struct vl53l1x_dev_s *priv, FAR uint16_t *id)
|
|
{
|
|
uint16_t tmp = 0;
|
|
|
|
tmp = vl53l1x_getreg16(priv, VL53L1_GET_ID);
|
|
*id = tmp;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_GetDistance
|
|
*
|
|
* Description:
|
|
* This function returns the distance measured by the sensor in mm.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_getdistance(FAR struct vl53l1x_dev_s *priv,
|
|
FAR uint16_t *distance)
|
|
{
|
|
uint16_t tmp;
|
|
|
|
tmp = vl53l1x_getreg16(priv, VL53L1_GET_DISTANCE);
|
|
*distance = tmp;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_getoffset
|
|
*
|
|
* Description:
|
|
* This function returns the programmed offset correction value in mm.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_getoffset(FAR struct vl53l1x_dev_s *priv,
|
|
FAR int16_t *offset)
|
|
{
|
|
uint16_t temp;
|
|
|
|
temp = vl53l1x_getreg16(priv, RANGE_OFFSET_MM);
|
|
|
|
temp = temp << 3;
|
|
temp = temp >> 5;
|
|
|
|
*offset = (int16_t) (temp);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_tempupdate
|
|
*
|
|
* Description:
|
|
* This function performs the temperature calibration. It is recommended to
|
|
* call this function any time the temperature might have changed by more
|
|
* than 8 deg C without sensor ranging activity for an extended period.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_tempupdate(FAR struct vl53l1x_dev_s *priv)
|
|
{
|
|
uint8_t tmp = 0;
|
|
|
|
vl53l1x_putreg8(priv, TIMEOUT_MACROP_LOOP_BOUND, 0x81);
|
|
vl53l1x_putreg8(priv, 0x0b, 0x92);
|
|
|
|
vl53l1x_startranging(priv);
|
|
|
|
while (tmp == 0)
|
|
{
|
|
vl53l1x_dataready(priv, &tmp);
|
|
}
|
|
|
|
vl53l1x_clearint(priv);
|
|
vl53l1x_stopranging(priv);
|
|
|
|
vl53l1x_putreg8(priv, TIMEOUT_MACROP_LOOP_BOUND, 0x09);
|
|
vl53l1x_putreg8(priv, 0x0b, 0);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_calibrateoffset
|
|
*
|
|
* Description:
|
|
* The function returns the offset value found and programs the offset
|
|
* compensation into the device.
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_calibrateoffset(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t target_distance,
|
|
FAR int16_t *offset)
|
|
{
|
|
uint8_t i = 0;
|
|
uint8_t tmp;
|
|
int16_t average_distance = 0;
|
|
uint16_t distance;
|
|
|
|
vl53l1x_putreg16(priv, RANGE_OFFSET_MM, 0x0);
|
|
vl53l1x_putreg16(priv, INNER_OFFSET_MM, 0x0);
|
|
vl53l1x_putreg16(priv, OUTER_OFFSET_MM, 0x0);
|
|
|
|
vl53l1x_startranging(priv);
|
|
|
|
for (i = 0; i < 50; i++)
|
|
{
|
|
while (tmp == 0)
|
|
{
|
|
vl53l1x_dataready(priv, &tmp);
|
|
}
|
|
|
|
vl53l1x_getdistance(priv, &distance);
|
|
vl53l1x_clearint(priv);
|
|
|
|
average_distance = average_distance + distance;
|
|
}
|
|
|
|
vl53l1x_stopranging(priv);
|
|
|
|
average_distance = average_distance / 50;
|
|
*offset = target_distance - average_distance;
|
|
|
|
vl53l1x_putreg16(priv, RANGE_OFFSET_MM, *offset *4);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_getreg8
|
|
*
|
|
* Description:
|
|
* Read from an 8-bit vl53l1x register
|
|
*
|
|
****************************************************************************/
|
|
|
|
static uint8_t vl53l1x_getreg8(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t regaddr)
|
|
{
|
|
struct i2c_config_s config;
|
|
|
|
uint8_t regval = 0;
|
|
uint16_t ret;
|
|
|
|
/* Set up the I2C configuration */
|
|
|
|
config.frequency = priv->freq;
|
|
config.address = priv->addr;
|
|
config.addrlen = 7;
|
|
|
|
/* Write the register address */
|
|
|
|
ret = i2c_write(priv->i2c, &config, (FAR uint8_t *)®addr, 2);
|
|
if (ret < 0)
|
|
{
|
|
snerr("ERROR: i2c_write failed: %d\n", ret);
|
|
return ret;
|
|
}
|
|
|
|
/* Read the register value */
|
|
|
|
ret = i2c_read(priv->i2c, &config, ®val, 1);
|
|
if (ret < 0)
|
|
{
|
|
snerr("ERROR: i2c_read failed: %d\n", ret);
|
|
return ret;
|
|
}
|
|
|
|
return regval;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: bmp180_getreg16
|
|
*
|
|
* Description:
|
|
* Read two 8-bit from a BMP180 register
|
|
*
|
|
****************************************************************************/
|
|
|
|
static uint16_t vl53l1x_getreg16(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t regaddr)
|
|
{
|
|
struct i2c_config_s config;
|
|
|
|
uint16_t msb;
|
|
uint16_t lsb;
|
|
uint16_t regval = 0;
|
|
uint8_t reg_addr_aux[2];
|
|
uint8_t ret;
|
|
|
|
/* Set up the I2C configuration */
|
|
|
|
config.frequency = priv->freq;
|
|
config.address = priv->addr;
|
|
config.addrlen = 7;
|
|
|
|
/* Split the I2C direction */
|
|
|
|
reg_addr_aux[0] = (regaddr >> 8) & 0xff;
|
|
reg_addr_aux[1] = regaddr;
|
|
|
|
/* Register to read */
|
|
|
|
sninfo("Reg %02x %\n", reg_addr_aux[0], reg_addr_aux[1]);
|
|
ret = i2c_write(priv->i2c, &config, (FAR uint8_t *)®_addr_aux, 2);
|
|
if (ret < 0)
|
|
{
|
|
snerr("ERROR: i2c_write failed: %d\n", ret);
|
|
return ret;
|
|
}
|
|
|
|
/* Read register */
|
|
|
|
ret = i2c_read(priv->i2c, &config, (FAR uint8_t *) & regval, 2);
|
|
if (ret < 0)
|
|
{
|
|
snerr("ERROR: i2c_read failed: %d\n", ret);
|
|
return ret;
|
|
}
|
|
|
|
/* MSB and LSB are inverted */
|
|
|
|
msb = (regval & 0xff);
|
|
lsb = (regval & 0xff00) >> 8;
|
|
|
|
regval = (msb << 8) | lsb;
|
|
|
|
return regval;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_getreg32
|
|
*
|
|
* Description:
|
|
* Read 4 8-bit from a vl53l1x register
|
|
*
|
|
****************************************************************************/
|
|
|
|
static uint32_t vl53l1x_getreg32(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t regaddr)
|
|
{
|
|
struct i2c_config_s config;
|
|
|
|
uint16_t byte[4];
|
|
uint32_t regval = 0;
|
|
uint8_t ret;
|
|
|
|
/* Set up the I2C configuration */
|
|
|
|
config.frequency = priv->freq;
|
|
config.address = priv->addr;
|
|
config.addrlen = 7;
|
|
|
|
/* Register to read */
|
|
|
|
ret = i2c_write(priv->i2c, &config, (FAR uint8_t *)®addr, 2);
|
|
if (ret < 0)
|
|
{
|
|
snerr("ERROR: i2c_write failed: %d\n", ret);
|
|
return ret;
|
|
}
|
|
|
|
/* Read register */
|
|
|
|
ret = i2c_read(priv->i2c, &config, (FAR uint8_t *) & regval, 4);
|
|
if (ret < 0)
|
|
{
|
|
snerr("ERROR: i2c_read failed: %d\n", ret);
|
|
return ret;
|
|
}
|
|
|
|
/* The bytes are in the opposite order of importance */
|
|
|
|
byte[0] = (regval & 0xff);
|
|
byte[1] = (regval & 0xff00) >> 8;
|
|
byte[2] = (regval & 0xffff00) >> 16;
|
|
byte[3] = (regval & 0xffffff00) >> 24;
|
|
|
|
regval = (byte[0] << 24) | (byte[1] << 16) | (byte[2] << 8) | byte[3];
|
|
|
|
return regval;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_putreg8
|
|
*
|
|
* Description:
|
|
* Write to an 8-bit vl53l1x register
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_putreg8(FAR struct vl53l1x_dev_s *priv, uint16_t regaddr,
|
|
uint8_t regval)
|
|
{
|
|
struct i2c_config_s config;
|
|
uint8_t data[3];
|
|
int ret;
|
|
|
|
/* Set up the I2C configuration */
|
|
|
|
config.frequency = priv->freq;
|
|
config.address = priv->addr;
|
|
config.addrlen = 7;
|
|
|
|
data[0] = (regaddr >> 8) & 0xff;
|
|
data[1] = regaddr;
|
|
data[2] = regval & 0xff;
|
|
|
|
/* Write the register address and value */
|
|
|
|
ret = i2c_write(priv->i2c, &config, (FAR uint8_t *) & data, 3);
|
|
if (ret < 0)
|
|
{
|
|
snerr("ERROR: i2c_write failed: %d\n", ret);
|
|
return;
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_putreg16
|
|
*
|
|
* Description:
|
|
* Write to an 16-bit vl53l1x register
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_putreg16(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t regaddr, uint16_t regval)
|
|
{
|
|
struct i2c_config_s config;
|
|
uint8_t data[4];
|
|
int ret;
|
|
|
|
/* Set up the I2C configuration */
|
|
|
|
config.frequency = priv->freq;
|
|
config.address = priv->addr;
|
|
config.addrlen = 7;
|
|
|
|
data[0] = (regaddr >> 8) & 0xff;
|
|
data[1] = regaddr;
|
|
data[2] = (regval >> 8) & 0xff;
|
|
data[3] = regval & 0xff;
|
|
|
|
/* Write the register address and value */
|
|
|
|
ret = i2c_write(priv->i2c, &config, (FAR uint8_t *) & data, 4);
|
|
if (ret < 0)
|
|
{
|
|
snerr("ERROR: i2c_write failed: %d\n", ret);
|
|
return;
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_putreg32
|
|
*
|
|
* Description:
|
|
* Write to an 32-bit vl53l1x register
|
|
*
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_putreg32(FAR struct vl53l1x_dev_s *priv,
|
|
uint16_t regaddr, uint32_t regval)
|
|
{
|
|
struct i2c_config_s config;
|
|
uint8_t data[7];
|
|
int ret;
|
|
|
|
/* Set up the I2C configuration */
|
|
|
|
config.frequency = priv->freq;
|
|
config.address = priv->addr;
|
|
config.addrlen = 7;
|
|
|
|
data[0] = (regaddr >> 8) & 0xff;
|
|
data[1] = regaddr;
|
|
data[2] = (regval >> 24) & 0xff;
|
|
data[4] = (regval >> 16) & 0xff;
|
|
data[5] = (regval >> 8) & 0xff;
|
|
data[6] = regval & 0xff;
|
|
|
|
/* Write the register address and value */
|
|
|
|
ret = i2c_write(priv->i2c, &config, (FAR uint8_t *) & data, 7);
|
|
if (ret < 0)
|
|
{
|
|
snerr("ERROR: i2c_write failed: %d\n", ret);
|
|
return;
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_read
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_read(FAR struct file *filep, FAR char *buffer,
|
|
size_t buflen)
|
|
{
|
|
FAR struct inode *inode = filep->f_inode;
|
|
FAR struct vl53l1x_dev_s *priv = inode->i_private;
|
|
FAR uint16_t *aux = (FAR uint16_t *) buffer;
|
|
|
|
vl53l1x_startranging(priv);
|
|
vl53l1x_getdistance(priv, aux);
|
|
vl53l1x_stopranging(priv);
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_write
|
|
****************************************************************************/
|
|
|
|
static ssize_t vl53l1x_write(FAR struct file *filep, FAR const char *buffer,
|
|
size_t buflen)
|
|
{
|
|
return -ENOSYS;
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_ioctl
|
|
****************************************************************************/
|
|
|
|
static void vl53l1x_ioctl(FAR struct file *filep, int cmd, uint16_t arg)
|
|
{
|
|
FAR struct inode *inode = filep->f_inode;
|
|
FAR struct vl53l1x_dev_s *priv = inode->i_private;
|
|
|
|
switch (cmd)
|
|
{
|
|
case SNIOC_DISTANCESHORT:
|
|
{
|
|
sninfo("Set distance up to 1.3M\n");
|
|
vl53l1x_setdistancemode(priv, 1);
|
|
}
|
|
break;
|
|
|
|
case SNIOC_DISTANCELONG:
|
|
{
|
|
sninfo("Set distance up to 4M\n");
|
|
vl53l1x_setdistancemode(priv, 2);
|
|
}
|
|
break;
|
|
|
|
case SNIOC_CALIBRATE:
|
|
{
|
|
sninfo("Calibrating distance\n");
|
|
int16_t offset;
|
|
vl53l1x_getoffset(priv, (FAR int16_t *)&offset);
|
|
vl53l1x_calibrateoffset(priv, arg, (FAR int16_t *)&offset);
|
|
}
|
|
break;
|
|
|
|
case SNIOC_TEMPUPDATE:
|
|
{
|
|
sninfo("Recalculating due to temperature change\n");
|
|
vl53l1x_tempupdate(priv);
|
|
}
|
|
break;
|
|
}
|
|
}
|
|
|
|
/****************************************************************************
|
|
* Public Functions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: vl53l1x_register
|
|
*
|
|
* Description:
|
|
* Register the vl53l1x character device as 'devpath'
|
|
*
|
|
* Input Parameters:
|
|
* devpath - The full path to the driver to register. E.g., "/dev/tof"
|
|
* i2c - An instance of the I2C interface to use to communicate with
|
|
* vl53l1x TOF
|
|
*
|
|
* Returned Value:
|
|
* Zero (OK) on success; a negated errno value on failure.
|
|
*
|
|
****************************************************************************/
|
|
|
|
int vl53l1x_register(FAR const char *devpath, FAR struct i2c_master_s *i2c)
|
|
{
|
|
FAR struct vl53l1x_dev_s *priv;
|
|
int ret = 0;
|
|
uint16_t id;
|
|
|
|
/* Initialize the vl53l1x device structure */
|
|
|
|
priv = kmm_malloc(sizeof(struct vl53l1x_dev_s));
|
|
if (!priv)
|
|
{
|
|
snerr("ERROR: Failed to allocate instance\n");
|
|
return -ENOMEM;
|
|
}
|
|
|
|
priv->i2c = i2c;
|
|
priv->addr = VL53L1X_ADDR;
|
|
priv->freq = VL53L1X_FREQ;
|
|
|
|
vl53l1x_sensorinit(priv);
|
|
|
|
vl53l1x_getid(priv, &id);
|
|
if (id != 0xeacc)
|
|
{
|
|
snerr("ERROR: Failed sensor ID %04x\n", id);
|
|
kmm_free(priv);
|
|
return 0;
|
|
}
|
|
|
|
register_driver(devpath, &g_vl53l1xfops, 0666, priv);
|
|
if (ret < 0)
|
|
{
|
|
snerr("ERROR: Failed to register driver: %d\n", ret);
|
|
kmm_free(priv);
|
|
return 0;
|
|
}
|
|
|
|
sninfo("vl53l1x driver loaded successfully!\n");
|
|
return 1;
|
|
}
|
|
|
|
#endif /* CONFIG_I2C && CONFIG_SENSORS_VL53L1X */
|