YAMS
Yet Another Mechanism System
Loading...
Searching...
No Matches
yams::motorcontrollers::local::A301Wrapper Class Reference

#include <A301Wrapper.hpp>

Inheritance diagram for yams::motorcontrollers::local::A301Wrapper:
Collaboration diagram for yams::motorcontrollers::local::A301Wrapper:

Public Member Functions

 A301Wrapper (first::a301::A301 *a301, SmartMotorControllerConfig *config)
 ~A301Wrapper ()
bool ApplyConfig (const SmartMotorControllerConfig &config) override
void SetupSimulation () override
void SimIterate () override
void SeedRelativeEncoder () override
void SynchronizeRelativeEncoder () override
void SetDutyCycle (double dutyCycle) override
double GetDutyCycle () override
void SetVoltage (wpi::units::volt_t voltage) override
wpi::units::volt_t GetVoltage () override
void SetPosition (wpi::units::turn_t angle) override
void SetPosition (wpi::units::meter_t distance) override
void SetVelocity (wpi::units::turns_per_second_t velocity) override
void SetVelocity (wpi::units::turns_per_second_t velocity, wpi::units::newton_t feedforwardForce) override
void SetVelocity (wpi::units::meters_per_second_t velocity) override
void SetEncoderPosition (wpi::units::turn_t angle) override
void SetEncoderPosition (wpi::units::meter_t distance) override
void SetEncoderVelocity (wpi::units::turns_per_second_t velocity) override
void SetEncoderVelocity (wpi::units::meters_per_second_t velocity) override
wpi::units::turn_t GetMechanismPosition () override
wpi::units::turns_per_second_t GetMechanismVelocity () override
wpi::units::turn_t GetRelativeMechanismPosition () override
wpi::units::turns_per_second_t GetRelativeMechanismVelocity () override
wpi::units::turns_per_second_squared_t GetMechanismAcceleration () override
wpi::units::turn_t GetRotorPosition () override
wpi::units::turns_per_second_t GetRotorVelocity () override
wpi::units::meter_t GetMeasurementPosition () override
wpi::units::meters_per_second_t GetMeasurementVelocity () override
wpi::units::meters_per_second_squared_t GetMeasurementAcceleration () override
std::optional< wpi::units::turn_t > GetExternalEncoderMechanismPosition () override
std::optional< wpi::units::turns_per_second_t > GetExternalEncoderMechanismVelocity () override
std::optional< wpi::units::ampere_t > GetSupplyCurrent () override
wpi::units::ampere_t GetStatorCurrent () override
wpi::units::celsius_t GetTemperature () override
wpi::math::DCMotor GetDCMotor () override
void SetZeroPower (MotorMode mode) override
void SetMotorInverted (bool inverted) override
void SetEncoderInverted (bool inverted) override
void SetKp (double kP) override
void SetKi (double kI) override
void SetKd (double kD) override
void SetFeedback (double kP, double kI, double kD) override
void SetKs (double kS) override
void SetKv (double kV) override
void SetKa (double kA) override
void SetKg (double kG) override
void SetFeedforward (double kS, double kV, double kA, double kG) override
void SetStatorCurrentLimit (wpi::units::ampere_t currentLimit) override
void SetSupplyCurrentLimit (wpi::units::ampere_t currentLimit) override
void SetClosedLoopRampRate (wpi::units::second_t rampRate) override
void SetOpenLoopRampRate (wpi::units::second_t rampRate) override
void SetMechanismUpperLimit (wpi::units::turn_t upperLimit) override
void SetMechanismLowerLimit (wpi::units::turn_t lowerLimit) override
void SetMechanismLimits (wpi::units::turn_t lower, wpi::units::turn_t upper) override
void SetMechanismLimitsEnabled (bool enabled) override
void SetMeasurementUpperLimit (wpi::units::meter_t upperLimit) override
void SetMeasurementLowerLimit (wpi::units::meter_t lowerLimit) override
void SetMotionProfileMaxVelocity (wpi::units::turns_per_second_t maxVelocity) override
void SetMotionProfileMaxVelocity (wpi::units::meters_per_second_t maxVelocity) override
void SetMotionProfileMaxAcceleration (wpi::units::turns_per_second_squared_t maxAcc) override
void SetMotionProfileMaxAcceleration (wpi::units::meters_per_second_squared_t maxAcc) override
void SetMotionProfileMaxJerk (wpi::units::angular_jerk::turns_per_second_cubed_t maxJerk) override
void SetExponentialProfile (std::optional< double > kV, std::optional< double > kA, std::optional< wpi::units::volt_t > maxInput) override
void SetClosedLoopSlot (ClosedLoopControllerSlot slot) override
void SetMechanismGearing (const gearing::MechanismGearing &gearing) override
void SetMechanismCircumference (wpi::units::meter_t circumference) override
SmartMotorControllerConfig & GetConfig () override
void * GetMotorController () override
void * GetMotorControllerConfig () override
telemetry::UnsupportedTelemetryFields GetUnsupportedTelemetryFields () override
void SetVelocity (wpi::units::meters_per_second_t velocity, wpi::units::newton_t feedforwardForce)
Public Member Functions inherited from yams::motorcontrollers::SmartMotorController
virtual ~SmartMotorController ()
virtual void SetSimSupplier (std::shared_ptr< SimSupplier > supplier)
SimSupplier * GetSimSupplier () const
void SetVelocity (wpi::units::meters_per_second_t velocity, wpi::units::newton_t feedforwardForce)
wpi::math::DCMotor GetMechanismDCMotor ()
void SetMechanismSimSupplier (std::shared_ptr< SimSupplier > supplier)
double GetMechanismDutyCycle (double dutyCycle)
wpi::units::second_t GetClosedLoopControllerPeriod () const
virtual std::optional< wpi::units::second_t > GetVelocityMeasurementDelay () const
void StartClosedLoopController ()
void StopClosedLoopController ()
bool IsClosedLoopControllerStopped () const
math::LQRController * GetLQRController ()
math::ADRCController * GetADRCController ()
void IterateClosedLoopController ()
void SetupTelemetry (std::shared_ptr< wpi::nt::NetworkTable > dataTable, std::shared_ptr< wpi::nt::NetworkTable > tuningTable)
void SetupTelemetry ()
void SetupLiveTuning ()
void UpdateTelemetry ()
bool TuningEnabled () const
void ApplyTuningValues ()
void StopLiveTuning ()
const std::vector< SmartMotorController * > & GetLooselyCoupledFollowers () const
void AddCloseHook (std::function< void()> hook)
SmartMotorController & WithTelemetry (telemetry::SmartMotorControllerTelemetryConfig config)
ClosedLoopControllerSlot GetClosedLoopControllerSlot () const
std::optional< wpi::units::turn_t > GetMechanismPositionSetpoint () const
std::optional< wpi::units::turns_per_second_t > GetMechanismSetpointVelocity () const
std::optional< wpi::units::meter_t > GetMeasurementPositionSetpoint () const
std::optional< wpi::units::meters_per_second_t > GetMeasurementSetpointVelocity () const
std::optional< wpi::units::newton_t > GetSetpointFeedforwardForce () const
std::string GetName () const
bool IsMotor (const wpi::math::DCMotor &a, const wpi::math::DCMotor &b) const
void CheckConfigSafety ()
void Close ()

Additional Inherited Members

Public Types inherited from yams::motorcontrollers::SmartMotorController
using ClosedLoopControllerSlot = SmartMotorControllerConfig::ClosedLoopControllerSlot
using MotorMode = SmartMotorControllerConfig::MotorMode
using ControlMode = SmartMotorControllerConfig::ControlMode
Protected Member Functions inherited from yams::motorcontrollers::SmartMotorController
 SmartMotorController ()
void LoadLooselyCoupledFollowers ()
void Follow (SmartMotorController &leader, bool inverted)
double CalculateSimDutyCycle (double dutyCycle)
void ConfigureSoftwarePID (const SmartMotorControllerConfig &config)
void ForwardPositionToFollowers (wpi::units::turn_t pos)
void ForwardPositionToFollowers (wpi::units::meter_t dist)
void ForwardVelocityToFollowers (wpi::units::turns_per_second_t vel)
void ForwardVelocityToFollowers (wpi::units::meters_per_second_t vel)
bool UsesSystemCoreController () const
void ApplyADRCConfig (const SmartMotorControllerConfig &config)
const void * BatterySimKey () const
Protected Attributes inherited from yams::motorcontrollers::SmartMotorController
SmartMotorControllerConfig * m_config {nullptr}
ClosedLoopControllerSlot m_slot {ClosedLoopControllerSlot::SLOT_0}
std::shared_ptr< SimSupplier > m_simSupplier
std::vector< SmartMotorController * > m_looseFollowers
bool m_iteratedByLeader {false}
bool m_simulatesMechanism {false}
std::optional< wpi::math::PIDController > m_pid
std::optional< math::LQRController > m_lqr
std::optional< math::ADRCController > m_adrc
std::optional< wpi::math::TrapezoidProfile< wpi::units::turns >::State > m_trapState
std::optional< wpi::math::ExponentialProfile< wpi::units::turns, wpi::units::volts >::State > m_expoState
std::optional< wpi::math::TrapezoidProfile< wpi::units::meters >::State > m_linearTrapState
std::optional< wpi::math::ExponentialProfile< wpi::units::meters, wpi::units::volts >::State > m_linearExpoState
std::optional< wpi::units::turn_t > m_lastClosedLoopMechanismPosition
std::optional< double > m_lastClosedLoopVoltage
std::optional< wpi::units::turn_t > m_setpointPosition
std::optional< wpi::units::turns_per_second_t > m_setpointVelocity
std::optional< wpi::units::newton_t > m_setpointFeedforwardForce
std::vector< std::function< void()> > m_closeHooks
std::unique_ptr< wpi::Notifier > m_closedLoopControllerThread
bool m_closedLoopControllerRunning {false}
std::shared_ptr< wpi::nt::NetworkTable > m_parentTable
std::shared_ptr< wpi::nt::NetworkTable > m_telemetryTable
std::shared_ptr< wpi::nt::NetworkTable > m_tuningTable
telemetry::SmartMotorControllerTelemetry m_telemetry
telemetry::SmartMotorControllerTelemetryConfig m_telemetryConfig
bool m_telemetryConfigExplicit {false}
std::shared_ptr< telemetry::SmartMotorControllerTelemetryConfig > m_specifiedTelemetryConfig
bool m_liveTuningRegistered {false}
bool m_closed {false}
Static Protected Attributes inherited from yams::motorcontrollers::SmartMotorController
static constexpr double kClosedLoopRampFullScaleVolts = 12.0

Detailed Description

SmartMotorController implementation for the FIRST A301 smart motor, using REVLib 2027.

The A301 has no closed loop gains, so the closed loop controller runs on the SystemCore and commands the A301 with voltage. It also has no current limits, ramp rates or voltage compensation, and configuring them throws a SmartMotorControllerConfigurationException.

The gearing given to WithMotorGearing is from the A301's rotor to the mechanism: usually the gearbox attached to the A301, and any gearing after it. Each A301 has one motor, YMotors::A301().

Followers: the A301 has no follower mode, so the wrapper follows in software. Wrap each other A301 on the mechanism in its own A301Wrapper and give them to the main A301's WithFollowers, as (A301Wrapper*, inverted) pairs. Only an A301Wrapper can follow an A301. The main A301 sends each follower its voltage or duty cycle, and its GetDCMotor() and simulation have every A301, so a follower does not simulate itself or draw current from BatterySim: it reads the main A301's simulation, and the main A301's SimIterate() iterates it. Create each follower before the main A301, and destroy it after. WithLooselyCoupledFollowers still works as on any motor controller, for motors with their own load.

REVLib does not simulate the A301, so in simulation the wrapper drives a DCMotorSim.

External encoder: the A301's own absolute encoder, on its output shaft, used by giving the first::a301::A301* itself to WithExternalEncoder. Its gearing, given to WithExternalEncoderGearing, is from the output shaft to the mechanism. Its zero offset, inversion and wrapping range are applied by the wrapper; without WithWrapping it reads [0, 1) rotations of the encoder.

Example usage (inside a subsystem constructor)

using namespace yams::motorcontrollers;
// Declare as subsystem members:
// first::a301::A301 m_a301{wpi::CANPort::CAN_S0, 3};
// SmartMotorControllerConfig m_cfg;
// std::optional<A301Wrapper> m_smc;
// The A301 has its 64:1 gearbox.
m_cfg.WithSubsystem(this)
.WithMotorGearing(yams::gearing::MechanismGearing{64.0})
.WithFeedback(1.0, 0.0, 0.0)
.WithMotorInverted(false)
.WithExternalEncoder(&m_a301)
.WithUseExternalFeedbackEncoder(true)
.WithClosedLoopMode()
m_smc.emplace(&m_a301, &m_cfg);
Definition MechanismGearing.hpp:19
Definition A301Wrapper.hpp:17
Definition ADRCConfig.hpp:20

Constructor & Destructor Documentation

◆ A301Wrapper()

yams::motorcontrollers::local::A301Wrapper::A301Wrapper ( first::a301::A301 * a301,
SmartMotorControllerConfig * config )

Construct an A301Wrapper around a FIRST A301.

Parameters
a301Pointer to the A301 hardware object (must outlive this wrapper).
configPointer to the SmartMotorControllerConfig (must outlive this wrapper).

◆ ~A301Wrapper()

yams::motorcontrollers::local::A301Wrapper::~A301Wrapper ( )

Member Function Documentation

◆ ApplyConfig()

bool yams::motorcontrollers::local::A301Wrapper::ApplyConfig ( const SmartMotorControllerConfig & config)
overridevirtual

Apply a SmartMotorControllerConfig to the underlying hardware.

Parameters
configConfiguration to apply.
Returns
true if the configuration was applied successfully.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetConfig()

SmartMotorControllerConfig & yams::motorcontrollers::local::A301Wrapper::GetConfig ( )
overridevirtual

Get a mutable reference to the current configuration.

Returns
Reference to the SmartMotorControllerConfig.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetDCMotor()

wpi::math::DCMotor yams::motorcontrollers::local::A301Wrapper::GetDCMotor ( )
overridevirtual

Get the DC motor model associated with this controller.

Returns
wpi::math::DCMotor model.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetDutyCycle()

double yams::motorcontrollers::local::A301Wrapper::GetDutyCycle ( )
overridevirtual

Get the current motor duty cycle.

Returns
Duty cycle in [-1, 1].

Implements yams::motorcontrollers::SmartMotorController.

◆ GetExternalEncoderMechanismPosition()

std::optional< wpi::units::turn_t > yams::motorcontrollers::local::A301Wrapper::GetExternalEncoderMechanismPosition ( )
overridevirtual

Get the mechanism position from the external (absolute) encoder (applies the external encoder gearing). Available whether or not the external encoder is used for feedback.

Returns
Mechanism position in turns from the external encoder, or empty if none is attached.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetExternalEncoderMechanismVelocity()

std::optional< wpi::units::turns_per_second_t > yams::motorcontrollers::local::A301Wrapper::GetExternalEncoderMechanismVelocity ( )
overridevirtual

The A301 does not report its absolute encoder's velocity, so this is the A301's relative encoder's velocity at the mechanism, or empty without the absolute encoder.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetMeasurementAcceleration()

wpi::units::meters_per_second_squared_t yams::motorcontrollers::local::A301Wrapper::GetMeasurementAcceleration ( )
overridevirtual

Get the linear measurement acceleration.

Returns
Linear acceleration in meters per second squared.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetMeasurementPosition()

wpi::units::meter_t yams::motorcontrollers::local::A301Wrapper::GetMeasurementPosition ( )
overridevirtual

Get the linear measurement position (applies circumference conversion).

Returns
Linear position in meters.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetMeasurementVelocity()

wpi::units::meters_per_second_t yams::motorcontrollers::local::A301Wrapper::GetMeasurementVelocity ( )
overridevirtual

Get the linear measurement velocity (applies circumference conversion).

Returns
Linear velocity in meters per second.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetMechanismAcceleration()

wpi::units::turns_per_second_squared_t yams::motorcontrollers::local::A301Wrapper::GetMechanismAcceleration ( )
overridevirtual

Get the mechanism acceleration (derived from velocity).

Returns
Mechanism acceleration in turns per second squared.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetMechanismPosition()

wpi::units::turn_t yams::motorcontrollers::local::A301Wrapper::GetMechanismPosition ( )
overridevirtual

Get the mechanism position (applies gearing). Uses the external (absolute) encoder when one is configured with SmartMotorControllerConfig::WithUseExternalFeedbackEncoder(), otherwise the relative encoder. Use GetRelativeMechanismPosition() to only read the relative encoder.

Returns
Mechanism position in turns.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetMechanismVelocity()

wpi::units::turns_per_second_t yams::motorcontrollers::local::A301Wrapper::GetMechanismVelocity ( )
overridevirtual

The A301 does not report its absolute encoder's velocity, so this is the A301's relative encoder's velocity at the mechanism.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetMotorController()

void * yams::motorcontrollers::local::A301Wrapper::GetMotorController ( )
overridevirtual

Get a raw pointer to the underlying A301.

Returns
Pointer to the first::a301::A301 instance.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetMotorControllerConfig()

void * yams::motorcontrollers::local::A301Wrapper::GetMotorControllerConfig ( )
overridevirtual

The A301 has no vendor config.

Returns
nullptr.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetRelativeMechanismPosition()

wpi::units::turn_t yams::motorcontrollers::local::A301Wrapper::GetRelativeMechanismPosition ( )
overridevirtual

Get the mechanism position from the relative encoder in the motor (applies gearing). Never uses the external (absolute) encoder.

Returns
Mechanism position in turns from the relative encoder.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetRelativeMechanismVelocity()

wpi::units::turns_per_second_t yams::motorcontrollers::local::A301Wrapper::GetRelativeMechanismVelocity ( )
overridevirtual

Get the mechanism velocity from the relative encoder in the motor (applies gearing). Never uses the external (absolute) encoder.

Returns
Mechanism velocity in turns per second from the relative encoder.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetRotorPosition()

wpi::units::turn_t yams::motorcontrollers::local::A301Wrapper::GetRotorPosition ( )
overridevirtual

Get the raw rotor position (no gearing applied).

Returns
Rotor position in turns.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetRotorVelocity()

wpi::units::turns_per_second_t yams::motorcontrollers::local::A301Wrapper::GetRotorVelocity ( )
overridevirtual

Get the raw rotor velocity (no gearing applied).

Returns
Rotor velocity in turns per second.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetStatorCurrent()

wpi::units::ampere_t yams::motorcontrollers::local::A301Wrapper::GetStatorCurrent ( )
overridevirtual

Get the stator (output) current draw.

Returns
Stator current.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetSupplyCurrent()

std::optional< wpi::units::ampere_t > yams::motorcontrollers::local::A301Wrapper::GetSupplyCurrent ( )
overridevirtual

The simulated supply current, or empty on the robot, since the A301 does not report it.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetTemperature()

wpi::units::celsius_t yams::motorcontrollers::local::A301Wrapper::GetTemperature ( )
overridevirtual

Get the motor controller temperature.

Returns
Temperature in degrees Celsius.

Implements yams::motorcontrollers::SmartMotorController.

◆ GetUnsupportedTelemetryFields()

telemetry::UnsupportedTelemetryFields yams::motorcontrollers::local::A301Wrapper::GetUnsupportedTelemetryFields ( )
overridevirtual

Supply current, current limits and ramp rates, which the A301 does not have.

Reimplemented from yams::motorcontrollers::SmartMotorController.

◆ GetVoltage()

wpi::units::volt_t yams::motorcontrollers::local::A301Wrapper::GetVoltage ( )
overridevirtual

Get the voltage currently applied to the motor.

Returns
Applied voltage.

Implements yams::motorcontrollers::SmartMotorController.

◆ SeedRelativeEncoder()

void yams::motorcontrollers::local::A301Wrapper::SeedRelativeEncoder ( )
overridevirtual

Seed the relative encoder from the absolute sensor position (one-shot on startup).

Implements yams::motorcontrollers::SmartMotorController.

◆ SetClosedLoopRampRate()

void yams::motorcontrollers::local::A301Wrapper::SetClosedLoopRampRate ( wpi::units::second_t rampRate)
overridevirtual

The closed loop runs on the SystemCore, which ramps its output.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetClosedLoopSlot()

void yams::motorcontrollers::local::A301Wrapper::SetClosedLoopSlot ( ClosedLoopControllerSlot slot)
overridevirtual

Select the active closed-loop gain slot.

Parameters
slotGain slot to activate.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetDutyCycle()

void yams::motorcontrollers::local::A301Wrapper::SetDutyCycle ( double dutyCycle)
overridevirtual

Command a duty-cycle output to the motor.

Parameters
dutyCycleNormalized duty cycle in [-1, 1].

Implements yams::motorcontrollers::SmartMotorController.

◆ SetEncoderInverted()

void yams::motorcontrollers::local::A301Wrapper::SetEncoderInverted ( bool inverted)
overridevirtual

The A301's internal encoder cannot be inverted; always throws std::runtime_error.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetEncoderPosition() [1/2]

void yams::motorcontrollers::local::A301Wrapper::SetEncoderPosition ( wpi::units::meter_t distance)
overridevirtual

Write a linear distance into the encoder (seeds the position).

Parameters
distanceLinear distance to write.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetEncoderPosition() [2/2]

void yams::motorcontrollers::local::A301Wrapper::SetEncoderPosition ( wpi::units::turn_t angle)
overridevirtual

Write a mechanism angle into the encoder (seeds the position).

Parameters
angleMechanism angle to write.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetEncoderVelocity() [1/2]

void yams::motorcontrollers::local::A301Wrapper::SetEncoderVelocity ( wpi::units::meters_per_second_t velocity)
overridevirtual

Linear version of SetEncoderVelocity(turns_per_second_t); throws without a mechanism circumference.

Parameters
velocityMechanism linear velocity.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetEncoderVelocity() [2/2]

void yams::motorcontrollers::local::A301Wrapper::SetEncoderVelocity ( wpi::units::turns_per_second_t velocity)
overridevirtual

Set the simulated mechanism velocity. Throws std::runtime_error outside of simulation, since the A301 does not support setting the encoder velocity.

Parameters
velocityMechanism velocity.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetExponentialProfile()

void yams::motorcontrollers::local::A301Wrapper::SetExponentialProfile ( std::optional< double > kV,
std::optional< double > kA,
std::optional< wpi::units::volt_t > maxInput )
overridevirtual

Update the exponential profile. Missing values keep the configured ones.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetFeedback()

void yams::motorcontrollers::local::A301Wrapper::SetFeedback ( double kP,
double kI,
double kD )
overridevirtual

Set all three PID feedback gains at once (live update).

Parameters
kPProportional gain.
kIIntegral gain.
kDDerivative gain.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetFeedforward()

void yams::motorcontrollers::local::A301Wrapper::SetFeedforward ( double kS,
double kV,
double kA,
double kG )
overridevirtual

Set all four feedforward gains at once (live update).

Parameters
kSStatic friction voltage.
kVVelocity feedforward coefficient.
kAAcceleration feedforward coefficient.
kGGravity feedforward coefficient.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetKa()

void yams::motorcontrollers::local::A301Wrapper::SetKa ( double kA)
overridevirtual

Set the acceleration feedforward coefficient (live update).

Parameters
kAAcceleration feedforward coefficient.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetKd()

void yams::motorcontrollers::local::A301Wrapper::SetKd ( double kD)
overridevirtual

Set the derivative gain (live update).

Parameters
kDDerivative gain.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetKg()

void yams::motorcontrollers::local::A301Wrapper::SetKg ( double kG)
overridevirtual

Set the gravity feedforward coefficient (live update).

Parameters
kGGravity feedforward coefficient.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetKi()

void yams::motorcontrollers::local::A301Wrapper::SetKi ( double kI)
overridevirtual

Set the integral gain (live update).

Parameters
kIIntegral gain.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetKp()

void yams::motorcontrollers::local::A301Wrapper::SetKp ( double kP)
overridevirtual

Set the proportional gain (live update).

Parameters
kPProportional gain.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetKs()

void yams::motorcontrollers::local::A301Wrapper::SetKs ( double kS)
overridevirtual

Set the static friction feedforward (live update).

Parameters
kSStatic friction voltage.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetKv()

void yams::motorcontrollers::local::A301Wrapper::SetKv ( double kV)
overridevirtual

Set the velocity feedforward coefficient (live update).

Parameters
kVVelocity feedforward coefficient.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetMeasurementLowerLimit()

void yams::motorcontrollers::local::A301Wrapper::SetMeasurementLowerLimit ( wpi::units::meter_t lowerLimit)
overridevirtual

Set the lower linear soft limit for the measurement.

Parameters
lowerLimitLower distance limit.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetMeasurementUpperLimit()

void yams::motorcontrollers::local::A301Wrapper::SetMeasurementUpperLimit ( wpi::units::meter_t upperLimit)
overridevirtual

Set the upper linear soft limit for the measurement.

Parameters
upperLimitUpper distance limit.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetMechanismCircumference()

void yams::motorcontrollers::local::A301Wrapper::SetMechanismCircumference ( wpi::units::meter_t circumference)
overridevirtual

Update the mechanism circumference used for linear position/velocity conversions.

The base implementation updates the config; wrappers override it to also reconfigure the hardware.

Parameters
circumferenceNew mechanism circumference.

Reimplemented from yams::motorcontrollers::SmartMotorController.

◆ SetMechanismGearing()

void yams::motorcontrollers::local::A301Wrapper::SetMechanismGearing ( const gearing::MechanismGearing & gearing)
overridevirtual

Update the mechanism gearing and rebuild the simulated motor, which depends on it.

Parameters
gearingNew mechanism gearing.

Reimplemented from yams::motorcontrollers::SmartMotorController.

◆ SetMechanismLimits()

void yams::motorcontrollers::local::A301Wrapper::SetMechanismLimits ( wpi::units::turn_t lower,
wpi::units::turn_t upper )
overridevirtual

Set both angular soft limits for the mechanism.

Parameters
lowerLower angle limit.
upperUpper angle limit.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetMechanismLimitsEnabled()

void yams::motorcontrollers::local::A301Wrapper::SetMechanismLimitsEnabled ( bool enabled)
overridevirtual

The closed loop controller on the SystemCore enforces the mechanism limits.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetMechanismLowerLimit()

void yams::motorcontrollers::local::A301Wrapper::SetMechanismLowerLimit ( wpi::units::turn_t lowerLimit)
overridevirtual

Set the lower angular soft limit for the mechanism.

Parameters
lowerLimitLower angle limit.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetMechanismUpperLimit()

void yams::motorcontrollers::local::A301Wrapper::SetMechanismUpperLimit ( wpi::units::turn_t upperLimit)
overridevirtual

Set the upper angular soft limit for the mechanism.

Parameters
upperLimitUpper angle limit.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetMotionProfileMaxAcceleration() [1/2]

void yams::motorcontrollers::local::A301Wrapper::SetMotionProfileMaxAcceleration ( wpi::units::meters_per_second_squared_t maxAcc)
overridevirtual

◆ SetMotionProfileMaxAcceleration() [2/2]

void yams::motorcontrollers::local::A301Wrapper::SetMotionProfileMaxAcceleration ( wpi::units::turns_per_second_squared_t maxAcc)
overridevirtual

◆ SetMotionProfileMaxJerk()

void yams::motorcontrollers::local::A301Wrapper::SetMotionProfileMaxJerk ( wpi::units::angular_jerk::turns_per_second_cubed_t maxJerk)
overridevirtual

Set the maximum jerk of a velocity trapezoidal profile (its acceleration constraint). Has no effect on position profiles.

Parameters
maxJerkMaximum angular jerk.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetMotionProfileMaxVelocity() [1/2]

void yams::motorcontrollers::local::A301Wrapper::SetMotionProfileMaxVelocity ( wpi::units::meters_per_second_t maxVelocity)
overridevirtual

Set the maximum linear velocity for the motion profile.

Parameters
maxVelocityMaximum linear velocity.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetMotionProfileMaxVelocity() [2/2]

void yams::motorcontrollers::local::A301Wrapper::SetMotionProfileMaxVelocity ( wpi::units::turns_per_second_t maxVelocity)
overridevirtual

Set the maximum angular velocity for the motion profile.

Parameters
maxVelocityMaximum mechanism angular velocity.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetMotorInverted()

void yams::motorcontrollers::local::A301Wrapper::SetMotorInverted ( bool inverted)
overridevirtual

Set the motor output direction.

Parameters
invertedtrue to invert the motor direction.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetOpenLoopRampRate()

void yams::motorcontrollers::local::A301Wrapper::SetOpenLoopRampRate ( wpi::units::second_t rampRate)
overridevirtual

The A301 has no ramp rates; always throws std::runtime_error.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetPosition() [1/2]

void yams::motorcontrollers::local::A301Wrapper::SetPosition ( wpi::units::meter_t distance)
overridevirtual

Command a linear measurement position setpoint (closed-loop).

Parameters
distanceTarget linear distance.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetPosition() [2/2]

void yams::motorcontrollers::local::A301Wrapper::SetPosition ( wpi::units::turn_t angle)
overridevirtual

Command a mechanism angle position setpoint (closed-loop).

Parameters
angleTarget mechanism angle.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetStatorCurrentLimit()

void yams::motorcontrollers::local::A301Wrapper::SetStatorCurrentLimit ( wpi::units::ampere_t currentLimit)
overridevirtual

The A301 has no current limits; always throws std::runtime_error.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetSupplyCurrentLimit()

void yams::motorcontrollers::local::A301Wrapper::SetSupplyCurrentLimit ( wpi::units::ampere_t currentLimit)
overridevirtual

The A301 has no current limits; always throws std::runtime_error.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetupSimulation()

void yams::motorcontrollers::local::A301Wrapper::SetupSimulation ( )
overridevirtual

Initialize the DCMotorSim used for simulation.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetVelocity() [1/4]

void yams::motorcontrollers::local::A301Wrapper::SetVelocity ( wpi::units::meters_per_second_t velocity)
overridevirtual

Command a linear measurement velocity setpoint (closed-loop).

Parameters
velocityTarget linear velocity.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetVelocity() [2/4]

void yams::motorcontrollers::SmartMotorController::SetVelocity ( wpi::units::meters_per_second_t velocity,
wpi::units::newton_t feedforwardForce )

Command a linear velocity setpoint with an additional feedforward force applied on top.

Throws SmartMotorControllerConfigurationException if the mechanism circumference is not configured.

Parameters
velocityTarget linear velocity.
feedforwardForceAdditional feedforward force at the mechanism.

◆ SetVelocity() [3/4]

void yams::motorcontrollers::local::A301Wrapper::SetVelocity ( wpi::units::turns_per_second_t velocity)
overridevirtual

Command a mechanism angular velocity setpoint (closed-loop).

Parameters
velocityTarget mechanism angular velocity.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetVelocity() [4/4]

void yams::motorcontrollers::local::A301Wrapper::SetVelocity ( wpi::units::turns_per_second_t velocity,
wpi::units::newton_t feedforwardForce )
overridevirtual

Command a velocity setpoint with an additional feedforward force, added by the SystemCore closed loop.

Parameters
velocityTarget mechanism angular velocity.
feedforwardForceAdditional feedforward force at the mechanism.

Reimplemented from yams::motorcontrollers::SmartMotorController.

◆ SetVoltage()

void yams::motorcontrollers::local::A301Wrapper::SetVoltage ( wpi::units::volt_t voltage)
overridevirtual

Command a voltage output to the motor.

Parameters
voltageVoltage to apply.

Implements yams::motorcontrollers::SmartMotorController.

◆ SetZeroPower()

void yams::motorcontrollers::local::A301Wrapper::SetZeroPower ( MotorMode mode)
overridevirtual

Set the idle (neutral) mode of the motor.

Parameters
modeCOAST or BRAKE.

Implements yams::motorcontrollers::SmartMotorController.

◆ SimIterate()

void yams::motorcontrollers::local::A301Wrapper::SimIterate ( )
overridevirtual

Advance the motor simulation by one loop iteration. Each motor controller's SimIterate() calls this last, with SmartMotorController::SimIterate(): it iterates the loosely coupled followers reading this motor controller's mechanism's simulation, which a mechanism steps right before. Each follower's iterates its own.

Reimplemented from yams::motorcontrollers::SmartMotorController.

◆ SynchronizeRelativeEncoder()

void yams::motorcontrollers::local::A301Wrapper::SynchronizeRelativeEncoder ( )
overridevirtual

Periodically re-synchronize the relative encoder to the absolute sensor.

Implements yams::motorcontrollers::SmartMotorController.


The documentation for this class was generated from the following file:
  • /home/runner/work/YAMS/YAMS/yams/cpp/include/yams/motorcontrollers/local/A301Wrapper.hpp