MPU6050 class
#include <main/devices/AccelGyro/MPU6050.h>
Contents
MPU6050 accelerometer and gyroscope over I2C.
Constructors, destructors, conversion operators
Public functions
- void ReadRegister(uint8_t reg, uint8_t* data, uint8_t len)
- void initialize()
- auto testConnection() -> bool
- auto getAuxVDDIOLevel() -> uint8_t
- void setAuxVDDIOLevel(uint8_t level)
- auto getRate() -> uint8_t
- void setRate(uint8_t rate)
- auto getExternalFrameSync() -> uint8_t
- void setExternalFrameSync(uint8_t sync)
- auto getDLPFMode() -> uint8_t
- void setDLPFMode(uint8_t bandwidth)
- auto getFullScaleGyroRange() -> uint8_t
- void setFullScaleGyroRange(uint8_t range)
- auto getAccelXSelfTestFactoryTrim() -> uint8_t
- auto getAccelYSelfTestFactoryTrim() -> uint8_t
- auto getAccelZSelfTestFactoryTrim() -> uint8_t
- auto getGyroXSelfTestFactoryTrim() -> uint8_t
- auto getGyroYSelfTestFactoryTrim() -> uint8_t
- auto getGyroZSelfTestFactoryTrim() -> uint8_t
- auto getAccelXSelfTest() -> bool
- void setAccelXSelfTest(bool enabled)
- auto getAccelYSelfTest() -> bool
- void setAccelYSelfTest(bool enabled)
- auto getAccelZSelfTest() -> bool
- void setAccelZSelfTest(bool enabled)
- auto getFullScaleAccelRange() -> uint8_t
- void setFullScaleAccelRange(uint8_t range)
- auto getDHPFMode() -> uint8_t
- void setDHPFMode(uint8_t mode)
- auto getFreefallDetectionThreshold() -> uint8_t
- void setFreefallDetectionThreshold(uint8_t threshold)
- auto getFreefallDetectionDuration() -> uint8_t
- void setFreefallDetectionDuration(uint8_t duration)
- auto getMotionDetectionThreshold() -> uint8_t
- void setMotionDetectionThreshold(uint8_t threshold)
- auto getMotionDetectionDuration() -> uint8_t
- void setMotionDetectionDuration(uint8_t duration)
- auto getZeroMotionDetectionThreshold() -> uint8_t
- void setZeroMotionDetectionThreshold(uint8_t threshold)
- auto getZeroMotionDetectionDuration() -> uint8_t
- void setZeroMotionDetectionDuration(uint8_t duration)
- auto getTempFIFOEnabled() -> bool
- void setTempFIFOEnabled(bool enabled)
- auto getXGyroFIFOEnabled() -> bool
- void setXGyroFIFOEnabled(bool enabled)
- auto getYGyroFIFOEnabled() -> bool
- void setYGyroFIFOEnabled(bool enabled)
- auto getZGyroFIFOEnabled() -> bool
- void setZGyroFIFOEnabled(bool enabled)
- auto getAccelFIFOEnabled() -> bool
- void setAccelFIFOEnabled(bool enabled)
- auto getSlave2FIFOEnabled() -> bool
- void setSlave2FIFOEnabled(bool enabled)
- auto getSlave1FIFOEnabled() -> bool
- void setSlave1FIFOEnabled(bool enabled)
- auto getSlave0FIFOEnabled() -> bool
- void setSlave0FIFOEnabled(bool enabled)
- auto getMultiMasterEnabled() -> bool
- void setMultiMasterEnabled(bool enabled)
- auto getWaitForExternalSensorEnabled() -> bool
- void setWaitForExternalSensorEnabled(bool enabled)
- auto getSlave3FIFOEnabled() -> bool
- void setSlave3FIFOEnabled(bool enabled)
- auto getSlaveReadWriteTransitionEnabled() -> bool
- void setSlaveReadWriteTransitionEnabled(bool enabled)
- auto getMasterClockSpeed() -> uint8_t
- void setMasterClockSpeed(uint8_t speed)
- auto getSlaveAddress(uint8_t num) -> uint8_t
- void setSlaveAddress(uint8_t num, uint8_t address)
- auto getSlaveRegister(uint8_t num) -> uint8_t
- void setSlaveRegister(uint8_t num, uint8_t reg)
- auto getSlaveEnabled(uint8_t num) -> bool
- void setSlaveEnabled(uint8_t num, bool enabled)
- auto getSlaveWordByteSwap(uint8_t num) -> bool
- void setSlaveWordByteSwap(uint8_t num, bool enabled)
- auto getSlaveWriteMode(uint8_t num) -> bool
- void setSlaveWriteMode(uint8_t num, bool mode)
- auto getSlaveWordGroupOffset(uint8_t num) -> bool
- void setSlaveWordGroupOffset(uint8_t num, bool enabled)
- auto getSlaveDataLength(uint8_t num) -> uint8_t
- void setSlaveDataLength(uint8_t num, uint8_t length)
- auto getSlave4Address() -> uint8_t
- void setSlave4Address(uint8_t address)
- auto getSlave4Register() -> uint8_t
- void setSlave4Register(uint8_t reg)
- void setSlave4OutputByte(uint8_t data)
- auto getSlave4Enabled() -> bool
- void setSlave4Enabled(bool enabled)
- auto getSlave4InterruptEnabled() -> bool
- void setSlave4InterruptEnabled(bool enabled)
- auto getSlave4WriteMode() -> bool
- void setSlave4WriteMode(bool mode)
- auto getSlave4MasterDelay() -> uint8_t
- void setSlave4MasterDelay(uint8_t delay)
- auto getSlate4InputByte() -> uint8_t
- auto getPassthroughStatus() -> bool
- auto getSlave4IsDone() -> bool
- auto getLostArbitration() -> bool
- auto getSlave4Nack() -> bool
- auto getSlave3Nack() -> bool
- auto getSlave2Nack() -> bool
- auto getSlave1Nack() -> bool
- auto getSlave0Nack() -> bool
- auto getInterruptMode() -> bool
- void setInterruptMode(bool mode)
- auto getInterruptDrive() -> bool
- void setInterruptDrive(bool drive)
- auto getInterruptLatch() -> bool
- void setInterruptLatch(bool latch)
- auto getInterruptLatchClear() -> bool
- void setInterruptLatchClear(bool clear)
- auto getFSyncInterruptLevel() -> bool
- void setFSyncInterruptLevel(bool level)
- auto getFSyncInterruptEnabled() -> bool
- void setFSyncInterruptEnabled(bool enabled)
- auto getI2CBypassEnabled() -> bool
- void setI2CBypassEnabled(bool enabled)
- auto getClockOutputEnabled() -> bool
- void setClockOutputEnabled(bool enabled)
- auto getIntEnabled() -> uint8_t
- void setIntEnabled(uint8_t enabled)
- auto getIntFreefallEnabled() -> bool
- void setIntFreefallEnabled(bool enabled)
- auto getIntMotionEnabled() -> bool
- void setIntMotionEnabled(bool enabled)
- auto getIntZeroMotionEnabled() -> bool
- void setIntZeroMotionEnabled(bool enabled)
- auto getIntFIFOBufferOverflowEnabled() -> bool
- void setIntFIFOBufferOverflowEnabled(bool enabled)
- auto getIntI2CMasterEnabled() -> bool
- void setIntI2CMasterEnabled(bool enabled)
- auto getIntDataReadyEnabled() -> bool
- void setIntDataReadyEnabled(bool enabled)
- auto getIntStatus() -> uint8_t
- auto getIntFreefallStatus() -> bool
- auto getIntMotionStatus() -> bool
- auto getIntZeroMotionStatus() -> bool
- auto getIntFIFOBufferOverflowStatus() -> bool
- auto getIntI2CMasterStatus() -> bool
- auto getIntDataReadyStatus() -> bool
- void getMotion9(int16_t* ax, int16_t* ay, int16_t* az, int16_t* gx, int16_t* gy, int16_t* gz, int16_t* mx, int16_t* my, int16_t* mz)
- void getMotion6(int16_t* ax, int16_t* ay, int16_t* az, int16_t* gx, int16_t* gy, int16_t* gz)
- void getAcceleration(int16_t* x, int16_t* y, int16_t* z)
- auto getAccelerationX() -> int16_t
- auto getAccelerationY() -> int16_t
- auto getAccelerationZ() -> int16_t
- auto getTemperature() -> int16_t
- void getRotation(int16_t* x, int16_t* y, int16_t* z)
- auto getRotationX() -> int16_t
- auto getRotationY() -> int16_t
- auto getRotationZ() -> int16_t
- auto getExternalSensorByte(int position) -> uint8_t
- auto getExternalSensorWord(int position) -> uint16_t
- auto getExternalSensorDWord(int position) -> uint32_t
- auto getMotionStatus() -> uint8_t
- auto getXNegMotionDetected() -> bool
- auto getXPosMotionDetected() -> bool
- auto getYNegMotionDetected() -> bool
- auto getYPosMotionDetected() -> bool
- auto getZNegMotionDetected() -> bool
- auto getZPosMotionDetected() -> bool
- auto getZeroMotionDetected() -> bool
- void setSlaveOutputByte(uint8_t num, uint8_t data)
- auto getExternalShadowDelayEnabled() -> bool
- void setExternalShadowDelayEnabled(bool enabled)
- auto getSlaveDelayEnabled(uint8_t num) -> bool
- void setSlaveDelayEnabled(uint8_t num, bool enabled)
- void resetGyroscopePath()
- void resetAccelerometerPath()
- void resetTemperaturePath()
- auto getAccelerometerPowerOnDelay() -> uint8_t
- void setAccelerometerPowerOnDelay(uint8_t delay)
- auto getFreefallDetectionCounterDecrement() -> uint8_t
- void setFreefallDetectionCounterDecrement(uint8_t decrement)
- auto getMotionDetectionCounterDecrement() -> uint8_t
- void setMotionDetectionCounterDecrement(uint8_t decrement)
- auto getFIFOEnabled() -> bool
- void setFIFOEnabled(bool enabled)
- auto getI2CMasterModeEnabled() -> bool
- void setI2CMasterModeEnabled(bool enabled)
- void switchSPIEnabled(bool enabled)
- void resetFIFO()
- void resetI2CMaster()
- void resetSensors()
- void reset()
- auto getSleepEnabled() -> bool
- void setSleepEnabled(bool enabled)
- auto getWakeCycleEnabled() -> bool
- void setWakeCycleEnabled(bool enabled)
- auto getTempSensorEnabled() -> bool
- void setTempSensorEnabled(bool enabled)
- auto getClockSource() -> uint8_t
- void setClockSource(uint8_t source)
- auto getWakeFrequency() -> uint8_t
- void setWakeFrequency(uint8_t frequency)
- auto getStandbyXAccelEnabled() -> bool
- void setStandbyXAccelEnabled(bool enabled)
- auto getStandbyYAccelEnabled() -> bool
- void setStandbyYAccelEnabled(bool enabled)
- auto getStandbyZAccelEnabled() -> bool
- void setStandbyZAccelEnabled(bool enabled)
- auto getStandbyXGyroEnabled() -> bool
- void setStandbyXGyroEnabled(bool enabled)
- auto getStandbyYGyroEnabled() -> bool
- void setStandbyYGyroEnabled(bool enabled)
- auto getStandbyZGyroEnabled() -> bool
- void setStandbyZGyroEnabled(bool enabled)
- auto getFIFOCount() -> uint16_t
- auto getFIFOByte() -> uint8_t
- void setFIFOByte(uint8_t data)
- void getFIFOBytes(uint8_t* data, uint8_t length)
- auto getDeviceID() -> uint8_t
- void setDeviceID(uint8_t id)
- auto getOTPBankValid() -> uint8_t
- void setOTPBankValid(bool enabled)
- auto getXGyroOffsetTC() -> int8_t
- void setXGyroOffsetTC(int8_t offset)
- auto getYGyroOffsetTC() -> int8_t
- void setYGyroOffsetTC(int8_t offset)
- auto getZGyroOffsetTC() -> int8_t
- void setZGyroOffsetTC(int8_t offset)
- auto getXFineGain() -> int8_t
- void setXFineGain(int8_t gain)
- auto getYFineGain() -> int8_t
- void setYFineGain(int8_t gain)
- auto getZFineGain() -> int8_t
- void setZFineGain(int8_t gain)
- auto getXAccelOffset() -> int16_t
- void setXAccelOffset(int16_t offset)
- auto getYAccelOffset() -> int16_t
- void setYAccelOffset(int16_t offset)
- auto getZAccelOffset() -> int16_t
- void setZAccelOffset(int16_t offset)
- auto getXGyroOffset() -> int16_t
- void setXGyroOffset(int16_t offset)
- auto getYGyroOffset() -> int16_t
- void setYGyroOffset(int16_t offset)
- auto getZGyroOffset() -> int16_t
- void setZGyroOffset(int16_t offset)
- auto getIntPLLReadyEnabled() -> bool
- void setIntPLLReadyEnabled(bool enabled)
- auto getIntDMPEnabled() -> bool
- void setIntDMPEnabled(bool enabled)
- auto getDMPInt5Status() -> bool
- auto getDMPInt4Status() -> bool
- auto getDMPInt3Status() -> bool
- auto getDMPInt2Status() -> bool
- auto getDMPInt1Status() -> bool
- auto getDMPInt0Status() -> bool
- auto getIntPLLReadyStatus() -> bool
- auto getIntDMPStatus() -> bool
- auto getDMPEnabled() -> bool
- void setDMPEnabled(bool enabled)
- void resetDMP()
- void setMemoryBank(uint8_t bank, bool prefetchEnabled = false, bool userBank = false)
- void setMemoryStartAddress(uint8_t address)
- auto readMemoryByte() -> uint8_t
- void writeMemoryByte(uint8_t data)
- void readMemoryBlock(uint8_t* data, uint16_t dataSize, uint8_t bank = 0, uint8_t address = 0)
- auto writeMemoryBlock(const uint8_t* data, uint16_t dataSize, uint8_t bank = 0, uint8_t address = 0, bool verify = true, bool useProgMem = false) -> bool
- auto writeProgMemoryBlock(const uint8_t* data, uint16_t dataSize, uint8_t bank = 0, uint8_t address = 0, bool verify = true) -> bool
- auto writeDMPConfigurationSet(const uint8_t* data, uint16_t dataSize, bool useProgMem = false) -> bool
- auto writeProgDMPConfigurationSet(const uint8_t* data, uint16_t dataSize) -> bool
- auto getDMPConfig1() -> uint8_t
- void setDMPConfig1(uint8_t config)
- auto getDMPConfig2() -> uint8_t
- void setDMPConfig2(uint8_t config)
- auto dmpInitialize() -> uint8_t
- auto dmpPacketAvailable() -> bool
- auto dmpSetFIFORate(uint8_t fifoRate) -> uint8_t
- auto dmpGetFIFORate() -> uint8_t
- auto dmpGetSampleStepSizeMS() -> uint8_t
- auto dmpGetSampleFrequency() -> uint8_t
- auto dmpDecodeTemperature(int8_t tempReg) -> int32_t
- auto dmpRunFIFORateProcesses() -> uint8_t
- auto dmpSendQuaternion(uint_fast16_t accuracy) -> uint8_t
- auto dmpSendGyro(uint_fast16_t elements, uint_fast16_t accuracy) -> uint8_t
- auto dmpSendAccel(uint_fast16_t elements, uint_fast16_t accuracy) -> uint8_t
- auto dmpSendLinearAccel(uint_fast16_t elements, uint_fast16_t accuracy) -> uint8_t
- auto dmpSendLinearAccelInWorld(uint_fast16_t elements, uint_fast16_t accuracy) -> uint8_t
- auto dmpSendControlData(uint_fast16_t elements, uint_fast16_t accuracy) -> uint8_t
- auto dmpSendSensorData(uint_fast16_t elements, uint_fast16_t accuracy) -> uint8_t
- auto dmpSendExternalSensorData(uint_fast16_t elements, uint_fast16_t accuracy) -> uint8_t
- auto dmpSendGravity(uint_fast16_t elements, uint_fast16_t accuracy) -> uint8_t
- auto dmpSendPacketNumber(uint_fast16_t accuracy) -> uint8_t
- auto dmpSendQuantizedAccel(uint_fast16_t elements, uint_fast16_t accuracy) -> uint8_t
- auto dmpSendEIS(uint_fast16_t elements, uint_fast16_t accuracy) -> uint8_t
- auto dmpGetAccel(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetAccel(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetAccel(VectorInt16* v, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetQuaternion(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetQuaternion(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetQuaternion(Quaternion* q, const uint8_t* packet = 0) -> uint8_t
- auto dmpGet6AxisQuaternion(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGet6AxisQuaternion(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGet6AxisQuaternion(Quaternion* q, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetRelativeQuaternion(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetRelativeQuaternion(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetRelativeQuaternion(Quaternion* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGyro(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGyro(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGyro(VectorInt16* v, const uint8_t* packet = 0) -> uint8_t
- auto dmpSetLinearAccelFilterCoefficient(float coef) -> uint8_t
- auto dmpGetLinearAccel(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetLinearAccel(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetLinearAccel(VectorInt16* v, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetLinearAccel(VectorInt16* v, VectorInt16* vRaw, VectorFloat* gravity) -> uint8_t
- auto dmpGetLinearAccelInWorld(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetLinearAccelInWorld(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetLinearAccelInWorld(VectorInt16* v, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetLinearAccelInWorld(VectorInt16* v, VectorInt16* vReal, Quaternion* q) -> uint8_t
- auto dmpGetGyroAndAccelSensor(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGyroAndAccelSensor(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGyroAndAccelSensor(VectorInt16* g, VectorInt16* a, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGyroSensor(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGyroSensor(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGyroSensor(VectorInt16* v, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetControlData(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetTemperature(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGravity(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGravity(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGravity(VectorInt16* v, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetGravity(VectorFloat* v, Quaternion* q) -> uint8_t
- auto dmpGetUnquantizedAccel(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetUnquantizedAccel(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetUnquantizedAccel(VectorInt16* v, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetQuantizedAccel(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetQuantizedAccel(int16_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetQuantizedAccel(VectorInt16* v, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetExternalSensorData(int32_t* data, uint16_t size, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetEIS(int32_t* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetEuler(float* data, Quaternion* q) -> uint8_t
- auto dmpGetYawPitchRoll(float* data, Quaternion* q, VectorFloat* gravity) -> uint8_t
- auto dmpGetAccelFloat(float* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpGetQuaternionFloat(float* data, const uint8_t* packet = 0) -> uint8_t
- auto dmpProcessFIFOPacket(const unsigned char* dmpData) -> uint8_t
- auto dmpReadAndProcessFIFOPacket(uint8_t numPackets, uint8_t* processed = NULL) -> uint8_t
- auto dmpSetFIFOProcessedCallback(void(*)(void) func) -> uint8_t
- auto dmpInitFIFOParam() -> uint8_t
- auto dmpCloseFIFO() -> uint8_t
- auto dmpSetGyroDataSource(uint8_t source) -> uint8_t
- auto dmpDecodeQuantizedAccel() -> uint8_t
- auto dmpGetGyroSumOfSquare() -> uint32_t
- auto dmpGetAccelSumOfSquare() -> uint32_t
- void dmpOverrideQuaternion(long* q)
- auto dmpGetFIFOPacketSize() -> uint16_t
- void CalibrateGyro(uint8_t Loops = 15)
- Fully calibrate Gyro from ZERO in about 6-7 Loops 600-700 readings.
- void CalibrateAccel(uint8_t Loops = 15)
- Fully calibrate Accel from ZERO in about 6-7 Loops 600-700 readings.
- void PID(uint8_t ReadAddress, float kP, float kI, uint8_t Loops)
Public variables
- I2Cdev& i2cDev
- uint8_t* dmpPacketBuffer
- uint16_t dmpPacketSize
Function documentation
void MPU6050:: ReadRegister(uint8_t reg,
uint8_t* data,
uint8_t len)
| Parameters | |
|---|---|
| reg | device register |
| data | output |
| len | read bytes |
Read from a register.
void MPU6050:: initialize()
Initialize the device.
Power on and prepare for general usage. This will activate the device and take it out of sleep mode (which must be done after start-up). This function also sets both the accelerometer and the gyroscope to their most sensitive settings, namely +/- 2g and +/- 250 degrees/sec, and sets the clock source to use the X Gyro for reference, which is slightly better than the default internal clock source.
bool MPU6050:: testConnection()
| Returns | if the device is connected |
|---|
Test device is working properly.
Verify the I2C connection. Make sure the device is connected and responds as expected.
uint8_t MPU6050:: getAuxVDDIOLevel()
| Returns | aux vdd io level |
|---|
AUX_VDDIO register.
Get the auxiliary I2C supply voltage level. When set to 1, the auxiliary I2C bus high logic level is VDD. When cleared to 0, the auxiliary I2C bus high logic level is VLOGIC. This does not apply to the MPU-6000, which does not have a VLOGIC pin.
void MPU6050:: setAuxVDDIOLevel(uint8_t level)
| Parameters | |
|---|---|
| level | I2C supply voltage level (0=VLOGIC, 1=VDD) |
Set AUX_VDDIO register.
Set the auxiliary I2C supply voltage level. When set to 1, the auxiliary I2C bus high logic level is VDD. When cleared to 0, the auxiliary I2C bus high logic level is VLOGIC. This does not apply to the MPU-6000, which does not have a VLOGIC pin.
uint8_t MPU6050:: getRate()
| Returns | the rate |
|---|
SMPLRT_DIV register.
Get gyroscope output rate divider. The sensor register output, FIFO output, DMP sampling, Motion detection, Zero Motion detection, and Free Fall detection are all based on the Sample Rate. The Sample Rate is generated by dividing the gyroscope output rate by SMPLRT_DIV:
Sample Rate = Gyroscope Output Rate / (1 + SMPLRT_DIV)
where Gyroscope Output Rate = 8kHz when the DLPF is disabled (DLPF_CFG = 0 or 7), and 1kHz when the DLPF is enabled (see Register 26).
Note: The accelerometer output rate is 1kHz. This means that for a Sample Rate greater than 1kHz, the same accelerometer sample may be output to the FIFO, DMP, and sensor registers more than once.
For a diagram of the gyroscope and accelerometer signal paths, see Section 8 of the MPU-6000/MPU-6050 Product Specification document.
void MPU6050:: setRate(uint8_t rate)
| Parameters | |
|---|---|
| rate | New sample rate divider |
SMPLRT_DIV register.
Set gyroscope sample rate divider.
uint8_t MPU6050:: getExternalFrameSync()
| Returns | frame sync |
|---|
The external frame sync.
Get external FSYNC configuration. Configures the external Frame Synchronization (FSYNC) pin sampling. An external signal connected to the FSYNC pin can be sampled by configuring EXT_SYNC_SET. Signal changes to the FSYNC pin are latched so that short strobes may be captured. The latched FSYNC signal will be sampled at the Sampling Rate, as defined in register 25. After sampling, the latch will reset to the current FSYNC signal state.
The sampled value will be reported in place of the least significant bit in a sensor data register determined by the value of EXT_SYNC_SET according to the following table.
EXT_SYNC_SET | FSYNC Bit Location -------------+------------------- 0 | Input disabled 1 | TEMP_OUT_L[0] 2 | GYRO_XOUT_L[0] 3 | GYRO_YOUT_L[0] 4 | GYRO_ZOUT_L[0] 5 | ACCEL_XOUT_L[0] 6 | ACCEL_YOUT_L[0] 7 | ACCEL_ZOUT_L[0]
void MPU6050:: setExternalFrameSync(uint8_t sync)
| Parameters | |
|---|---|
| sync | New FSYNC configuration value |
Set the external frame sync.
Set external FSYNC configuration.
uint8_t MPU6050:: getDLPFMode()
| Returns | DLPF mode |
|---|
Return the DLPF mode.
Get digital low-pass filter configuration. The DLPF_CFG parameter sets the digital low pass filter configuration. It also determines the internal sampling rate used by the device as shown in the table below.
Note: The accelerometer output rate is 1kHz. This means that for a Sample Rate greater than 1kHz, the same accelerometer sample may be output to the FIFO, DMP, and sensor registers more than once.
| ACCELEROMETER | GYROSCOPE
DLPF_CFG | Bandwidth | Delay | Bandwidth | Delay | Sample Rate
---------+-----------+--------+-----------+--------+-------------
0 | 260Hz | 0ms | 256Hz | 0.98ms | 8kHz
1 | 184Hz | 2.0ms | 188Hz | 1.9ms | 1kHz
2 | 94Hz | 3.0ms | 98Hz | 2.8ms | 1kHz
3 | 44Hz | 4.9ms | 42Hz | 4.8ms | 1kHz
4 | 21Hz | 8.5ms | 20Hz | 8.3ms | 1kHz
5 | 10Hz | 13.8ms | 10Hz | 13.4ms | 1kHz
6 | 5Hz | 19.0ms | 5Hz | 18.6ms | 1kHz
7 | -- Reserved -- | -- Reserved -- | Reserved
void MPU6050:: setDLPFMode(uint8_t bandwidth)
| Parameters | |
|---|---|
| bandwidth | dlpf |
Set DLPF mode.
Set digital low-pass filter configuration.
uint8_t MPU6050:: getFullScaleGyroRange()
| Returns | gyro range |
|---|
Full scale gyro range.
Get full-scale gyroscope range. The FS_SEL parameter allows setting the full-scale range of the gyro sensors, as described in the table below.
0 = +/- 250 degrees/sec 1 = +/- 500 degrees/sec 2 = +/- 1000 degrees/sec 3 = +/- 2000 degrees/sec
void MPU6050:: setFullScaleGyroRange(uint8_t range)
| Parameters | |
|---|---|
| range | New full-scale gyroscope range value |
Set full scale gyro range.
Set full-scale gyroscope range.
uint8_t MPU6050:: getAccelXSelfTestFactoryTrim()
| Returns | factory trim |
|---|
Acceleration x self test.
Get self-test factory trim value for accelerometer X axis.
uint8_t MPU6050:: getAccelYSelfTestFactoryTrim()
| Returns | factory trim |
|---|
Acceleration y self test.
Get self-test factory trim value for accelerometer Y axis.
uint8_t MPU6050:: getAccelZSelfTestFactoryTrim()
| Returns | factory trim |
|---|
Acceleration z self test.
Get self-test factory trim value for accelerometer Z axis.
uint8_t MPU6050:: getGyroXSelfTestFactoryTrim()
| Returns | factory trim |
|---|
Gyroscope x self test.
Get self-test factory trim value for gyro X axis.
uint8_t MPU6050:: getGyroYSelfTestFactoryTrim()
| Returns | factory trim |
|---|
Gyroscope y self test.
Get self-test factory trim value for gyro Y axis.
uint8_t MPU6050:: getGyroZSelfTestFactoryTrim()
| Returns | factory trim |
|---|
Gyroscope z self test.
Get self-test factory trim value for gyro Z axis.
bool MPU6050:: getAccelXSelfTest()
| Returns | pass |
|---|
Acceleration x self test.
Get self-test enabled setting for accelerometer X axis.
void MPU6050:: setAccelXSelfTest(bool enabled)
| Parameters | |
|---|---|
| enabled | Self-test enabled value |
| Returns | enabled test |
Set acceleration x self test.
Get self-test enabled setting for accelerometer X axis.
bool MPU6050:: getAccelYSelfTest()
| Returns | pass |
|---|
Acceleration y self test.
Get self-test enabled value for accelerometer Y axis.
void MPU6050:: setAccelYSelfTest(bool enabled)
| Parameters | |
|---|---|
| enabled | Self-test enabled value |
| Returns | enabled test |
Set acceleration y self test.
Get self-test enabled value for accelerometer Y axis.
bool MPU6050:: getAccelZSelfTest()
| Returns | pass |
|---|
Acceleration y self test.
Get self-test enabled value for accelerometer Z axis.
void MPU6050:: setAccelZSelfTest(bool enabled)
| Parameters | |
|---|---|
| enabled | Self-test enabled value |
| Returns | enabled test |
Set acceleration z self test.
Set self-test enabled value for accelerometer Z axis.
uint8_t MPU6050:: getFullScaleAccelRange()
| Returns | Current full-scale accelerometer range setting |
|---|
Get full-scale accelerometer range. The FS_SEL parameter allows setting the full-scale range of the accelerometer sensors, as described in the table below.
0 = +/- 2g 1 = +/- 4g 2 = +/- 8g 3 = +/- 16g
void MPU6050:: setFullScaleAccelRange(uint8_t range)
| Parameters | |
|---|---|
| range | New full-scale accelerometer range setting |
Set full-scale accelerometer range.
uint8_t MPU6050:: getDHPFMode()
| Returns | Current high-pass filter configuration |
|---|
Get the high-pass filter configuration. The DHPF is a filter module in the path leading to motion detectors (Free Fall, Motion threshold, and Zero Motion). The high pass filter output is not available to the data registers (see Figure in Section 8 of the MPU-6000/ MPU-6050 Product Specification document).
The high pass filter has three modes:
Reset: The filter output settles to zero within one sample. This
effectively disables the high pass filter. This mode may be toggled
to quickly settle the filter.On: The high pass filter will pass signals above the cut off frequency.
Hold: When triggered, the filter holds the present sample. The filter
output will be the difference between the input sample and the held
sample.
ACCEL_HPF | Filter Mode | Cut-off Frequency ----------+-------------+------------------ 0 | Reset | None 1 | On | 5Hz 2 | On | 2.5Hz 3 | On | 1.25Hz 4 | On | 0.63Hz 7 | Hold | None
void MPU6050:: setDHPFMode(uint8_t mode)
Set the high-pass filter configuration.
uint8_t MPU6050:: getFreefallDetectionThreshold()
| Returns | Current free-fall acceleration threshold value (LSB = 2mg) |
|---|
Get free-fall event acceleration threshold. This register configures the detection threshold for Free Fall event detection. The unit of FF_THR is 1LSB = 2mg. Free Fall is detected when the absolute value of the accelerometer measurements for the three axes are each less than the detection threshold. This condition increments the Free Fall duration counter (Register 30). The Free Fall interrupt is triggered when the Free Fall duration counter reaches the time specified in FF_DUR.
For more details on the Free Fall detection interrupt, see Section 8.2 of the MPU-6000/MPU-6050 Product Specification document as well as Registers 56 and 58 of this document.
void MPU6050:: setFreefallDetectionThreshold(uint8_t threshold)
| Parameters | |
|---|---|
| threshold | New free-fall acceleration threshold value (LSB = 2mg) |
Get free-fall event acceleration threshold.
uint8_t MPU6050:: getFreefallDetectionDuration()
| Returns | Current free-fall duration threshold value (LSB = 1ms) |
|---|
Get free-fall event duration threshold. This register configures the duration counter threshold for Free Fall event detection. The duration counter ticks at 1kHz, therefore FF_DUR has a unit of 1 LSB = 1 ms.
The Free Fall duration counter increments while the absolute value of the accelerometer measurements are each less than the detection threshold (Register 29). The Free Fall interrupt is triggered when the Free Fall duration counter reaches the time specified in this register.
For more details on the Free Fall detection interrupt, see Section 8.2 of the MPU-6000/MPU-6050 Product Specification document as well as Registers 56 and 58 of this document.
void MPU6050:: setFreefallDetectionDuration(uint8_t duration)
| Parameters | |
|---|---|
| duration | New free-fall duration threshold value (LSB = 1ms) |
Get free-fall event duration threshold.
uint8_t MPU6050:: getMotionDetectionThreshold()
| Returns | Current motion detection acceleration threshold value (LSB = 2mg) |
|---|
Get motion detection event acceleration threshold. This register configures the detection threshold for Motion interrupt generation. The unit of MOT_THR is 1LSB = 2mg. Motion is detected when the absolute value of any of the accelerometer measurements exceeds this Motion detection threshold. This condition increments the Motion detection duration counter (Register 32). The Motion detection interrupt is triggered when the Motion Detection counter reaches the time count specified in MOT_DUR (Register 32).
The Motion interrupt will indicate the axis and polarity of detected motion in MOT_DETECT_STATUS (Register 97).
For more details on the Motion detection interrupt, see Section 8.3 of the MPU-6000/MPU-6050 Product Specification document as well as Registers 56 and 58 of this document.
void MPU6050:: setMotionDetectionThreshold(uint8_t threshold)
| Parameters | |
|---|---|
| threshold | New motion detection acceleration threshold value (LSB = 2mg) |
Set motion detection event acceleration threshold.
uint8_t MPU6050:: getMotionDetectionDuration()
| Returns | Current motion detection duration threshold value (LSB = 1ms) |
|---|
Get motion detection event duration threshold. This register configures the duration counter threshold for Motion interrupt generation. The duration counter ticks at 1 kHz, therefore MOT_DUR has a unit of 1LSB = 1ms. The Motion detection duration counter increments when the absolute value of any of the accelerometer measurements exceeds the Motion detection threshold (Register 31). The Motion detection interrupt is triggered when the Motion detection counter reaches the time count specified in this register.
For more details on the Motion detection interrupt, see Section 8.3 of the MPU-6000/MPU-6050 Product Specification document.
void MPU6050:: setMotionDetectionDuration(uint8_t duration)
| Parameters | |
|---|---|
| duration | New motion detection duration threshold value (LSB = 1ms) |
Set motion detection event duration threshold.
uint8_t MPU6050:: getZeroMotionDetectionThreshold()
| Returns | Current zero motion detection acceleration threshold value (LSB = 2mg) |
|---|
Get zero motion detection event acceleration threshold. This register configures the detection threshold for Zero Motion interrupt generation. The unit of ZRMOT_THR is 1LSB = 2mg. Zero Motion is detected when the absolute value of the accelerometer measurements for the 3 axes are each less than the detection threshold. This condition increments the Zero Motion duration counter (Register 34). The Zero Motion interrupt is triggered when the Zero Motion duration counter reaches the time count specified in ZRMOT_DUR (Register 34).
Unlike Free Fall or Motion detection, Zero Motion detection triggers an interrupt both when Zero Motion is first detected and when Zero Motion is no longer detected.
When a zero motion event is detected, a Zero Motion Status will be indicated in the MOT_DETECT_STATUS register (Register 97). When a motion-to-zero-motion condition is detected, the status bit is set to 1. When a zero-motion-to- motion condition is detected, the status bit is set to 0.
For more details on the Zero Motion detection interrupt, see Section 8.4 of the MPU-6000/MPU-6050 Product Specification document as well as Registers 56 and 58 of this document.
void MPU6050:: setZeroMotionDetectionThreshold(uint8_t threshold)
| Parameters | |
|---|---|
| threshold | New zero motion detection acceleration threshold value (LSB = 2mg) |
Set zero motion detection event acceleration threshold.
uint8_t MPU6050:: getZeroMotionDetectionDuration()
| Returns | Current zero motion detection duration threshold value (LSB = 64ms) |
|---|
Get zero motion detection event duration threshold. This register configures the duration counter threshold for Zero Motion interrupt generation. The duration counter ticks at 16 Hz, therefore ZRMOT_DUR has a unit of 1 LSB = 64 ms. The Zero Motion duration counter increments while the absolute value of the accelerometer measurements are each less than the detection threshold (Register 33). The Zero Motion interrupt is triggered when the Zero Motion duration counter reaches the time count specified in this register.
For more details on the Zero Motion detection interrupt, see Section 8.4 of the MPU-6000/MPU-6050 Product Specification document, as well as Registers 56 and 58 of this document.
void MPU6050:: setZeroMotionDetectionDuration(uint8_t duration)
| Parameters | |
|---|---|
| duration | New zero motion detection duration threshold value (LSB = 1ms) |
Set zero motion detection event duration threshold.
bool MPU6050:: getTempFIFOEnabled()
| Returns | Current temperature FIFO enabled value |
|---|
Get temperature FIFO enabled value. When set to 1, this bit enables TEMP_OUT_H and TEMP_OUT_L (Registers 65 and 66) to be written into the FIFO buffer.
void MPU6050:: setTempFIFOEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New temperature FIFO enabled value |
Set temperature FIFO enabled value.
bool MPU6050:: getXGyroFIFOEnabled()
| Returns | Current gyroscope X-axis FIFO enabled value |
|---|
Get gyroscope X-axis FIFO enabled value. When set to 1, this bit enables GYRO_XOUT_H and GYRO_XOUT_L (Registers 67 and 68) to be written into the FIFO buffer.
void MPU6050:: setXGyroFIFOEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New gyroscope X-axis FIFO enabled value |
Set gyroscope X-axis FIFO enabled value.
bool MPU6050:: getYGyroFIFOEnabled()
| Returns | Current gyroscope Y-axis FIFO enabled value |
|---|
Get gyroscope Y-axis FIFO enabled value. When set to 1, this bit enables GYRO_YOUT_H and GYRO_YOUT_L (Registers 69 and 70) to be written into the FIFO buffer.
void MPU6050:: setYGyroFIFOEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New gyroscope Y-axis FIFO enabled value |
Set gyroscope Y-axis FIFO enabled value.
bool MPU6050:: getZGyroFIFOEnabled()
| Returns | Current gyroscope Z-axis FIFO enabled value |
|---|
Get gyroscope Z-axis FIFO enabled value. When set to 1, this bit enables GYRO_ZOUT_H and GYRO_ZOUT_L (Registers 71 and 72) to be written into the FIFO buffer.
void MPU6050:: setZGyroFIFOEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New gyroscope Z-axis FIFO enabled value |
Set gyroscope Z-axis FIFO enabled value.
bool MPU6050:: getAccelFIFOEnabled()
| Returns | Current accelerometer FIFO enabled value |
|---|
Get accelerometer FIFO enabled value. When set to 1, this bit enables ACCEL_XOUT_H, ACCEL_XOUT_L, ACCEL_YOUT_H, ACCEL_YOUT_L, ACCEL_ZOUT_H, and ACCEL_ZOUT_L (Registers 59 to 64) to be written into the FIFO buffer.
void MPU6050:: setAccelFIFOEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New accelerometer FIFO enabled value |
Set accelerometer FIFO enabled value.
bool MPU6050:: getSlave2FIFOEnabled()
| Returns | Current Slave 2 FIFO enabled value |
|---|
Get Slave 2 FIFO enabled value. When set to 1, this bit enables EXT_SENS_DATA registers (Registers 73 to 96) associated with Slave 2 to be written into the FIFO buffer.
void MPU6050:: setSlave2FIFOEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New Slave 2 FIFO enabled value |
Set Slave 2 FIFO enabled value.
bool MPU6050:: getSlave1FIFOEnabled()
| Returns | Current Slave 1 FIFO enabled value |
|---|
Get Slave 1 FIFO enabled value. When set to 1, this bit enables EXT_SENS_DATA registers (Registers 73 to 96) associated with Slave 1 to be written into the FIFO buffer.
void MPU6050:: setSlave1FIFOEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New Slave 1 FIFO enabled value |
Set Slave 1 FIFO enabled value.
bool MPU6050:: getSlave0FIFOEnabled()
| Returns | Current Slave 0 FIFO enabled value |
|---|
Get Slave 0 FIFO enabled value. When set to 1, this bit enables EXT_SENS_DATA registers (Registers 73 to 96) associated with Slave 0 to be written into the FIFO buffer.
void MPU6050:: setSlave0FIFOEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New Slave 0 FIFO enabled value |
Set Slave 0 FIFO enabled value.
bool MPU6050:: getMultiMasterEnabled()
| Returns | Current multi-master enabled value |
|---|
Get multi-master enabled value. Multi-master capability allows multiple I2C masters to operate on the same bus. In circuits where multi-master capability is required, set MULT_MST_EN to 1. This will increase current drawn by approximately 30uA.
In circuits where multi-master capability is required, the state of the I2C bus must always be monitored by each separate I2C Master. Before an I2C Master can assume arbitration of the bus, it must first confirm that no other I2C Master has arbitration of the bus. When MULT_MST_EN is set to 1, the MPU-60X0's bus arbitration detection logic is turned on, enabling it to detect when the bus is available.
void MPU6050:: setMultiMasterEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New multi-master enabled value |
Set multi-master enabled value.
bool MPU6050:: getWaitForExternalSensorEnabled()
| Returns | Current wait-for-external-sensor-data enabled value |
|---|
Get wait-for-external-sensor-data enabled value. When the WAIT_FOR_ES bit is set to 1, the Data Ready interrupt will be delayed until External Sensor data from the Slave Devices are loaded into the EXT_SENS_DATA registers. This is used to ensure that both the internal sensor data (i.e. from gyro and accel) and external sensor data have been loaded to their respective data registers (i.e. the data is synced) when the Data Ready interrupt is triggered.
void MPU6050:: setWaitForExternalSensorEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New wait-for-external-sensor-data enabled value |
Set wait-for-external-sensor-data enabled value.
bool MPU6050:: getSlave3FIFOEnabled()
| Returns | Current Slave 3 FIFO enabled value |
|---|
Get Slave 3 FIFO enabled value. When set to 1, this bit enables EXT_SENS_DATA registers (Registers 73 to 96) associated with Slave 3 to be written into the FIFO buffer.
void MPU6050:: setSlave3FIFOEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New Slave 3 FIFO enabled value |
Set Slave 3 FIFO enabled value.
bool MPU6050:: getSlaveReadWriteTransitionEnabled()
| Returns | Current slave read/write transition enabled value |
|---|
Get slave read/write transition enabled value. The I2C_MST_P_NSR bit configures the I2C Master's transition from one slave read to the next slave read. If the bit equals 0, there will be a restart between reads. If the bit equals 1, there will be a stop followed by a start of the following read. When a write transaction follows a read transaction, the stop followed by a start of the successive write will be always used.
void MPU6050:: setSlaveReadWriteTransitionEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New slave read/write transition enabled value |
Set slave read/write transition enabled value.
uint8_t MPU6050:: getMasterClockSpeed()
| Returns | Current I2C master clock speed |
|---|
Get I2C master clock speed. I2C_MST_CLK is a 4 bit unsigned value which configures a divider on the MPU-60X0 internal 8MHz clock. It sets the I2C master clock speed according to the following table:
I2C_MST_CLK | I2C Master Clock Speed | 8MHz Clock Divider ------------+------------------------+------------------- 0 | 348kHz | 23 1 | 333kHz | 24 2 | 320kHz | 25 3 | 308kHz | 26 4 | 296kHz | 27 5 | 286kHz | 28 6 | 276kHz | 29 7 | 267kHz | 30 8 | 258kHz | 31 9 | 500kHz | 16 10 | 471kHz | 17 11 | 444kHz | 18 12 | 421kHz | 19 13 | 400kHz | 20 14 | 381kHz | 21 15 | 364kHz | 22
void MPU6050:: setMasterClockSpeed(uint8_t speed)
Set I2C master clock speed. @reparam speed Current I2C master clock speed
uint8_t MPU6050:: getSlaveAddress(uint8_t num)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| Returns | Current address for specified slave |
Get the I2C address of the specified slave (0-3). Note that Bit 7 (MSB) controls read/write mode. If Bit 7 is set, it's a read operation, and if it is cleared, then it's a write operation. The remaining bits (6-0) are the 7-bit device address of the slave device.
In read mode, the result of the read is placed in the lowest available EXT_SENS_DATA register. For further information regarding the allocation of read results, please refer to the EXT_SENS_DATA register description (Registers 73 - 96).
The MPU-6050 supports a total of five slaves, but Slave 4 has unique characteristics, and so it has its own functions (getSlave4* and setSlave4*).
I2C data transactions are performed at the Sample Rate, as defined in Register 25. The user is responsible for ensuring that I2C data transactions to and from each enabled Slave can be completed within a single period of the Sample Rate.
The I2C slave access rate can be reduced relative to the Sample Rate. This reduced access rate is determined by I2C_MST_DLY (Register 52). Whether a slave's access rate is reduced relative to the Sample Rate is determined by I2C_MST_DELAY_CTRL (Register 103).
The processing order for the slaves is fixed. The sequence followed for processing the slaves is Slave 0, Slave 1, Slave 2, Slave 3 and Slave 4. If a particular Slave is disabled it will be skipped.
Each slave can either be accessed at the sample rate or at a reduced sample rate. In a case where some slaves are accessed at the Sample Rate and some slaves are accessed at the reduced rate, the sequence of accessing the slaves (Slave 0 to Slave 4) is still followed. However, the reduced rate slaves will be skipped if their access rate dictates that they should not be accessed during that particular cycle. For further information regarding the reduced access rate, please refer to Register 52. Whether a slave is accessed at the Sample Rate or at the reduced rate is determined by the Delay Enable bits in Register 103.
void MPU6050:: setSlaveAddress(uint8_t num,
uint8_t address)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| address | New address for specified slave |
Set the I2C address of the specified slave (0-3).
uint8_t MPU6050:: getSlaveRegister(uint8_t num)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| Returns | Current active register for specified slave |
Get the active internal register for the specified slave (0-3). Read/write operations for this slave will be done to whatever internal register address is stored in this MPU register.
The MPU-6050 supports a total of five slaves, but Slave 4 has unique characteristics, and so it has its own functions.
void MPU6050:: setSlaveRegister(uint8_t num,
uint8_t reg)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| reg | New active register for specified slave |
Set the active internal register for the specified slave (0-3).
bool MPU6050:: getSlaveEnabled(uint8_t num)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| Returns | Current enabled value for specified slave |
Get the enabled value for the specified slave (0-3). When set to 1, this bit enables Slave 0 for data transfer operations. When cleared to 0, this bit disables Slave 0 from data transfer operations.
void MPU6050:: setSlaveEnabled(uint8_t num,
bool enabled)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| enabled | New enabled value for specified slave |
Set the enabled value for the specified slave (0-3).
bool MPU6050:: getSlaveWordByteSwap(uint8_t num)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| Returns | Current word pair byte-swapping enabled value for specified slave |
Get word pair byte-swapping enabled for the specified slave (0-3). When set to 1, this bit enables byte swapping. When byte swapping is enabled, the high and low bytes of a word pair are swapped. Please refer to I2C_SLV0_GRP for the pairing convention of the word pairs. When cleared to 0, bytes transferred to and from Slave 0 will be written to EXT_SENS_DATA registers in the order they were transferred.
void MPU6050:: setSlaveWordByteSwap(uint8_t num,
bool enabled)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| enabled | New word pair byte-swapping enabled value for specified slave |
Set word pair byte-swapping enabled for the specified slave (0-3).
bool MPU6050:: getSlaveWriteMode(uint8_t num)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| Returns | Current write mode for specified slave (0 = register address + data, 1 = data only) |
Get write mode for the specified slave (0-3). When set to 1, the transaction will read or write data only. When cleared to 0, the transaction will write a register address prior to reading or writing data. This should equal 0 when specifying the register address within the Slave device to/from which the ensuing data transaction will take place.
void MPU6050:: setSlaveWriteMode(uint8_t num,
bool mode)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| mode | New write mode for specified slave (0 = register address + data, 1 = data only) |
Set write mode for the specified slave (0-3).
bool MPU6050:: getSlaveWordGroupOffset(uint8_t num)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| Returns | Current word pair grouping order offset for specified slave |
Get word pair grouping order offset for the specified slave (0-3). This sets specifies the grouping order of word pairs received from registers. When cleared to 0, bytes from register addresses 0 and 1, 2 and 3, etc (even, then odd register addresses) are paired to form a word. When set to 1, bytes from register addresses are paired 1 and 2, 3 and 4, etc. (odd, then even register addresses) are paired to form a word.
void MPU6050:: setSlaveWordGroupOffset(uint8_t num,
bool enabled)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| enabled | New word pair grouping order offset for specified slave |
Set word pair grouping order offset for the specified slave (0-3).
uint8_t MPU6050:: getSlaveDataLength(uint8_t num)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| Returns | Number of bytes to read for specified slave |
Get number of bytes to read for the specified slave (0-3). Specifies the number of bytes transferred to and from Slave 0. Clearing this bit to 0 is equivalent to disabling the register by writing 0 to I2C_SLV0_EN.
void MPU6050:: setSlaveDataLength(uint8_t num,
uint8_t length)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| length | Number of bytes to read for specified slave |
Set number of bytes to read for the specified slave (0-3).
uint8_t MPU6050:: getSlave4Address()
| Returns | Current address for Slave 4 |
|---|
Get the I2C address of Slave 4. Note that Bit 7 (MSB) controls read/write mode. If Bit 7 is set, it's a read operation, and if it is cleared, then it's a write operation. The remaining bits (6-0) are the 7-bit device address of the slave device.
void MPU6050:: setSlave4Address(uint8_t address)
| Parameters | |
|---|---|
| address | New address for Slave 4 |
Set the I2C address of Slave 4.
uint8_t MPU6050:: getSlave4Register()
| Returns | Current active register for Slave 4 |
|---|
Get the active internal register for the Slave 4. Read/write operations for this slave will be done to whatever internal register address is stored in this MPU register.
void MPU6050:: setSlave4Register(uint8_t reg)
| Parameters | |
|---|---|
| reg | New active register for Slave 4 |
Set the active internal register for Slave 4.
void MPU6050:: setSlave4OutputByte(uint8_t data)
| Parameters | |
|---|---|
| data | New byte to write to Slave 4 |
Set new byte to write to Slave 4. This register stores the data to be written into the Slave 4. If I2C_SLV4_RW is set 1 (set to read), this register has no effect.
bool MPU6050:: getSlave4Enabled()
| Returns | Current enabled value for Slave 4 |
|---|
Get the enabled value for the Slave 4. When set to 1, this bit enables Slave 4 for data transfer operations. When cleared to 0, this bit disables Slave 4 from data transfer operations.
void MPU6050:: setSlave4Enabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New enabled value for Slave 4 |
Set the enabled value for Slave 4.
bool MPU6050:: getSlave4InterruptEnabled()
| Returns | Current enabled value for Slave 4 transaction interrupts. |
|---|
Get the enabled value for Slave 4 transaction interrupts. When set to 1, this bit enables the generation of an interrupt signal upon completion of a Slave 4 transaction. When cleared to 0, this bit disables the generation of an interrupt signal upon completion of a Slave 4 transaction. The interrupt status can be observed in Register 54.
void MPU6050:: setSlave4InterruptEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New enabled value for Slave 4 transaction interrupts. |
Set the enabled value for Slave 4 transaction interrupts.
bool MPU6050:: getSlave4WriteMode()
| Returns | Current write mode for Slave 4 (0 = register address + data, 1 = data only) |
|---|
Get write mode for Slave 4. When set to 1, the transaction will read or write data only. When cleared to 0, the transaction will write a register address prior to reading or writing data. This should equal 0 when specifying the register address within the Slave device to/from which the ensuing data transaction will take place.
void MPU6050:: setSlave4WriteMode(bool mode)
| Parameters | |
|---|---|
| mode | New write mode for Slave 4 (0 = register address + data, 1 = data only) |
Set write mode for the Slave 4.
uint8_t MPU6050:: getSlave4MasterDelay()
| Returns | Current Slave 4 master delay value |
|---|
Get Slave 4 master delay value. This configures the reduced access rate of I2C slaves relative to the Sample Rate. When a slave's access rate is decreased relative to the Sample Rate, the slave is accessed every:
1 / (1 + I2C_MST_DLY) samples
This base Sample Rate in turn is determined by SMPLRT_DIV (register 25) and DLPF_CFG (register 26). Whether a slave's access rate is reduced relative to the Sample Rate is determined by I2C_MST_DELAY_CTRL (register 103). For further information regarding the Sample Rate, please refer to register 25.
void MPU6050:: setSlave4MasterDelay(uint8_t delay)
| Parameters | |
|---|---|
| delay | New Slave 4 master delay value |
Set Slave 4 master delay value.
uint8_t MPU6050:: getSlate4InputByte()
| Returns | Last available byte read from to Slave 4 |
|---|
Get last available byte read from Slave 4. This register stores the data read from Slave 4. This field is populated after a read transaction.
bool MPU6050:: getPassthroughStatus()
| Returns | FSYNC interrupt status |
|---|
Get FSYNC interrupt status. This bit reflects the status of the FSYNC interrupt from an external device into the MPU-60X0. This is used as a way to pass an external interrupt through the MPU-60X0 to the host application processor. When set to 1, this bit will cause an interrupt if FSYNC_INT_EN is asserted in INT_PIN_CFG (Register 55).
bool MPU6050:: getSlave4IsDone()
| Returns | Slave 4 transaction done status |
|---|
Get Slave 4 transaction done status. Automatically sets to 1 when a Slave 4 transaction has completed. This triggers an interrupt if the I2C_MST_INT_EN bit in the INT_ENABLE register (Register 56) is asserted and if the SLV_4_DONE_INT bit is asserted in the I2C_SLV4_CTRL register (Register 52).
bool MPU6050:: getLostArbitration()
| Returns | Master arbitration lost status |
|---|
Get master arbitration lost status. This bit automatically sets to 1 when the I2C Master has lost arbitration of the auxiliary I2C bus (an error condition). This triggers an interrupt if the I2C_MST_INT_EN bit in the INT_ENABLE register (Register 56) is asserted.
bool MPU6050:: getSlave4Nack()
| Returns | Slave 4 NACK interrupt status |
|---|
Get Slave 4 NACK status. This bit automatically sets to 1 when the I2C Master receives a NACK in a transaction with Slave 4. This triggers an interrupt if the I2C_MST_INT_EN bit in the INT_ENABLE register (Register 56) is asserted.
bool MPU6050:: getSlave3Nack()
| Returns | Slave 3 NACK interrupt status |
|---|
Get Slave 3 NACK status. This bit automatically sets to 1 when the I2C Master receives a NACK in a transaction with Slave 3. This triggers an interrupt if the I2C_MST_INT_EN bit in the INT_ENABLE register (Register 56) is asserted.
bool MPU6050:: getSlave2Nack()
| Returns | Slave 2 NACK interrupt status |
|---|
Get Slave 2 NACK status. This bit automatically sets to 1 when the I2C Master receives a NACK in a transaction with Slave 2. This triggers an interrupt if the I2C_MST_INT_EN bit in the INT_ENABLE register (Register 56) is asserted.
bool MPU6050:: getSlave1Nack()
| Returns | Slave 1 NACK interrupt status |
|---|
Get Slave 1 NACK status. This bit automatically sets to 1 when the I2C Master receives a NACK in a transaction with Slave 1. This triggers an interrupt if the I2C_MST_INT_EN bit in the INT_ENABLE register (Register 56) is asserted.
bool MPU6050:: getSlave0Nack()
| Returns | Slave 0 NACK interrupt status |
|---|
Get Slave 0 NACK status. This bit automatically sets to 1 when the I2C Master receives a NACK in a transaction with Slave 0. This triggers an interrupt if the I2C_MST_INT_EN bit in the INT_ENABLE register (Register 56) is asserted.
bool MPU6050:: getInterruptMode()
| Returns | Current interrupt mode (0=active-high, 1=active-low) |
|---|
Get interrupt logic level mode. Will be set 0 for active-high, 1 for active-low.
void MPU6050:: setInterruptMode(bool mode)
| Parameters | |
|---|---|
| mode | New interrupt mode (0=active-high, 1=active-low) |
Set interrupt logic level mode.
bool MPU6050:: getInterruptDrive()
| Returns | Current interrupt drive mode (0=push-pull, 1=open-drain) |
|---|
Get interrupt drive mode. Will be set 0 for push-pull, 1 for open-drain.
void MPU6050:: setInterruptDrive(bool drive)
| Parameters | |
|---|---|
| drive | New interrupt drive mode (0=push-pull, 1=open-drain) |
Set interrupt drive mode.
bool MPU6050:: getInterruptLatch()
| Returns | Current latch mode (0=50us-pulse, 1=latch-until-int-cleared) |
|---|
Get interrupt latch mode. Will be set 0 for 50us-pulse, 1 for latch-until-int-cleared.
void MPU6050:: setInterruptLatch(bool latch)
| Parameters | |
|---|---|
| latch | New latch mode (0=50us-pulse, 1=latch-until-int-cleared) |
Set interrupt latch mode.
bool MPU6050:: getInterruptLatchClear()
| Returns | Current latch clear mode (0=status-read-only, 1=any-register-read) |
|---|
Get interrupt latch clear mode. Will be set 0 for status-read-only, 1 for any-register-read.
void MPU6050:: setInterruptLatchClear(bool clear)
| Parameters | |
|---|---|
| clear | New latch clear mode (0=status-read-only, 1=any-register-read) |
Set interrupt latch clear mode.
bool MPU6050:: getFSyncInterruptLevel()
| Returns | Current FSYNC interrupt mode (0=active-high, 1=active-low) |
|---|
Get FSYNC interrupt logic level mode.
void MPU6050:: setFSyncInterruptLevel(bool level)
Set FSYNC interrupt logic level mode.
bool MPU6050:: getFSyncInterruptEnabled()
| Returns | Current interrupt enabled setting |
|---|
Get FSYNC pin interrupt enabled setting. Will be set 0 for disabled, 1 for enabled.
void MPU6050:: setFSyncInterruptEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New FSYNC pin interrupt enabled setting |
Set FSYNC pin interrupt enabled setting.
bool MPU6050:: getI2CBypassEnabled()
| Returns | Current I2C bypass enabled status |
|---|
Get I2C bypass enabled status. When this bit is equal to 1 and I2C_MST_EN (Register 106 bit[5]) is equal to 0, the host application processor will be able to directly access the auxiliary I2C bus of the MPU-60X0. When this bit is equal to 0, the host application processor will not be able to directly access the auxiliary I2C bus of the MPU-60X0 regardless of the state of I2C_MST_EN (Register 106 bit[5]).
void MPU6050:: setI2CBypassEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New I2C bypass enabled status |
Set I2C bypass enabled status. When this bit is equal to 1 and I2C_MST_EN (Register 106 bit[5]) is equal to 0, the host application processor will be able to directly access the auxiliary I2C bus of the MPU-60X0. When this bit is equal to 0, the host application processor will not be able to directly access the auxiliary I2C bus of the MPU-60X0 regardless of the state of I2C_MST_EN (Register 106 bit[5]).
bool MPU6050:: getClockOutputEnabled()
| Returns | Current reference clock output enabled status |
|---|
Get reference clock output enabled status. When this bit is equal to 1, a reference clock output is provided at the CLKOUT pin. When this bit is equal to 0, the clock output is disabled. For further information regarding CLKOUT, please refer to the MPU-60X0 Product Specification document.
void MPU6050:: setClockOutputEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New reference clock output enabled status |
Set reference clock output enabled status. When this bit is equal to 1, a reference clock output is provided at the CLKOUT pin. When this bit is equal to 0, the clock output is disabled. For further information regarding CLKOUT, please refer to the MPU-60X0 Product Specification document.
uint8_t MPU6050:: getIntEnabled()
| Returns | Current interrupt enabled status |
|---|
Get full interrupt enabled status. Full register byte for all interrupts, for quick reading. Each bit will be set 0 for disabled, 1 for enabled.
void MPU6050:: setIntEnabled(uint8_t enabled)
| Parameters | |
|---|---|
| enabled | New interrupt enabled status |
Set full interrupt enabled status. Full register byte for all interrupts, for quick reading. Each bit should be set 0 for disabled, 1 for enabled.
bool MPU6050:: getIntFreefallEnabled()
| Returns | Current interrupt enabled status |
|---|
Get Free Fall interrupt enabled status. Will be set 0 for disabled, 1 for enabled.
void MPU6050:: setIntFreefallEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New interrupt enabled status |
Set Free Fall interrupt enabled status.
bool MPU6050:: getIntMotionEnabled()
| Returns | Current interrupt enabled status |
|---|
Get Motion Detection interrupt enabled status. Will be set 0 for disabled, 1 for enabled.
void MPU6050:: setIntMotionEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New interrupt enabled status |
Set Motion Detection interrupt enabled status.
bool MPU6050:: getIntZeroMotionEnabled()
| Returns | Current interrupt enabled status |
|---|
Get Zero Motion Detection interrupt enabled status. Will be set 0 for disabled, 1 for enabled.
void MPU6050:: setIntZeroMotionEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New interrupt enabled status |
Set Zero Motion Detection interrupt enabled status.
bool MPU6050:: getIntFIFOBufferOverflowEnabled()
| Returns | Current interrupt enabled status |
|---|
Get FIFO Buffer Overflow interrupt enabled status. Will be set 0 for disabled, 1 for enabled.
void MPU6050:: setIntFIFOBufferOverflowEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New interrupt enabled status |
Set FIFO Buffer Overflow interrupt enabled status.
bool MPU6050:: getIntI2CMasterEnabled()
| Returns | Current interrupt enabled status |
|---|
Get I2C Master interrupt enabled status. This enables any of the I2C Master interrupt sources to generate an interrupt. Will be set 0 for disabled, 1 for enabled.
void MPU6050:: setIntI2CMasterEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New interrupt enabled status |
Set I2C Master interrupt enabled status.
bool MPU6050:: getIntDataReadyEnabled()
| Returns | Current interrupt enabled status |
|---|
Get Data Ready interrupt enabled setting. This event occurs each time a write operation to all of the sensor registers has been completed. Will be set 0 for disabled, 1 for enabled.
void MPU6050:: setIntDataReadyEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New interrupt enabled status |
Set Data Ready interrupt enabled status.
uint8_t MPU6050:: getIntStatus()
| Returns | Current interrupt status |
|---|
Get full set of interrupt status bits. These bits clear to 0 after the register has been read. Very useful for getting multiple INT statuses, since each single bit read clears all of them because it has to read the whole byte.
bool MPU6050:: getIntFreefallStatus()
| Returns | Current interrupt status |
|---|
Get Free Fall interrupt status. This bit automatically sets to 1 when a Free Fall interrupt has been generated. The bit clears to 0 after the register has been read.
bool MPU6050:: getIntMotionStatus()
| Returns | Current interrupt status |
|---|
Get Motion Detection interrupt status. This bit automatically sets to 1 when a Motion Detection interrupt has been generated. The bit clears to 0 after the register has been read.
bool MPU6050:: getIntZeroMotionStatus()
| Returns | Current interrupt status |
|---|
Get Zero Motion Detection interrupt status. This bit automatically sets to 1 when a Zero Motion Detection interrupt has been generated. The bit clears to 0 after the register has been read.
bool MPU6050:: getIntFIFOBufferOverflowStatus()
| Returns | Current interrupt status |
|---|
Get FIFO Buffer Overflow interrupt status. This bit automatically sets to 1 when a Free Fall interrupt has been generated. The bit clears to 0 after the register has been read.
bool MPU6050:: getIntI2CMasterStatus()
| Returns | Current interrupt status |
|---|
Get I2C Master interrupt status. This bit automatically sets to 1 when an I2C Master interrupt has been generated. For a list of I2C Master interrupts, please refer to Register 54. The bit clears to 0 after the register has been read.
bool MPU6050:: getIntDataReadyStatus()
| Returns | Current interrupt status |
|---|
Get Data Ready interrupt status. This bit automatically sets to 1 when a Data Ready interrupt has been generated. The bit clears to 0 after the register has been read.
void MPU6050:: getMotion9(int16_t* ax,
int16_t* ay,
int16_t* az,
int16_t* gx,
int16_t* gy,
int16_t* gz,
int16_t* mx,
int16_t* my,
int16_t* mz)
| Parameters | |
|---|---|
| ax | 16-bit signed integer container for accelerometer X-axis value |
| ay | 16-bit signed integer container for accelerometer Y-axis value |
| az | 16-bit signed integer container for accelerometer Z-axis value |
| gx | 16-bit signed integer container for gyroscope X-axis value |
| gy | 16-bit signed integer container for gyroscope Y-axis value |
| gz | 16-bit signed integer container for gyroscope Z-axis value |
| mx | 16-bit signed integer container for magnetometer X-axis value |
| my | 16-bit signed integer container for magnetometer Y-axis value |
| mz | 16-bit signed integer container for magnetometer Z-axis value |
Get raw 9-axis motion sensor readings (accel/gyro/compass). FUNCTION NOT FULLY IMPLEMENTED YET.
void MPU6050:: getMotion6(int16_t* ax,
int16_t* ay,
int16_t* az,
int16_t* gx,
int16_t* gy,
int16_t* gz)
| Parameters | |
|---|---|
| ax | 16-bit signed integer container for accelerometer X-axis value |
| ay | 16-bit signed integer container for accelerometer Y-axis value |
| az | 16-bit signed integer container for accelerometer Z-axis value |
| gx | 16-bit signed integer container for gyroscope X-axis value |
| gy | 16-bit signed integer container for gyroscope Y-axis value |
| gz | 16-bit signed integer container for gyroscope Z-axis value |
Get raw 6-axis motion sensor readings (accel/gyro). Retrieves all currently available motion sensor values.
void MPU6050:: getAcceleration(int16_t* x,
int16_t* y,
int16_t* z)
| Parameters | |
|---|---|
| x | 16-bit signed integer container for X-axis acceleration |
| y | 16-bit signed integer container for Y-axis acceleration |
| z | 16-bit signed integer container for Z-axis acceleration |
Get 3-axis accelerometer readings. These registers store the most recent accelerometer measurements. Accelerometer measurements are written to these registers at the Sample Rate as defined in Register 25.
The accelerometer measurement registers, along with the temperature measurement registers, gyroscope measurement registers, and external sensor data registers, are composed of two sets of registers: an internal register set and a user-facing read register set.
The data within the accelerometer sensors' internal register set is always updated at the Sample Rate. Meanwhile, the user-facing read register set duplicates the internal register set's data values whenever the serial interface is idle. This guarantees that a burst read of sensor registers will read measurements from the same sampling instant. Note that if burst reads are not used, the user is responsible for ensuring a set of single byte reads correspond to a single sampling instant by checking the Data Ready interrupt.
Each 16-bit accelerometer measurement has a full scale defined in ACCEL_FS (Register 28). For each full scale setting, the accelerometers' sensitivity per LSB in ACCEL_xOUT is shown in the table below:
AFS_SEL | Full Scale Range | LSB Sensitivity --------+------------------+---------------- 0 | +/- 2g | 8192 LSB/mg 1 | +/- 4g | 4096 LSB/mg 2 | +/- 8g | 2048 LSB/mg 3 | +/- 16g | 1024 LSB/mg
int16_t MPU6050:: getAccelerationX()
| Returns | X-axis acceleration measurement in 16-bit 2's complement format |
|---|
Get X-axis accelerometer reading.
int16_t MPU6050:: getAccelerationY()
| Returns | Y-axis acceleration measurement in 16-bit 2's complement format |
|---|
Get Y-axis accelerometer reading.
int16_t MPU6050:: getAccelerationZ()
| Returns | Z-axis acceleration measurement in 16-bit 2's complement format |
|---|
Get Z-axis accelerometer reading.
int16_t MPU6050:: getTemperature()
| Returns | Temperature reading in 16-bit 2's complement format |
|---|
Get current internal temperature.
void MPU6050:: getRotation(int16_t* x,
int16_t* y,
int16_t* z)
| Parameters | |
|---|---|
| x | 16-bit signed integer container for X-axis rotation |
| y | 16-bit signed integer container for Y-axis rotation |
| z | 16-bit signed integer container for Z-axis rotation |
Get 3-axis gyroscope readings. These gyroscope measurement registers, along with the accelerometer measurement registers, temperature measurement registers, and external sensor data registers, are composed of two sets of registers: an internal register set and a user-facing read register set. The data within the gyroscope sensors' internal register set is always updated at the Sample Rate. Meanwhile, the user-facing read register set duplicates the internal register set's data values whenever the serial interface is idle. This guarantees that a burst read of sensor registers will read measurements from the same sampling instant. Note that if burst reads are not used, the user is responsible for ensuring a set of single byte reads correspond to a single sampling instant by checking the Data Ready interrupt.
Each 16-bit gyroscope measurement has a full scale defined in FS_SEL (Register 27). For each full scale setting, the gyroscopes' sensitivity per LSB in GYRO_xOUT is shown in the table below:
FS_SEL | Full Scale Range | LSB Sensitivity -------+--------------------+---------------- 0 | +/- 250 degrees/s | 131 LSB/deg/s 1 | +/- 500 degrees/s | 65.5 LSB/deg/s 2 | +/- 1000 degrees/s | 32.8 LSB/deg/s 3 | +/- 2000 degrees/s | 16.4 LSB/deg/s
int16_t MPU6050:: getRotationX()
| Returns | X-axis rotation measurement in 16-bit 2's complement format |
|---|
Get X-axis gyroscope reading.
int16_t MPU6050:: getRotationY()
| Returns | Y-axis rotation measurement in 16-bit 2's complement format |
|---|
Get Y-axis gyroscope reading.
int16_t MPU6050:: getRotationZ()
| Returns | Z-axis rotation measurement in 16-bit 2's complement format |
|---|
Get Z-axis gyroscope reading.
uint8_t MPU6050:: getExternalSensorByte(int position)
| Parameters | |
|---|---|
| position | Starting position (0-23) |
| Returns | Byte read from register |
Read single byte from external sensor data register. These registers store data read from external sensors by the Slave 0, 1, 2, and 3 on the auxiliary I2C interface. Data read by Slave 4 is stored in I2C_SLV4_DI (Register 53).
External sensor data is written to these registers at the Sample Rate as defined in Register 25. This access rate can be reduced by using the Slave Delay Enable registers (Register 103).
External sensor data registers, along with the gyroscope measurement registers, accelerometer measurement registers, and temperature measurement registers, are composed of two sets of registers: an internal register set and a user-facing read register set.
The data within the external sensors' internal register set is always updated at the Sample Rate (or the reduced access rate) whenever the serial interface is idle. This guarantees that a burst read of sensor registers will read measurements from the same sampling instant. Note that if burst reads are not used, the user is responsible for ensuring a set of single byte reads correspond to a single sampling instant by checking the Data Ready interrupt.
Data is placed in these external sensor data registers according to I2C_SLV0_CTRL, I2C_SLV1_CTRL, I2C_SLV2_CTRL, and I2C_SLV3_CTRL (Registers 39, 42, 45, and 48). When more than zero bytes are read (I2C_SLVx_LEN > 0) from an enabled slave (I2C_SLVx_EN = 1), the slave is read at the Sample Rate (as defined in Register 25) or delayed rate (if specified in Register 52 and 103). During each Sample cycle, slave reads are performed in order of Slave number. If all slaves are enabled with more than zero bytes to be read, the order will be Slave 0, followed by Slave 1, Slave 2, and Slave 3.
Each enabled slave will have EXT_SENS_DATA registers associated with it by number of bytes read (I2C_SLVx_LEN) in order of slave number, starting from EXT_SENS_DATA_00. Note that this means enabling or disabling a slave may change the higher numbered slaves' associated registers. Furthermore, if fewer total bytes are being read from the external sensors as a result of such a change, then the data remaining in the registers which no longer have an associated slave device (i.e. high numbered registers) will remain in these previously allocated registers unless reset.
If the sum of the read lengths of all SLVx transactions exceed the number of available EXT_SENS_DATA registers, the excess bytes will be dropped. There are 24 EXT_SENS_DATA registers and hence the total read lengths between all the slaves cannot be greater than 24 or some bytes will be lost.
Note: Slave 4's behavior is distinct from that of Slaves 0-3. For further information regarding the characteristics of Slave 4, please refer to Registers 49 to 53.
EXAMPLE: Suppose that Slave 0 is enabled with 4 bytes to be read (I2C_SLV0_EN = 1 and I2C_SLV0_LEN = 4) while Slave 1 is enabled with 2 bytes to be read so that I2C_SLV1_EN = 1 and I2C_SLV1_LEN = 2. In such a situation, EXT_SENS_DATA _00 through _03 will be associated with Slave 0, while EXT_SENS_DATA _04 and 05 will be associated with Slave 1. If Slave 2 is enabled as well, registers starting from EXT_SENS_DATA_06 will be allocated to Slave 2.
If Slave 2 is disabled while Slave 3 is enabled in this same situation, then registers starting from EXT_SENS_DATA_06 will be allocated to Slave 3 instead.
REGISTER ALLOCATION FOR DYNAMIC DISABLE VS. NORMAL DISABLE: If a slave is disabled at any time, the space initially allocated to the slave in the EXT_SENS_DATA register, will remain associated with that slave. This is to avoid dynamic adjustment of the register allocation.
The allocation of the EXT_SENS_DATA registers is recomputed only when (1) all slaves are disabled, or (2) the I2C_MST_RST bit is set (Register 106).
This above is also true if one of the slaves gets NACKed and stops functioning.
uint16_t MPU6050:: getExternalSensorWord(int position)
| Parameters | |
|---|---|
| position | Starting position (0-21) |
| Returns | Word read from register |
Read word (2 bytes) from external sensor data registers.
uint32_t MPU6050:: getExternalSensorDWord(int position)
| Parameters | |
|---|---|
| position | Starting position (0-20) |
| Returns | Double word read from registers |
Read double word (4 bytes) from external sensor data registers.
uint8_t MPU6050:: getMotionStatus()
| Returns | Motion detection status byte |
|---|
Get full motion detection status register content (all bits).
bool MPU6050:: getXNegMotionDetected()
| Returns | Motion detection status |
|---|
Get X-axis negative motion detection interrupt status.
bool MPU6050:: getXPosMotionDetected()
| Returns | Motion detection status |
|---|
Get X-axis positive motion detection interrupt status.
bool MPU6050:: getYNegMotionDetected()
| Returns | Motion detection status |
|---|
Get Y-axis negative motion detection interrupt status.
bool MPU6050:: getYPosMotionDetected()
| Returns | Motion detection status |
|---|
Get Y-axis positive motion detection interrupt status.
bool MPU6050:: getZNegMotionDetected()
| Returns | Motion detection status |
|---|
Get Z-axis negative motion detection interrupt status.
bool MPU6050:: getZPosMotionDetected()
| Returns | Motion detection status |
|---|
Get Z-axis positive motion detection interrupt status.
bool MPU6050:: getZeroMotionDetected()
| Returns | Motion detection status |
|---|
Get zero motion detection interrupt status.
void MPU6050:: setSlaveOutputByte(uint8_t num,
uint8_t data)
| Parameters | |
|---|---|
| num | Slave number (0-3) |
| data | Byte to write |
Write byte to Data Output container for specified slave. This register holds the output data written into Slave when Slave is set to write mode. For further information regarding Slave control, please refer to Registers 37 to 39 and immediately following.
bool MPU6050:: getExternalShadowDelayEnabled()
| Returns | Current external data shadow delay enabled status. |
|---|
Get external data shadow delay enabled status. This register is used to specify the timing of external sensor data shadowing. When DELAY_ES_SHADOW is set to 1, shadowing of external sensor data is delayed until all data has been received.
void MPU6050:: setExternalShadowDelayEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New external data shadow delay enabled status. |
Set external data shadow delay enabled status.
bool MPU6050:: getSlaveDelayEnabled(uint8_t num)
| Parameters | |
|---|---|
| num | Slave number (0-4) |
| Returns | Current slave delay enabled status. |
Get slave delay enabled status. When a particular slave delay is enabled, the rate of access for the that slave device is reduced. When a slave's access rate is decreased relative to the Sample Rate, the slave is accessed every:
1 / (1 + I2C_MST_DLY) Samples
This base Sample Rate in turn is determined by SMPLRT_DIV (register * 25) and DLPF_CFG (register 26).
For further information regarding I2C_MST_DLY, please refer to register 52. For further information regarding the Sample Rate, please refer to register 25.
void MPU6050:: setSlaveDelayEnabled(uint8_t num,
bool enabled)
| Parameters | |
|---|---|
| num | Slave number (0-4) |
| enabled | New slave delay enabled status. |
Set slave delay enabled status.
void MPU6050:: resetGyroscopePath()
Reset gyroscope signal path. The reset will revert the signal path analog to digital converters and filters to their power up configurations.
void MPU6050:: resetAccelerometerPath()
Reset accelerometer signal path. The reset will revert the signal path analog to digital converters and filters to their power up configurations.
void MPU6050:: resetTemperaturePath()
Reset temperature sensor signal path. The reset will revert the signal path analog to digital converters and filters to their power up configurations.
uint8_t MPU6050:: getAccelerometerPowerOnDelay()
| Returns | Current accelerometer power-on delay |
|---|
Get accelerometer power-on delay. The accelerometer data path provides samples to the sensor registers, Motion detection, Zero Motion detection, and Free Fall detection modules. The signal path contains filters which must be flushed on wake-up with new samples before the detection modules begin operations. The default wake-up delay, of 4ms can be lengthened by up to 3ms. This additional delay is specified in ACCEL_ON_DELAY in units of 1 LSB = 1 ms. The user may select any value above zero unless instructed otherwise by InvenSense. Please refer to Section 8 of the MPU-6000/MPU-6050 Product Specification document for further information regarding the detection modules.
void MPU6050:: setAccelerometerPowerOnDelay(uint8_t delay)
| Parameters | |
|---|---|
| delay | New accelerometer power-on delay (0-3) |
Set accelerometer power-on delay.
uint8_t MPU6050:: getFreefallDetectionCounterDecrement()
| Returns | Current decrement configuration |
|---|
Get Free Fall detection counter decrement configuration. Detection is registered by the Free Fall detection module after accelerometer measurements meet their respective threshold conditions over a specified number of samples. When the threshold conditions are met, the corresponding detection counter increments by 1. The user may control the rate at which the detection counter decrements when the threshold condition is not met by configuring FF_COUNT. The decrement rate can be set according to the following table:
FF_COUNT | Counter Decrement ---------+------------------ 0 | Reset 1 | 1 2 | 2 3 | 4
When FF_COUNT is configured to 0 (reset), any non-qualifying sample will reset the counter to 0. For further information on Free Fall detection, please refer to Registers 29 to 32.
void MPU6050:: setFreefallDetectionCounterDecrement(uint8_t decrement)
| Parameters | |
|---|---|
| decrement | New decrement configuration value |
Set Free Fall detection counter decrement configuration.
uint8_t MPU6050:: getMotionDetectionCounterDecrement()
Get Motion detection counter decrement configuration. Detection is registered by the Motion detection module after accelerometer measurements meet their respective threshold conditions over a specified number of samples. When the threshold conditions are met, the corresponding detection counter increments by 1. The user may control the rate at which the detection counter decrements when the threshold condition is not met by configuring MOT_COUNT. The decrement rate can be set according to the following table:
MOT_COUNT | Counter Decrement ----------+------------------ 0 | Reset 1 | 1 2 | 2 3 | 4
When MOT_COUNT is configured to 0 (reset), any non-qualifying sample will reset the counter to 0. For further information on Motion detection, please refer to Registers 29 to 32.
void MPU6050:: setMotionDetectionCounterDecrement(uint8_t decrement)
| Parameters | |
|---|---|
| decrement | New decrement configuration value |
Set Motion detection counter decrement configuration.
bool MPU6050:: getFIFOEnabled()
| Returns | Current FIFO enabled status |
|---|
Get FIFO enabled status. When this bit is set to 0, the FIFO buffer is disabled. The FIFO buffer cannot be written to or read from while disabled. The FIFO buffer's state does not change unless the MPU-60X0 is power cycled.
void MPU6050:: setFIFOEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New FIFO enabled status |
Set FIFO enabled status.
bool MPU6050:: getI2CMasterModeEnabled()
| Returns | Current I2C Master Mode enabled status |
|---|
Get I2C Master Mode enabled status. When this mode is enabled, the MPU-60X0 acts as the I2C Master to the external sensor slave devices on the auxiliary I2C bus. When this bit is cleared to 0, the auxiliary I2C bus lines (AUX_DA and AUX_CL) are logically driven by the primary I2C bus (SDA and SCL). This is a precondition to enabling Bypass Mode. For further information regarding Bypass Mode, please refer to Register 55.
void MPU6050:: setI2CMasterModeEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New I2C Master Mode enabled status |
Set I2C Master Mode enabled status.
void MPU6050:: switchSPIEnabled(bool enabled)
Switch from I2C to SPI mode (MPU-6000 only) If this is set, the primary SPI interface will be enabled in place of the disabled primary I2C interface.
void MPU6050:: resetFIFO()
Reset the FIFO. This bit resets the FIFO buffer when set to 1 while FIFO_EN equals 0. This bit automatically clears to 0 after the reset has been triggered.
void MPU6050:: resetI2CMaster()
Reset the I2C Master. This bit resets the I2C Master when set to 1 while I2C_MST_EN equals 0. This bit automatically clears to 0 after the reset has been triggered.
void MPU6050:: resetSensors()
Reset all sensor registers and signal paths. When set to 1, this bit resets the signal paths for all sensors (gyroscopes, accelerometers, and temperature sensor). This operation will also clear the sensor registers. This bit automatically clears to 0 after the reset has been triggered.
When resetting only the signal path (and not the sensor registers), please use Register 104, SIGNAL_PATH_RESET.
void MPU6050:: reset()
Trigger a full device reset. A small delay of ~50ms may be desirable after triggering a reset.
bool MPU6050:: getSleepEnabled()
| Returns | Current sleep mode enabled status |
|---|
Get sleep mode status. Setting the SLEEP bit in the register puts the device into very low power sleep mode. In this mode, only the serial interface and internal registers remain active, allowing for a very low standby current. Clearing this bit puts the device back into normal mode. To save power, the individual standby selections for each of the gyros should be used if any gyro axis is not used by the application.
void MPU6050:: setSleepEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New sleep mode enabled status |
Set sleep mode status.
bool MPU6050:: getWakeCycleEnabled()
| Returns | Current sleep mode enabled status |
|---|
Get wake cycle enabled status. When this bit is set to 1 and SLEEP is disabled, the MPU-60X0 will cycle between sleep mode and waking up to take a single sample of data from active sensors at a rate determined by LP_WAKE_CTRL (register 108).
void MPU6050:: setWakeCycleEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New sleep mode enabled status |
Set wake cycle enabled status.
bool MPU6050:: getTempSensorEnabled()
| Returns | Current temperature sensor enabled status |
|---|
Get temperature sensor enabled status. Control the usage of the internal temperature sensor.
Note: this register stores the disabled value, but for consistency with the rest of the code, the function is named and used with standard true/false values to indicate whether the sensor is enabled or disabled, respectively.
void MPU6050:: setTempSensorEnabled(bool enabled)
| Parameters | |
|---|---|
| enabled | New temperature sensor enabled status |
Set temperature sensor enabled status. Note: this register stores the disabled value, but for consistency with the rest of the code, the function is named and used with standard true/false values to indicate whether the sensor is enabled or disabled, respectively.
void MPU6050:: setClockSource(uint8_t source)
| Parameters | |
|---|---|
| source | New clock source setting |
Set clock source setting. An internal 8MHz oscillator, gyroscope based clock, or external sources can be selected as the MPU-60X0 clock source. When the internal 8 MHz oscillator or an external source is chosen as the clock source, the MPU-60X0 can operate in low power modes with the gyroscopes disabled.
Upon power up, the MPU-60X0 clock source defaults to the internal oscillator. However, it is highly recommended that the device be configured to use one of the gyroscopes (or an external clock source) as the clock reference for improved stability. The clock source can be selected according to the following table:
CLK_SEL | Clock Source --------+-------------------------------------- 0 | Internal oscillator 1 | PLL with X Gyro reference 2 | PLL with Y Gyro reference 3 | PLL with Z Gyro reference 4 | PLL with external 32.768kHz reference 5 | PLL with external 19.2MHz reference 6 | Reserved 7 | Stops the clock and keeps the timing generator in reset
uint8_t MPU6050:: getWakeFrequency()
| Returns | Current wake frequency |
|---|
Get wake frequency in Accel-Only Low Power Mode. The MPU-60X0 can be put into Accerlerometer Only Low Power Mode by setting PWRSEL to 1 in the Power Management 1 register (Register 107). In this mode, the device will power off all devices except for the primary I2C interface, waking only the accelerometer at fixed intervals to take a single measurement. The frequency of wake-ups can be configured with LP_WAKE_CTRL as shown below:
LP_WAKE_CTRL | Wake-up Frequency -------------+------------------ 0 | 1.25 Hz 1 | 2.5 Hz 2 | 5 Hz 3 | 10 Hz
For further information regarding the MPU-60X0's power modes, please refer to Register 107.
void MPU6050:: setWakeFrequency(uint8_t frequency)
| Parameters | |
|---|---|
| frequency | New wake frequency |
Set wake frequency in Accel-Only Low Power Mode.
bool MPU6050:: getStandbyXAccelEnabled()
| Returns | Current X-axis standby enabled status |
|---|
Get X-axis accelerometer standby enabled status. If enabled, the X-axis will not gather or report data (or use power).
void MPU6050:: setStandbyXAccelEnabled(bool enabled)
Set X-axis accelerometer standby enabled status.
bool MPU6050:: getStandbyYAccelEnabled()
| Returns | Current Y-axis standby enabled status |
|---|
Get Y-axis accelerometer standby enabled status. If enabled, the Y-axis will not gather or report data (or use power).
void MPU6050:: setStandbyYAccelEnabled(bool enabled)
Set Y-axis accelerometer standby enabled status.
bool MPU6050:: getStandbyZAccelEnabled()
| Returns | Current Z-axis standby enabled status |
|---|
Get Z-axis accelerometer standby enabled status. If enabled, the Z-axis will not gather or report data (or use power).
void MPU6050:: setStandbyZAccelEnabled(bool enabled)
Set Z-axis accelerometer standby enabled status.
bool MPU6050:: getStandbyXGyroEnabled()
| Returns | Current X-axis standby enabled status |
|---|
Get X-axis gyroscope standby enabled status. If enabled, the X-axis will not gather or report data (or use power).
void MPU6050:: setStandbyXGyroEnabled(bool enabled)
Set X-axis gyroscope standby enabled status.
bool MPU6050:: getStandbyYGyroEnabled()
| Returns | Current Y-axis standby enabled status |
|---|
Get Y-axis gyroscope standby enabled status. If enabled, the Y-axis will not gather or report data (or use power).
void MPU6050:: setStandbyYGyroEnabled(bool enabled)
Set Y-axis gyroscope standby enabled status.
bool MPU6050:: getStandbyZGyroEnabled()
| Returns | Current Z-axis standby enabled status |
|---|
Get Z-axis gyroscope standby enabled status. If enabled, the Z-axis will not gather or report data (or use power).
void MPU6050:: setStandbyZGyroEnabled(bool enabled)
Set Z-axis gyroscope standby enabled status.
uint16_t MPU6050:: getFIFOCount()
| Returns | Current FIFO buffer size |
|---|
Get current FIFO buffer size. This value indicates the number of bytes stored in the FIFO buffer. This number is in turn the number of bytes that can be read from the FIFO buffer and it is directly proportional to the number of samples available given the set of sensor data bound to be stored in the FIFO (register 35 and 36).
uint8_t MPU6050:: getFIFOByte()
| Returns | Byte from FIFO buffer |
|---|
Get byte from FIFO buffer. This register is used to read and write data from the FIFO buffer. Data is written to the FIFO in order of register number (from lowest to highest). If all the FIFO enable flags (see below) are enabled and all External Sensor Data registers (Registers 73 to 96) are associated with a Slave device, the contents of registers 59 through 96 will be written in order at the Sample Rate.
The contents of the sensor data registers (Registers 59 to 96) are written into the FIFO buffer when their corresponding FIFO enable flags are set to 1 in FIFO_EN (Register 35). An additional flag for the sensor data registers associated with I2C Slave 3 can be found in I2C_MST_CTRL (Register 36).
If the FIFO buffer has overflowed, the status bit FIFO_OFLOW_INT is automatically set to 1. This bit is located in INT_STATUS (Register 58). When the FIFO buffer has overflowed, the oldest data will be lost and new data will be written to the FIFO.
If the FIFO buffer is empty, reading this register will return the last byte that was previously read from the FIFO until new data is available. The user should check FIFO_COUNT to ensure that the FIFO buffer is not read when empty.
void MPU6050:: setFIFOByte(uint8_t data)
Write byte to FIFO buffer.
uint8_t MPU6050:: getDeviceID()
| Returns | Device ID (6 bits only! should be 0x34) |
|---|
Get Device ID. This register is used to verify the identity of the device (0b110100, 0x34).
void MPU6050:: setDeviceID(uint8_t id)
| Parameters | |
|---|---|
| id | New device ID to set. |
Set Device ID. Write a new ID into the WHO_AM_I register (no idea why this should ever be necessary though).
void MPU6050:: PID(uint8_t ReadAddress,
float kP,
float kI,
uint8_t Loops)
| Parameters | |
|---|---|
| ReadAddress | |
| kP | |
| kI | |
| Loops | |