Package com.revrobotics

Class SparkMaxRelativeEncoder

java.lang.Object

com.revrobotics.SparkMaxRelativeEncoder

All Implemented Interfaces:

CANEncoder, CANSensor, MotorFeedbackSensor, RelativeEncoder

public class SparkMaxRelativeEncoder
extends Object
implements RelativeEncoder

Get an instance of this class by using CANSparkMax.getEncoder() or CANSparkMax.getEncoder(Type, int).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	SparkMaxRelativeEncoder.Type

Method Summary

Modifier and Type	Method	Description
int	getAverageDepth()	Get the average sampling depth for a quadrature encoder.
int	getCountsPerRevolution()	Get the counts per revolution of the quadrature encoder.
boolean	getInverted()	Get the phase of the MotorFeedbackSensor.
int	getMeasurementPeriod()	Get the number of samples for reading from a quadrature encoder.
double	getPosition()	Get the position of the motor.
double	getPositionConversionFactor()	Get the conversion factor for position of the encoder.
double	getVelocity()	Get the velocity of the motor.
double	getVelocityConversionFactor()	Get the conversion factor for velocity of the encoder.
REVLibError	setAverageDepth(int depth)	Set the average sampling depth for a quadrature encoder.
REVLibError	setInverted(boolean inverted)	Set the phase of the MotorFeedbackSensor so that it is set to be in phase with the motor itself.
REVLibError	setMeasurementPeriod(int period_us)	Set the measurement period for velocity measurements of a quadrature encoder.
REVLibError	setPosition(double position)	Set the position of the encoder.
REVLibError	setPositionConversionFactor(double factor)	Set the conversion factor for position of the encoder.
REVLibError	setVelocityConversionFactor(double factor)	Set the conversion factor for velocity of the encoder.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getPosition

public double getPosition()

Description copied from interface: RelativeEncoder

Get the position of the motor. This returns the native units of 'rotations' by default, and can be changed by a scale factor using setPositionConversionFactor().

Specified by:

getPosition in interface CANEncoder

Specified by:

getPosition in interface RelativeEncoder

Returns:

Number of rotations of the motor

getVelocity

public double getVelocity()

Description copied from interface: RelativeEncoder

Get the velocity of the motor. This returns the native units of 'RPM' by default, and can be changed by a scale factor using setVelocityConversionFactor().

Specified by:

getVelocity in interface CANEncoder

Specified by:

getVelocity in interface RelativeEncoder

Returns:

Number the RPM of the motor

setPosition

public REVLibError setPosition(double position)

Description copied from interface: RelativeEncoder

Set the position of the encoder. By default the units are 'rotations' and can be changed by a scale factor using setPositionConversionFactor().

Specified by:

setPosition in interface CANEncoder

Specified by:

setPosition in interface RelativeEncoder

Parameters:

position - Number of rotations of the motor

Returns:

REVLibError.kOk if successful

setPositionConversionFactor

public REVLibError setPositionConversionFactor(double factor)

Description copied from interface: RelativeEncoder

Set the conversion factor for position of the encoder. Multiplied by the native output units to give you position.

Specified by:

setPositionConversionFactor in interface CANEncoder

Specified by:

setPositionConversionFactor in interface RelativeEncoder

Parameters:

factor - The conversion factor to multiply the native units by

Returns:

REVLibError.kOk if successful

setVelocityConversionFactor

public REVLibError setVelocityConversionFactor(double factor)

Description copied from interface: RelativeEncoder

Set the conversion factor for velocity of the encoder. Multiplied by the native output units to give you velocity

Specified by:

setVelocityConversionFactor in interface CANEncoder

Specified by:

setVelocityConversionFactor in interface RelativeEncoder

Parameters:

factor - The conversion factor to multiply the native units by

Returns:

REVLibError.kOk if successful

getPositionConversionFactor

public double getPositionConversionFactor()

Description copied from interface: RelativeEncoder

Get the conversion factor for position of the encoder. Multiplied by the native output units to give you position

Specified by:

getPositionConversionFactor in interface CANEncoder

Specified by:

getPositionConversionFactor in interface RelativeEncoder

Returns:

The conversion factor for position

getVelocityConversionFactor

public double getVelocityConversionFactor()

Description copied from interface: RelativeEncoder

Get the conversion factor for velocity of the encoder. Multiplied by the native output units to give you velocity

Specified by:

getVelocityConversionFactor in interface CANEncoder

Specified by:

getVelocityConversionFactor in interface RelativeEncoder

Returns:

The conversion factor for velocity

setAverageDepth

public REVLibError setAverageDepth(int depth)

Description copied from interface: RelativeEncoder

Set the average sampling depth for a quadrature encoder. This value sets the number of samples in the average for velocity readings. This can be any value from 1 to 64.

When the SparkMax controller is in Brushless mode, this will not change any behavior.

Specified by:

setAverageDepth in interface CANEncoder

Specified by:

setAverageDepth in interface RelativeEncoder

Parameters:

depth - The average sampling depth between 1 and 64 (default)

Returns:

REVLibError.kOk if successful

getAverageDepth

public int getAverageDepth()

Description copied from interface: RelativeEncoder

Get the average sampling depth for a quadrature encoder.

Specified by:

getAverageDepth in interface CANEncoder

Specified by:

getAverageDepth in interface RelativeEncoder

Returns:

The average sampling depth

setMeasurementPeriod

public REVLibError setMeasurementPeriod(int period_us)

Description copied from interface: RelativeEncoder

Set the measurement period for velocity measurements of a quadrature encoder. When the SparkMax controller is in Brushless mode, this will not change any behavior.

The basic formula to calculate velocity is change in position / change in time. This parameter sets the change in time for measurement.

Specified by:

setMeasurementPeriod in interface CANEncoder

Specified by:

setMeasurementPeriod in interface RelativeEncoder

Parameters:

period_us - Measurement period in milliseconds. This number may be between 1 and 100 (default).

Returns:

REVLibError.kOk if successful

getMeasurementPeriod

public int getMeasurementPeriod()

Description copied from interface: RelativeEncoder

Get the number of samples for reading from a quadrature encoder.

Specified by:

getMeasurementPeriod in interface CANEncoder

Specified by:

getMeasurementPeriod in interface RelativeEncoder

Returns:

Number of samples

getCountsPerRevolution

public int getCountsPerRevolution()

Description copied from interface: RelativeEncoder

Get the counts per revolution of the quadrature encoder.

For a description on the difference between CPR, PPR, etc. go to https://www.cuidevices.com/blog/what-is-encoder-ppr-cpr-and-lpr

Specified by:

getCountsPerRevolution in interface CANEncoder

Specified by:

getCountsPerRevolution in interface RelativeEncoder

Returns:

Counts per revolution

setInverted

public REVLibError setInverted(boolean inverted)

Description copied from interface: MotorFeedbackSensor

Set the phase of the MotorFeedbackSensor so that it is set to be in phase with the motor itself. This only works for quadrature encoders and analog sensors. This will throw an error if the user tries to set the inversion of the hall sensor.

Specified by:

setInverted in interface CANEncoder

Specified by:

setInverted in interface CANSensor

Specified by:

setInverted in interface MotorFeedbackSensor

Specified by:

setInverted in interface RelativeEncoder

Parameters:

inverted - The phase of the sensor

Returns:

REVLibError.kOk if successful

getInverted

public boolean getInverted()

Description copied from interface: MotorFeedbackSensor

Get the phase of the MotorFeedbackSensor. This will just return false if the user tries to get the inversion of the hall sensor.

Specified by:

getInverted in interface CANEncoder

Specified by:

getInverted in interface CANSensor

Specified by:

getInverted in interface MotorFeedbackSensor

Specified by:

getInverted in interface RelativeEncoder

Returns:

The phase of the sensor