#include <IMotorController.h>

Inherits ctre::phoenix::motorcontrol::IFollower.

Inherited by ctre::phoenix::motorcontrol::IMotorControllerEnhanced [virtual], ctre::phoenix::motorcontrol::can::BaseMotorController [virtual], and ctre::phoenix::motorcontrol::can::VictorSPX [virtual].

Public Member Functions
virtual void	Set (ControlMode Mode, double demand)=0

virtual void	Set (ControlMode mode, double demand0, DemandType demand1Type, double demand1)=0

virtual void	NeutralOutput ()=0

virtual void	SetNeutralMode (NeutralMode neutralMode)=0

virtual void	SetSensorPhase (bool PhaseSensor)=0

virtual void	SetInverted (bool invert)=0

virtual void	SetInverted (InvertType invertType)=0

virtual bool	GetInverted () const =0

virtual ErrorCode	ConfigFactoryDefault (int timeout)=0

virtual ErrorCode	ConfigOpenloopRamp (double secondsFromNeutralToFull, int timeoutMs=0)=0

virtual ErrorCode	ConfigClosedloopRamp (double secondsFromNeutralToFull, int timeoutMs=0)=0

virtual ErrorCode	ConfigPeakOutputForward (double percentOut, int timeoutMs=0)=0

virtual ErrorCode	ConfigPeakOutputReverse (double percentOut, int timeoutMs=0)=0

virtual ErrorCode	ConfigNominalOutputForward (double percentOut, int timeoutMs=0)=0

virtual ErrorCode	ConfigNominalOutputReverse (double percentOut, int timeoutMs=0)=0

virtual ErrorCode	ConfigNeutralDeadband (double percentDeadband, int timeoutMs=0)=0

virtual ErrorCode	ConfigVoltageCompSaturation (double voltage, int timeoutMs=0)=0

virtual ErrorCode	ConfigVoltageMeasurementFilter (int filterWindowSamples, int timeoutMs=0)=0

virtual void	EnableVoltageCompensation (bool enable)=0

virtual bool	IsVoltageCompensationEnabled ()=0

virtual double	GetBusVoltage ()=0

virtual double	GetMotorOutputPercent ()=0

virtual double	GetMotorOutputVoltage ()=0

virtual double	GetTemperature ()=0

virtual ErrorCode	ConfigSelectedFeedbackSensor (RemoteFeedbackDevice feedbackDevice, int pidIdx=0, int timeoutMs=0)=0

virtual ErrorCode	ConfigSelectedFeedbackCoefficient (double coefficient, int pidIdx=0, int timeoutMs=0)=0

virtual ErrorCode	ConfigRemoteFeedbackFilter (int deviceID, RemoteSensorSource remoteSensorSource, int remoteOrdinal, int timeoutMs=0)=0

virtual ErrorCode	ConfigRemoteFeedbackFilter (ctre::phoenix::sensors::CANCoder &canCoderRef, int remoteOrdinal, int timeoutMs=0)=0

virtual ErrorCode	ConfigRemoteFeedbackFilter (ctre::phoenix::motorcontrol::can::BaseTalon &talonRef, int remoteOrdinal, int timeoutMs=0)=0

virtual ErrorCode	ConfigSensorTerm (SensorTerm sensorTerm, FeedbackDevice feedbackDevice, int timeoutMs=0)=0

virtual double	GetSelectedSensorPosition (int pidIdx=0)=0

virtual double	GetSelectedSensorVelocity (int pidIdx=0)=0

virtual ErrorCode	SetSelectedSensorPosition (double sensorPos, int pidIdx=0, int timeoutMs=50)=0

virtual ErrorCode	SetControlFramePeriod (ControlFrame frame, int periodMs)=0

virtual ErrorCode	SetStatusFramePeriod (StatusFrame frame, uint8_t periodMs, int timeoutMs=0)=0

virtual int	GetStatusFramePeriod (StatusFrame frame, int timeoutMs=0)=0

virtual ErrorCode	ConfigForwardLimitSwitchSource (RemoteLimitSwitchSource type, LimitSwitchNormal normalOpenOrClose, int deviceID, int timeoutMs=0)=0

virtual ErrorCode	ConfigReverseLimitSwitchSource (RemoteLimitSwitchSource type, LimitSwitchNormal normalOpenOrClose, int deviceID, int timeoutMs=0)=0

virtual void	OverrideLimitSwitchesEnable (bool enable)=0

virtual ErrorCode	ConfigForwardSoftLimitThreshold (double forwardSensorLimit, int timeoutMs=0)=0

virtual ErrorCode	ConfigReverseSoftLimitThreshold (double reverseSensorLimit, int timeoutMs=0)=0

virtual ErrorCode	ConfigForwardSoftLimitEnable (bool enable, int timeoutMs=0)=0

virtual ErrorCode	ConfigReverseSoftLimitEnable (bool enable, int timeoutMs=0)=0

virtual void	OverrideSoftLimitsEnable (bool enable)=0

virtual ErrorCode	Config_kP (int slotIdx, double value, int timeoutMs=0)=0

virtual ErrorCode	Config_kI (int slotIdx, double value, int timeoutMs=0)=0

virtual ErrorCode	Config_kD (int slotIdx, double value, int timeoutMs=0)=0

virtual ErrorCode	Config_kF (int slotIdx, double value, int timeoutMs=0)=0

virtual ErrorCode	Config_IntegralZone (int slotIdx, double izone, int timeoutMs=0)=0

virtual ErrorCode	ConfigAllowableClosedloopError (int slotIdx, double allowableCloseLoopError, int timeoutMs=0)=0

virtual ErrorCode	ConfigMaxIntegralAccumulator (int slotIdx, double iaccum, int timeoutMs=0)=0

virtual ErrorCode	ConfigClosedLoopPeakOutput (int slotIdx, double percentOut, int timeoutMs=0)=0

virtual ErrorCode	ConfigClosedLoopPeriod (int slotIdx, int loopTimeMs, int timeoutMs=0)=0

virtual ErrorCode	ConfigAuxPIDPolarity (bool invert, int timeoutMs=0)=0

virtual ErrorCode	SetIntegralAccumulator (double iaccum, int pidIdx=0, int timeoutMs=0)=0

virtual double	GetClosedLoopError (int pidIdx=0)=0

virtual double	GetIntegralAccumulator (int pidIdx=0)=0

virtual double	GetErrorDerivative (int pidIdx=0)=0

virtual ErrorCode	SelectProfileSlot (int slotIdx, int pidIdx)=0

virtual double	GetClosedLoopTarget (int pidIdx=0)=0

virtual double	GetActiveTrajectoryPosition (int pidIdx=0)=0

virtual double	GetActiveTrajectoryVelocity (int pidIdx=0)=0

virtual double	GetActiveTrajectoryArbFeedFwd (int pidIdx=0)=0

virtual ErrorCode	ConfigMotionCruiseVelocity (double sensorUnitsPer100ms, int timeoutMs=0)=0

virtual ErrorCode	ConfigMotionAcceleration (double sensorUnitsPer100msPerSec, int timeoutMs=0)=0

virtual ErrorCode	ConfigMotionSCurveStrength (int curveStrength, int timeoutMs)=0

virtual ErrorCode	ClearMotionProfileTrajectories ()=0

virtual int	GetMotionProfileTopLevelBufferCount ()=0

virtual ErrorCode	PushMotionProfileTrajectory (const ctre::phoenix::motion::TrajectoryPoint &trajPt)=0

virtual bool	IsMotionProfileTopLevelBufferFull ()=0

virtual void	ProcessMotionProfileBuffer ()=0

virtual ErrorCode	GetMotionProfileStatus (ctre::phoenix::motion::MotionProfileStatus &statusToFill)=0

virtual ErrorCode	ClearMotionProfileHasUnderrun (int timeoutMs=0)=0

virtual ErrorCode	ChangeMotionControlFramePeriod (int periodMs)=0

virtual ErrorCode	ConfigMotionProfileTrajectoryPeriod (int baseTrajDurationMs, int timeoutMs=0)=0

virtual ErrorCode	ConfigFeedbackNotContinuous (bool feedbackNotContinuous, int timeoutMs=0)=0

virtual ErrorCode	ConfigRemoteSensorClosedLoopDisableNeutralOnLOS (bool remoteSensorClosedLoopDisableNeutralOnLOS, int timeoutMs=0)=0

virtual ErrorCode	ConfigClearPositionOnLimitF (bool clearPositionOnLimitF, int timeoutMs=0)=0

virtual ErrorCode	ConfigClearPositionOnLimitR (bool clearPositionOnLimitR, int timeoutMs=0)=0

virtual ErrorCode	ConfigClearPositionOnQuadIdx (bool clearPositionOnQuadIdx, int timeoutMs=0)=0

virtual ErrorCode	ConfigLimitSwitchDisableNeutralOnLOS (bool limitSwitchDisableNeutralOnLOS, int timeoutMs=0)=0

virtual ErrorCode	ConfigSoftLimitDisableNeutralOnLOS (bool softLimitDisableNeutralOnLOS, int timeoutMs=0)=0

virtual ErrorCode	ConfigPulseWidthPeriod_EdgesPerRot (int pulseWidthPeriod_EdgesPerRot, int timeoutMs=0)=0

virtual ErrorCode	ConfigPulseWidthPeriod_FilterWindowSz (int pulseWidthPeriod_FilterWindowSz, int timeoutMs=0)=0

virtual ErrorCode	GetLastError ()=0

virtual ErrorCode	GetFaults (Faults &toFill)=0

virtual ErrorCode	GetStickyFaults (StickyFaults &toFill)=0

virtual ErrorCode	ClearStickyFaults (int timeoutMs=0)=0

virtual int	GetFirmwareVersion ()=0

virtual bool	HasResetOccurred ()=0

virtual ErrorCode	ConfigSetCustomParam (int newValue, int paramIndex, int timeoutMs=0)=0

virtual int	ConfigGetCustomParam (int paramIndex, int timeoutMs=0)=0

virtual ErrorCode	ConfigSetParameter (ParamEnum param, double value, uint8_t subValue, int ordinal, int timeoutMs=0)=0

virtual double	ConfigGetParameter (ParamEnum paramEnum, int ordinal, int timeoutMs=0)=0

virtual int	GetBaseID ()=0

virtual int	GetDeviceID ()=0

virtual ControlMode	GetControlMode ()=0

Public Member Functions inherited from ctre::phoenix::motorcontrol::IFollower
virtual void	Follow (ctre::phoenix::motorcontrol::IMotorController &masterToFollow)=0

virtual void	ValueUpdated ()=0

Detailed Description

Interface for motor controllers

Member Function Documentation

◆ ChangeMotionControlFramePeriod()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ChangeMotionControlFramePeriod ( int periodMs )

pure virtual

Calling application can opt to speed up the handshaking between the robot API and the controller to increase the download rate of the controller's Motion Profile. Ideally the period should be no more than half the period of a trajectory point.

Parameters

periodMs The transmit period in ms.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ClearMotionProfileHasUnderrun()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ClearMotionProfileHasUnderrun ( int timeoutMs = 0 )

pure virtual

Clear the "Has Underrun" flag. Typically this is called after application has confirmed an underrun had occured.

Parameters

timeoutMs Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ClearMotionProfileTrajectories()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ClearMotionProfileTrajectories ( )

pure virtual

Clear the buffered motion profile in both controller's RAM (bottom), and in the API (top).

Returns: Error Code generated by function. 0 indicates no error

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ClearStickyFaults()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ClearStickyFaults ( int timeoutMs = 0 )

pure virtual

Clears all sticky faults.

Parameters

timeoutMs Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Last Error Code generated by a function.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ Config_IntegralZone()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::Config_IntegralZone	(	int	slotIdx,
		double	izone,
		int	timeoutMs = `0`
	)

pure virtual

Sets the Integral Zone constant in the given parameter slot. If the (absolute) closed-loop error is outside of this zone, integral accumulator is automatically cleared. This ensures than integral wind up events will stop after the sensor gets far enough from its target.

Parameters

slotIdx	Parameter slot for the constant.
izone	Value of the Integral Zone constant (closed loop error units X 1ms).
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ Config_kD()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::Config_kD	(	int	slotIdx,
		double	value,
		int	timeoutMs = `0`
	)

pure virtual

Sets the 'D' constant in the given parameter slot.

This is multiplied by derivative error (sensor units per PID loop, typically 1ms). Note the closed loop output interprets a final value of 1023 as full output. So use a gain of '250' to get full output if derr is 4096u (Mag Encoder 1 rotation) per 1000 loops (typ 1 sec)

Parameters

slotIdx	Parameter slot for the constant.
value	Value of the D constant.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ Config_kF()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::Config_kF	(	int	slotIdx,
		double	value,
		int	timeoutMs = `0`
	)

pure virtual

Sets the 'F' constant in the given parameter slot.

See documentation for calculation details. If using velocity, motion magic, or motion profile, use (1023 * duty-cycle / sensor-velocity-sensor-units-per-100ms).

Parameters

slotIdx	Parameter slot for the constant.
value	Value of the F constant.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ Config_kI()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::Config_kI	(	int	slotIdx,
		double	value,
		int	timeoutMs = `0`
	)

pure virtual

Sets the 'I' constant in the given parameter slot. This is multiplied by accumulated closed loop error in sensor units every PID Loop.
Note the closed loop output interprets a final value of 1023 as full output.
So use a gain of '0.00025' to get full output if err is 4096u for 1000 loops (accumulater holds 4,096,000), [which is equivalent to one CTRE mag encoder rotation for 1000 milliseconds].

Parameters

slotIdx	Parameter slot for the constant.
value	Value of the I constant.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ Config_kP()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::Config_kP	(	int	slotIdx,
		double	value,
		int	timeoutMs = `0`
	)

pure virtual

Sets the 'P' constant in the given parameter slot. This is multiplied by closed loop error in sensor units. Note the closed loop output interprets a final value of 1023 as full output. So use a gain of '0.25' to get full output if err is 4096u (Mag Encoder 1 rotation)

Parameters

slotIdx	Parameter slot for the constant.
value	Value of the P constant.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigAllowableClosedloopError()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigAllowableClosedloopError	(	int	slotIdx,
		double	allowableCloseLoopError,
		int	timeoutMs = `0`
	)

pure virtual

Sets the allowable closed-loop error in the given parameter slot.

Parameters

slotIdx	Parameter slot for the constant.
allowableCloseLoopError	Value of the allowable closed-loop error in sensor units (or sensor units per 100ms for velocity).
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigAuxPIDPolarity()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigAuxPIDPolarity	(	bool	invert,
		int	timeoutMs = `0`
	)

pure virtual

Configures the Polarity of the Auxiliary PID (PID1).

Standard Polarity: Primary Output = PID0 + PID1, Auxiliary Output = PID0 - PID1,

Inverted Polarity: Primary Output = PID0 - PID1, Auxiliary Output = PID0 + PID1,

Parameters

invert	If true, use inverted PID1 output polarity.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigClearPositionOnLimitF()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigClearPositionOnLimitF	(	bool	clearPositionOnLimitF,
		int	timeoutMs = `0`
	)

pure virtual

Enables clearing the position of the feedback sensor when the forward limit switch is triggered

Parameters

clearPositionOnLimitF	Whether clearing is enabled, defaults false
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigClearPositionOnLimitR()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigClearPositionOnLimitR	(	bool	clearPositionOnLimitR,
		int	timeoutMs = `0`
	)

pure virtual

Enables clearing the position of the feedback sensor when the reverse limit switch is triggered

Parameters

clearPositionOnLimitR	Whether clearing is enabled, defaults false
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigClearPositionOnQuadIdx()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigClearPositionOnQuadIdx	(	bool	clearPositionOnQuadIdx,
		int	timeoutMs = `0`
	)

pure virtual

Enables clearing the position of the feedback sensor when the quadrature index signal is detected

Parameters

clearPositionOnQuadIdx	Whether clearing is enabled, defaults false
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigClosedLoopPeakOutput()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigClosedLoopPeakOutput	(	int	slotIdx,
		double	percentOut,
		int	timeoutMs = `0`
	)

pure virtual

Sets the peak closed-loop output. This peak output is slot-specific and is applied to the output of the associated PID loop. This setting is seperate from the generic Peak Output setting.

Parameters

slotIdx	Parameter slot for the constant.
percentOut	Peak Percent Output from 0 to 1. This value is absolute and the magnitude will apply in both forward and reverse directions.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigClosedLoopPeriod()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigClosedLoopPeriod	(	int	slotIdx,
		int	loopTimeMs,
		int	timeoutMs = `0`
	)

pure virtual

Sets the loop time (in milliseconds) of the PID closed-loop calculations. Default value is 1 ms.

Parameters

slotIdx	Parameter slot for the constant.
loopTimeMs	Loop timing of the closed-loop calculations. Minimum value of 1 ms, maximum of 64 ms.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigClosedloopRamp()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigClosedloopRamp	(	double	secondsFromNeutralToFull,
		int	timeoutMs = `0`
	)

pure virtual

Configures the closed-loop ramp rate of throttle output.

Parameters

secondsFromNeutralToFull	Minimum desired time to go from neutral to full throttle. A value of '0' will disable the ramp.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigFactoryDefault()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigFactoryDefault ( int timeout )

pure virtual

Revert all configurations to factory default values. Use this before your individual config* calls to avoid having to config every single param.

Alternatively you can use the configAllSettings routine.

Parameters

timeout Timeout value in ms. Function will generate error if config is not successful within timeout.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigFeedbackNotContinuous()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigFeedbackNotContinuous	(	bool	feedbackNotContinuous,
		int	timeoutMs = `0`
	)

pure virtual

Disables continuous tracking of the position for analog and pulse-width. If the signal goes from 4095 to 0 (pulse-width) a motor controller will continue to read 4096 by default. If overflow tracking is disabled, it will wrap to 0 (not continuous)

If using pulse-width on CTRE Mag Encoder (within one rotation) or absolute analog sensor (within one rotation), setting feedbackNotContinuous to true is recommended, to prevent intermittent connections from causing sensor "jumps" of 4096 (or 1024 for analog) units.

Parameters

feedbackNotContinuous	True to disable the overflow tracking.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigForwardLimitSwitchSource()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigForwardLimitSwitchSource	(	RemoteLimitSwitchSource	type,
		LimitSwitchNormal	normalOpenOrClose,
		int	deviceID,
		int	timeoutMs = `0`
	)

pure virtual

Configures the forward limit switch for a remote source. For example, a CAN motor controller may need to monitor the Limit-F pin of another Talon or CANifier.

Parameters

type	Remote limit switch source. User can choose between a remote Talon SRX, CANifier, or deactivate the feature.
normalOpenOrClose	Setting for normally open, normally closed, or disabled. This setting matches the Phoenix Tuner drop down.
deviceID	Device ID of remote source (Talon SRX or CANifier device ID).
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseTalon, ctre::phoenix::motorcontrol::can::BaseMotorController, and ctre::phoenix::motorcontrol::IMotorControllerEnhanced.

◆ ConfigForwardSoftLimitEnable()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigForwardSoftLimitEnable	(	bool	enable,
		int	timeoutMs = `0`
	)

pure virtual

Configures the forward soft limit enable.

Parameters

enable	Forward Sensor Position Limit Enable.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigForwardSoftLimitThreshold()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigForwardSoftLimitThreshold	(	double	forwardSensorLimit,
		int	timeoutMs = `0`
	)

pure virtual

Configures the forward soft limit threhold.

Parameters

forwardSensorLimit	Forward Sensor Position Limit (in raw sensor units).
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigGetCustomParam()

virtual int ctre::phoenix::motorcontrol::IMotorController::ConfigGetCustomParam	(	int	paramIndex,
		int	timeoutMs = `0`
	)

pure virtual

Gets the value of a custom parameter.

Parameters

paramIndex	Index of custom parameter [0,1].
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Value of the custom param.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigGetParameter()

virtual double ctre::phoenix::motorcontrol::IMotorController::ConfigGetParameter	(	ParamEnum	paramEnum,
		int	ordinal,
		int	timeoutMs = `0`
	)

pure virtual

Gets a parameter.

Parameters

paramEnum	Parameter enumeration.
ordinal	Ordinal of parameter.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Value of parameter.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigLimitSwitchDisableNeutralOnLOS()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigLimitSwitchDisableNeutralOnLOS	(	bool	limitSwitchDisableNeutralOnLOS,
		int	timeoutMs = `0`
	)

pure virtual

Disables limit switches triggering (if enabled) when the sensor is no longer detected.

Parameters

limitSwitchDisableNeutralOnLOS	disable triggering
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigMaxIntegralAccumulator()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigMaxIntegralAccumulator	(	int	slotIdx,
		double	iaccum,
		int	timeoutMs = `0`
	)

pure virtual

Sets the maximum integral accumulator in the given parameter slot.

Parameters

slotIdx	Parameter slot for the constant.
iaccum	Value of the maximum integral accumulator (closed loop error units X 1ms).
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigMotionAcceleration()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigMotionAcceleration	(	double	sensorUnitsPer100msPerSec,
		int	timeoutMs = `0`
	)

pure virtual

Sets the Motion Magic Acceleration. This is the target acceleration that the motion magic curve generator can use.

Parameters

sensorUnitsPer100msPerSec	Motion Magic Acceleration (in raw sensor units per 100 ms per second).
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigMotionCruiseVelocity()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigMotionCruiseVelocity	(	double	sensorUnitsPer100ms,
		int	timeoutMs = `0`
	)

pure virtual

Sets the Motion Magic Cruise Velocity. This is the peak target velocity that the motion magic curve generator can use.

Parameters

sensorUnitsPer100ms	Motion Magic Cruise Velocity (in raw sensor units per 100 ms).
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigMotionProfileTrajectoryPeriod()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigMotionProfileTrajectoryPeriod	(	int	baseTrajDurationMs,
		int	timeoutMs = `0`
	)

pure virtual

When trajectory points are processed in the motion profile executer, the MPE determines how long to apply the active trajectory point by summing baseTrajDurationMs with the timeDur of the trajectory point (see TrajectoryPoint).

This allows general selection of the execution rate of the points with 1ms resolution, while allowing some degree of change from point to point.

Parameters

baseTrajDurationMs	The base duration time of every trajectory point. This is summed with the trajectory points unique timeDur.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigMotionSCurveStrength()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigMotionSCurveStrength	(	int	curveStrength,
		int	timeoutMs
	)

pure virtual

Sets the Motion Magic S Curve Strength. Call this before using Motion Magic. Modifying this during a Motion Magic action should be avoided.

Parameters

curveStrength	0 to use Trapezoidal Motion Profile. [1,8] for S-Curve (greater value yields greater smoothing).
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigNeutralDeadband()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigNeutralDeadband	(	double	percentDeadband,
		int	timeoutMs = `0`
	)

pure virtual

Configures the output deadband percentage.

Parameters

percentDeadband	Desired deadband percentage. Minimum is 0.1%, Maximum is 25%. Pass 0.04 for 4% (factory default).
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigNominalOutputForward()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigNominalOutputForward	(	double	percentOut,
		int	timeoutMs = `0`
	)

pure virtual

Configures the forward nominal output percentage.

Parameters

percentOut	Nominal (minimum) percent output. [0,+1]
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigNominalOutputReverse()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigNominalOutputReverse	(	double	percentOut,
		int	timeoutMs = `0`
	)

pure virtual

Configures the reverse nominal output percentage.

Parameters

percentOut	Nominal (minimum) percent output. [-1,0]
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigOpenloopRamp()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigOpenloopRamp	(	double	secondsFromNeutralToFull,
		int	timeoutMs = `0`
	)

pure virtual

Configures the open-loop ramp rate of throttle output.

Parameters

secondsFromNeutralToFull	Minimum desired time to go from neutral to full throttle. A value of '0' will disable the ramp.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigPeakOutputForward()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigPeakOutputForward	(	double	percentOut,
		int	timeoutMs = `0`
	)

pure virtual

Configures the forward peak output percentage.

Parameters

percentOut	Desired peak output percentage. [0,1]
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigPeakOutputReverse()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigPeakOutputReverse	(	double	percentOut,
		int	timeoutMs = `0`
	)

pure virtual

Configures the reverse peak output percentage.

Parameters

percentOut	Desired peak output percentage.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigPulseWidthPeriod_EdgesPerRot()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigPulseWidthPeriod_EdgesPerRot	(	int	pulseWidthPeriod_EdgesPerRot,
		int	timeoutMs = `0`
	)

pure virtual

Sets the edges per rotation of a pulse width sensor. (This should be set for tachometer use).

Parameters

pulseWidthPeriod_EdgesPerRot	edges per rotation
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigPulseWidthPeriod_FilterWindowSz()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigPulseWidthPeriod_FilterWindowSz	(	int	pulseWidthPeriod_FilterWindowSz,
		int	timeoutMs = `0`
	)

pure virtual

Sets the number of samples to use in smoothing a pulse width sensor with a rolling average. Default is 1 (no smoothing).

Parameters

pulseWidthPeriod_FilterWindowSz	samples for rolling avg
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigRemoteFeedbackFilter() [1/3]

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigRemoteFeedbackFilter	(	ctre::phoenix::motorcontrol::can::BaseTalon &	talonRef,
		int	remoteOrdinal,
		int	timeoutMs = `0`
	)

pure virtual

Select what remote device and signal to assign to Remote Sensor 0 or Remote Sensor 1. After binding a remote device and signal to Remote Sensor X, you may select Remote Sensor X as a PID source for closed-loop features.

Parameters

talonRef	Talon device reference to use.
remoteOrdinal	0 for configuring Remote Sensor 0, 1 for configuring Remote Sensor 1
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigRemoteFeedbackFilter() [2/3]

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigRemoteFeedbackFilter	(	ctre::phoenix::sensors::CANCoder &	canCoderRef,
		int	remoteOrdinal,
		int	timeoutMs = `0`
	)

pure virtual

Select what remote device and signal to assign to Remote Sensor 0 or Remote Sensor 1. After binding a remote device and signal to Remote Sensor X, you may select Remote Sensor X as a PID source for closed-loop features.

Parameters

canCoderRef	CANCoder device reference to use.
remoteOrdinal	0 for configuring Remote Sensor 0, 1 for configuring Remote Sensor 1
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigRemoteFeedbackFilter() [3/3]

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigRemoteFeedbackFilter	(	int	deviceID,
		RemoteSensorSource	remoteSensorSource,
		int	remoteOrdinal,
		int	timeoutMs = `0`
	)

pure virtual

Select what remote device and signal to assign to Remote Sensor 0 or Remote Sensor 1. After binding a remote device and signal to Remote Sensor X, you may select Remote Sensor X as a PID source for closed-loop features.

Parameters

deviceID	The device ID of the remote sensor device.
remoteSensorSource	The remote sensor device and signal type to bind.
remoteOrdinal	0 for configuring Remote Sensor 0, 1 for configuring Remote Sensor 1
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigRemoteSensorClosedLoopDisableNeutralOnLOS()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigRemoteSensorClosedLoopDisableNeutralOnLOS	(	bool	remoteSensorClosedLoopDisableNeutralOnLOS,
		int	timeoutMs = `0`
	)

pure virtual

Disables going to neutral (brake/coast) when a remote sensor is no longer detected.

Parameters

remoteSensorClosedLoopDisableNeutralOnLOS	disable going to neutral
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigReverseLimitSwitchSource()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigReverseLimitSwitchSource	(	RemoteLimitSwitchSource	type,
		LimitSwitchNormal	normalOpenOrClose,
		int	deviceID,
		int	timeoutMs = `0`
	)

pure virtual

Configures the reverse limit switch for a remote source. For example, a CAN motor controller may need to monitor the Limit-R pin of another Talon or CANifier.

Parameters

type	Remote limit switch source. User can choose between a remote Talon SRX, CANifier, or deactivate the feature.
normalOpenOrClose	Setting for normally open, normally closed, or disabled. This setting matches the Phoenix Tuner drop down.
deviceID	Device ID of remote source (Talon SRX or CANifier device ID).
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseTalon, ctre::phoenix::motorcontrol::can::BaseMotorController, and ctre::phoenix::motorcontrol::IMotorControllerEnhanced.

◆ ConfigReverseSoftLimitEnable()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigReverseSoftLimitEnable	(	bool	enable,
		int	timeoutMs = `0`
	)

pure virtual

Configures the reverse soft limit enable.

Parameters

enable	Reverse Sensor Position Limit Enable.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigReverseSoftLimitThreshold()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigReverseSoftLimitThreshold	(	double	reverseSensorLimit,
		int	timeoutMs = `0`
	)

pure virtual

Configures the reverse soft limit threshold.

Parameters

reverseSensorLimit	Reverse Sensor Position Limit (in raw sensor units).
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigSelectedFeedbackCoefficient()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigSelectedFeedbackCoefficient	(	double	coefficient,
		int	pidIdx = `0`,
		int	timeoutMs = `0`
	)

pure virtual

The Feedback Coefficient is a scalar applied to the value of the feedback sensor. Useful when you need to scale your sensor values within the closed-loop calculations. Default value is 1.

Selected Feedback Sensor register in firmware is the decoded sensor value multiplied by the Feedback Coefficient.

Parameters

coefficient	Feedback Coefficient value. Maximum value of 1. Resolution is 1/(2^16). Cannot be 0.
pidIdx	0 for Primary closed-loop. 1 for auxiliary closed-loop.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigSelectedFeedbackSensor()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigSelectedFeedbackSensor	(	RemoteFeedbackDevice	feedbackDevice,
		int	pidIdx = `0`,
		int	timeoutMs = `0`
	)

pure virtual

Select the remote feedback device for the motor controller. Most CTRE CAN motor controllers will support remote sensors over CAN.

Parameters

feedbackDevice	Remote Feedback Device to select.
pidIdx	0 for Primary closed-loop. 1 for auxiliary closed-loop.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::TalonSRX, ctre::phoenix::motorcontrol::can::BaseMotorController, ctre::phoenix::motorcontrol::can::BaseTalon, ctre::phoenix::motorcontrol::can::TalonFX, ctre::phoenix::motorcontrol::can::WPI_TalonFX, ctre::phoenix::motorcontrol::can::WPI_TalonSRX, ctre::phoenix::motorcontrol::can::WPI_VictorSPX, and ctre::phoenix::motorcontrol::IMotorControllerEnhanced.

◆ ConfigSensorTerm()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigSensorTerm	(	SensorTerm	sensorTerm,
		FeedbackDevice	feedbackDevice,
		int	timeoutMs = `0`
	)

pure virtual

Select what sensor term should be bound to switch feedback device. Sensor Sum = Sensor Sum Term 0 - Sensor Sum Term 1 Sensor Difference = Sensor Diff Term 0 - Sensor Diff Term 1 The four terms are specified with this routine. Then Sensor Sum/Difference can be selected for closed-looping.

Parameters

sensorTerm	Which sensor term to bind to a feedback source.
feedbackDevice	The sensor signal to attach to sensorTerm.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigSetCustomParam()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigSetCustomParam	(	int	newValue,
		int	paramIndex,
		int	timeoutMs = `0`
	)

pure virtual

Sets the value of a custom parameter. This is for arbitrary use.

Sometimes it is necessary to save calibration/limit/target information in the device. Particularly if the device is part of a subsystem that can be replaced.

Parameters

newValue	Value for custom parameter.
paramIndex	Index of custom parameter [0,1]
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigSetParameter()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigSetParameter	(	ParamEnum	param,
		double	value,
		uint8_t	subValue,
		int	ordinal,
		int	timeoutMs = `0`
	)

pure virtual

Sets a parameter. Generally this is not used. This can be utilized in - Using new features without updating API installation. - Errata workarounds to circumvent API implementation. - Allows for rapid testing / unit testing of firmware.

Parameters

param	Parameter enumeration.
value	Value of parameter.
subValue	Subvalue for parameter. Maximum value of 255.
ordinal	Ordinal of parameter.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigSoftLimitDisableNeutralOnLOS()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigSoftLimitDisableNeutralOnLOS	(	bool	softLimitDisableNeutralOnLOS,
		int	timeoutMs = `0`
	)

pure virtual

Disables soft limits triggering (if enabled) when the sensor is no longer detected.

Parameters

softLimitDisableNeutralOnLOS	disable triggering
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigVoltageCompSaturation()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigVoltageCompSaturation	(	double	voltage,
		int	timeoutMs = `0`
	)

pure virtual

Configures the Voltage Compensation saturation voltage.

Parameters

voltage	This is the max voltage to apply to the hbridge when voltage compensation is enabled. For example, if 10 (volts) is specified and a TalonSRX is commanded to 0.5 (PercentOutput, closed-loop, etc) then the TalonSRX will attempt to apply a duty-cycle to produce 5V.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ConfigVoltageMeasurementFilter()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::ConfigVoltageMeasurementFilter	(	int	filterWindowSamples,
		int	timeoutMs = `0`
	)

pure virtual

Configures the voltage measurement filter.

Parameters

filterWindowSamples	Number of samples in the rolling average of voltage measurement.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ EnableVoltageCompensation()

virtual void ctre::phoenix::motorcontrol::IMotorController::EnableVoltageCompensation ( bool enable )

pure virtual

Enables voltage compensation. If enabled, voltage compensation works in all control modes.

Be sure to configure the saturation voltage before enabling this.

Parameters

enable Enable state of voltage compensation.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetActiveTrajectoryArbFeedFwd()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetActiveTrajectoryArbFeedFwd ( int pidIdx = 0 )

pure virtual

Gets the active trajectory arbitrary feedforward using MotionMagic/MotionProfile control modes.

Parameters

pidIdx 0 for Primary closed-loop. 1 for auxiliary closed-loop.

Returns: The Active Trajectory ArbFeedFwd in units of percent output (where 0.01 is 1%).

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetActiveTrajectoryPosition()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetActiveTrajectoryPosition ( int pidIdx = 0 )

pure virtual

Gets the active trajectory target position for using MotionMagic/MotionProfile control modes.

Parameters

pidIdx 0 for Primary closed-loop. 1 for auxiliary closed-loop.

Returns: The Active Trajectory Position in sensor units.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetActiveTrajectoryVelocity()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetActiveTrajectoryVelocity ( int pidIdx = 0 )

pure virtual

Gets the active trajectory target velocity for using MotionMagic/MotionProfile control modes.

Parameters

pidIdx 0 for Primary closed-loop. 1 for auxiliary closed-loop.

Returns: The Active Trajectory Velocity in sensor units per 100ms.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetBaseID()

virtual int ctre::phoenix::motorcontrol::IMotorController::GetBaseID ( )

pure virtual

Returns: BaseID of device

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetBusVoltage()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetBusVoltage ( )

pure virtual

Gets the bus voltage seen by the device.

Returns: The bus voltage value (in volts).

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetClosedLoopError()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetClosedLoopError ( int pidIdx = 0 )

pure virtual

Gets the closed-loop error. The units depend on which control mode is in use.

If closed-loop is seeking a target sensor position, closed-loop error is the difference between target and current sensor value (in sensor units. Example 4096 units per rotation for CTRE Mag Encoder).

If closed-loop is seeking a target sensor velocity, closed-loop error is the difference between target and current sensor value (in sensor units per 100ms).

If using motion profiling or Motion Magic, closed loop error is calculated against the current target, and not the "final" target at the end of the profile/movement.

See Phoenix-Documentation information on units.

Parameters

pidIdx 0 for Primary closed-loop. 1 for auxiliary closed-loop.

Returns: Closed-loop error value.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetClosedLoopTarget()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetClosedLoopTarget ( int pidIdx = 0 )

pure virtual

Gets the current target of a given closed loop.

Parameters

pidIdx 0 for Primary closed-loop. 1 for auxiliary closed-loop.

Returns: The closed loop target.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetControlMode()

virtual ControlMode ctre::phoenix::motorcontrol::IMotorController::GetControlMode ( )

pure virtual

Returns: control mode motor controller is in

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetDeviceID()

virtual int ctre::phoenix::motorcontrol::IMotorController::GetDeviceID ( )

pure virtual

Returns the Device ID

Returns: Device number.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetErrorDerivative()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetErrorDerivative ( int pidIdx = 0 )

pure virtual

Gets the derivative of the closed-loop error.

Parameters

pidIdx 0 for Primary closed-loop. 1 for auxiliary closed-loop.

Returns: The error derivative value.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetFaults()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::GetFaults ( Faults & toFill )

pure virtual

Polls the various fault flags.

Parameters

toFill Caller's object to fill with latest fault flags.

Returns: Last Error Code generated by a function.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetFirmwareVersion()

virtual int ctre::phoenix::motorcontrol::IMotorController::GetFirmwareVersion ( )

pure virtual

Gets the firmware version of the device.

Returns: Firmware version of device. For example: version 1-dot-2 is 0x0102.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetIntegralAccumulator()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetIntegralAccumulator ( int pidIdx = 0 )

pure virtual

Gets the iaccum value.

Parameters

pidIdx 0 for Primary closed-loop. 1 for auxiliary closed-loop.

Returns: Integral accumulator value (Closed-loop error X 1ms).

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetInverted()

virtual bool ctre::phoenix::motorcontrol::IMotorController::GetInverted ( ) const

pure virtual

Returns: invert setting of motor output.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController, and ctre::phoenix::motorcontrol::can::WPI_BaseMotorController.

◆ GetLastError()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::GetLastError ( )

pure virtual

Gets the last error generated by this object. Not all functions return an error code but can potentially report errors. This function can be used to retrieve those error codes.

Returns: Last Error Code generated by a function.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetMotionProfileStatus()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::GetMotionProfileStatus ( ctre::phoenix::motion::MotionProfileStatus & statusToFill )

pure virtual

Retrieve all status information. For best performance, Caller can snapshot all status information regarding the motion profile executer.

Parameters

statusToFill Caller supplied object to fill.

The members are filled, as follows...

topBufferRem: The available empty slots in the trajectory buffer. The robot API holds a "top buffer" of trajectory points, so your applicaion can dump several points at once. The API will then stream them into the low-level buffer, allowing the motor controller to act on them.

topBufferRem: The number of points in the top trajectory buffer.

btmBufferCnt: The number of points in the low level controller buffer.

hasUnderrun: Set if isUnderrun ever gets set. Can be manually cleared by clearMotionProfileHasUnderrun() or automatically cleared by startMotionProfile().

isUnderrun: This is set if controller needs to shift a point from its buffer into the active trajectory point however the buffer is empty. This gets cleared automatically when is resolved.

activePointValid: True if the active trajectory point is not empty, false otherwise. The members in activePoint are only valid if this signal is set.

isLast: is set/cleared based on the MP executer's current trajectory point's IsLast value. This assumes IsLast was set when PushMotionProfileTrajectory was used to insert the currently processed trajectory point.

profileSlotSelect: The currently processed trajectory point's selected slot. This can differ in the currently selected slot used for Position and Velocity servo modes

outputEnable: The current output mode of the motion profile executer (disabled, enabled, or hold). When changing the set() value in MP mode, it's important to check this signal to confirm the change takes effect before interacting with the top buffer.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetMotionProfileTopLevelBufferCount()

virtual int ctre::phoenix::motorcontrol::IMotorController::GetMotionProfileTopLevelBufferCount ( )

pure virtual

Retrieve just the buffer count for the api-level (top) buffer. This routine performs no CAN or data structure lookups, so its fast and ideal if caller needs to quickly poll the progress of trajectory points being emptied into controller's RAM. Otherwise just use GetMotionProfileStatus.

Returns: number of trajectory points in the top buffer.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetMotorOutputPercent()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetMotorOutputPercent ( )

pure virtual

Gets the output percentage of the motor controller.

Returns: Output of the motor controller (in percent).

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetMotorOutputVoltage()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetMotorOutputVoltage ( )

pure virtual

Returns: applied voltage to motor in volts.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetSelectedSensorPosition()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetSelectedSensorPosition ( int pidIdx = 0 )

pure virtual

Get the selected sensor position (in raw sensor units).

Parameters

pidIdx 0 for Primary closed-loop. 1 for auxiliary closed-loop. See Phoenix-Documentation for how to interpret.

Returns: Position of selected sensor (in raw sensor units).

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetSelectedSensorVelocity()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetSelectedSensorVelocity ( int pidIdx = 0 )

pure virtual

Get the selected sensor velocity.

Parameters

pidIdx 0 for Primary closed-loop. 1 for auxiliary closed-loop.

Returns: selected sensor (in raw sensor units) per 100ms. See Phoenix-Documentation for how to interpret.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetStatusFramePeriod()

virtual int ctre::phoenix::motorcontrol::IMotorController::GetStatusFramePeriod	(	StatusFrame	frame,
		int	timeoutMs = `0`
	)

pure virtual

Gets the period of the given status frame.

Parameters

frame	Frame to get the period of.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Period of the given status frame.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController, ctre::phoenix::motorcontrol::can::BaseTalon, and ctre::phoenix::motorcontrol::IMotorControllerEnhanced.

◆ GetStickyFaults()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::GetStickyFaults ( StickyFaults & toFill )

pure virtual

Polls the various sticky fault flags.

Parameters

toFill Caller's object to fill with latest sticky fault flags.

Returns: Last Error Code generated by a function.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ GetTemperature()

virtual double ctre::phoenix::motorcontrol::IMotorController::GetTemperature ( )

pure virtual

Gets the temperature of the motor controller.

Returns: Temperature of the motor controller (in 'C)

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ HasResetOccurred()

virtual bool ctre::phoenix::motorcontrol::IMotorController::HasResetOccurred ( )

pure virtual

Returns true if the device has reset since last call.

Returns: Has a Device Reset Occurred?

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ IsMotionProfileTopLevelBufferFull()

virtual bool ctre::phoenix::motorcontrol::IMotorController::IsMotionProfileTopLevelBufferFull ( )

pure virtual

Retrieve just the buffer full for the api-level (top) buffer. This routine performs no CAN or data structure lookups, so its fast and ideal if caller needs to quickly poll. Otherwise just use GetMotionProfileStatus.

Returns: number of trajectory points in the top buffer.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ IsVoltageCompensationEnabled()

virtual bool ctre::phoenix::motorcontrol::IMotorController::IsVoltageCompensationEnabled ( )

pure virtual

Returns the enable state of Voltage Compensation that the caller has set.

Returns: TRUE if voltage compensation is enabled.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ NeutralOutput()

virtual void ctre::phoenix::motorcontrol::IMotorController::NeutralOutput ( )

pure virtual

Neutral the motor output by setting control mode to disabled.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ OverrideLimitSwitchesEnable()

virtual void ctre::phoenix::motorcontrol::IMotorController::OverrideLimitSwitchesEnable ( bool enable )

pure virtual

Sets the enable state for limit switches.

Parameters

enable Enable state for limit switches.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ OverrideSoftLimitsEnable()

virtual void ctre::phoenix::motorcontrol::IMotorController::OverrideSoftLimitsEnable ( bool enable )

pure virtual

Can be used to override-disable the soft limits. This function can be used to quickly disable soft limits without having to modify the persistent configuration.

Parameters

enable Enable state for soft limit switches.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ ProcessMotionProfileBuffer()

virtual void ctre::phoenix::motorcontrol::IMotorController::ProcessMotionProfileBuffer ( )

pure virtual

This must be called periodically to funnel the trajectory points from the API's top level buffer to the controller's bottom level buffer. Recommendation is to call this twice as fast as the execution rate of the motion profile. So if MP is running with 20ms trajectory points, try calling this routine every 10ms. All motion profile functions are thread-safe through the use of a mutex, so there is no harm in having the caller utilize threading.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ PushMotionProfileTrajectory()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::PushMotionProfileTrajectory ( const ctre::phoenix::motion::TrajectoryPoint & trajPt )

pure virtual

Push another trajectory point into the top level buffer (which is emptied into the motor controller's bottom buffer as room allows).

Parameters

trajPt

to push into buffer. The members should be filled in with these values...

targPos: servo position in sensor units.
targVel: velocity to feed-forward in sensor units
per 100ms.
profileSlotSelect0 Which slot to get PIDF gains. PID is used for position servo. F is used
as the Kv constant for velocity feed-forward. Typically this is hardcoded
to the a particular slot, but you are free gain schedule if need be.
Choose from [0,3]
profileSlotSelect1 Which slot to get PIDF gains for auxiliary PId.
This only has impact during MotionProfileArc Control mode.
Choose from [0,1].
isLastPoint set to nonzero to signal motor controller to keep processing this
trajectory point, instead of jumping to the next one
when timeDurMs expires. Otherwise MP executer will
eventually see an empty buffer after the last point
expires, causing it to assert the IsUnderRun flag.
However this may be desired if calling application
never wants to terminate the MP.
zeroPos set to nonzero to signal motor controller to "zero" the selected
position sensor before executing this trajectory point.
Typically the first point should have this set only thus
allowing the remainder of the MP positions to be relative to
zero.
timeDur Duration to apply this trajectory pt.
This time unit is ADDED to the exising base time set by
configMotionProfileTrajectoryPeriod().

Returns: CTR_OKAY if trajectory point push ok. ErrorCode if buffer is full due to kMotionProfileTopBufferCapacity.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ SelectProfileSlot()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::SelectProfileSlot	(	int	slotIdx,
		int	pidIdx
	)

pure virtual

Selects which profile slot to use for closed-loop control.

Parameters

slotIdx	Profile slot to select.
pidIdx	0 for Primary closed-loop. 1 for auxiliary closed-loop.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ Set() [1/2]

virtual void ctre::phoenix::motorcontrol::IMotorController::Set	(	ControlMode	Mode,
		double	demand
	)

pure virtual

Sets the appropriate output on the talon, depending on the mode.

Parameters

Mode	The output mode to apply. In PercentOutput, the output is between -1.0 and 1.0, with 0.0 as stopped. In Current mode, output value is in amperes. In Velocity mode, output value is in position change / 100ms. In Position mode, output value is in encoder ticks or an analog value, depending on the sensor. In Follower mode, the output value is the integer device ID of the talon to duplicate.
demand	The setpoint value, as described above.

Standard Driving Example: _talonLeft.set(ControlMode.PercentOutput, leftJoy); _talonRght.set(ControlMode.PercentOutput, rghtJoy);

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController, ctre::phoenix::motorcontrol::can::TalonFX, ctre::phoenix::motorcontrol::can::TalonSRX, ctre::phoenix::motorcontrol::can::WPI_BaseMotorController, ctre::phoenix::motorcontrol::can::WPI_TalonFX, ctre::phoenix::motorcontrol::can::WPI_TalonSRX, ctre::phoenix::motorcontrol::can::WPI_VictorSPX, and ctre::phoenix::motorcontrol::can::VictorSPX.

◆ Set() [2/2]

virtual void ctre::phoenix::motorcontrol::IMotorController::Set	(	ControlMode	mode,
		double	demand0,
		DemandType	demand1Type,
		double	demand1
	)

pure virtual

Parameters

mode	Sets the appropriate output on the talon, depending on the mode.
demand0	The output value to apply. such as advanced feed forward and/or auxiliary close-looping in firmware. In PercentOutput, the output is between -1.0 and 1.0, with 0.0 as stopped. In Current mode, output value is in amperes. In Velocity mode, output value is in position change / 100ms. In Position mode, output value is in encoder ticks or an analog value, depending on the sensor. See In Follower mode, the output value is the integer device ID of the talon to duplicate.
demand1Type	The demand type for demand1. Neutral: Ignore demand1 and apply no change to the demand0 output. AuxPID: Use demand1 to set the target for the auxiliary PID 1. ArbitraryFeedForward: Use demand1 as an arbitrary additive value to the demand0 output. In PercentOutput the demand0 output is the motor output, and in closed-loop modes the demand0 output is the output of PID0.
demand1	Supplmental output value. Units match the set mode.

Arcade Drive Example: _talonLeft.set(ControlMode.PercentOutput, joyForward, DemandType.ArbitraryFeedForward, +joyTurn); _talonRght.set(ControlMode.PercentOutput, joyForward, DemandType.ArbitraryFeedForward, -joyTurn);

Drive Straight Example: Note: Selected Sensor Configuration is necessary for both PID0 and PID1. _talonLeft.follow(_talonRght, FollwerType.AuxOutput1); _talonRght.set(ControlMode.PercentOutput, joyForward, DemandType.AuxPID, desiredRobotHeading);

Drive Straight to a Distance Example: Note: Other configurations (sensor selection, PID gains, etc.) need to be set. _talonLeft.follow(_talonRght, FollwerType.AuxOutput1); _talonRght.set(ControlMode.MotionMagic, targetDistance, DemandType.AuxPID, desiredRobotHeading);

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController, ctre::phoenix::motorcontrol::can::TalonFX, ctre::phoenix::motorcontrol::can::TalonSRX, ctre::phoenix::motorcontrol::can::WPI_BaseMotorController, ctre::phoenix::motorcontrol::can::WPI_TalonFX, ctre::phoenix::motorcontrol::can::WPI_TalonSRX, ctre::phoenix::motorcontrol::can::WPI_VictorSPX, and ctre::phoenix::motorcontrol::can::VictorSPX.

◆ SetControlFramePeriod()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::SetControlFramePeriod	(	ControlFrame	frame,
		int	periodMs
	)

pure virtual

Sets the period of the given control frame.

Parameters

frame	Frame whose period is to be changed.
periodMs	Period in ms for the given frame.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ SetIntegralAccumulator()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::SetIntegralAccumulator	(	double	iaccum,
		int	pidIdx = `0`,
		int	timeoutMs = `0`
	)

pure virtual

Sets the integral accumulator. Typically this is used to clear/zero the integral accumulator, however some use cases may require seeding the accumulator for a faster response.

Parameters

iaccum	Value to set for the integral accumulator (closed loop error units X 1ms).
pidIdx	0 for Primary closed-loop. 1 for auxiliary closed-loop.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ SetInverted() [1/2]

virtual void ctre::phoenix::motorcontrol::IMotorController::SetInverted ( bool invert )

pure virtual

Inverts the hbridge output of the motor controller.

This does not impact sensor phase and should not be used to correct sensor polarity.

This will invert the hbridge output but NOT the LEDs. This ensures....

Green LEDs always represents positive request from robot-controller/closed-looping mode.
Green LEDs correlates to forward limit switch.
Green LEDs correlates to forward soft limit.

Parameters

invert Invert state to set.

Implemented in ctre::phoenix::motorcontrol::can::TalonFX, ctre::phoenix::motorcontrol::can::WPI_TalonFX, ctre::phoenix::motorcontrol::can::WPI_TalonSRX, ctre::phoenix::motorcontrol::can::WPI_VictorSPX, ctre::phoenix::motorcontrol::can::BaseMotorController, and ctre::phoenix::motorcontrol::can::WPI_BaseMotorController.

◆ SetInverted() [2/2]

virtual void ctre::phoenix::motorcontrol::IMotorController::SetInverted ( InvertType invertType )

pure virtual

Inverts the hbridge output of the motor controller in relation to the master if present

This does not impact sensor phase and should not be used to correct sensor polarity.

This will allow you to either:

Not invert the motor
Invert the motor
Always follow the master regardless of master's inversion
Always oppose the master regardless of master's inversion

Parameters

invertType Invert state to set.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController, ctre::phoenix::motorcontrol::can::TalonFX, ctre::phoenix::motorcontrol::can::WPI_BaseMotorController, ctre::phoenix::motorcontrol::can::WPI_TalonFX, ctre::phoenix::motorcontrol::can::WPI_TalonSRX, and ctre::phoenix::motorcontrol::can::WPI_VictorSPX.

◆ SetNeutralMode()

virtual void ctre::phoenix::motorcontrol::IMotorController::SetNeutralMode ( NeutralMode neutralMode )

pure virtual

Sets the mode of operation during neutral throttle output.

Parameters

neutralMode The desired mode of operation when the Controller output throttle is neutral (ie brake/coast)

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ SetSelectedSensorPosition()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::SetSelectedSensorPosition	(	double	sensorPos,
		int	pidIdx = `0`,
		int	timeoutMs = `50`
	)

pure virtual

Sets the sensor position to the given value.

Parameters

sensorPos	Position to set for the selected sensor (in raw sensor units).
pidIdx	0 for Primary closed-loop. 1 for auxiliary closed-loop.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ SetSensorPhase()

virtual void ctre::phoenix::motorcontrol::IMotorController::SetSensorPhase ( bool PhaseSensor )

pure virtual

Sets the phase of the sensor. Use when controller forward/reverse output doesn't correlate to appropriate forward/reverse reading of sensor. Pick a value so that positive PercentOutput yields a positive change in sensor. After setting this, user can freely call SetInverted() with any value.

Parameters

PhaseSensor Indicates whether to invert the phase of the sensor.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController.

◆ SetStatusFramePeriod()

virtual ErrorCode ctre::phoenix::motorcontrol::IMotorController::SetStatusFramePeriod	(	StatusFrame	frame,
		uint8_t	periodMs,
		int	timeoutMs = `0`
	)

pure virtual

Sets the period of the given status frame.

User ensure CAN Bus utilization is not high.

This setting is not persistent and is lost when device is reset. If this is a concern, calling application can use HasResetOccurred() to determine if the status frame needs to be reconfigured.

Parameters

frame	Frame whose period is to be changed.
periodMs	Period in ms for the given frame.
timeoutMs	Timeout value in ms. If nonzero, function will wait for config success and report an error if it times out. If zero, no blocking or checking is performed.

Returns: Error Code generated by function. 0 indicates no error.

Implemented in ctre::phoenix::motorcontrol::can::BaseMotorController, ctre::phoenix::motorcontrol::can::BaseTalon, and ctre::phoenix::motorcontrol::IMotorControllerEnhanced.

The documentation for this class was generated from the following file:

Phoenix-api/cpp/src/main/native/include/ctre/phoenix/motorcontrol/IMotorController.h

Public Member Functions

Detailed Description

Member Function Documentation

◆ ChangeMotionControlFramePeriod()

◆ ClearMotionProfileHasUnderrun()

◆ ClearMotionProfileTrajectories()

◆ ClearStickyFaults()

◆ Config_IntegralZone()

◆ Config_kD()

◆ Config_kF()

◆ Config_kI()

◆ Config_kP()

◆ ConfigAllowableClosedloopError()

◆ ConfigAuxPIDPolarity()

◆ ConfigClearPositionOnLimitF()

◆ ConfigClearPositionOnLimitR()

◆ ConfigClearPositionOnQuadIdx()

◆ ConfigClosedLoopPeakOutput()

◆ ConfigClosedLoopPeriod()

◆ ConfigClosedloopRamp()

◆ ConfigFactoryDefault()

◆ ConfigFeedbackNotContinuous()

◆ ConfigForwardLimitSwitchSource()

◆ ConfigForwardSoftLimitEnable()

◆ ConfigForwardSoftLimitThreshold()

◆ ConfigGetCustomParam()

◆ ConfigGetParameter()

◆ ConfigLimitSwitchDisableNeutralOnLOS()

◆ ConfigMaxIntegralAccumulator()

◆ ConfigMotionAcceleration()

◆ ConfigMotionCruiseVelocity()

◆ ConfigMotionProfileTrajectoryPeriod()

◆ ConfigMotionSCurveStrength()

◆ ConfigNeutralDeadband()

◆ ConfigNominalOutputForward()

◆ ConfigNominalOutputReverse()

◆ ConfigOpenloopRamp()

◆ ConfigPeakOutputForward()

◆ ConfigPeakOutputReverse()

◆ ConfigPulseWidthPeriod_EdgesPerRot()

◆ ConfigPulseWidthPeriod_FilterWindowSz()

◆ ConfigRemoteFeedbackFilter() [1/3]

◆ ConfigRemoteFeedbackFilter() [2/3]

◆ ConfigRemoteFeedbackFilter() [3/3]

◆ ConfigRemoteSensorClosedLoopDisableNeutralOnLOS()

◆ ConfigReverseLimitSwitchSource()

◆ ConfigReverseSoftLimitEnable()

◆ ConfigReverseSoftLimitThreshold()

◆ ConfigSelectedFeedbackCoefficient()

◆ ConfigSelectedFeedbackSensor()

◆ ConfigSensorTerm()

◆ ConfigSetCustomParam()

◆ ConfigSetParameter()

◆ ConfigSoftLimitDisableNeutralOnLOS()

◆ ConfigVoltageCompSaturation()

◆ ConfigVoltageMeasurementFilter()

◆ EnableVoltageCompensation()

◆ GetActiveTrajectoryArbFeedFwd()

◆ GetActiveTrajectoryPosition()

◆ GetActiveTrajectoryVelocity()

◆ GetBaseID()

◆ GetBusVoltage()

◆ GetClosedLoopError()

◆ GetClosedLoopTarget()

◆ GetControlMode()

◆ GetDeviceID()

◆ GetErrorDerivative()

◆ GetFaults()

◆ GetFirmwareVersion()

◆ GetIntegralAccumulator()

◆ GetInverted()

◆ GetLastError()

◆ GetMotionProfileStatus()

◆ GetMotionProfileTopLevelBufferCount()

◆ GetMotorOutputPercent()

◆ GetMotorOutputVoltage()

◆ GetSelectedSensorPosition()

◆ GetSelectedSensorVelocity()

◆ GetStatusFramePeriod()

◆ GetStickyFaults()