kx122: Added driver files to src
Signed-off-by: Samuli Rissanen <samuli.rissanen@hotmail.com> Signed-off-by: Noel Eck <noel.eck@intel.com>
This commit is contained in:
Samuli Rissanen
493
src/kx122/kx122.hpp
Normal file
493
src/kx122/kx122.hpp
Normal file
@@ -0,0 +1,493 @@
|
||||
/*
|
||||
* The MIT License (MIT)
|
||||
*
|
||||
* Author: Samuli Rissanen <samuli.rissanen@hotmail.com>
|
||||
* Copyright (c) 2018 Rohm Semiconductor.
|
||||
*
|
||||
* Permission is hereby granted, free of charge, to any person obtaining a copy of
|
||||
* this software and associated documentation files (the "Software"), to deal in
|
||||
* the Software without restriction, including without limitation the rights to
|
||||
* use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
||||
* the Software, and to permit persons to whom the Software is furnished to do so,
|
||||
* subject to the following conditions:
|
||||
*
|
||||
* The above copyright notice and this permission notice shall be included in all
|
||||
* copies or substantial portions of the Software.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
||||
* FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
||||
* COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
||||
* IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
||||
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
*/
|
||||
|
||||
#include <mraa/gpio.hpp>
|
||||
|
||||
extern "C"{
|
||||
#include "kx122.h"
|
||||
}
|
||||
|
||||
/**
|
||||
* @file kx122.hpp
|
||||
* @library kx122
|
||||
* @brief C++ API for the kx122 driver
|
||||
*
|
||||
* @include kx122.cxx
|
||||
*/
|
||||
|
||||
namespace upm{
|
||||
|
||||
class KX122{
|
||||
public:
|
||||
|
||||
/**
|
||||
KX122 constructor
|
||||
Set addr to -1 if using SPI.
|
||||
When using I2C, set chip_select_pin to -1
|
||||
|
||||
@param bus I2C or SPI bus to use.
|
||||
@param addr I2C address of the sensor.
|
||||
@param chip_select Chip select pin for SPI.
|
||||
@throws std::runtime_error on initialization failure.
|
||||
*/
|
||||
KX122(int bus, int addr, int chip_select);
|
||||
|
||||
/**
|
||||
KX122 destructor
|
||||
*/
|
||||
~KX122();
|
||||
|
||||
/**
|
||||
Initializes the sensor with given sampling rate, resolution and acceleration range.
|
||||
This gets called in the constructor, so it will not need to be called unless the device is reset.
|
||||
|
||||
Sensor is automatically set into standby mode during the initialization.
|
||||
Sensor is set to active mode after initialization.
|
||||
|
||||
@param odr One of the KX122_ODR_T values.
|
||||
@param res One of the KX122_RES_T values.
|
||||
@param grange One of the KX122_RANGE_T values.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void deviceInit(KX122_ODR_T odr, KX122_RES_T res, KX122_RANGE_T grange);
|
||||
|
||||
/**
|
||||
Gets the length of one sample period depeding on the sampling rate of the sensor.
|
||||
@return Floating point value of the sampling period, or if error occurs returns -1.
|
||||
*/
|
||||
float getSamplePeriod();
|
||||
|
||||
/**
|
||||
Gets who am i value of the sensor.
|
||||
|
||||
@param data Pointer to a uint8_t variable to store the value.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void getWhoAmI(uint8_t *data);
|
||||
|
||||
/**
|
||||
Gets raw accelerometer data from the sensor.
|
||||
@param x Pointer to a floating point variable to store the x-axis value. Can be set to NULL if not wanted.
|
||||
@param y Pointer to a floating point variable to store the y-axis value. Can be set to NULL if not wanted.
|
||||
@param z Pointer to a floating point variable to store the z-axis value. Can be set to NULL if not wanted.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void getRawAccelerationData(float *x, float *y, float *z);
|
||||
|
||||
/**
|
||||
Gets converted (m/s^2) accelerometer data from the sensor.
|
||||
|
||||
@param x Pointer to a floating point variable to store the x-axis value. Can be set to NULL if not wanted.
|
||||
@param y Pointer to a floating point variable to store the y-axis value. Can be set to NULL if not wanted.
|
||||
@param z Pointer to a floating point variable to store the z-axis value. Can be set to NULL if not wanted.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void getAccelerationData(float *x, float *y, float *z);
|
||||
|
||||
/**
|
||||
Performs a sensor software reset. The software reset clears the RAM of the sensor and resets all registers
|
||||
to pre-defined values.
|
||||
|
||||
You should call deviceInit() after the software reset.
|
||||
|
||||
See the datasheet for more details.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void softwareReset();
|
||||
|
||||
/**
|
||||
Enables sensor filter bypass.
|
||||
|
||||
Sensor needs to be in standby mode when enabling the filter bypass.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void enableIIR();
|
||||
|
||||
/**
|
||||
Disables sensor filter bypass.
|
||||
|
||||
Sensor needs to be in standby mode when enabling the filter bypass.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void disableIIR();
|
||||
|
||||
/**
|
||||
Performs a self-test of the sensor. The test applies an electrostatic force to the sensor,
|
||||
simulating input acceleration. The test compares samples from all axis before and after
|
||||
applying the electrostatic force to the sensor. If the amount of acceleration increases according
|
||||
to the values defined in TABLE 1 of the datasheet, the test passes.
|
||||
|
||||
See the datasheet for more information.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void selfTest();
|
||||
|
||||
/**
|
||||
Sets the sensor to the standby mode.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void setSensorStandby();
|
||||
|
||||
/**
|
||||
Sets the sensor to the active mode.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void setSensorActive();
|
||||
|
||||
/**
|
||||
Sets the data sampling rate of the sensor.
|
||||
|
||||
Sensor needs to be in standby mode when setting the data sampling rate.
|
||||
|
||||
@param odr One of the KX122_ODR_T values.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void setODR(KX122_ODR_T odr);
|
||||
|
||||
/**
|
||||
Sets the acceleration range of the sensor.
|
||||
|
||||
Sensor needs to be in standby mode when setting the acceleration range value.
|
||||
|
||||
@param grange One of the KX122_RANGE_T values.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void setGrange(KX122_RANGE_T grange);
|
||||
|
||||
/**
|
||||
Sets the resolution of the sensor. High resolution (16 bits) or low resolution (8 bits).
|
||||
|
||||
Sensor needs to be in standby mode when setting the sensor resolution.
|
||||
|
||||
@param res One of the KX122_RES_T values.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void setResolution(KX122_RES_T res);
|
||||
|
||||
/**
|
||||
Sets the low pass filter roll off
|
||||
|
||||
Sensor needs to be in standby mode when setting the filter roll off value.
|
||||
|
||||
@param lpro One of the LPRO_STATE_T values.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void setBW(LPRO_STATE_T lpro);
|
||||
|
||||
/**
|
||||
Set the amount of samples to be averaged in low power mode.
|
||||
|
||||
Sensor needs to be in standby mode when setting the average value.
|
||||
|
||||
@param avg One of the KX122_AVG_T values.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void setAverage(KX122_AVG_T avg);
|
||||
|
||||
/**
|
||||
Installs an interrupt handler to be executed when an interrupt is detected on the interrupt pin.
|
||||
|
||||
@param edge One of the mraa::Edge values. Interrupt trigger edge.
|
||||
@param intp One of the KX122_INTERRUPT_PIN_T values. Specifies which interrupt pin you are setting.
|
||||
@param pin The GPIO pin to use as the interrupt pin.
|
||||
@param isr Pointer to the function to be called, when the interrupt occurs.
|
||||
@param arg The arguments to be passed to the function.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void installISR(mraa::Edge edge, KX122_INTERRUPT_PIN_T intp, int pin, void (*isr)(void*), void *arg);
|
||||
|
||||
/**
|
||||
Uninstalls a previously installed interrupt handler.
|
||||
|
||||
@param intp One of the KX122_INTERRUPT_PIN_T values. Specifies which interrupt pin handler is uninstalled.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void uninstallISR(KX122_INTERRUPT_PIN_T intp);
|
||||
|
||||
/**
|
||||
Enables interrupts on the interrupt pin 1 of the sensor.
|
||||
|
||||
Pulse width = 50us (10us if data sampling rate > 1600Hz).
|
||||
Using pulse mode.
|
||||
|
||||
Sensor needs to be in standby mode when enabling the interrupt.
|
||||
|
||||
See datasheet for more details.
|
||||
|
||||
@param polarity One of the KX122_INTERRUPT_POLARITY_T values. Select the polarity of the interrupt.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void enableInterrupt1(KX122_INTERRUPT_POLARITY_T polarity);
|
||||
|
||||
/**
|
||||
Enables interrupts on the interrupt pin 2 of the sensor.
|
||||
|
||||
Pulse width = 50us (10us if data sampling rate > 1600Hz).
|
||||
Using pulse mode.
|
||||
|
||||
Sensor needs to be in standby mode when enabling the interrupt.
|
||||
|
||||
See datasheet for more details.
|
||||
|
||||
@param polarity One of the KX122_INTERRUPT_POLARITY_T values. Select the polarity of the interrupt.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void enableInterrupt2(KX122_INTERRUPT_POLARITY_T polarity);
|
||||
|
||||
/**
|
||||
Disables interrupts on the interrupt pin 1 of the sensor.
|
||||
|
||||
Sensor needs to be in standby mode when disabling the interrupt pin 1.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void disableInterrupt1();
|
||||
|
||||
/**
|
||||
Disables interrupts on the interrupt pin 2 of the sensor.
|
||||
|
||||
Sensor needs to be in standby mode when disabling the interrupt pin 2.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void disableInterrupt2();
|
||||
|
||||
/**
|
||||
Routes the interrupts to the interrupt pin 1 of the sensor.
|
||||
|
||||
Sensor needs to be in standby mode when routing the interrupts.
|
||||
|
||||
See datasheet for more details.
|
||||
|
||||
@param bits One or more of the KX122_INTERRUPT_T values. Combine with bitwise OR (|)
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void routeInterrupt1(uint8_t bits);
|
||||
|
||||
/**
|
||||
Routes the interrupts to the interrupt pin 2 of the sensor.
|
||||
|
||||
Sensor needs to be in standby mode when routing the interrupts.
|
||||
|
||||
See datasheet for more details.
|
||||
|
||||
@param bits One or more of the KX122_INTERRUPT_T values. Combine with bitwise OR (|)
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void routeInterrupt2(uint8_t bits);
|
||||
|
||||
/**
|
||||
Gets the status of the interrupts. (Has an interrupt occured)
|
||||
|
||||
See datasheet for more details.
|
||||
|
||||
@param data Pointer to a uint8_t variable to store the value.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void getInterruptStatus(uint8_t *data);
|
||||
|
||||
/**
|
||||
Gets the source of the interrupt.
|
||||
|
||||
See datasheet for more details.
|
||||
|
||||
@param data Pointer to a uint8_t variable to store the value.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void getInterruptSource(uint8_t *data);
|
||||
|
||||
/**
|
||||
Clears latching interrupts (Wakeup, Data Ready).
|
||||
|
||||
See datasheet for more details.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void clearInterrupt();
|
||||
|
||||
/**
|
||||
Enables the data ready interrupt. Availability of new acceleration data is
|
||||
reflected as an interrupt.
|
||||
|
||||
Sensor needs to be in standby mode when enabling the interrupt.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void enableDataReadyInterrupt();
|
||||
|
||||
/**
|
||||
Disables the data ready interrupt.
|
||||
|
||||
Sensor needs to be in standby mode when disabling the interrupt.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void disableDataReadyInterrupt();
|
||||
|
||||
/**
|
||||
Enables the buffer full interrupt.
|
||||
Buffer can hold 681 sets of values (8 bit, low resolution mode) or
|
||||
340 sets of values (16 bit, high resolution mode).
|
||||
|
||||
Sensor needs to be in standby mode when enabling the interrupt.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void enableBufferFullInterrupt();
|
||||
|
||||
/**
|
||||
Disables the buffer full interrupt.
|
||||
|
||||
Sensor needs to be in standby mode when disabling the interrupt.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void disableBufferFullInterrupt();
|
||||
|
||||
/**
|
||||
Enables the buffer.
|
||||
|
||||
Sensor needs to be in standby mode when enabling the buffer.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void enableBuffer();
|
||||
|
||||
/**
|
||||
Disables the buffer.
|
||||
|
||||
Sensor needs to be in standby mode when disabling the buffer.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void disableBuffer();
|
||||
|
||||
/**
|
||||
Initializes the buffer with the given sample watermark level, buffer resolution and buffer operating mode.
|
||||
Buffer is enabled after the initialization.
|
||||
|
||||
Sensor is automatically set into standby mode during the buffer initialization.
|
||||
Sensor is set to active mode after initialization.
|
||||
|
||||
See the other buffer functions for details about the different parameter values.
|
||||
|
||||
@param samples Amount of samples to trigger the watermark interrupt.
|
||||
@param res One of the KX122_RES_T values.
|
||||
@param mode One of the KX122_BUFFER_MODE_T values.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void bufferInit(uint samples, KX122_RES_T res, KX122_BUFFER_MODE_T mode);
|
||||
|
||||
/**
|
||||
Sets the buffer resolution.
|
||||
Buffer resolution is indepedent of the sensor resolution.
|
||||
|
||||
Sensor needs to be in standby mode when setting the buffer resolution.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void setBufferResolution(KX122_RES_T res);
|
||||
|
||||
/**
|
||||
Sets the buffer watermark interrupt threshold.
|
||||
When the buffer sample count reaches the watermark, watermark interrupt will be given.
|
||||
|
||||
In low resolution mode, maxiumum number of samples is 681. In high resolution, the maximum
|
||||
number is 340.
|
||||
|
||||
See datasheet for more details.
|
||||
|
||||
Sensor needs to be in standby mode when setting the buffer threshold.
|
||||
|
||||
@param samples Amount of samples to trigger the watermark interrupt.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void setBufferThreshold(uint samples);
|
||||
|
||||
/**
|
||||
Sets the buffer operating mode.
|
||||
The buffer can operate in FIFO,FILO or Stream mode.
|
||||
The buffer gathers data, reports data and interracts with the status indicators
|
||||
in a slightly different way depending on the operating mode.
|
||||
|
||||
See datasheet for more details.
|
||||
|
||||
Sensor needs to be in standby mode when setting the buffer mode.
|
||||
|
||||
@param mode One of the KX122_BUFFER_MODE_T values.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void setBufferMode(KX122_BUFFER_MODE_T mode);
|
||||
|
||||
/**
|
||||
Gets the current amount of samples in the buffer.
|
||||
|
||||
@param samples Pointer to an uint variable to store the data.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void getBufferStatus(uint *samples);
|
||||
|
||||
/**
|
||||
Gets the specified amount of raw acceleration samples from the buffer.
|
||||
|
||||
Make sure the array size is atleast the amount of samples to be read.
|
||||
|
||||
@param len The amount of samples to read from the buffer.
|
||||
@param x_array Pointer to an floating point array to store the x-axis data. Can be set to NULL if not wanted.
|
||||
@param y_array Pointer to an floating point array to store the y-axis data. Can be set to NULL if not wanted.
|
||||
@param z_array Pointer to an floating point array to store the z-axis data. Can be set to NULL if not wanted.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void getRawBufferSamples(uint len, float *x_array, float *y_array, float *z_array);
|
||||
|
||||
/**
|
||||
Gets the specified amount of converted (m/s^2) acceleration samples from the buffer.
|
||||
|
||||
Make sure the array size is atleast the amount of samples to be read.
|
||||
|
||||
@param len The amount of samples to read from the buffer.
|
||||
@param x_array Pointer to an floating point array to store the x-axis data. Can be set to NULL if not wanted.
|
||||
@param y_array Pointer to an floating point array to store the y-axis data. Can be set to NULL if not wanted.
|
||||
@param z_array Pointer to an floating point array to store the z-axis data. Can be set to NULL if not wanted.
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void getBufferSamples(uint len, float *x_array, float *y_array, float *z_array);
|
||||
|
||||
/**
|
||||
Clears the buffer, removing all existing samples from the buffer.
|
||||
|
||||
@throws std::runtime_error on failure.
|
||||
*/
|
||||
void clearBuffer();
|
||||
private:
|
||||
//Device context
|
||||
kx122_context m_kx122;
|
||||
};
|
||||
}
|
||||
Reference in New Issue
Block a user