Package swervelib.motors
Class SparkFlexSwerve
java.lang.Object
swervelib.motors.SwerveMotor
swervelib.motors.SparkFlexSwerve
- All Implemented Interfaces:
AutoCloseable
An implementation of
SparkFlex as a SwerveMotor.-
Field Summary
FieldsModifier and TypeFieldDescriptionAbsolute encoder attached to the SparkFlex (if exists)Integrated encoder.Closed-loop PID controller.Fields inherited from class swervelib.motors.SwerveMotor
isDriveMotor, maximumRetries, simMotor -
Constructor Summary
ConstructorsConstructorDescriptionSparkFlexSwerve(int id, boolean isDriveMotor, DCMotor motorType) Initialize theSwerveMotoras aSparkFlexconnected to a Brushless Motor.SparkFlexSwerve(SparkFlex motor, boolean isDriveMotor, DCMotor motorType) Initialize the swerve motor. -
Method Summary
Modifier and TypeMethodDescriptionvoidSave the configurations from flash to EEPROM.voidClear the sticky faults on the motor controller.voidclose()voidconfigureIntegratedEncoder(double positionConversionFactor) Configure the integrated encoder for the swerve module.voidconfigurePIDF(PIDFConfig config) Configure the PIDF values for the closed loop controller.voidconfigurePIDWrapping(double minInput, double maxInput) Configure the PID wrapping for the position closed loop controller.voidDisable PID Wrapping on the motor.voidConfigure the factory defaults.doubleGet the applied dutycycle output.Get the current configuration of theSparkFlexgetMotor()Get the motor object from the module.doubleGet the position of the integrated encoder.Get theDCMotorof the motor class.doubleGet the velocity of the integrated encoder.doubleGet the voltage output of the motor controller.voidset(double percentOutput) Set the percentage output.setAbsoluteEncoder(SwerveAbsoluteEncoder encoder) Set the absolute encoder to be a compatible absolute encoder.voidsetCurrentLimit(int currentLimit) Set the current limit for the swerve drive motor, remember this may cause jumping if used in conjunction with voltage compensation.voidsetInverted(boolean inverted) Set the motor to be inverted.voidsetLoopRampRate(double rampRate) Set the maximum rate the open/closed loop output can change by.voidsetMotorBrake(boolean isBrakeMode) Set the idle mode.voidsetPosition(double position) Set the integrated encoder position.voidsetReference(double setpoint, double feedforward) Set the closed loop PID controller reference point.voidsetReference(double setpoint, double feedforward, double position) Set the closed loop PID controller reference point.voidsetVoltage(double voltage) Set the voltage of the motor.voidsetVoltageCompensation(double nominalVoltage) Set the voltage compensation for the swerve module motor.voidupdateConfig(SparkFlexConfig cfgGiven) Update the config for theSparkFlexbooleanQueries whether the absolute encoder is directly attached to the motor controller.
-
Field Details
-
encoder
Integrated encoder. -
absoluteEncoder
Absolute encoder attached to the SparkFlex (if exists) -
pid
Closed-loop PID controller.
-
-
Constructor Details
-
SparkFlexSwerve
Initialize the swerve motor. -
SparkFlexSwerve
Initialize theSwerveMotoras aSparkFlexconnected to a Brushless Motor.
-
-
Method Details
-
close
public void close()- Specified by:
closein interfaceAutoCloseable- Specified by:
closein classSwerveMotor
-
getConfig
Get the current configuration of theSparkFlex- Returns:
SparkFlexConfig
-
updateConfig
Update the config for theSparkFlex- Parameters:
cfgGiven- GivenSparkFlexConfigwhich should have minimal modifications.
-
setVoltageCompensation
public void setVoltageCompensation(double nominalVoltage) Set the voltage compensation for the swerve module motor.- Specified by:
setVoltageCompensationin 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:
setCurrentLimitin 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:
setLoopRampRatein classSwerveMotor- Parameters:
rampRate- Time in seconds to go from 0 to full throttle.
-
getMotor
Get the motor object from the module.- Specified by:
getMotorin classSwerveMotor- Returns:
- Motor object.
-
getSimMotor
Get theDCMotorof the motor class.- Specified by:
getSimMotorin classSwerveMotor- Returns:
DCMotorof this type.
-
usingExternalFeedbackSensor
public boolean usingExternalFeedbackSensor()Queries whether the absolute encoder is directly attached to the motor controller.- Specified by:
usingExternalFeedbackSensorin classSwerveMotor- Returns:
- connected absolute encoder state.
-
factoryDefaults
public void factoryDefaults()Configure the factory defaults.- Specified by:
factoryDefaultsin classSwerveMotor
-
clearStickyFaults
public void clearStickyFaults()Clear the sticky faults on the motor controller.- Specified by:
clearStickyFaultsin classSwerveMotor
-
setAbsoluteEncoder
Set the absolute encoder to be a compatible absolute encoder.- Specified by:
setAbsoluteEncoderin classSwerveMotor- Parameters:
encoder- The encoder to use.- Returns:
- The
SwerveMotorfor 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:
configureIntegratedEncoderin classSwerveMotor- Parameters:
positionConversionFactor- The conversion factor to apply.
-
configurePIDF
Configure the PIDF values for the closed loop controller.- Specified by:
configurePIDFin 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:
configurePIDWrappingin classSwerveMotor- Parameters:
minInput- Minimum PID input.maxInput- Maximum PID input.
-
disablePIDWrapping
public void disablePIDWrapping()Disable PID Wrapping on the motor.- Specified by:
disablePIDWrappingin classSwerveMotor
-
setMotorBrake
public void setMotorBrake(boolean isBrakeMode) Set the idle mode.- Specified by:
setMotorBrakein classSwerveMotor- Parameters:
isBrakeMode- Set the brake mode.
-
setInverted
public void setInverted(boolean inverted) Set the motor to be inverted.- Specified by:
setInvertedin classSwerveMotor- Parameters:
inverted- State of inversion.
-
burnFlash
public void burnFlash()Save the configurations from flash to EEPROM.- Specified by:
burnFlashin classSwerveMotor
-
set
public void set(double percentOutput) Set the percentage output.- Specified by:
setin 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:
setReferencein 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:
setReferencein 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:
getVoltagein classSwerveMotor- Returns:
- Voltage output.
-
setVoltage
public void setVoltage(double voltage) Set the voltage of the motor.- Specified by:
setVoltagein classSwerveMotor- Parameters:
voltage- Voltage to set.
-
getAppliedOutput
public double getAppliedOutput()Get the applied dutycycle output.- Specified by:
getAppliedOutputin classSwerveMotor- Returns:
- Applied dutycycle output to the motor.
-
getVelocity
public double getVelocity()Get the velocity of the integrated encoder.- Specified by:
getVelocityin classSwerveMotor- Returns:
- velocity
-
getPosition
public double getPosition()Get the position of the integrated encoder.- Specified by:
getPositionin classSwerveMotor- Returns:
- Position
-
setPosition
public void setPosition(double position) Set the integrated encoder position.- Specified by:
setPositionin classSwerveMotor- Parameters:
position- Integrated encoder position.
-