mirror of
https://github.com/wpilibsuite/allwpilib
synced 2026-07-03 03:01:44 +00:00
Accelerometer is hyper-specific to ADXL accelerometers, and Gyro is less useful now that 3D IMUs are prevalent, and if those IMUs want to support the Gyro interface, they also need to provide a way to set the axis used for the Gyro interface, which is confusing. Higher-order functions (e.g., lambdas) are a more flexible interface boundary than interfaces, but they didn't exist when these interfaces were created.
112 lines
2.6 KiB
C++
112 lines
2.6 KiB
C++
// Copyright (c) FIRST and other WPILib contributors.
|
|
// Open Source Software; you can modify and/or share it under the terms of
|
|
// the WPILib BSD license file in the root directory of this project.
|
|
|
|
#pragma once
|
|
|
|
#include <hal/SimDevice.h>
|
|
#include <networktables/NTSendable.h>
|
|
#include <wpi/sendable/SendableHelper.h>
|
|
|
|
#include "frc/SPI.h"
|
|
|
|
namespace frc {
|
|
|
|
/**
|
|
* ADXL362 SPI Accelerometer.
|
|
*
|
|
* This class allows access to an Analog Devices ADXL362 3-axis accelerometer.
|
|
*/
|
|
class ADXL362 : public nt::NTSendable, public wpi::SendableHelper<ADXL362> {
|
|
public:
|
|
enum Range { kRange_2G = 0, kRange_4G = 1, kRange_8G = 2 };
|
|
|
|
enum Axes { kAxis_X = 0x00, kAxis_Y = 0x02, kAxis_Z = 0x04 };
|
|
struct AllAxes {
|
|
double XAxis;
|
|
double YAxis;
|
|
double ZAxis;
|
|
};
|
|
|
|
public:
|
|
/**
|
|
* Constructor. Uses the onboard CS1.
|
|
*
|
|
* @param range The range (+ or -) that the accelerometer will measure.
|
|
*/
|
|
explicit ADXL362(Range range = kRange_2G);
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @param port The SPI port the accelerometer is attached to
|
|
* @param range The range (+ or -) that the accelerometer will measure.
|
|
*/
|
|
explicit ADXL362(SPI::Port port, Range range = kRange_2G);
|
|
|
|
~ADXL362() override = default;
|
|
|
|
ADXL362(ADXL362&&) = default;
|
|
ADXL362& operator=(ADXL362&&) = default;
|
|
|
|
SPI::Port GetSpiPort() const;
|
|
|
|
/**
|
|
* Set the measuring range of the accelerometer.
|
|
*
|
|
* @param range The maximum acceleration, positive or negative, that the
|
|
* accelerometer will measure.
|
|
*/
|
|
void SetRange(Range range);
|
|
|
|
/**
|
|
* Returns the acceleration along the X axis in g-forces.
|
|
*
|
|
* @return The acceleration along the X axis in g-forces.
|
|
*/
|
|
double GetX();
|
|
|
|
/**
|
|
* Returns the acceleration along the Y axis in g-forces.
|
|
*
|
|
* @return The acceleration along the Y axis in g-forces.
|
|
*/
|
|
double GetY();
|
|
|
|
/**
|
|
* Returns the acceleration along the Z axis in g-forces.
|
|
*
|
|
* @return The acceleration along the Z axis in g-forces.
|
|
*/
|
|
double GetZ();
|
|
|
|
/**
|
|
* Get the acceleration of one axis in Gs.
|
|
*
|
|
* @param axis The axis to read from.
|
|
* @return Acceleration of the ADXL362 in Gs.
|
|
*/
|
|
virtual double GetAcceleration(Axes axis);
|
|
|
|
/**
|
|
* Get the acceleration of all axes in Gs.
|
|
*
|
|
* @return An object containing the acceleration measured on each axis of the
|
|
* ADXL362 in Gs.
|
|
*/
|
|
virtual AllAxes GetAccelerations();
|
|
|
|
void InitSendable(nt::NTSendableBuilder& builder) override;
|
|
|
|
private:
|
|
SPI m_spi;
|
|
hal::SimDevice m_simDevice;
|
|
hal::SimEnum m_simRange;
|
|
hal::SimDouble m_simX;
|
|
hal::SimDouble m_simY;
|
|
hal::SimDouble m_simZ;
|
|
double m_gsPerLSB = 0.001;
|
|
};
|
|
|
|
} // namespace frc
|