Motor Groups C++ API

Note

Motor Groups function similar to motors but with multiple motors, and there is a C++ API for them.

Note

pros::MotorGroup is an alias for pros::Motor_Group

pros::Motor_Group

Constructor(s)

This function uses the following values of errno when an error state is reached:
  • ENXIO - The given value is not within the range of V5 ports (1-21).
  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given
Example
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
void opcontrol() {
  pros::Motor motor_1 (1);
  pros::Motor motor_2 (2);
  pros::Motor_Group motor_group ({motor_1, motor_2});
  pros::Controller master (E_CONTROLLER_MASTER);

  while (true) {
    motor_group.move(master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y));
    pros::delay(5);
  }
}
Parameters  
motors An initializer_list of motors to be in the motor group
Example
1
2
3
4
5
6
7
8
9
void opcontrol(){
  std::vector<Motor> motors{pros::Motor(1), pros::Motor(2)};
  pros::Motor_Group motor_group (motors);
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group.move(master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y));
    pros::delay(5);
  }
}
Parameters  
motors A Vector with the ports of the motors. Negative ports indicate that the motor is reversed
Example
1
2
3
4
5
6
7
8
void opcontrol(){
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group.move(master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y));
    pros::delay(5);
  }
}
Parameters  
motor_ports An initializer list with the ports of the motors. Negative ports indicate that the motor is reversed
Example
1
2
3
4
5
6
7
8
9
void opcontrol(){
  std::vector<std::int8_t> ports = {1, 2};
  pros::Motor_Group motor_group (ports);
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group.move(master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y));
    pros::delay(5);
  }
}
Parameters  
motor_ports A Vector with the ports of the motors. Negative ports indicate that the motor is reversed

Operator Overloads

operator=

Sets the voltage for all the motors in the motor group from -128 to 127.

This is designed to map easily to the input from the controller’s analog stick for simple opcontrol use. The actual behavior of the motor is analogous to use of pros::Motor::move() on each motor individually

This function uses the following values of errno when an error state is reached:

  • ENODEV - One of the ports cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given
Prototype
Example
virtual std::int32_t operator= ( std::int8_t voltage ) const

1
2
3
4
5
6
7
8
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group = master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y);
    pros::delay(5);
  }
}
Parameters  
voltage The new motor voltage from -127 to 127

operator[]

Indexes Motor in the Motor_Group in the same way as an array.

This function uses the following values of `errno when an error state is reached:
  • ENXIO - Out of bounds on indexing the motor groups.
Prototype
Example
pros::Motor& operator[] ( int index ) const

1
2
3
4
5
6
7
8
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group[0] = master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y);
    pros::delay(5);
  }
}
Parameters  
index The index of the motor in the motor group

Returns: The appropriate Motor reference or sets errno if the operation failed

Other Functions:

at

Indexes the motor group in the same way as an array. This function is provided for cases where the [] operator syntax does not play nicely with C++ types such as smart points.

This function uses the following values of `errno when an error state is reached:
  • ENXIO - Out of bounds on indexing the motor groups.
Prototype
Example
pros::Motor& pros::Motor_Group::at( int index );

1
2
3
4
5
6
7
8
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group.at(0) = master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y);
    pros::delay(5);
  }
}
Parameters  
index The index of the motor in the motor group

Returns: The appropriate Motor reference or sets erno if the operation failed

Movement Functions

move

Sets the voltage for the motors in the motor group from -127 to 127.

This is designed to map easily to the input from the controller’s analog stick for simple opcontrol use. The actual behavior of the motor is analogous to use of motor_move(), or motorSet()` from the PROS 2 API on each motor.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given
Prototype
Example
std::int32_t pros::Motor_Group::move ( std::int32_t voltage )

1
2
3
4
5
6
7
8
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group.move(master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y));
    pros::delay(5);
  }
}
Parameters  
voltage The new motor voltage from -127 to 127

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

move_absolute

Sets the target absolute position for the motors to move to.

This movement is relative to the position of the motors when initialized or the position when it was most recently reset with pros::Motor::set_zero_position().

Note

This function simply sets the target for the motor, it does not block program execution until the movement finishes. The example code shows how to block until a movement is finished.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given
Prototype
Example
std::int32_t pros::Motor_Group::move_absolute ( double position,
                                          std::int32_t velocity )

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
void autonomous() {
  pros::Motor_Group motor_group ({1, 2});
  motor_group.move_absolute(100, 100); // Moves 100 units forward
  Motor_Group::get_position()
  while (!((motor_group.get_positions() < 105) && (motor_group.get_positions() > 95))) {
    // Continue running this loop as long as the motor is not within +-5 units of its goal
    pros::delay(5);
  }
  motor_group.move_absolute(100, 100); // This does not cause a movement
  while (!((motor_group.get_positions() < 105) && (motor_group.get_positions() > 95))) {
    pros::delay(5);
  }
  motor_group.tare_position();
  motor_group.move_absolute(100, 100); // Moves 100 units forward
  while (!((motor_group.get_positions() < 105) && (motor_group.get_positions() > 95))) {
    pros::delay(5);
  }
}
Parameters  
position The absolute position to move to in the motors’ encoder units
velocity The maximum allowable velocity for the movement

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

move_relative

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

This movement is relative to the current position of the motor as given in `get_position`_.

Note

This function simply sets the target for the motor, it does not block program execution until the movement finishes. The example code shows how to block until a movement is finished.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_move_relative on each motor.

Prototype
Example
std::int32_t pros::Motor_Group::move_relative ( double position,
                                          std::int32_t velocity )

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
void autonomous() {
  pros::Motor_Group motor_group ({1, 2});
  motor_group.move_relative(100, 100); // Moves 100 units forward
  while (!((motor_group.get_positions() < 105) && (motor_group.get_positions() > 95))) {
    // Continue running this loop as long as the motor_group is not within +-5 units of its goal
    pros::delay(5);
  }
  motor_group.move_relative(100, 100); // Also moves 100 units forward
  while (!((motor_group.get_positions() < 205) && (motor_group.get_positions() > 195))) {
    pros::delay(5);
  }
}
Parameters  
position The relative position to move to in the motor’s encoder units
velocity The maximum allowable velocity for the movement

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

move_velocity

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 E_MOTOR_GEARSET_36, +-200 for E_MOTOR_GEARSET_18, and +-600 for blue. The velocity is held with PID to ensure consistent speed, as opposed to setting the motor’s voltage.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_move_velocity on each motor.

Prototype
Example
std::int32_t pros::Motor_Group::move_velocity ( cosnt std::int16_t velocity )

1
2
3
4
5
6
void autonomous() {
  pros::Motor_Group motor_group ({1, 2});
  motor_group.move_velocity(100);
  pros::delay(1000); // Move at 100 RPM for 1 second
  motor_group.move_velocity(0);
}
Parameters  
velocity 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.

move_voltage

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

Note

This function will not respect brake modes, and simply sets the voltage to the desired value.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_move_voltage on each motor.

Prototype
Example
std::int32_t pros::Motor_Group::move_voltage ( std::int16_t voltage )

1
2
3
4
5
6
void autonomous() {
  pros::Motor_Group motor_group ({1,2});
  motor_group.move_voltage(12000);
  pros::delay(1000); // Move at max voltage for 1 second
  motor_group.move_voltage(0);
}
Parameters  
voltage The new voltage for the motor from -12000 mV to 12000 mV

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

brake

Stops the motor group using the currently configured brake mode.

This function sets motor velocity to zero, which will cause it to act according to the set brake mode. If brake mode is set to MOTOR_BRAKE_HOLD.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_brake on each motor.

Prototype
Example
std::int32_t pros::Motor_Group::brake ( void )

1
2
3
4
5
6
void autonomous() {
  pros::Motor_Group motor_group ({1,2});
  motor_group.move_voltage(12000);
  pros::delay(1000); // Move at max voltage for 1 second
  motor_group.brake(); // Brakes all motor
}

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

get_target_velocities

Gets the velocity commanded to the motor by the user.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor

Analogous to motor_get_target_velocity on each motor.

Prototype
Example
std::vector<std::int32_t> pros::Motor_Group::get_target_velocities ( )

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group.move_velocity(master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y));
    std::vector<std::int32_t> targets = motor_group.get_target_velocities();
    std::cout << "Motor Velocities: " << targets[0] << ", " << targets[1];
    // Prints the value of E_CONTROLLER_ANALOG_LEFT_Y
    pros::delay(2);
  }
}

Returns: A vector filled with The commanded motor velocities from +-100, +-200, or +-600, or a vector filled with PROS_ERR if the operation failed, setting errno.

get_target_positions

Gets the target position set for the motor by the user.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_get_target_position on each motor.

Prototype
Example
std::vector<double> pros::Motor_Group::get_target_positions ( )

1
2
3
4
5
6
7
void autonomous() {
  pros::Motor_Group motor_group ({1, 2});
  motor_group.move_absolute(100, 100);
  std::vector<double> targets = motor_group.get_target_positions()
  std::cout << "Motor Targets: " << targets[0] << ", " << targets[1];

}

Returns: A vector filled with the target position in its encoder units or a vector filled with PROS_ERR_F if the operation failed, setting errno.

Telemetry Functions

get_actual_velocities

Gets the actual velocity of each motor.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_get_actual_velocity on each motor.

Prototype
Example
std::vector<double> pros::Motor_Group::get_actual_velocities ( )

1
2
3
4
5
6
7
8
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  while (true) {
    motor_group = controller_get_analog(E_CONTROLLER_MASTER, E_CONTROLLER_ANALOG_LEFT_Y);
    printf("Actual velocities: %lf\n", motor_group.get_actual_velocities());
    pros::delay(2);
  }
}

Returns: A vector with the each motor’s actual velocity in RPM in the order or a vector filled with PROS_ERR_F if the operation failed, setting errno.

get_positions

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

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor

Analogous to motor_get_position on each motor.

Prototype
Example
std::vector<double> pros::Motor_Group::get_positions ( )

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group = master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y);
    std::vector<double> positions = motor_group.get_positions();
    std::cout << "Motor Positions: " << positions[0] << ", " << positions[1];
    pros::delay(2);
  }
}

Return: A vector with the motors’ absolute position in its encoder units or PROS_ERR_F if the operation failed, setting errno.

get_raw_positions

Gets the raw positions for a motor group given the timestamps for the motors

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_get_raw_position on each motor.

Prototype
Example
std::vector<std::int32_t> pros::Motor_Group::get_raw_positions(std::vector<std::uint32_t*> &timestamps)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
void opcontrol() {
        pros::Motor_Group motors({1, 2});
        while (true) {
    uint32_t timestamp1 = pros::millis();
    uint32_t timestamp2 = timestamp1;
    std::vector<std::uint32_t*> timestamps = {&timestamp1, &timestamp2};
    std::vector<std::int32_t> raw_positions = motors.get_raw_positions(timestamps);
    std::cout << "Raw positions: " << raw_positions[0] << ", " raw_positions[1] << std::endl;
          pros::delay(20);
        }
      }

Returns: A vector with the raw positions of each motor for the given, or a vector filled with PROS_ERR if the operation failed, setting errno.

Parameters  
timestamps A refernece to a vector containing pointers to the timestamps corresponding to each motor.

get_temperatures

Gets the temperatrues of the motors in the group in degrees Celcius. The resolution of this reading is 5 degrees Celsius. The motor will start to reduce its power when the temperature reading is greater than or equal to 55 C.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor

Analogous to motor_get_temperature on each motor.

Prototype
Example
std::vector<double> pros::Motor_Group::get_temperatures(void)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group = master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y);
    std::vector<double> temperaturess = motor_group.get_temperatures();
    std::cout << "Motor Temperatures: " << temperaturess[0] << ", " << temperaturess[1];
    pros::delay(2);
  }
}

Returns: A vector filled with the motor’s temperatures in degrees Celcius, or a vector filled with PROS_ERR_F if the operation failed, setting errno.

get_voltages

Gets the voltage of the motors in the group in mV.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given
Prototype
Example
std::vector<std::uint32_t> pros::Motor_Group::get_voltages(void);

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
void opcontrol() {
  pros::Motor_Group motors({1, 2});
  std::vector<std::uint32_t> voltages;
  while (true) {
    voltage = motors.get_voltages();
    for (uint32_t i = 0; i < voltages.size(); i++) {
      printf("Voltages: %ld\n", voltages[i]);
    }
    pros::delay(20);
  }
}

Returns: A vector with each motors’ voltage limits in V or a vector filled with PROS_ERR if the operation failed, setting errno.

get_efficiencies

Gets the efficiency of the motors 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.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_get_efficiency on each motor.

Prototype
Example
std::vector<std::int32_t> pros::Motor_Group::get_efficiencies ( )

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group = master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y);
    std::vector<std::int32_t> efficiencies = motor_group.get_efficiencies();
    std::cout << "Motor Efficiencies: " << efficiencies[0] << ", " << efficiencies[1];
    pros::delay(2);
  }
}

Returns: A vector filled with the motor’s efficiency in percent or a vector filled with PROS_ERR_F if the operation failed, setting errno.

are_over_current

Checks if the motors are drawing over its current limit.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_is_over_current on each motor.

Prototype
Example
std::vector<std::int32_t> pros::Motor_Group::are_over_current ( )

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor = master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y);
    std::vector<std::int32_t> currents = motor_group.are_over_current();
    std::cout << "Are the motors over their current limits?: " << currents[0] << ", " << currents[1];
    pros::delay(2);
  }
}

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.

are_over_temp

Gets the temperature limit flag for the motors.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor

Analogous to motor_is_over_temp on each motor.

Prototype
Example
std::vector<std::int32_t> pros::Motor_Group::are_over_temp ( )

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group = master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y);
    std::vector<std::int32_t> temps = motor_group.are_over_temp();
    std::cout << "Are the motors over their temperature limits?: " << temps[0] << ", " << temps[1];
    pros::delay(2);
  }
}

Returns: A vector with for each motor a 1 if the temperature limit is exceeded and 0 if the temperature is below the limit, or a vector filled with PROS_ERR if the operation failed, setting errno.

Configuration Functions

set_zero_position

Sets the position for the motor in its encoder units.

This will be the future reference point for the motors’ “absolute” position.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_set_zero_position on each motor.

Prototype
Example
std::int32_t pros::Motor_Group::set_zero_position ( double position )

1
2
3
4
5
6
7
8
void autonomous() {
  pros::Motor_Group motor_group ({1,2});
  motor_group.move_absolute(100, 100); // Moves 100 units forward
  motor_group.move_absolute(100, 100); // This does not cause a movement

  motor_group.set_zero_position(80);
  motor_group.move_absolute(100, 100); // Moves 80 units forward
}
Parameters  
position The new reference position in its encoder units

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

set_brake_modes

Sets one of motor_brake_mode_e_t to the motor group.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given
Prototype
Example
std::int32_t pros::Motor_Group::set_brake_modes ( pros::motor_brake_mode_e_t mode)

1
2
3
4
5
void initialize() {
  pros::Motor_Group motor_group ({1, 2});
  motor_group.set_brake_modes(pros::E_MOTOR_BRAKE_HOLD);
  std::cout << "Brake Modes: " << motor_group.get_brake_modes();
}

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

set_reversed

Sets the reverse flag for all the motors in the motor group.

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

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_set_reversed on each motor.

Prototype
Example
std::int32_t pros::Motor_Group::set_reversed ( bool reverse )

1
2
3
4
5
void initialize() {
  pros::Motor_Group motor_group ({1,2});
  motor_group.set_reversed(true);
  std::cout << "Is this motor group reversed? " << motor_group.is_reversed();
}
Parameters  
reverse 1 reverses the motor, 0 is default

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

set_voltage_limit

Sets the voltage limit for all the motors in Volts.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_set_voltage_limit on each motor.

Prototype
Example
std::int32_t pros::Motor_Group::set_voltage_limit ( std::int32_t limit )

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
void autonomous() {
  pros::Motor_Group motor_group ({1,2});
  pros::Controller master (E_CONTROLLER_MASTER);

  motor_group.set_voltage_limit(10000);
  while (true) {
    motor_group = master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y);
    // The motor will not output more than 10 V
    pros::delay(2);
  }
}
Parameters  
limit The new voltage limit in Volts

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

set_gearing

Sets one of motor_gearset_e_t for all the motors in the motor group.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_set_gearing on each motor.

Prototype
Example
std::int32_t pros::Motor_Group::set_gearing ( pros::motor_gearset_e_t_ gearset )

1
2
3
4
5
void initialize() {
  pros::Motor_Group motor_group ({1,2});
  motor_group.set_gearing(E_MOTOR_GEARSET_06);
  std::cout << "Motor group gearing: " << motor_group.get_gearing();
}
Parameters  
gearset The new motor gearset

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

set_encoder_units

Sets one of motor_encoder_units_e_t for the all the motor encoders in the motor group.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_set_encoder_units on each motor.

Prototype
Example
std::int32_t pros::Motor_Group::set_encoder_units ( pros::motor_encoder_units_e_t units )

1
2
3
4
5
void initialize() {
  pros::Motor_Group motor_group ({1,2});
  motor_group.set_encoder_units(E_MOTOR_ENCODER_DEGREES);
  std::cout << "Encoder Units: " << motor_group.get_encoder_units();
}
Parameters  
units The new motor encoder units

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

Gets the number of motors in the motor group;

Prototype
Example
std::int32_t pros::Motor_Group::size ( )

void initialize() {
  pros::Motor_Group motor_group ({1,2});
  std::cout << "Number of Motors: " << motor_group.size();
}

Returns: The number of Motors in the motor group.

tare_position

Sets the “absolute” zero position of the motor group to its current position.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_tare_position on each motor.

Prototype
Example
std::int32_t pros::Motor_Group::tare_position ( )

1
2
3
4
5
6
7
8
void autonomous() {
  pros::Motor_Group motor_group ({1,2});
  motor_group.move_absolute(100, 100); // Moves 100 units forward
  motor_group.move_absolute(100, 100); // This does not cause a movement

  motor_group.tare_position();
  motor_group.move_absolute(100, 100); // Moves 100 units forward
}

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

get_brake_modes

Gets the brake mode that was set for the motors.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_get_brake_mode on each motor.

Prototype
Example
std::vector<pros::motor_brake_mode_e_t> pros::Motor_Group::get_brake_modes ( )

1
2
3
4
5
6
void initialize() {
  pros::Motor_Group motor_group ({1, 2});
  motor_group.set_brake_modes(pros::E_MOTOR_BRAKE_HOLD);
  std::vector<pros::motor_brake_mode_e_t> brake_modes = motor_group.get_brake_modes();
  std::cout << "Brake Modes: " << brake_modes[0] << ", " << brake_modes[1];
}

Returns: A vector with for each motor one of motor_brake_mode_e_t, according to what was set for the motor, or a vector filled with E_MOTOR_BRAKE_INVALID if the operation failed, setting errno.

get_gearing

Gets the gearset that was set for the motor.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given
Prototype
Example
std::vector<pros::motor_gearset_e_t> pros::Motor_Group::get_gearing (  )

1
2
3
4
5
6
void initialize() {
  pros::Motor_Group motor_group ({1,2});
  motor_group.set_gearing(E_MOTOR_GEARSET_06);
  std::vector<pros::motor_gearset_e_t> gearing = motor_group.get_gearing();
  std::cout << "Motor group gearing: " << gearing[0] << ", " << gearing[1];
}

Returns: A Vector with a motor_gearset_e_t for each motor according to what is set for the motor, or E_GEARSET_INVALID if the operation failed for that motor.

get_current_draws

Gets the current drawn by each motor in mA.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_get_current_draw on each motor.

Prototype
Example
std::vector<std::int32_t> pros::Motor_Group::get_current_draws ( )

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group = master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y);
    std::vector<std::int32_t> currents = motor_group.get_current_draw();
    std::cout << "Motor Current Draws: " << currents[0] << ", " currents[1];
    pros::delay(2);
  }
}

Returns: A vector containing each motor’s current in mA or a vector filled with PROS_ERR if the operation failed, setting errno.

get_current_limits

Gets the current limit for each motor in mA.

The default value is 2500 mA.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_get_current_limit on each motor.

Prototype
Example
std::vector<std::int32_t> pros::Motor_Group::get_current_limits ( )

1
2
3
4
5
6
7
8
void opcontrol() {
  pros::Motor_Group motor_group ({1, 2});
  while (true) {
  std::vector<std::int32_t> limits = motor_group.get_current_limits();
    std::cout << "Motor Current Limits: " << limits[0] << ", " << limits[1];
    pros::delay(2);
  }
}

Returns: A vector with each motors’ current limits in mA or a vector filled with PROS_ERR if the operation failed, setting errno.

get_ports

Gets the port number of each motor.

Prototype
Example
std::vector<std::uint8_t> pros::Motor_Group::get_ports ( )

void autonomous() {
  pros::Motor_Group motor_group ({1, 2});
  std::vector<std::uint8_t> ports = motor_group.get_ports(); // Returns {1, 2}
}

Returns: A vector with each motor’s port number.

get_voltage_limits

Gets the current limit for each motor in V.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given
Prototype
Example
std::vector<std::uint32_t> pros::Motor_Group::get_voltage_limits(void);

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
void opcontrol() {
        pros::Motor_Group motors({1, 2});
        std::vector<std::uint32_t> voltage_limits;
        while (true) {
                voltage_limits = motors.get_voltage_limits();

          for (uint32_t i = 0; i < voltage_limits.size(); i++) {
                  printf("Voltage Limits: %ld\n", voltage_limits[i]);
          }
          pros::delay(20);
        }
      }

Returns: A vector with each motors’ voltage limits in V or a vector filled with PROS_ERR if the operation failed, setting errno.

get_directions

Gets the direction of movement for the motors.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor

Analogous to motor_get_direction on each motor.

Prototype
Example
std::int32_t pros::Motor_Group::get_directions ( )

1
2
3
4
5
6
7
8
9
void opcontrol() {
  pros::Motor_Group motor_group (1);
  pros::Controller master (E_CONTROLLER_MASTER);
  while (true) {
    motor_group = master.get_analog(E_CONTROLLER_ANALOG_LEFT_Y);
    std::cout << "Motor Directions: " << motor_group.get_directions();
    pros::delay(2);
  }
}

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

get_encoder_units

Gets the encoder units that were set for each motor.

This function uses the following values of errno when an error state is reached:

  • ENODEV - The port cannot be configured as a motor
  • EACCESS - The Motor group mutex can’t be taken or given

Analogous to motor_get_encoder_units on each motor.

Prototype
Example
pros::motor_encoder_units_e_t pros::Motor_Group::get_encoder_units ( )

1
2
3
4
5
void initialize() {
  pros::Motor motor (1, E_MOTOR_GEARSET_06, false, E_MOTOR_ENCODER_COUNTS);
  pros::Motor_Group motor_group ({motor});
  std::cout << "Motor Group Encoder Units: " << motor_group.get_encoder_units();
}

Returns: A vector filled with one of motor_encoder_units_e_t for each motor according to what is set for the motor or a vector filled with E_MOTOR_ENCODER_INVALID if the operation failed.

Macros

None.

Enumerated Values

pros::motor_brake_mode_e_t

Indicates the current ‘brake mode’ of the motor.

1
2
3
4
5
6
typedef enum motor_brake_mode_e {
  E_MOTOR_BRAKE_COAST = 0, // Motor coasts when stopped, default behavior
  E_MOTOR_BRAKE_BRAKE = 1, // Motor short brakes when stopped
  E_MOTOR_BRAKE_HOLD = 2, // Motor actively holds position when stopped
  E_MOTOR_BRAKE_INVALID = INT32_MAX
} motor_brake_mode_e_t;
Value  
pros::E_MOTOR_BRAKE_COAST Motor coasts when stopped, default behavior
pros::E_MOTOR_BRAKE_BRAKE Motor short brakes when stopped by shorting (directly connecting) the motor’s positive and negative lead https://en.m.wikipedia.org/wiki/Dynamic_braking
pros::E_MOTOR_BRAKE_HOLD Motor actively holds position when stopped
pros::E_MOTOR_BRAKE_INVALID Invalid brake mode

pros::motor_encoder_units_e_t

Indicates the units used by the motor’s encoder.

1
2
3
4
5
6
7
8
9
typedef enum motor_encoder_units_e {
  E_MOTOR_ENCODER_DEGREES = 0,   // Position is recorded as angle in degrees
                                 // as a floating point number
  E_MOTOR_ENCODER_ROTATIONS = 1, // Position is recorded as angle in rotations
                                 // as a floating point number
  E_MOTOR_ENCODER_COUNTS = 2,    // Position is recorded as raw encoder ticks
                                 // as a whole number
  E_MOTOR_ENCODER_INVALID = INT32_MAX
} motor_encoder_units_e_t;
Value  
pros::E_MOTOR_ENCODER_DEGREES Position is recorded as angle in degrees as a floating point number
pros::E_MOTOR_ENCODER_ROTATIONS Position is recorded as angle in rotations as a floating point number
pros::E_MOTOR_ENCODER_COUNTS Position is recorded as raw encoder ticks as a whole number
pros::E_MOTOR_BRAKE_INVALID Invalid motor encoder units

pros::motor_fault_e_t

1
2
3
4
5
6
7
typedef enum motor_fault_e {
      E_MOTOR_FAULT_NO_FAULTS = 0x00,
      E_MOTOR_FAULT_MOTOR_OVER_TEMP = 0x01,  // Analogous to motor_is_over_temp()
      E_MOTOR_FAULT_DRIVER_FAULT = 0x02,     // Indicates a motor h-bridge fault
      E_MOTOR_FAULT_OVER_CURRENT = 0x04,     // Analogous to motor_is_over_current()
      E_MOTOR_FAULT_DRV_OVER_CURRENT = 0x08  // Indicates an h-bridge over current
} motor_fault_e_t;
Value  
pros::E_MOTOR_FAULT_NO_FAULTS No faults
pros::E_MOTOR_FAULT_MOTOR_OVER_TEMP Analogous to motor_is_over_temp()
pros::E_MOTOR_FAULT_DRIVER_FAULT Indicates a motor h-bridge fault
pros::E_MOTOR_FAULT_OVER_CURRENT Analogous to motor_is_over_current()
pros::E_MOTOR_FAULT_DRV_OVER_CURRENT Indicates an h-bridge over current

pros::motor_flag_e_t

1
2
3
4
5
6
typedef enum motor_flag_e {
  E_MOTOR_FLAGS_NONE = 0x00,
  E_MOTOR_FLAGS_BUSY = 0x01,           // Cannot currently communicate to the motor
  E_MOTOR_FLAGS_ZERO_VELOCITY = 0x02,  // Analogous to motor_is_stopped()
  E_MOTOR_FLAGS_ZERO_POSITION = 0x04   // Analogous to motor_get_zero_position_flag()
} motor_flag_e_t;
Value  
pros::E_MOTOR_FLAGS_NONE There are no flags raised
pros::E_MOTOR_FLAGS_BUSY Cannot currently communicate to the motor
pros::E_MOTOR_FLAGS_ZERO_VELOCITY Analogous to pros::Motor::is_stopped()
pros::E_MOTOR_FLAGS_ZERO_POSITION Analogous to pros::Motor::get_zero_position_flag()

pros::motor_gearset_e_t

Indicates the internal gearing used by the motor.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
typedef enum motor_gearset_e {
  E_MOTOR_GEARSET_36 = 0, // 36:1
  E_MOTOR_GEAR_RED = E_MOTOR_GEARSET_36, // Red gear set
  E_MOTOR_GEAR_100 = E_MOTOR_GEARSET_36, // 100 RPM
  E_MOTOR_GEARSET_18 = 1, // 18:1
  E_MOTOR_GEAR_GREEN = E_MOTOR_GEARSET_18, // Green gear set
  E_MOTOR_GEAR_200 = E_MOTOR_GEARSET_18, // 200 RPM
  E_MOTOR_GEARSET_06 = 2, // 6:1
  E_MOTOR_GEAR_BLUE  = E_MOTOR_GEARSET_06, // Blue gear set
  E_MOTOR_GEAR_600 = E_MOTOR_GEARSET_06, // 600 RPM
  E_MOTOR_GEARSET_INVALID = INT32_MAX
} motor_gearset_e_t;
Value  
pros::E_MOTOR_GEARSET_36 36:1
pros::E_MOTOR_GEAR_RED Red gear set
pros::E_MOTOR_GEAR_100 100 RPM
pros::E_MOTOR_GEARSET_18 18:1
pros::E_MOTOR_GEAR_GREEN Green gear set
pros::E_MOTOR_GEAR_200 200 RPM
pros::E_MOTOR_GEARSET_06 6:1
pros::E_MOTOR_GEAR_BLUE Blue Gear Set
pros::E_MOTOR_GEAR_600 200 RPM
pros::E_MOTOR_GEARSET_INVALID Error return code