153 lines
4.3 KiB
C++
153 lines
4.3 KiB
C++
#pragma once
|
|
|
|
#include "hardware/i2c.h"
|
|
#include "hardware/gpio.h"
|
|
#include "common/pimoroni_common.hpp"
|
|
#include "common/pimoroni_i2c.hpp"
|
|
|
|
namespace pimoroni {
|
|
|
|
class MSA301 {
|
|
//--------------------------------------------------
|
|
// Constants
|
|
//--------------------------------------------------
|
|
public:
|
|
static const uint8_t DEFAULT_I2C_ADDRESS = 0x26;
|
|
|
|
static const uint8_t SOFT_RESET = 0x00;
|
|
static const uint8_t PART_ID = 0x01;
|
|
static const uint8_t MOTION_INTERRUPT = 0x09;
|
|
static const uint8_t DATA_INTERRUPT = 0x0a;
|
|
static const uint8_t ORIENTATION_STATUS = 0x0c;
|
|
static const uint8_t RESOLUTION_RANGE = 0x0f;
|
|
static const uint8_t POWER_MODE_BANDWIDTH = 0x11;
|
|
static const uint8_t SET_AXIS_POLARITY = 0x12;
|
|
static const uint8_t INTERRUPT_ENABLE_0 = 0x16;
|
|
static const uint8_t INTERRUPT_ENABLE_1 = 0x17;
|
|
static const uint8_t INTERRUPT_LATCH_PERIOD = 0x21;
|
|
static const uint8_t FREEFALL_DURATION = 0x22;
|
|
|
|
|
|
//--------------------------------------------------
|
|
// Enums
|
|
//--------------------------------------------------
|
|
public:
|
|
enum Axis {
|
|
X = 0x02,
|
|
Y = 0x04,
|
|
Z = 0x06
|
|
};
|
|
|
|
enum Orientation {
|
|
PORTRAIT = 0b00,
|
|
PORTRAIT_INVERTED = 0b01,
|
|
LANDSCAPE = 0b10,
|
|
LANDSCAPE_INVERTED = 0b11
|
|
};
|
|
|
|
enum PowerMode {
|
|
NORMAL = 0b00,
|
|
LOW = 0b01,
|
|
SUSPEND = 0b10
|
|
};
|
|
|
|
enum Range {
|
|
G_2 = 0b00,
|
|
G_4 = 0b01,
|
|
G_8 = 0b10,
|
|
G_16 = 0b11
|
|
};
|
|
|
|
enum Resolution {
|
|
BITS_14 = 0b0000,
|
|
BITS_12 = 0b0100,
|
|
BITS_10 = 0b1000,
|
|
BITS_8 = 0b1100
|
|
};
|
|
|
|
enum AxisPolarity {
|
|
INVERT_X = 0b1000,
|
|
INVERT_Y = 0b0100,
|
|
INVERT_Z = 0b0010,
|
|
XY_SWAP = 0b0001
|
|
};
|
|
|
|
enum Interrupt {
|
|
NONE = 0,
|
|
ACTIVE = 0b0000111,
|
|
NEW_DATA = 0b1000000000000,
|
|
FREEFALL = 0b0100000000000,
|
|
ORIENTATION = 0b1000000,
|
|
SINGLE_TAP = 0b0100000,
|
|
DOUBLE_TAP = 0b0010000,
|
|
Z_ACTIVE = 0b0000100,
|
|
Y_ACTIVE = 0b0000010,
|
|
X_ACTIVE = 0b0000001
|
|
};
|
|
|
|
enum InterruptLatchPeriod {
|
|
LATCH_1MS = 0b1001,
|
|
LATCH_2MS = 0b1011,
|
|
LATCH_25MS = 0b1100,
|
|
LATCH_50MS = 0b1101,
|
|
LATCH_100MS = 0b1110,
|
|
LATCH_250MS = 0b0001,
|
|
LATCH_500MS = 0b0010,
|
|
LATCH_1S = 0b0011,
|
|
LATCH_2S = 0b0100,
|
|
LATCH_4S = 0b0101,
|
|
LATCH_8S = 0b0110
|
|
};
|
|
|
|
|
|
//--------------------------------------------------
|
|
// Variables
|
|
//--------------------------------------------------
|
|
private:
|
|
I2C *i2c;
|
|
const uint8_t address = DEFAULT_I2C_ADDRESS;
|
|
uint interrupt = PIN_UNUSED;
|
|
|
|
//--------------------------------------------------
|
|
// Constructors/Destructor
|
|
//--------------------------------------------------
|
|
public:
|
|
MSA301() : MSA301(new I2C()) {};
|
|
|
|
MSA301(I2C *i2c, uint interrupt = PIN_UNUSED) : i2c(i2c), interrupt(interrupt) {}
|
|
|
|
// TODO remove MicroPython-binding compatibility constructors
|
|
MSA301(i2c_inst_t *i2c_inst, uint sda, uint scl, uint interrupt = PIN_UNUSED) : MSA301(new I2C(sda, scl), interrupt) {}
|
|
|
|
|
|
//--------------------------------------------------
|
|
// Methods
|
|
//--------------------------------------------------
|
|
public:
|
|
bool init();
|
|
void reset();
|
|
|
|
i2c_inst_t* get_i2c() const;
|
|
int get_sda() const;
|
|
int get_scl() const;
|
|
int get_int() const;
|
|
|
|
uint8_t part_id();
|
|
float get_axis(Axis axis, uint8_t sample_count = 1);
|
|
float get_x_axis(uint8_t sample_count = 1);
|
|
float get_y_axis(uint8_t sample_count = 1);
|
|
float get_z_axis(uint8_t sample_count = 1);
|
|
Orientation get_orientation();
|
|
|
|
void set_power_mode(MSA301::PowerMode power_mode);
|
|
void set_range_and_resolution(Range range, MSA301::Resolution resolution);
|
|
void set_axis_polarity(uint8_t polarity);
|
|
|
|
void disable_all_interrupts();
|
|
void enable_interrupts(uint16_t interrupts);
|
|
void set_interrupt_latch(InterruptLatchPeriod latch_period, bool reset_latched);
|
|
bool read_interrupt(Interrupt interrupt);
|
|
};
|
|
}
|
|
|