ADXL362 accelerometer library

Dependents:   ADXL362-helloworld EVAL_ADXL362_ARDZ Lab6 Lab6 ... more

For additional information check out the mbed page of the Analog Devices wiki: https://wiki.analog.com/resources/tools-software/mbed-drivers-all

Committer:
adisuciu
Date:
Thu Aug 18 12:33:31 2016 +0000
Revision:
1:ae171c032dc0
Parent:
0:2e21c4508cab
Implemented missing doxygen tags

Who changed what in which revision?

UserRevisionLine numberNew contents of line
adisuciu 0:2e21c4508cab 1 /**
adisuciu 0:2e21c4508cab 2 * @file ADXL362.cpp
adisuciu 0:2e21c4508cab 3 * @brief Source file for ADXL362
adisuciu 0:2e21c4508cab 4 * @author Analog Devices Inc.
adisuciu 0:2e21c4508cab 5 *
adisuciu 0:2e21c4508cab 6 * For support please go to:
adisuciu 0:2e21c4508cab 7 * Github: https://github.com/analogdevicesinc/mbed-adi
adisuciu 0:2e21c4508cab 8 * Support: https://ez.analog.com/community/linux-device-drivers/microcontroller-no-os-drivers
adisuciu 0:2e21c4508cab 9 * Product: http://www.analog.com/adxl362
adisuciu 0:2e21c4508cab 10 * More: https://wiki.analog.com/resources/tools-software/mbed-drivers-all
adisuciu 0:2e21c4508cab 11
adisuciu 0:2e21c4508cab 12 ********************************************************************************
adisuciu 0:2e21c4508cab 13 * Copyright 2016(c) Analog Devices, Inc.
adisuciu 0:2e21c4508cab 14 *
adisuciu 0:2e21c4508cab 15 * All rights reserved.
adisuciu 0:2e21c4508cab 16 *
adisuciu 0:2e21c4508cab 17 * Redistribution and use in source and binary forms, with or without
adisuciu 0:2e21c4508cab 18 * modification, are permitted provided that the following conditions are met:
adisuciu 0:2e21c4508cab 19 * - Redistributions of source code must retain the above copyright
adisuciu 0:2e21c4508cab 20 * notice, this list of conditions and the following disclaimer.
adisuciu 0:2e21c4508cab 21 * - Redistributions in binary form must reproduce the above copyright
adisuciu 0:2e21c4508cab 22 * notice, this list of conditions and the following disclaimer in
adisuciu 0:2e21c4508cab 23 * the documentation and/or other materials provided with the
adisuciu 0:2e21c4508cab 24 * distribution.
adisuciu 0:2e21c4508cab 25 * - Neither the name of Analog Devices, Inc. nor the names of its
adisuciu 0:2e21c4508cab 26 * contributors may be used to endorse or promote products derived
adisuciu 0:2e21c4508cab 27 * from this software without specific prior written permission.
adisuciu 0:2e21c4508cab 28 * - The use of this software may or may not infringe the patent rights
adisuciu 0:2e21c4508cab 29 * of one or more patent holders. This license does not release you
adisuciu 0:2e21c4508cab 30 * from the requirement that you obtain separate licenses from these
adisuciu 0:2e21c4508cab 31 * patent holders to use this software.
adisuciu 0:2e21c4508cab 32 * - Use of the software either in source or binary form, must be run
adisuciu 0:2e21c4508cab 33 * on or directly connected to an Analog Devices Inc. component.
adisuciu 0:2e21c4508cab 34 *
adisuciu 0:2e21c4508cab 35 * THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR
adisuciu 0:2e21c4508cab 36 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT,
adisuciu 0:2e21c4508cab 37 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
adisuciu 0:2e21c4508cab 38 * IN NO EVENT SHALL ANALOG DEVICES BE LIABLE FOR ANY DIRECT, INDIRECT,
adisuciu 0:2e21c4508cab 39 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
adisuciu 0:2e21c4508cab 40 * LIMITED TO, INTELLECTUAL PROPERTY RIGHTS, PROCUREMENT OF SUBSTITUTE GOODS OR
adisuciu 0:2e21c4508cab 41 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
adisuciu 0:2e21c4508cab 42 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
adisuciu 0:2e21c4508cab 43 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
adisuciu 0:2e21c4508cab 44 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
adisuciu 0:2e21c4508cab 45 *
adisuciu 0:2e21c4508cab 46 ********************************************************************************/
adisuciu 0:2e21c4508cab 47
adisuciu 0:2e21c4508cab 48 #include <stdint.h>
adisuciu 0:2e21c4508cab 49 #include "mbed.h"
adisuciu 0:2e21c4508cab 50 #include "ADXL362.h"
adisuciu 0:2e21c4508cab 51
adisuciu 0:2e21c4508cab 52 /**
adisuciu 0:2e21c4508cab 53 * ADXL362 constructor. Sets CS and SPI bus
adisuciu 0:2e21c4508cab 54 * @param CS - CS pin of the ADXL362
adisuciu 0:2e21c4508cab 55 * @param MOSI - MOSI pin of the ADXL362
adisuciu 0:2e21c4508cab 56 * @param MISO - MISO pin of the ADXL362
adisuciu 0:2e21c4508cab 57 * @param SCK- SCK pin of the ADXL362
adisuciu 0:2e21c4508cab 58 */
adisuciu 0:2e21c4508cab 59 ADXL362::ADXL362(PinName CS, PinName MOSI, PinName MISO, PinName SCK) :
adisuciu 0:2e21c4508cab 60 adxl362(MOSI, MISO, SCK), cs(CS), _int1(NULL), _int2(NULL), _int1_poll(NC), _int2_poll(
adisuciu 0:2e21c4508cab 61 NC)
adisuciu 0:2e21c4508cab 62 {
adisuciu 0:2e21c4508cab 63 cs = true; // cs is active low
adisuciu 0:2e21c4508cab 64 adxl362.format(8, _SPI_MODE);
adisuciu 0:2e21c4508cab 65 _temp_stored_in_fifo = false;
adisuciu 0:2e21c4508cab 66 _int1_act_low = true;
adisuciu 0:2e21c4508cab 67 _int2_act_low = true;
adisuciu 0:2e21c4508cab 68 }
adisuciu 0:2e21c4508cab 69
adisuciu 0:2e21c4508cab 70 /**
adisuciu 0:2e21c4508cab 71 * Sets ADXL362 SPI bus frequency
adisuciu 0:2e21c4508cab 72 * @param hz - frequency in hz
adisuciu 0:2e21c4508cab 73 */
adisuciu 0:2e21c4508cab 74 void ADXL362::frequency(int hz)
adisuciu 0:2e21c4508cab 75 {
adisuciu 0:2e21c4508cab 76 adxl362.frequency(hz);
adisuciu 0:2e21c4508cab 77 }
adisuciu 0:2e21c4508cab 78
adisuciu 0:2e21c4508cab 79 /**
adisuciu 0:2e21c4508cab 80 * Resets the ADXL362
adisuciu 0:2e21c4508cab 81 * A latency of approximately 0.5 ms is required after soft reset.
adisuciu 0:2e21c4508cab 82 */
adisuciu 0:2e21c4508cab 83 void ADXL362::reset()
adisuciu 0:2e21c4508cab 84 {
adisuciu 0:2e21c4508cab 85 adxl362.format(8, _SPI_MODE);
adisuciu 0:2e21c4508cab 86 cs = false;
adisuciu 0:2e21c4508cab 87 // Writing Code 0x52 (representing the letter, R, in ASCII or unicode) to this register immediately resets the ADXL362.
adisuciu 0:2e21c4508cab 88 write_reg(SOFT_RESET, 0x52);
adisuciu 0:2e21c4508cab 89 cs = true;
adisuciu 0:2e21c4508cab 90
adisuciu 0:2e21c4508cab 91 }
adisuciu 0:2e21c4508cab 92
adisuciu 0:2e21c4508cab 93 /**
adisuciu 0:2e21c4508cab 94 * Writes the reg register with data
adisuciu 0:2e21c4508cab 95 * @param reg - ADXL362_register_t register to be written
adisuciu 0:2e21c4508cab 96 * @param data - data to be written
adisuciu 0:2e21c4508cab 97 */
adisuciu 0:2e21c4508cab 98 void ADXL362::write_reg(ADXL362_register_t reg, uint8_t data)
adisuciu 0:2e21c4508cab 99 {
adisuciu 0:2e21c4508cab 100 adxl362.format(8, _SPI_MODE);
adisuciu 0:2e21c4508cab 101 cs = false;
adisuciu 0:2e21c4508cab 102 adxl362.write(_WRITE_REG_CMD);
adisuciu 0:2e21c4508cab 103 adxl362.write(static_cast<uint8_t>(reg));
adisuciu 0:2e21c4508cab 104 adxl362.write(static_cast<uint8_t>(data));
adisuciu 0:2e21c4508cab 105 cs = true;
adisuciu 0:2e21c4508cab 106 }
adisuciu 0:2e21c4508cab 107
adisuciu 0:2e21c4508cab 108 /**
adisuciu 0:2e21c4508cab 109 * Reads the reg register
adisuciu 0:2e21c4508cab 110 * @param reg - ADXL362_register_t register to be read
adisuciu 0:2e21c4508cab 111 * @return - data read from the register
adisuciu 0:2e21c4508cab 112 */
adisuciu 0:2e21c4508cab 113 uint8_t ADXL362::read_reg(ADXL362_register_t reg)
adisuciu 0:2e21c4508cab 114 {
adisuciu 0:2e21c4508cab 115 uint8_t ret_val;
adisuciu 0:2e21c4508cab 116 adxl362.format(8, _SPI_MODE);
adisuciu 0:2e21c4508cab 117 cs = false;
adisuciu 0:2e21c4508cab 118 adxl362.write(_READ_REG_CMD);
adisuciu 0:2e21c4508cab 119 adxl362.write(static_cast<uint8_t>(reg));
adisuciu 0:2e21c4508cab 120 ret_val = adxl362.write(_DUMMY_BYTE);
adisuciu 0:2e21c4508cab 121 cs = true;
adisuciu 0:2e21c4508cab 122 return ret_val;
adisuciu 0:2e21c4508cab 123 }
adisuciu 0:2e21c4508cab 124
adisuciu 0:2e21c4508cab 125 /**
adisuciu 0:2e21c4508cab 126 * Writes 16 bit registers to the ADXL362. Performs conversion from Intel to Motorola byte order
adisuciu 0:2e21c4508cab 127 * @param reg - ADXL362_register_t register to be written
adisuciu 0:2e21c4508cab 128 * @param data - data to be written
adisuciu 0:2e21c4508cab 129 */
adisuciu 0:2e21c4508cab 130 void ADXL362::write_reg_u16(ADXL362_register_t reg, uint16_t data)
adisuciu 0:2e21c4508cab 131 {
adisuciu 0:2e21c4508cab 132 adxl362.format(8, _SPI_MODE);
adisuciu 0:2e21c4508cab 133
adisuciu 0:2e21c4508cab 134 cs = false;
adisuciu 0:2e21c4508cab 135 adxl362.write(_WRITE_REG_CMD);
adisuciu 0:2e21c4508cab 136 adxl362.write(static_cast<uint8_t>(reg));
adisuciu 0:2e21c4508cab 137 adxl362.write(static_cast<uint8_t>(data & 0xff));
adisuciu 0:2e21c4508cab 138 adxl362.write(static_cast<uint8_t>((data & 0xff00) >> 8));
adisuciu 0:2e21c4508cab 139
adisuciu 0:2e21c4508cab 140 cs = true;
adisuciu 0:2e21c4508cab 141 }
adisuciu 0:2e21c4508cab 142
adisuciu 0:2e21c4508cab 143 /**
adisuciu 0:2e21c4508cab 144 * Reads 16 bit registers from the ADXL362. Performs conversion from Motorola to Intel Byte order
adisuciu 0:2e21c4508cab 145 * @param reg - ADXL362_register_t register to be read
adisuciu 0:2e21c4508cab 146 * @return - data read from the ADXL362
adisuciu 0:2e21c4508cab 147 */
adisuciu 0:2e21c4508cab 148 uint16_t ADXL362::read_reg_u16(ADXL362_register_t reg)
adisuciu 0:2e21c4508cab 149 {
adisuciu 0:2e21c4508cab 150 uint16_t ret_val = 0;
adisuciu 0:2e21c4508cab 151 adxl362.format(8, _SPI_MODE);
adisuciu 0:2e21c4508cab 152
adisuciu 0:2e21c4508cab 153 cs = false;
adisuciu 0:2e21c4508cab 154 adxl362.write(_READ_REG_CMD);
adisuciu 0:2e21c4508cab 155 adxl362.write(static_cast<uint8_t>(reg));
adisuciu 0:2e21c4508cab 156 ret_val = adxl362.write(_DUMMY_BYTE);
adisuciu 0:2e21c4508cab 157 ret_val = ret_val | (adxl362.write(_DUMMY_BYTE) << 8);
adisuciu 0:2e21c4508cab 158 cs = true;
adisuciu 0:2e21c4508cab 159
adisuciu 0:2e21c4508cab 160 return ret_val;
adisuciu 0:2e21c4508cab 161 }
adisuciu 0:2e21c4508cab 162
adisuciu 0:2e21c4508cab 163 /**
adisuciu 0:2e21c4508cab 164 * Scans the X,Y,Z,T registers for data.
adisuciu 0:2e21c4508cab 165 * ADXL362 needs to be in measurement mode to read data
adisuciu 0:2e21c4508cab 166 * ADXL362 is set in measurement mode using ADXL362::set_mode(ADXL362::MEASUREMENT)
adisuciu 0:2e21c4508cab 167 * @return a 64 bit integer with the following format 0xXXYYZZTT
adisuciu 0:2e21c4508cab 168 */
adisuciu 0:2e21c4508cab 169 uint64_t ADXL362::scan()
adisuciu 0:2e21c4508cab 170 {
adisuciu 0:2e21c4508cab 171 uint64_t ret_val = 0;
adisuciu 0:2e21c4508cab 172 uint16_t x, y, z, t = 0;
adisuciu 0:2e21c4508cab 173
adisuciu 0:2e21c4508cab 174 adxl362.format(8, _SPI_MODE);
adisuciu 0:2e21c4508cab 175 cs = false;
adisuciu 0:2e21c4508cab 176 adxl362.write(_READ_REG_CMD);
adisuciu 0:2e21c4508cab 177 adxl362.write(static_cast<uint8_t>(XDATA_L));
adisuciu 0:2e21c4508cab 178
adisuciu 0:2e21c4508cab 179 x = adxl362.write(_DUMMY_BYTE);
adisuciu 0:2e21c4508cab 180 x = x | static_cast<uint16_t>(adxl362.write(_DUMMY_BYTE) << 8);
adisuciu 0:2e21c4508cab 181 y = adxl362.write(_DUMMY_BYTE);
adisuciu 0:2e21c4508cab 182 y = y | static_cast<uint16_t>(adxl362.write(_DUMMY_BYTE) << 8);
adisuciu 0:2e21c4508cab 183 z = adxl362.write(_DUMMY_BYTE);
adisuciu 0:2e21c4508cab 184 z = z | static_cast<uint16_t>(adxl362.write(_DUMMY_BYTE) << 8);
adisuciu 0:2e21c4508cab 185 t = adxl362.write(_DUMMY_BYTE);
adisuciu 0:2e21c4508cab 186 t = t | static_cast<uint16_t>(adxl362.write(_DUMMY_BYTE) << 8);
adisuciu 0:2e21c4508cab 187
adisuciu 0:2e21c4508cab 188 ret_val = static_cast<uint64_t>(x) << 48;
adisuciu 0:2e21c4508cab 189 ret_val |= static_cast<uint64_t>(y) << 32;
adisuciu 0:2e21c4508cab 190 ret_val |= static_cast<uint64_t>(z) << 16;
adisuciu 0:2e21c4508cab 191 ret_val |= static_cast<uint64_t>(t);
adisuciu 0:2e21c4508cab 192 cs = true;
adisuciu 0:2e21c4508cab 193 return ret_val;
adisuciu 0:2e21c4508cab 194 }
adisuciu 0:2e21c4508cab 195
adisuciu 0:2e21c4508cab 196 /**
adisuciu 0:2e21c4508cab 197 * Reads the X 8 bit register from the ADXL362
adisuciu 0:2e21c4508cab 198 * ADXL362 is set in measurement mode using ADXL362::set_mode(ADXL362::MEASUREMENT)
adisuciu 0:2e21c4508cab 199 * @return 8 bit X data
adisuciu 0:2e21c4508cab 200 */
adisuciu 0:2e21c4508cab 201 uint8_t ADXL362::scanx_u8()
adisuciu 0:2e21c4508cab 202 {
adisuciu 0:2e21c4508cab 203 return read_reg(XDATA);
adisuciu 0:2e21c4508cab 204 }
adisuciu 0:2e21c4508cab 205
adisuciu 0:2e21c4508cab 206 /**
adisuciu 0:2e21c4508cab 207 * Reads the X 16 bit register from the ADXL362
adisuciu 0:2e21c4508cab 208 * ADXL362 is set in measurement mode using ADXL362::set_mode(ADXL362::MEASUREMENT)
adisuciu 0:2e21c4508cab 209 * @return 16 bit X data
adisuciu 0:2e21c4508cab 210 */
adisuciu 0:2e21c4508cab 211 uint16_t ADXL362::scanx()
adisuciu 0:2e21c4508cab 212 {
adisuciu 0:2e21c4508cab 213 return read_reg_u16(XDATA_L);
adisuciu 0:2e21c4508cab 214 }
adisuciu 0:2e21c4508cab 215
adisuciu 0:2e21c4508cab 216 /**
adisuciu 0:2e21c4508cab 217 * Reads the Y 8 bit register from the ADXL362
adisuciu 0:2e21c4508cab 218 * ADXL362 is set in measurement mode using ADXL362::set_mode(ADXL362::MEASUREMENT)
adisuciu 0:2e21c4508cab 219 * @return 8 bit Y data
adisuciu 0:2e21c4508cab 220 */
adisuciu 0:2e21c4508cab 221 uint8_t ADXL362::scany_u8()
adisuciu 0:2e21c4508cab 222 {
adisuciu 0:2e21c4508cab 223 return read_reg(YDATA);
adisuciu 0:2e21c4508cab 224 }
adisuciu 0:2e21c4508cab 225
adisuciu 0:2e21c4508cab 226 /**
adisuciu 0:2e21c4508cab 227 * Reads the Y 16 bit register from the ADXL362
adisuciu 0:2e21c4508cab 228 * ADXL362 is set in measurement mode using ADXL362::set_mode(ADXL362::MEASUREMENT)
adisuciu 0:2e21c4508cab 229 * @return 16 bit Y data
adisuciu 0:2e21c4508cab 230 */
adisuciu 0:2e21c4508cab 231 uint16_t ADXL362::scany()
adisuciu 0:2e21c4508cab 232 {
adisuciu 0:2e21c4508cab 233 return read_reg_u16(YDATA_L);
adisuciu 0:2e21c4508cab 234 }
adisuciu 0:2e21c4508cab 235
adisuciu 0:2e21c4508cab 236 /**
adisuciu 0:2e21c4508cab 237 * Reads the Z 8 bit register from the ADXL362
adisuciu 0:2e21c4508cab 238 * ADXL362 is set in measurement mode using ADXL362::set_mode(ADXL362::MEASUREMENT)
adisuciu 0:2e21c4508cab 239 * @return 8 bit Z data
adisuciu 0:2e21c4508cab 240 */
adisuciu 0:2e21c4508cab 241 uint8_t ADXL362::scanz_u8()
adisuciu 0:2e21c4508cab 242 {
adisuciu 0:2e21c4508cab 243 return read_reg(ZDATA);
adisuciu 0:2e21c4508cab 244 }
adisuciu 0:2e21c4508cab 245
adisuciu 0:2e21c4508cab 246 /**
adisuciu 0:2e21c4508cab 247 * Reads the Z 16 bit register from the ADXL362
adisuciu 0:2e21c4508cab 248 * ADXL362 is set in measurement mode using ADXL362::set_mode(ADXL362::MEASUREMENT)
adisuciu 0:2e21c4508cab 249 * @return 16 bit Z data
adisuciu 0:2e21c4508cab 250 */
adisuciu 0:2e21c4508cab 251 uint16_t ADXL362::scanz()
adisuciu 0:2e21c4508cab 252 {
adisuciu 0:2e21c4508cab 253 return read_reg_u16(ZDATA_L);
adisuciu 0:2e21c4508cab 254 }
adisuciu 0:2e21c4508cab 255
adisuciu 0:2e21c4508cab 256 /**
adisuciu 0:2e21c4508cab 257 * Reads the T 16 bit register from the ADXL362
adisuciu 0:2e21c4508cab 258 * ADXL362 is set in measurement mode using ADXL362::set_mode(ADXL362::MEASUREMENT)
adisuciu 0:2e21c4508cab 259 * @return 16 bit T data
adisuciu 0:2e21c4508cab 260 */
adisuciu 0:2e21c4508cab 261 uint16_t ADXL362::scant()
adisuciu 0:2e21c4508cab 262 {
adisuciu 0:2e21c4508cab 263 return read_reg_u16(TEMP_L);
adisuciu 0:2e21c4508cab 264 }
adisuciu 0:2e21c4508cab 265
adisuciu 0:2e21c4508cab 266 /**
adisuciu 0:2e21c4508cab 267 * Sets the STANDBY/MEASUREMENT mode of the ADXL362
adisuciu 0:2e21c4508cab 268 * @param mode - ADXL362_modes_t STANDBY/MEASUREMENT mode
adisuciu 0:2e21c4508cab 269 */
adisuciu 0:2e21c4508cab 270 void ADXL362::set_mode(ADXL362_modes_t mode)
adisuciu 0:2e21c4508cab 271 {
adisuciu 0:2e21c4508cab 272 uint8_t reg_val;
adisuciu 0:2e21c4508cab 273 reg_val = read_reg(POWER_CTL);
adisuciu 0:2e21c4508cab 274 reg_val = reg_val | static_cast<uint8_t>(mode);
adisuciu 0:2e21c4508cab 275 write_reg(POWER_CTL, reg_val);
adisuciu 0:2e21c4508cab 276 }
adisuciu 0:2e21c4508cab 277
adisuciu 0:2e21c4508cab 278 /**
adisuciu 0:2e21c4508cab 279 * Sets the activity threshold registers
adisuciu 0:2e21c4508cab 280 * To enable activity/inactivity, the ACT_INACT_CTL reg must also be set
adisuciu 0:2e21c4508cab 281 * using the ADXL362::set_act_inact_ctl_reg(uint8_t data) method
adisuciu 0:2e21c4508cab 282 * @param threshold - activity threshold in natural format
adisuciu 0:2e21c4508cab 283 */
adisuciu 0:2e21c4508cab 284 void ADXL362::set_activity_threshold(uint16_t threshold)
adisuciu 0:2e21c4508cab 285 {
adisuciu 0:2e21c4508cab 286 write_reg_u16(THRESH_ACT_L, threshold);
adisuciu 0:2e21c4508cab 287 }
adisuciu 0:2e21c4508cab 288
adisuciu 0:2e21c4508cab 289 /**
adisuciu 0:2e21c4508cab 290 * Sets the activity time register
adisuciu 0:2e21c4508cab 291 * To enable activity/inactivity, the ACT_INACT_CTL reg must also be set
adisuciu 0:2e21c4508cab 292 * using the ADXL362::set_act_inact_ctl_reg(uint8_t data) method
adisuciu 0:2e21c4508cab 293 * @param time - activity time
adisuciu 0:2e21c4508cab 294 */
adisuciu 0:2e21c4508cab 295 void ADXL362::set_activity_time(uint8_t time)
adisuciu 0:2e21c4508cab 296 {
adisuciu 0:2e21c4508cab 297 write_reg(TIME_ACT, time);
adisuciu 0:2e21c4508cab 298 }
adisuciu 0:2e21c4508cab 299
adisuciu 0:2e21c4508cab 300 /**
adisuciu 0:2e21c4508cab 301 * Sets the inactivity threshold register
adisuciu 0:2e21c4508cab 302 * To enable activity/inactivity, the ACT_INACT_CTL reg must also be set
adisuciu 0:2e21c4508cab 303 * using the ADXL362::set_act_inact_ctl_reg(uint8_t data) method
adisuciu 0:2e21c4508cab 304 * @param threshold - inactivity threshold in natural format
adisuciu 0:2e21c4508cab 305 */
adisuciu 0:2e21c4508cab 306 void ADXL362::set_inactivity_threshold(uint16_t threshold)
adisuciu 0:2e21c4508cab 307 {
adisuciu 0:2e21c4508cab 308 write_reg_u16(THRESH_INACT_L, threshold);
adisuciu 0:2e21c4508cab 309 }
adisuciu 0:2e21c4508cab 310
adisuciu 0:2e21c4508cab 311 /**
adisuciu 0:2e21c4508cab 312 * Sets the inactivity time register
adisuciu 0:2e21c4508cab 313 * To enable activity/inactivity, the ACT_INACT_CTL reg must also be set
adisuciu 0:2e21c4508cab 314 * using the ADXL362::set_act_inact_ctl_reg(uint8_t data) method
adisuciu 0:2e21c4508cab 315 * @param time - inactivity time in natural format
adisuciu 0:2e21c4508cab 316 */
adisuciu 0:2e21c4508cab 317 void ADXL362::set_inactivity_time(uint16_t time)
adisuciu 0:2e21c4508cab 318 {
adisuciu 0:2e21c4508cab 319 write_reg_u16(TIME_INACT_L, time);
adisuciu 0:2e21c4508cab 320 }
adisuciu 0:2e21c4508cab 321
adisuciu 0:2e21c4508cab 322 /**
adisuciu 0:2e21c4508cab 323 * Sets the ACT_INACT_CTL register of the ADXL362
adisuciu 0:2e21c4508cab 324 * @param data - data to be written to the register
adisuciu 0:2e21c4508cab 325 */
adisuciu 0:2e21c4508cab 326 void ADXL362::set_act_inact_ctl_reg(uint8_t data)
adisuciu 0:2e21c4508cab 327 {
adisuciu 0:2e21c4508cab 328 write_reg(ACT_INACT_CTL, data);
adisuciu 0:2e21c4508cab 329 }
adisuciu 0:2e21c4508cab 330
adisuciu 0:2e21c4508cab 331 /**
adisuciu 0:2e21c4508cab 332 * Configures INT1 output of the ADXL362 for polling use
adisuciu 0:2e21c4508cab 333 * @param in - uC pin connected to ADXL362's INT1
adisuciu 0:2e21c4508cab 334 * @param data - data to be written to INTMAP1
adisuciu 0:2e21c4508cab 335 * @param pull - (optional) configures pullup on In pin
adisuciu 0:2e21c4508cab 336 */
adisuciu 0:2e21c4508cab 337 void ADXL362::set_polling_interrupt1_pin(PinName in, uint8_t data,
adisuciu 0:2e21c4508cab 338 PinMode pull)
adisuciu 0:2e21c4508cab 339 {
adisuciu 0:2e21c4508cab 340 if ((data & 0x7F) != 0) {
adisuciu 0:2e21c4508cab 341 write_reg(INTMAP1, data);
adisuciu 0:2e21c4508cab 342 _int1_poll = DigitalIn(in);
adisuciu 0:2e21c4508cab 343 _int1_poll.mode(pull);
adisuciu 0:2e21c4508cab 344 if (data & 0x80) {
adisuciu 0:2e21c4508cab 345 _int1_act_low = true;
adisuciu 0:2e21c4508cab 346 } else {
adisuciu 0:2e21c4508cab 347 _int1_act_low = false;
adisuciu 0:2e21c4508cab 348 }
adisuciu 0:2e21c4508cab 349 }
adisuciu 0:2e21c4508cab 350 }
adisuciu 0:2e21c4508cab 351
adisuciu 0:2e21c4508cab 352 /**
adisuciu 0:2e21c4508cab 353 * Configures INT2 output of the ADXL362 for polling use
adisuciu 0:2e21c4508cab 354 * @param in - uC pin connected to ADXL362's INT2
adisuciu 0:2e21c4508cab 355 * @param data - data to be written to INTMAP2
adisuciu 0:2e21c4508cab 356 * @param pull - (optional) configures pullup on In pin
adisuciu 0:2e21c4508cab 357 */
adisuciu 0:2e21c4508cab 358 void ADXL362::set_polling_interrupt2_pin(PinName in, uint8_t data,
adisuciu 0:2e21c4508cab 359 PinMode pull)
adisuciu 0:2e21c4508cab 360 {
adisuciu 0:2e21c4508cab 361 if ((data & 0x7F) != 0) {
adisuciu 0:2e21c4508cab 362 write_reg(INTMAP2, data);
adisuciu 0:2e21c4508cab 363 _int2_poll = DigitalIn(in);
adisuciu 0:2e21c4508cab 364 _int2_poll.mode(pull);
adisuciu 0:2e21c4508cab 365 if (data & 0x80) {
adisuciu 0:2e21c4508cab 366 _int2_act_low = true;
adisuciu 0:2e21c4508cab 367 } else {
adisuciu 0:2e21c4508cab 368 _int2_act_low = false;
adisuciu 0:2e21c4508cab 369 }
adisuciu 0:2e21c4508cab 370 }
adisuciu 0:2e21c4508cab 371 }
adisuciu 0:2e21c4508cab 372
adisuciu 0:2e21c4508cab 373 /**
adisuciu 0:2e21c4508cab 374 * Gets the active state of the INT1 pin
adisuciu 0:2e21c4508cab 375 * @return true if active, false if not active
adisuciu 0:2e21c4508cab 376 */
adisuciu 0:2e21c4508cab 377 bool ADXL362::get_int1()
adisuciu 0:2e21c4508cab 378 {
adisuciu 0:2e21c4508cab 379 if(_int1_poll != NC) return (_int1_poll.read() != _int1_act_low); // boolean XOR
adisuciu 0:2e21c4508cab 380 else return (_int1->read() != _int1_act_low);
adisuciu 0:2e21c4508cab 381 }
adisuciu 0:2e21c4508cab 382
adisuciu 0:2e21c4508cab 383 /**
adisuciu 0:2e21c4508cab 384 * Gets the active state of the INT2 pin
adisuciu 0:2e21c4508cab 385 * @return true if active, false if not active
adisuciu 0:2e21c4508cab 386 */
adisuciu 0:2e21c4508cab 387 bool ADXL362::get_int2()
adisuciu 0:2e21c4508cab 388 {
adisuciu 0:2e21c4508cab 389 if(_int2_poll != NC) return (_int1_poll.read() != _int1_act_low); // boolean XOR
adisuciu 0:2e21c4508cab 390 else return (_int2->read() != _int2_act_low);
adisuciu 0:2e21c4508cab 391 }
adisuciu 0:2e21c4508cab 392
adisuciu 0:2e21c4508cab 393
adisuciu 0:2e21c4508cab 394 /**
adisuciu 0:2e21c4508cab 395 * Configures the INT1 pin of the ADXL362 to be used in interrupt mode
adisuciu 0:2e21c4508cab 396 * @param in - uC pin connected to ADXL362's INT1
adisuciu 0:2e21c4508cab 397 * @param data - data to be written to INTMAP1
adisuciu 0:2e21c4508cab 398 * @param callback_rising - rising edge interrupt callback - can be set to NULL if no callback is required for rising edge
adisuciu 0:2e21c4508cab 399 * @param callback_falling - falling edge interrupt callback - can be set to NULL if no callback is required for falling edge
adisuciu 0:2e21c4508cab 400 * @param pull - (optional) configures pullup on In pin
adisuciu 0:2e21c4508cab 401 */
adisuciu 0:2e21c4508cab 402 void ADXL362::set_interrupt1_pin(PinName in, uint8_t data,
adisuciu 0:2e21c4508cab 403 void (*callback_rising)(void), void (*callback_falling)(void), PinMode pull)
adisuciu 0:2e21c4508cab 404 {
adisuciu 0:2e21c4508cab 405 if ((data & 0x7F) != 0) {
adisuciu 0:2e21c4508cab 406 write_reg(INTMAP1, data);
adisuciu 0:2e21c4508cab 407 delete _int1;
adisuciu 0:2e21c4508cab 408 _int1 = new InterruptIn(in);
adisuciu 0:2e21c4508cab 409 _int1->mode(pull);
adisuciu 0:2e21c4508cab 410 if(callback_falling != NULL) _int1->fall(callback_falling);
adisuciu 0:2e21c4508cab 411 if(callback_rising != NULL) _int1->rise(callback_rising);
adisuciu 0:2e21c4508cab 412 if (data & 0x80) {
adisuciu 0:2e21c4508cab 413 _int1_act_low = true;
adisuciu 0:2e21c4508cab 414 } else {
adisuciu 0:2e21c4508cab 415 _int1_act_low = false;
adisuciu 0:2e21c4508cab 416 }
adisuciu 0:2e21c4508cab 417 }
adisuciu 0:2e21c4508cab 418 }
adisuciu 0:2e21c4508cab 419
adisuciu 0:2e21c4508cab 420
adisuciu 0:2e21c4508cab 421 /**
adisuciu 0:2e21c4508cab 422 * Configures the INT2 pin of the ADXL362 to be used in interrupt mode
adisuciu 0:2e21c4508cab 423 * @param in - uC pin connected to ADXL362's INT2
adisuciu 0:2e21c4508cab 424 * @param data - data to be written to INTMAP2
adisuciu 0:2e21c4508cab 425 * @param callback_rising - rising edge interrupt callback - can be set to NULL if no callback is required for rising edge
adisuciu 0:2e21c4508cab 426 * @param callback_falling - falling edge interrupt callback - can be set to NULL if no callback is required for falling edge
adisuciu 0:2e21c4508cab 427 * @param pull - (optional) configures pullup on In pin
adisuciu 0:2e21c4508cab 428 */
adisuciu 0:2e21c4508cab 429 void ADXL362::set_interrupt2_pin(PinName in, uint8_t data,
adisuciu 0:2e21c4508cab 430 void (*callback_rising)(void), void (*callback_falling)(void), PinMode pull)
adisuciu 0:2e21c4508cab 431 {
adisuciu 0:2e21c4508cab 432 if ((data & 0x7F) != 0) {
adisuciu 0:2e21c4508cab 433 write_reg(INTMAP2, data);
adisuciu 0:2e21c4508cab 434 delete _int2;
adisuciu 0:2e21c4508cab 435 _int2 = new InterruptIn(in);
adisuciu 0:2e21c4508cab 436 _int2->mode(pull);
adisuciu 0:2e21c4508cab 437 if(callback_falling != NULL) _int2->fall(callback_falling);
adisuciu 0:2e21c4508cab 438 if(callback_rising != NULL) _int2->rise(callback_rising);
adisuciu 0:2e21c4508cab 439 if (data & 0x80) {
adisuciu 0:2e21c4508cab 440 _int2_act_low = true;
adisuciu 0:2e21c4508cab 441 } else {
adisuciu 0:2e21c4508cab 442 _int2_act_low = false;
adisuciu 0:2e21c4508cab 443 }
adisuciu 0:2e21c4508cab 444 }
adisuciu 0:2e21c4508cab 445 }
adisuciu 0:2e21c4508cab 446
adisuciu 0:2e21c4508cab 447 /**
adisuciu 0:2e21c4508cab 448 * Enables external interrupt registration for pin configured as INT1
adisuciu 0:2e21c4508cab 449 * To enable this interrupt, it must first be configured using ADXL362::set_interrupt1_pin()
adisuciu 0:2e21c4508cab 450 */
adisuciu 0:2e21c4508cab 451 void ADXL362::enable_interrupt1()
adisuciu 0:2e21c4508cab 452 {
adisuciu 0:2e21c4508cab 453 _int1->enable_irq();
adisuciu 0:2e21c4508cab 454 }
adisuciu 0:2e21c4508cab 455
adisuciu 0:2e21c4508cab 456 /**
adisuciu 0:2e21c4508cab 457 * Enables external interrupt registration for pin configured as INT2
adisuciu 0:2e21c4508cab 458 * * To enable this interrupt, it must first be configured using ADXL362::set_interrupt2_pin()
adisuciu 0:2e21c4508cab 459 */
adisuciu 0:2e21c4508cab 460 void ADXL362::enable_interrupt2()
adisuciu 0:2e21c4508cab 461 {
adisuciu 0:2e21c4508cab 462 _int2->enable_irq();
adisuciu 0:2e21c4508cab 463 }
adisuciu 0:2e21c4508cab 464
adisuciu 0:2e21c4508cab 465 /**
adisuciu 0:2e21c4508cab 466 * Disables external interrupt registration for pin configured as INT1
adisuciu 0:2e21c4508cab 467 */
adisuciu 0:2e21c4508cab 468 void ADXL362::disable_interrupt1()
adisuciu 0:2e21c4508cab 469 {
adisuciu 0:2e21c4508cab 470 _int1->disable_irq();
adisuciu 0:2e21c4508cab 471 }
adisuciu 0:2e21c4508cab 472
adisuciu 0:2e21c4508cab 473 /**
adisuciu 0:2e21c4508cab 474 * Disables external interrupt registration for pin configured as INT2
adisuciu 0:2e21c4508cab 475 */
adisuciu 0:2e21c4508cab 476 void ADXL362::disable_interrupt2()
adisuciu 0:2e21c4508cab 477 {
adisuciu 0:2e21c4508cab 478 _int2->disable_irq();
adisuciu 0:2e21c4508cab 479 }
adisuciu 0:2e21c4508cab 480
adisuciu 0:2e21c4508cab 481 /**
adisuciu 0:2e21c4508cab 482 * Sets the POWER_CTL register
adisuciu 0:2e21c4508cab 483 * @param data - data to be written to the register
adisuciu 0:2e21c4508cab 484 */
adisuciu 0:2e21c4508cab 485 void ADXL362::set_power_ctl_reg(uint8_t data)
adisuciu 0:2e21c4508cab 486 {
adisuciu 0:2e21c4508cab 487 write_reg(POWER_CTL, data);
adisuciu 0:2e21c4508cab 488 }
adisuciu 0:2e21c4508cab 489
adisuciu 0:2e21c4508cab 490 /**
adisuciu 0:2e21c4508cab 491 * Sets the FILTER_CTL register
adisuciu 0:2e21c4508cab 492 * @param data - data to be written to the register
adisuciu 0:2e21c4508cab 493 */
adisuciu 0:2e21c4508cab 494 void ADXL362::set_filter_ctl_reg(uint8_t data)
adisuciu 0:2e21c4508cab 495 {
adisuciu 0:2e21c4508cab 496 write_reg(FILTER_CTL, data);
adisuciu 0:2e21c4508cab 497 }
adisuciu 0:2e21c4508cab 498
adisuciu 0:2e21c4508cab 499 /**
adisuciu 0:2e21c4508cab 500 * Reads the STATUS register of the ADXL362
adisuciu 0:2e21c4508cab 501 * @return - data in the status register
adisuciu 0:2e21c4508cab 502 */
adisuciu 0:2e21c4508cab 503 uint8_t ADXL362::read_status()
adisuciu 0:2e21c4508cab 504 {
adisuciu 0:2e21c4508cab 505 return read_reg(STATUS);
adisuciu 0:2e21c4508cab 506 }
adisuciu 0:2e21c4508cab 507
adisuciu 0:2e21c4508cab 508 /**
adisuciu 0:2e21c4508cab 509 * Reads the FIFO_ENTRIES_L and FIFO_ENTRIES_H register
adisuciu 0:2e21c4508cab 510 * @return the number of entries in the FIFO
adisuciu 0:2e21c4508cab 511 */
adisuciu 0:2e21c4508cab 512 uint16_t ADXL362::fifo_read_nr_of_entries()
adisuciu 0:2e21c4508cab 513 {
adisuciu 0:2e21c4508cab 514 return read_reg_u16(FIFO_ENTRIES_L);
adisuciu 0:2e21c4508cab 515 }
adisuciu 0:2e21c4508cab 516
adisuciu 0:2e21c4508cab 517 /**
adisuciu 0:2e21c4508cab 518 * Setup for the FIFO
adisuciu 0:2e21c4508cab 519 * @param store_temp - boolean, true - temperature will be stored in the fifo. false otherwise
adisuciu 0:2e21c4508cab 520 * @param mode - ADXL362_FIFO_modes_t fifo mode
adisuciu 0:2e21c4508cab 521 * @param nr_of_entries - number of entries in the FIFO
adisuciu 0:2e21c4508cab 522 */
adisuciu 0:2e21c4508cab 523 void ADXL362::fifo_setup(bool store_temp, ADXL362_FIFO_modes_t mode, uint16_t nr_of_entries)
adisuciu 0:2e21c4508cab 524 {
adisuciu 0:2e21c4508cab 525 uint8_t fifo_ctl = static_cast<uint8_t>(mode);
adisuciu 0:2e21c4508cab 526 _temp_stored_in_fifo = store_temp;
adisuciu 0:2e21c4508cab 527
adisuciu 0:2e21c4508cab 528 fifo_ctl = fifo_ctl | (static_cast<uint8_t>(_temp_stored_in_fifo) << 2);
adisuciu 0:2e21c4508cab 529
adisuciu 0:2e21c4508cab 530 if (nr_of_entries > 0xff) {
adisuciu 0:2e21c4508cab 531 fifo_ctl = fifo_ctl | static_cast<uint8_t>(AH);
adisuciu 0:2e21c4508cab 532 }
adisuciu 0:2e21c4508cab 533 write_reg(FIFO_CONTROL, fifo_ctl);
adisuciu 0:2e21c4508cab 534 write_reg(FIFO_SAMPLES, static_cast<uint8_t>(nr_of_entries & 0xff));
adisuciu 0:2e21c4508cab 535
adisuciu 0:2e21c4508cab 536 }
adisuciu 0:2e21c4508cab 537
adisuciu 0:2e21c4508cab 538 /**
adisuciu 0:2e21c4508cab 539 * Reads a FIFO entry
adisuciu 0:2e21c4508cab 540 * @return FIFO entry
adisuciu 0:2e21c4508cab 541 */
adisuciu 0:2e21c4508cab 542 uint16_t ADXL362::fifo_read_u16()
adisuciu 0:2e21c4508cab 543 {
adisuciu 0:2e21c4508cab 544 uint16_t ret_val = 0;
adisuciu 0:2e21c4508cab 545 adxl362.format(8, _SPI_MODE);
adisuciu 0:2e21c4508cab 546
adisuciu 0:2e21c4508cab 547 cs = false;
adisuciu 0:2e21c4508cab 548 adxl362.write(_READ_FIFO_CMD);
adisuciu 0:2e21c4508cab 549 ret_val = adxl362.write(_DUMMY_BYTE);
adisuciu 0:2e21c4508cab 550 ret_val = (ret_val) | static_cast<uint16_t>(adxl362.write(_DUMMY_BYTE) << 8);
adisuciu 0:2e21c4508cab 551 cs = true;
adisuciu 0:2e21c4508cab 552
adisuciu 0:2e21c4508cab 553 return ret_val;
adisuciu 0:2e21c4508cab 554 }
adisuciu 0:2e21c4508cab 555
adisuciu 0:2e21c4508cab 556 /**
adisuciu 0:2e21c4508cab 557 * Reads 3(4) bytes from the FIFO(if store_temp was set), assembles the data in the format used by the scan method
adisuciu 0:2e21c4508cab 558 * ADXL362::fifo_setup() needs to be called before calling fifo_scan to ensure correct fifo operation
adisuciu 0:2e21c4508cab 559 * fifo_scan and fifo_read_u16 should not be used as fifo_read_u16 disaligns the fifo therefore
adisuciu 0:2e21c4508cab 560 * fifo_scan will return data from multiple samples
adisuciu 0:2e21c4508cab 561 * @return scanned data from the fifo in the 0xXXYYZZTT format
adisuciu 0:2e21c4508cab 562 */
adisuciu 0:2e21c4508cab 563 uint64_t ADXL362::fifo_scan()
adisuciu 0:2e21c4508cab 564 {
adisuciu 0:2e21c4508cab 565
adisuciu 0:2e21c4508cab 566 uint64_t ret_val = 0;
adisuciu 0:2e21c4508cab 567 uint16_t x = 0, y = 0, z = 0, dummy, t = 0, sample_type;
adisuciu 0:2e21c4508cab 568
adisuciu 0:2e21c4508cab 569 adxl362.format(8, _SPI_MODE);
adisuciu 0:2e21c4508cab 570 cs = false;
adisuciu 0:2e21c4508cab 571 adxl362.write(_READ_FIFO_CMD);
adisuciu 0:2e21c4508cab 572 uint8_t samples = (_temp_stored_in_fifo) ? 4 : 3;
adisuciu 0:2e21c4508cab 573 for(uint8_t i = 0; i < samples; i++) {
adisuciu 0:2e21c4508cab 574 dummy = adxl362.write(_DUMMY_BYTE);
adisuciu 0:2e21c4508cab 575 dummy = dummy | static_cast<uint16_t>(adxl362.write(_DUMMY_BYTE) << 8);
adisuciu 0:2e21c4508cab 576 sample_type = (dummy & 0xc000) >> 14;
adisuciu 0:2e21c4508cab 577 dummy = dummy & 0x3fff;
adisuciu 0:2e21c4508cab 578 switch(sample_type) {
adisuciu 0:2e21c4508cab 579 case 0: // x
adisuciu 0:2e21c4508cab 580 x = dummy;
adisuciu 0:2e21c4508cab 581 break;
adisuciu 0:2e21c4508cab 582 case 1: // y
adisuciu 0:2e21c4508cab 583 y = dummy;
adisuciu 0:2e21c4508cab 584 break;
adisuciu 0:2e21c4508cab 585 case 2: // z
adisuciu 0:2e21c4508cab 586 z = dummy;
adisuciu 0:2e21c4508cab 587 break;
adisuciu 0:2e21c4508cab 588 case 3: // temp
adisuciu 0:2e21c4508cab 589 t = dummy;
adisuciu 0:2e21c4508cab 590 break;
adisuciu 0:2e21c4508cab 591 }
adisuciu 0:2e21c4508cab 592
adisuciu 0:2e21c4508cab 593 }
adisuciu 0:2e21c4508cab 594
adisuciu 0:2e21c4508cab 595 // format xxyyzztt
adisuciu 0:2e21c4508cab 596 ret_val = static_cast<uint64_t> (x) << 48;
adisuciu 0:2e21c4508cab 597 ret_val |= static_cast<uint64_t>(y) << 32;
adisuciu 0:2e21c4508cab 598 ret_val |= static_cast<uint64_t>(z) << 16;
adisuciu 0:2e21c4508cab 599 ret_val |= static_cast<uint64_t>(t);
adisuciu 0:2e21c4508cab 600 cs = true;
adisuciu 0:2e21c4508cab 601 return ret_val;
adisuciu 0:2e21c4508cab 602 }