Package swervelib.motors
Class SparkMaxSwerve
java.lang.Object
swervelib.motors.SwerveMotor
swervelib.motors.SparkMaxSwerve
An implementation of
CANSparkMax
as a SwerveMotor
.-
Field Summary
Modifier and TypeFieldDescriptionAbsolute encoder attached to the SparkMax (if exists)Integrated encoder.Closed-loop PID controller.Fields inherited from class swervelib.motors.SwerveMotor
isDriveMotor, maximumRetries
-
Constructor Summary
ConstructorDescriptionSparkMaxSwerve
(int id, boolean isDriveMotor) Initialize theSwerveMotor
as aCANSparkMax
connected to a Brushless Motor.SparkMaxSwerve
(CANSparkMax motor, boolean isDriveMotor) Initialize the swerve motor. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Save the configurations from flash to EEPROM.void
Clear the sticky faults on the motor controller.void
configureCANStatusFrames
(int CANStatus0, int CANStatus1, int CANStatus2, int CANStatus3, int CANStatus4, int CANStatus5, int CANStatus6) Set the CAN status frames.void
configureIntegratedEncoder
(double positionConversionFactor) Configure the integrated encoder for the swerve module.void
configurePIDF
(PIDFConfig config) Configure the PIDF values for the closed loop controller.void
configurePIDWrapping
(double minInput, double maxInput) Configure the PID wrapping for the position closed loop controller.void
Configure the factory defaults.double
Get the applied dutycycle output.getMotor()
Get the motor object from the module.double
Get the position of the integrated encoder.double
Get the velocity of the integrated encoder.double
Get the voltage output of the motor controller.boolean
Queries whether the absolute encoder is directly attached to the motor controller.void
set
(double percentOutput) Set the percentage output.setAbsoluteEncoder
(SwerveAbsoluteEncoder encoder) Set the absolute encoder to be a compatible absolute encoder.void
setCurrentLimit
(int currentLimit) Set the current limit for the swerve drive motor, remember this may cause jumping if used in conjunction with voltage compensation.void
setInverted
(boolean inverted) Set the motor to be inverted.void
setLoopRampRate
(double rampRate) Set the maximum rate the open/closed loop output can change by.void
setMotorBrake
(boolean isBrakeMode) Set the idle mode.void
setPosition
(double position) Set the integrated encoder position.void
setReference
(double setpoint, double feedforward) Set the closed loop PID controller reference point.void
setReference
(double setpoint, double feedforward, double position) Set the closed loop PID controller reference point.void
setVoltage
(double voltage) Set the voltage of the motor.void
setVoltageCompensation
(double nominalVoltage) Set the voltage compensation for the swerve module motor.
-
Field Details
-
encoder
Integrated encoder. -
absoluteEncoder
Absolute encoder attached to the SparkMax (if exists) -
pid
Closed-loop PID controller.
-
-
Constructor Details
-
SparkMaxSwerve
Initialize the swerve motor.- Parameters:
motor
- The SwerveMotor as a SparkMax object.isDriveMotor
- Is the motor being initialized a drive motor?
-
SparkMaxSwerve
public SparkMaxSwerve(int id, boolean isDriveMotor) Initialize theSwerveMotor
as aCANSparkMax
connected to a Brushless Motor.- Parameters:
id
- CAN ID of the SparkMax.isDriveMotor
- Is the motor being initialized a drive motor?
-
-
Method Details
-
setVoltageCompensation
public void setVoltageCompensation(double nominalVoltage) Set the voltage compensation for the swerve module motor.- Specified by:
setVoltageCompensation
in classSwerveMotor
- Parameters:
nominalVoltage
- Nominal voltage for operation to output to.
-
setCurrentLimit
public void setCurrentLimit(int currentLimit) Set the current limit for the swerve drive motor, remember this may cause jumping if used in conjunction with voltage compensation. This is useful to protect the motor from current spikes.- Specified by:
setCurrentLimit
in classSwerveMotor
- Parameters:
currentLimit
- Current limit in AMPS at free speed.
-
setLoopRampRate
public void setLoopRampRate(double rampRate) Set the maximum rate the open/closed loop output can change by.- Specified by:
setLoopRampRate
in classSwerveMotor
- Parameters:
rampRate
- Time in seconds to go from 0 to full throttle.
-
getMotor
Get the motor object from the module.- Specified by:
getMotor
in classSwerveMotor
- Returns:
- Motor object.
-
isAttachedAbsoluteEncoder
public boolean isAttachedAbsoluteEncoder()Queries whether the absolute encoder is directly attached to the motor controller.- Specified by:
isAttachedAbsoluteEncoder
in classSwerveMotor
- Returns:
- connected absolute encoder state.
-
factoryDefaults
public void factoryDefaults()Configure the factory defaults.- Specified by:
factoryDefaults
in classSwerveMotor
-
clearStickyFaults
public void clearStickyFaults()Clear the sticky faults on the motor controller.- Specified by:
clearStickyFaults
in classSwerveMotor
-
setAbsoluteEncoder
Set the absolute encoder to be a compatible absolute encoder.- Specified by:
setAbsoluteEncoder
in classSwerveMotor
- Parameters:
encoder
- The encoder to use.- Returns:
- The
SwerveMotor
for easy instantiation.
-
configureIntegratedEncoder
public void configureIntegratedEncoder(double positionConversionFactor) Configure the integrated encoder for the swerve module. Sets the conversion factors for position and velocity.- Specified by:
configureIntegratedEncoder
in classSwerveMotor
- Parameters:
positionConversionFactor
- The conversion factor to apply.
-
configurePIDF
Configure the PIDF values for the closed loop controller.- Specified by:
configurePIDF
in classSwerveMotor
- Parameters:
config
- Configuration class holding the PIDF values.
-
configurePIDWrapping
public void configurePIDWrapping(double minInput, double maxInput) Configure the PID wrapping for the position closed loop controller.- Specified by:
configurePIDWrapping
in classSwerveMotor
- Parameters:
minInput
- Minimum PID input.maxInput
- Maximum PID input.
-
configureCANStatusFrames
public void configureCANStatusFrames(int CANStatus0, int CANStatus1, int CANStatus2, int CANStatus3, int CANStatus4, int CANStatus5, int CANStatus6) Set the CAN status frames.- Parameters:
CANStatus0
- Applied Output, Faults, Sticky Faults, Is FollowerCANStatus1
- Motor Velocity, Motor Temperature, Motor Voltage, Motor CurrentCANStatus2
- Motor PositionCANStatus3
- Analog Sensor Voltage, Analog Sensor Velocity, Analog Sensor PositionCANStatus4
- Alternate Encoder Velocity, Alternate Encoder PositionCANStatus5
- Duty Cycle Absolute Encoder Position, Duty Cycle Absolute Encoder Absolute AngleCANStatus6
- Duty Cycle Absolute Encoder Velocity, Duty Cycle Absolute Encoder Frequency
-
setMotorBrake
public void setMotorBrake(boolean isBrakeMode) Set the idle mode.- Specified by:
setMotorBrake
in classSwerveMotor
- Parameters:
isBrakeMode
- Set the brake mode.
-
setInverted
public void setInverted(boolean inverted) Set the motor to be inverted.- Specified by:
setInverted
in classSwerveMotor
- Parameters:
inverted
- State of inversion.
-
burnFlash
public void burnFlash()Save the configurations from flash to EEPROM.- Specified by:
burnFlash
in classSwerveMotor
-
set
public void set(double percentOutput) Set the percentage output.- Specified by:
set
in classSwerveMotor
- Parameters:
percentOutput
- percent out for the motor controller.
-
setReference
public void setReference(double setpoint, double feedforward) Set the closed loop PID controller reference point.- Specified by:
setReference
in classSwerveMotor
- Parameters:
setpoint
- Setpoint in MPS or Angle in degrees.feedforward
- Feedforward in volt-meter-per-second or kV.
-
setReference
public void setReference(double setpoint, double feedforward, double position) Set the closed loop PID controller reference point.- Specified by:
setReference
in classSwerveMotor
- Parameters:
setpoint
- Setpoint in meters per second or angle in degrees.feedforward
- Feedforward in volt-meter-per-second or kV.position
- Only used on the angle motor, the position of the motor in degrees.
-
getVoltage
public double getVoltage()Get the voltage output of the motor controller.- Specified by:
getVoltage
in classSwerveMotor
- Returns:
- Voltage output.
-
setVoltage
public void setVoltage(double voltage) Set the voltage of the motor.- Specified by:
setVoltage
in classSwerveMotor
- Parameters:
voltage
- Voltage to set.
-
getAppliedOutput
public double getAppliedOutput()Get the applied dutycycle output.- Specified by:
getAppliedOutput
in classSwerveMotor
- Returns:
- Applied dutycycle output to the motor.
-
getVelocity
public double getVelocity()Get the velocity of the integrated encoder.- Specified by:
getVelocity
in classSwerveMotor
- Returns:
- velocity
-
getPosition
public double getPosition()Get the position of the integrated encoder.- Specified by:
getPosition
in classSwerveMotor
- Returns:
- Position
-
setPosition
public void setPosition(double position) Set the integrated encoder position.- Specified by:
setPosition
in classSwerveMotor
- Parameters:
position
- Integrated encoder position.
-