ADXL372

Arduino library for the ADXL372 accelerometer

Available in Arduino Library manager!

Please read the documentation: ADXL372 Datasheet

How to install from Arduino IDE:

1. Open the Library Manager (Ctrl + Shift + I).
2. Search for ADXL372.
3. Install the latest version.

How to use:

This library uses SPI as communication with the accelerometer. I²C is supported, but has limited functionality. See the documentation for further information.

This accelerometer is packed with features, so check out the simple example here for the minimum requirements for continuously reading the 3-axis acceleration.

• ADXL372class(csPin) Create an ADXL372 object with the CS (Chip select) pin.
• begin() Call this to initiate the accelerometer.
• begin(uint32_t spiClockSpeed) Initiate with a custom spi clock speed.
• printDevice() Print the device's Analog Devices ID, device ID, MEMS ID, revision ID and Device Status.
• selfTest() Executes the self test procedure. Returns true if the test finished and passed, otherwise returns false.

Reading Acceleration

• setStatusCheck(bool isCheckingStatus) Sets if you want to check if the data is ready or not, before reading the acceleration data.
• readAcceleration(float& x, float& y, float& z) Read the 3-axis acceleration in g.
• readPeakAcceleration(float& xPeak, float& yPeak, float& zPeak) Read the 3-axis peak acceleration in g.

Offset

• setOffsetTrims(OffsetTrims xOffset, OffsetTrims yOffset, OffsetTrims zOffset) Sets the offsets for each of the 3-axis. Can be set between -60 and 52.5 with 7.5 intervals.

Activity

• setActivityThresholds(uint16_t xThreshold, uint16_t yThreshold, uint16_t zThreshold) Sets the activity thresholds for the 3 axis. Threshold value is a 11-bit value with 100mg per LSB
• enableActivityDetection(bool isEnabledX, bool isEnabledY, bool isEnabledZ) Enable activity detection for each axis.
• setReferencedActivityProcessing(bool isReferenced) Referenced activity processing for each axis when true. Absolute processing when false.
• setActivityTimer(uint8_t timerPeriod) Sets the activity timer period. Timer period is ~6.6ms per code at 3200Hz ODR and below, and ~3.3ms at 6400Hz ODR.

Inactivity

• setInactivityThresholds(uint16_t xThreshold, uint16_t yThreshold, uint16_t zThreshold) Sets the inactivity thresholds for the 3 axis. Same as activity threshold.
• enableInactivityDetection(bool isEnabledX, bool isEnabledY, bool isEnabledZ) Enable inactivity detection for each axis.
• setReferencedInactivityProcessing(bool isReferenced) Referenced inactivity processing for each axis when true. Absolute processing when false.
• setInactivityTimer(uint16_t timerPeriod) Sets the activity timer period. Timer period is ~26ms per code at 3200Hz ODR and below, and ~13ms at 6400Hz ODR.

Motion Warning

• setMotionWarningThresholds(uint16_t xThreshold, uint16_t yThreshold, uint16_t zThreshold) Sets the Motion Warning thresholds for the 3 axis. Same as activity threshold.
• enableMotionWarningDetection(bool isEnabledX, bool isEnabledY, bool isEnabledZ) Enable Motion Warning detection for each axis.
• setReferencedMotionWarningProcessing(bool isReferenced) Referenced Motion Warning processing for each axis when true. Absolute processing when false.

FIFO

The FIFO has not been implemented yet.

Interrupt pins

• selectInt1Function(InterruptFunction function) Select an interrupt function for interrupt pin 1
• selectInt1Functions(uint8_t function) Select multiple interrupt functions for interrupt pin 1. For example: (DATA_RDY | AWAKE).
• selectInt2Function(InterruptFunction function) Select an interrupt function for interrupt pin 2
• selectInt2Functions(uint8_t function) Select multiple interrupt functions for interrupt pin 2.

Timing

• setOdr(Odr odr) Sets the ODR. Default is 400Hz.

  ODR options:

  1. ODR_400Hz
  2. ODR_800Hz
  3. ODR_1600Hz
  4. ODR_3200Hz
  5. ODR_6400Hz

• setWakeUpRate(WakeUpRate wur) Sets the wake-up rate. Default is 52ms.

  Wake-up rate options:

  1. WUR_52ms
  2. WUR_104ms
  3. WUR_208ms
  4. WUR_512ms
  5. WUR_2048ms
  6. WUR_4096ms
  7. WUR_8192ms
  8. WUR_24576ms

• enableExternalClock(bool isEnabled) Enables external clock. When using this, apply a clock in the INT1 pin.

• enableExternalTrigger(bool isEnabled) Enables external triggers. When this enabled, use the INT2 pin as the sync trigger input.

Measure

• setBandwidth(Bandwidth bandwidth) Sets the bandwidth of the accelerometer. Default is 200Hz. Please use up to half of the ODR to unsure the Nyquist criteria.

  Bandwidth options:

  1. BW_200Hz
  2. BW_400Hz
  3. BW_800Hz
  4. BW_1600Hz
  5. BW_3200Hz

• enableLowNoiseOperation(bool isEnabled) Enables Low-noise operation when set to true.

• setLinkLoopActivityProcessing(LinkLoop activityProcessing) Sets the activity processing mode. Activity and inactivity must be enabled for either linked or looped mode.

  Link-Loop options:

  1. DEFAULT
  2. LINKED
  3. LOOPED

• enableAutosleep(bool isEnabled) Enables Autosleep mode when set to true. If activity processing is set to DEFAULT, this bit will be ignored.

Power Control

• setOperatingMode(OperatingMode opMode) Sets the accelerometer operating mode.

  Operating mode options:

  1. STANDBY
  2. WAKE_UP
  3. INSTANT_ON
  4. FULL_BANDWIDTH

• disableHighPassFilter(bool isDisabled) Disables the digital high-pass filter.

• disableLowPassFilter(bool isDisabled) Disables the digital low-pass activity detect filter.

• setFilterSettling(FilterSettlingPeriod filterSettling) Sets the filter settling period. It is ideal to set this to 16ms when the high-pass filter and the low-pass activity detect filter are disabled.

  Filter settling period options:

  1. FSP_370ms
  2. FSP_16ms

• setInstantOnThreshold(InstantOnThreshold threshold) Sets the instant on threshold.

  Intant on threshold options:

  1. IOT_LOW_THRESH
  2. IOT_HIGH_THRESH