#include <motorGroup.hpp>

Inheritance diagram for okapi::MotorGroup:

Public Member Functions
	MotorGroup (const std::initializer_list< Motor > &imotors, const std::shared_ptr< Logger > &ilogger=Logger::getDefaultLogger())
	A group of V5 motors which act as one motor (i.e.

	MotorGroup (const std::initializer_list< std::shared_ptr< AbstractMotor > > &imotors, const std::shared_ptr< Logger > &ilogger=Logger::getDefaultLogger())
	A group of V5 motors which act as one motor (i.e.

std::int32_t	moveAbsolute (double iposition, std::int32_t ivelocity) override
	Motor movement functions

std::int32_t	moveRelative (double iposition, std::int32_t ivelocity) override
	Sets the relative target position for the motor to move to.

std::int32_t	moveVelocity (std::int16_t ivelocity) override
	Sets the velocity for the motor.

std::int32_t	moveVoltage (std::int16_t ivoltage) override
	Sets the voltage for the motor from `-12000` to `12000`.

std::int32_t	modifyProfiledVelocity (std::int32_t ivelocity) override
	Changes the output velocity for a profiled movement (moveAbsolute or moveRelative).

double	getTargetPosition () override
	Motor telemetry functions

double	getPosition () override
	Gets the absolute position of the motor in its encoder units.

std::int32_t	tarePosition () override
	Sets the "absolute" zero position of the motor to its current position.

std::int32_t	getTargetVelocity () override
	Gets the velocity commanded to the motor by the user.

double	getActualVelocity () override
	Gets the actual velocity of the motor.

std::int32_t	getCurrentDraw () override
	Gets the current drawn by the motor in mA.

std::int32_t	getDirection () override
	Gets the direction of movement for the motor.

double	getEfficiency () override
	Gets the efficiency of the motor in percent.

std::int32_t	isOverCurrent () override
	Checks if the motor is drawing over its current limit.

std::int32_t	isOverTemp () override
	Checks if the motor's temperature is above its limit.

std::int32_t	isStopped () override
	Checks if the motor is stopped.

std::int32_t	getZeroPositionFlag () override
	Checks if the motor is at its zero position.

uint32_t	getFaults () override
	Gets the faults experienced by the motor.

uint32_t	getFlags () override
	Gets the flags set by the motor's operation.

std::int32_t	getRawPosition (std::uint32_t *timestamp) override
	Gets the raw encoder count of the motor at a given timestamp.

double	getPower () override
	Gets the power drawn by the motor in Watts.

double	getTemperature () override
	Gets the temperature of the motor in degrees Celsius.

double	getTorque () override
	Gets the torque generated by the motor in Newton Metres (Nm).

std::int32_t	getVoltage () override
	Gets the voltage delivered to the motor in millivolts.

std::int32_t	setBrakeMode (AbstractMotor::brakeMode imode) override
	Motor configuration functions

brakeMode	getBrakeMode () override
	Gets the brake mode that was set for the motor.

std::int32_t	setCurrentLimit (std::int32_t ilimit) override
	Sets the current limit for the motor in mA.

std::int32_t	getCurrentLimit () override
	Gets the current limit for the motor in mA.

std::int32_t	setEncoderUnits (AbstractMotor::encoderUnits iunits) override
	Sets one of AbstractMotor::encoderUnits for the motor encoder.

encoderUnits	getEncoderUnits () override
	Gets the encoder units that were set for the motor.

std::int32_t	setGearing (AbstractMotor::gearset igearset) override
	Sets one of AbstractMotor::gearset for the motor.

gearset	getGearing () override
	Gets the gearset that was set for the motor.

std::int32_t	setReversed (bool ireverse) override
	Sets the reverse flag for the motor.

std::int32_t	setVoltageLimit (std::int32_t ilimit) override
	Sets the voltage limit for the motor in Volts.

void	controllerSet (double ivalue) override
	Writes the value of the controller output.

size_t	getSize ()
	Gets the number of motors in the motor group.

std::shared_ptr< ContinuousRotarySensor >	getEncoder () override
	Get the encoder associated with the first motor in this group.

virtual std::shared_ptr< ContinuousRotarySensor >	getEncoder (std::size_t index)
	Get the encoder associated with this motor.

Public Member Functions inherited from okapi::AbstractMotor
virtual	~AbstractMotor ()

double	getPositionError ()
	Gets the positional error (target position minus actual position) of the motor in its encoder units.

double	getVelocityError ()
	Gets the difference between the target velocity of the motor and the actual velocity of the motor.

Protected Attributes
std::vector< std::shared_ptr< AbstractMotor > >	motors

Additional Inherited Members
Public Types inherited from okapi::AbstractMotor
enum class	brakeMode { coast = 0 , brake = 1 , hold = 2 , invalid = INT32_MAX }
	Indicates the 'brake mode' of a motor. More...

enum class	encoderUnits { degrees = 0 , rotations = 1 , counts = 2 , invalid = INT32_MAX }
	Indicates the units used by the motor encoders. More...

enum class	gearset { red = 100 , green = 200 , blue = 600 , invalid = INT32_MAX }
	Indicates the internal gear ratio of a motor. More...

Detailed Description

Definition at line 15 of file motorGroup.hpp.

Constructor & Destructor Documentation

◆ MotorGroup() [1/2]

okapi::MotorGroup::MotorGroup	(	const std::initializer_list< Motor > &	imotors,
		const std::shared_ptr< Logger > &	ilogger = `Logger::getDefaultLogger()`
	)

A group of V5 motors which act as one motor (i.e.

they are mechanically linked). A MotorGroup requires at least one motor. If no motors are supplied, a std::invalid_argument exception is thrown.

Parameters

imotors	The motors in this group.
ilogger	The logger this instance will log initialization warnings to.

◆ MotorGroup() [2/2]

okapi::MotorGroup::MotorGroup	(	const std::initializer_list< std::shared_ptr< AbstractMotor > > &	imotors,
		const std::shared_ptr< Logger > &	ilogger = `Logger::getDefaultLogger()`
	)

A group of V5 motors which act as one motor (i.e.

they are mechanically linked). A MotorGroup requires at least one motor. If no motors are supplied, a std::invalid_argument exception is thrown.

Parameters

imotors	The motors in this group.
ilogger	The logger this instance will log initialization warnings to.

Member Function Documentation

◆ controllerSet()

void okapi::MotorGroup::controllerSet ( double ivalue )

overridevirtual

Writes the value of the controller output.

This method might be automatically called in another thread by the controller. The range of input values is expected to be [-1, 1].

Parameters

ivalue the controller's output in the range [-1, 1]

Implements okapi::ControllerOutput< double >.

◆ getActualVelocity()

double okapi::MotorGroup::getActualVelocity ( )

overridevirtual

Gets the actual velocity of the motor.

Returns: The motor's actual velocity in RPM or PROS_ERR_F if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getBrakeMode()

brakeMode okapi::MotorGroup::getBrakeMode ( )

overridevirtual

Gets the brake mode that was set for the motor.

Returns: One of brakeMode, according to what was set for the motor, or brakeMode::invalid if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getCurrentDraw()

std::int32_t okapi::MotorGroup::getCurrentDraw ( )

overridevirtual

Gets the current drawn by the motor in mA.

Returns: The motor's current in mA or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getCurrentLimit()

std::int32_t okapi::MotorGroup::getCurrentLimit ( )

overridevirtual

Gets the current limit for the motor in mA.

The default value is 2500 mA.

Returns: The motor's current limit in mA or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getDirection()

std::int32_t okapi::MotorGroup::getDirection ( )

overridevirtual

Gets the direction of movement for the motor.

Returns: 1 for moving in the positive direction, -1 for moving in the negative direction, and PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getEfficiency()

double okapi::MotorGroup::getEfficiency ( )

overridevirtual

Gets the efficiency of the motor in percent.

An efficiency of 100% means that the motor is moving electrically while drawing no electrical power, and an efficiency of 0% means that the motor is drawing power but not moving.

Returns: The motor's efficiency in percent or PROS_ERR_F if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getEncoder() [1/2]

std::shared_ptr< ContinuousRotarySensor > okapi::MotorGroup::getEncoder ( )

overridevirtual

Get the encoder associated with the first motor in this group.

Returns: The encoder for the motor at index 0.

Implements okapi::AbstractMotor.

◆ getEncoder() [2/2]

virtual std::shared_ptr< ContinuousRotarySensor > okapi::MotorGroup::getEncoder ( std::size_t index )

virtual

Get the encoder associated with this motor.

Parameters

index The index in motors to get the encoder from.

Returns: The encoder for the motor at index.

◆ getEncoderUnits()

encoderUnits okapi::MotorGroup::getEncoderUnits ( )

overridevirtual

Gets the encoder units that were set for the motor.

Returns: One of encoderUnits according to what is set for the motor or encoderUnits::invalid if the operation failed.

Implements okapi::AbstractMotor.

◆ getFaults()

uint32_t okapi::MotorGroup::getFaults ( )

overridevirtual

Gets the faults experienced by the motor.

Compare this bitfield to the bitmasks in pros::motor_fault_e_t.

Returns: A currently unknown bitfield containing the motor's faults. 0b00000100 = Current Limit Hit

Implements okapi::AbstractMotor.

◆ getFlags()

uint32_t okapi::MotorGroup::getFlags ( )

overridevirtual

Gets the flags set by the motor's operation.

Compare this bitfield to the bitmasks in pros::motor_flag_e_t.

Returns: A currently unknown bitfield containing the motor's flags. These seem to be unrelated to the individual get_specific_flag functions

Implements okapi::AbstractMotor.

◆ getGearing()

gearset okapi::MotorGroup::getGearing ( )

overridevirtual

Gets the gearset that was set for the motor.

Returns: One of gearset according to what is set for the motor, or gearset::invalid if the operation failed.

Implements okapi::AbstractMotor.

◆ getPosition()

double okapi::MotorGroup::getPosition ( )

overridevirtual

Gets the absolute position of the motor in its encoder units.

Returns: The motor's absolute position in its encoder units or PROS_ERR_F if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getPower()

double okapi::MotorGroup::getPower ( )

overridevirtual

Gets the power drawn by the motor in Watts.

Returns: The motor's power draw in Watts or PROS_ERR_F if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getRawPosition()

std::int32_t okapi::MotorGroup::getRawPosition ( std::uint32_t * timestamp )

overridevirtual

Gets the raw encoder count of the motor at a given timestamp.

Parameters

timestamp A pointer to a time in milliseconds for which the encoder count will be returned. If NULL, the timestamp at which the encoder count was read will not be supplied.

Returns: The raw encoder count at the given timestamp or PROS_ERR if the operation failed.

Implements okapi::AbstractMotor.

◆ getSize()

size_t okapi::MotorGroup::getSize ( )

Gets the number of motors in the motor group.

Returns: size_t

◆ getTargetPosition()

double okapi::MotorGroup::getTargetPosition ( )

overridevirtual

Motor telemetry functions

These functions allow programmers to collect telemetry from motors
Gets the target position set for the motor by the user.

Returns: The target position in its encoder units or PROS_ERR_F if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getTargetVelocity()

std::int32_t okapi::MotorGroup::getTargetVelocity ( )

overridevirtual

Gets the velocity commanded to the motor by the user.

Returns: The commanded motor velocity from +-100, +-200, or +-600, or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getTemperature()

double okapi::MotorGroup::getTemperature ( )

overridevirtual

Gets the temperature of the motor in degrees Celsius.

Returns: The motor's temperature in degrees Celsius or PROS_ERR_F if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getTorque()

double okapi::MotorGroup::getTorque ( )

overridevirtual

Gets the torque generated by the motor in Newton Metres (Nm).

Returns: The motor's torque in NM or PROS_ERR_F if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getVoltage()

std::int32_t okapi::MotorGroup::getVoltage ( )

overridevirtual

Gets the voltage delivered to the motor in millivolts.

Returns: The motor's voltage in V or PROS_ERR_F if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ getZeroPositionFlag()

std::int32_t okapi::MotorGroup::getZeroPositionFlag ( )

overridevirtual

Checks if the motor is at its zero position.

Although this function forwards data from the motor, the motor presently does not provide any value. This function returns PROS_ERR with errno set to ENOSYS.

Returns: 1 if the motor is at zero absolute position, 0 if the motor has moved from its absolute zero, or PROS_ERR if the operation failed, setting errno

Implements okapi::AbstractMotor.

◆ isOverCurrent()

std::int32_t okapi::MotorGroup::isOverCurrent ( )

overridevirtual

Checks if the motor is drawing over its current limit.

Returns: 1 if the motor's current limit is being exceeded and 0 if the current limit is not exceeded, or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ isOverTemp()

std::int32_t okapi::MotorGroup::isOverTemp ( )

overridevirtual

Checks if the motor's temperature is above its limit.

Returns: 1 if the temperature limit is exceeded and 0 if the the temperature is below the limit, or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ isStopped()

std::int32_t okapi::MotorGroup::isStopped ( )

overridevirtual

Checks if the motor is stopped.

Although this function forwards data from the motor, the motor presently does not provide any value. This function returns PROS_ERR with errno set to ENOSYS.

Returns: 1 if the motor is not moving, 0 if the motor is moving, or PROS_ERR if the operation failed, setting errno

Implements okapi::AbstractMotor.

◆ modifyProfiledVelocity()

std::int32_t okapi::MotorGroup::modifyProfiledVelocity ( std::int32_t ivelocity )

overridevirtual

Changes the output velocity for a profiled movement (moveAbsolute or moveRelative).

This will have no effect if the motor is not following a profiled movement.

Parameters

ivelocity The new motor velocity from +-100, +-200, or +-600 depending on the motor's gearset.

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ moveAbsolute()

std::int32_t okapi::MotorGroup::moveAbsolute	(	double	iposition,
		std::int32_t	ivelocity
	)

overridevirtual

Motor movement functions

These functions allow programmers to make motors move
Sets the target absolute position for the motor to move to.

This movement is relative to the position of the motor when initialized or the position when it was most recently reset with setZeroPosition().

Note: This function simply sets the target for the motor, it does not block program execution until the movement finishes.

Parameters

iposition	The absolute position to move to in the motor's encoder units
ivelocity	The maximum allowable velocity for the movement in RPM

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ moveRelative()

std::int32_t okapi::MotorGroup::moveRelative	(	double	iposition,
		std::int32_t	ivelocity
	)

overridevirtual

Sets the relative target position for the motor to move to.

This movement is relative to the current position of the motor. Providing 10.0 as the position parameter would result in the motor moving clockwise 10 units, no matter what the current position is.

Note: This function simply sets the target for the motor, it does not block program execution until the movement finishes.

Parameters

iposition	The relative position to move to in the motor's encoder units
ivelocity	The maximum allowable velocity for the movement in RPM

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ moveVelocity()

std::int32_t okapi::MotorGroup::moveVelocity ( std::int16_t ivelocity )

overridevirtual

Sets the velocity for the motor.

This velocity corresponds to different actual speeds depending on the gearset used for the motor. This results in a range of +-100 for pros::c::red, +-200 for green, and +-600 for blue. The velocity is held with PID to ensure consistent speed, as opposed to setting the motor's voltage.

Parameters

ivelocity The new motor velocity from -+-100, +-200, or +-600 depending on the motor's gearset

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ moveVoltage()

std::int32_t okapi::MotorGroup::moveVoltage ( std::int16_t ivoltage )

overridevirtual

Sets the voltage for the motor from -12000 to 12000.

Parameters

ivoltage The new voltage value from -12000 to 12000.

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ setBrakeMode()

std::int32_t okapi::MotorGroup::setBrakeMode ( AbstractMotor::brakeMode imode )

overridevirtual

Motor configuration functions

These functions allow programmers to configure the behavior of motors
Sets one of AbstractMotor::brakeMode to the motor.

This function uses the following values of errno when an error state is reached: EACCES - Another resource is currently trying to access the port.

Parameters

imode The new motor brake mode to set for the motor.

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ setCurrentLimit()

std::int32_t okapi::MotorGroup::setCurrentLimit ( std::int32_t ilimit )

overridevirtual

Sets the current limit for the motor in mA.

This function uses the following values of errno when an error state is reached: EACCES - Another resource is currently trying to access the port.

Parameters

ilimit The new current limit in mA.

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ setEncoderUnits()

std::int32_t okapi::MotorGroup::setEncoderUnits ( AbstractMotor::encoderUnits iunits )

overridevirtual

Sets one of AbstractMotor::encoderUnits for the motor encoder.

Parameters

iunits The new motor encoder units.

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ setGearing()

std::int32_t okapi::MotorGroup::setGearing ( AbstractMotor::gearset igearset )

overridevirtual

Sets one of AbstractMotor::gearset for the motor.

Parameters

igearset The new motor gearset.

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ setReversed()

std::int32_t okapi::MotorGroup::setReversed ( bool ireverse )

overridevirtual

Sets the reverse flag for the motor.

This will invert its movements and the values returned for its position.

Parameters

ireverse True reverses the motor, false is default.

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ setVoltageLimit()

std::int32_t okapi::MotorGroup::setVoltageLimit ( std::int32_t ilimit )

overridevirtual

Sets the voltage limit for the motor in Volts.

Parameters

ilimit The new voltage limit in Volts.

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

◆ tarePosition()

std::int32_t okapi::MotorGroup::tarePosition ( )

overridevirtual

Sets the "absolute" zero position of the motor to its current position.

Returns: 1 if the operation was successful or PROS_ERR if the operation failed, setting errno.

Implements okapi::AbstractMotor.

Member Data Documentation

◆ motors

std::vector<std::shared_ptr<AbstractMotor> > okapi::MotorGroup::motors

protected

Definition at line 398 of file motorGroup.hpp.

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

include/okapi/impl/device/motor/motorGroup.hpp

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ MotorGroup() [1/2]

◆ MotorGroup() [2/2]

Member Function Documentation

◆ controllerSet()

◆ getActualVelocity()

◆ getBrakeMode()

◆ getCurrentDraw()

◆ getCurrentLimit()

◆ getDirection()

◆ getEfficiency()

◆ getEncoder() [1/2]

◆ getEncoder() [2/2]

◆ getEncoderUnits()

◆ getFaults()

◆ getFlags()

◆ getGearing()

◆ getPosition()

◆ getPower()

◆ getRawPosition()

◆ getSize()

◆ getTargetPosition()

◆ getTargetVelocity()

◆ getTemperature()

◆ getTorque()

◆ getVoltage()

◆ getZeroPositionFlag()

◆ isOverCurrent()

◆ isOverTemp()

◆ isStopped()

◆ modifyProfiledVelocity()

◆ moveAbsolute()

◆ moveRelative()

◆ moveVelocity()

◆ moveVoltage()

◆ setBrakeMode()

◆ setCurrentLimit()

◆ setEncoderUnits()

◆ setGearing()

◆ setReversed()

◆ setVoltageLimit()

◆ tarePosition()

Member Data Documentation

◆ motors