BunyipsLib/org.murraybridgebunyips.bunyipslib/IMUEx

IMUEx

Drop-in replacement for an Inertial Measurement Unit that provides WPIUnit data and the capabilities of automatic updates similar to (but not implementing) a subsystem multi-thread.

This class supports different readings of IMU measurement, such as an unrestricted domain on heading reads, while also being able to provide IMU units in terms of WPIUnits.

This class is also down-castable to the Universal IMU Interface. Note that all data in this class is retrieved via the run method, which opens the possibility for threading the IMU via startThread, similar to a BunyipsSubsystem.

Since this class is down-castable, it also can be used as a HardwareDevice and serves as a drop-in replacement for the IMU interface.

Field-exposed angles from this class are intrinsic. Read more in the YawPitchRollAngles and Orientation classes.

Author

Lucas Bubner, 2024

Since

4.0.0

Constructors

IMUEx

constructor(imu: IMU)

Wrap an IMU to use in IMUEx.

Types

YawDomain

enum YawDomain

The various modes that the yaw field can represent the current robot yaw as.

Properties

lastAcquisitionTimeNanos

@Nullable

open var lastAcquisitionTimeNanos: Long

Last acquisition of data from the IMU by IMUOp.

pitch

@NonNull

open var pitch: Measure<Angle>

Last read pitch of the IMU.

pitchVel

@NonNull

open var pitchVel: Measure<Velocity<Angle>>

Last read pitch velocity of the IMU.

quaternion

@NonNull

open var quaternion: Quaternion

Last known robot-centric quaternion reported from the IMU and yaw offset.

roll

@NonNull

open var roll: Measure<Angle>

Last read roll of the IMU.

rollVel

@NonNull

open var rollVel: Measure<Velocity<Angle>>

Last read roll velocity of the IMU.

yaw

@NonNull

open var yaw: Measure<Angle>

Last read yaw (heading) of the IMU with the yaw offset.

yawOffset

open var yawOffset: Measure<Angle>

yawVel

@NonNull

open var yawVel: Measure<Velocity<Angle>>

Last read yaw velocity of the IMU.

Functions

open fun close()

getConnectionInfo

open fun getConnectionInfo(): String

getDeviceName

open fun getDeviceName(): String

getManufacturer

open fun getManufacturer(): HardwareDevice.Manufacturer

getRobotAngularVelocity

open fun getRobotAngularVelocity(angleUnit: AngleUnit): AngularVelocity

getRobotOrientation

open fun getRobotOrientation(reference: AxesReference, order: AxesOrder, angleUnit: AngleUnit): Orientation

Note: This Orientation will not respect the currently set YawDomain to ensure consistency across usages of the Universal IMU Interface.

getRobotOrientationAsQuaternion

open fun getRobotOrientationAsQuaternion(): Quaternion

Note: This Orientation will not respect the currently set YawDomain to ensure consistency across usages of the Universal IMU Interface.

getRobotYawPitchRollAngles

open fun getRobotYawPitchRollAngles(): YawPitchRollAngles

Note: This method will not respect the currently set YawDomain, as it may not respect the angle requirement as listed by the YawPitchRollAngles that is provided by this method.

getVersion

open fun getVersion(): Int

getYawDomain

open fun getYawDomain(): IMUEx.YawDomain

Gets the current yaw domain, which is the domain this IMU is reporting yaw at.

initialize