发动机

介绍

VEX IQ（第二代）运动类别提供了与电机和电机组交互的方法。

For the examples below, the configured motor will be named Motor1, and the configured motor group will be named MotorGroup1. They will be used in all subsequent examples throughout this API documentation when referring to motor and motor_group class methods.

以下是所有方法的列表：

动作——控制电机的运动。

• spin – Spins a motor or motor group in a specified direction indefinitely.

• spinFor – Spins a motor or motor group for a specified distance.

• spinToPosition – Spins a motor to an absolute position.

• stop – Stops a motor or motor group with configurable behavior.

改变器——改变电机的不同属性。

• setVelocity – Sets the default velocity for the motor or motor group.

• setMaxTorque – Sets the maximum torque for a motor or motor group.

• setPosition – Sets the motor or motor group’s position to a specific value.

• setStopping – Sets the stop behavior (brake, coast, or hold).

• setTimeout – Limits how long a motor function waits before giving up if movement is blocked.

• setReversed – Sets only a motor to have its direction be reversed.

• resetPosition – Sets only a motor’s position to 0.

Getters – 从电机返回数据。

• isDone – Returns whether a motor or motor group is currently not spinning.

• isSpinning – Returns whether a motor or motor group is currently spinning.

• position – Returns a motor or motor group’s current position.

• velocity – Returns a motor or motor group’s current velocity.

• current – Returns the current being used by a motor or motor group.

• direction – Returns the spin direction of a motor or motor group.

• power – Returns the amount of power being used by a motor or motor group.

• torque – Returns the torque generated by a motor or motor group.

• efficiency – Returns the efficiency of a motor or motor group.

• temperature – Returns the temperature of a motor or motor group.

• count – Returns the amount of motors in a motor group.

构造函数——手动初始化和配置电机和电机组。

• motor – Creates a motor.

• motor_group – Creates a motor group.

行动

spin

spin spins a motor or motor group in the specified direction indefinitely.

Default Usage:
Motor1.spin(direction);

Overload Usages:
Motor1.spin(direction, velocity, velocityUnits);
Motor1.spin(direction, voltage, voltageUnits);

参数	描述
direction	The direction in which to spin the motor or motor group: forward reverse
velocity	电机或电机组以双倍速度旋转。
velocityUnits	The unit that will represent the velocity: percent dps – degrees per second rpm – rotations per minute
voltage	电机旋转所需的电压。
voltageUnits	The unit that will represent the voltage: voltageUnits::volt – volts voltageUnits::mV – millivolts

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Spin forward, then stop
  Motor1.spin(forward);
  wait(1, seconds);
  Motor1.stop();
}

spinFor

spinFor spins a Motor or Motor Group for a set amount in a specified direction.

Default Usage:
Motor1.spinFor(direction, rotation, units, wait);

Overload Usages:
Motor1.spinFor(rotation, units, velocity, units_v, wait);
Motor1.spinFor(direction, rotation, units, velocity, units_v, wait);
Motor1.spinFor(rotation, units, wait);
Motor1.spinFor(time, units_t, velocity, units_v);
Motor1.spinFor(direction, time, units_t, velocity, units_v);
Motor1.spinFor(time, units_t);
Motor1.spinFor(direction, time, units_t);

参数	描述
direction	The direction in which to spin the motor or motor group: forward reverse
rotation	电机将旋转多远。
units	The unit that will represent the rotation: degrees turns
wait	Optional. true (default) – The robot waits until spinFor is complete before executing the next line of code. false – The robot starts the action and moves on to the next line of code right away, without waiting for spinFor to finish.
velocity	电机或电机组以双倍速度旋转。
units_v	The unit that will represent the velocity: dps – degrees per second rpm – rotations per minute velocityUnits::pct – percent
time	The amount of time the motor will spin for. wait cannot be used when using the time parameter.
units_t	The unit that represents the time: seconds msec – milliseconds

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Spin 1 turn fast, then 1 turn slow
  Motor1.spinFor(forward, 1, turns, true);
  Motor1.spinFor(reverse, 1, turns, 20, percent, true);
}

spinToPosition

spinToPosition spins the motor or motor group to a specified position.

Default Usage:
Motor1.spinToPosition(position, units, wait);

Overload Usages:
Motor1.spinToPosition(position, positionUnits, velocity, velocityUnits, wait);

参数	描述
position	The position that the motor or motor group will spin to.
units	The unit that will represent the position: degrees turns
wait	Optional. true (default) – The robot waits until spinToPosition is complete before executing the next line of code. false – The robot starts the action and moves on to the next line of code right away, without waiting for spinToPosition to finish.
velocity	电机或电机组以双倍速度旋转。
velocityUnits	The unit that will represent the velocity: dps – degrees per second rpm – rotations per minute velocityUnits::pct – percent

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Spin forward, then go to 90°
  Motor1.spin(forward);
  wait(1, seconds);
  Motor1.spinToPosition(90, degrees);
}

stop

stop stops the motor or motor group from spinning.

Default Usage:
Motor1.stop();

Overload Usages:
Motor1.stop(mode);

参数	描述
mode	How the motor or motor group will stop: brake – Stops immediately. coast – Slows gradually to a stop. hold – Stops and resists movement using motor feedback.

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Spin and coast to a stop
  Motor1.setVelocity(100, percent);
  Motor1.spin(forward);
  wait(1, seconds);
  Motor1.stop(coast);
}

修改器

setVelocity

setVelocity sets the default velocity for a motor or motor group. This velocity setting will be used for subsequent calls to any motor functions if a specific velocity is not provided.

Usage:
Motor1.setVelocity(velocity, units);

参数	描述
velocity	电机或电机组旋转的速度为双倍。
units	The unit that represents the velocity: percent rpm – rotations per minute dps – degrees per second.

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Try default, then slow, then fast
  Motor1.spinFor(forward, 180, degrees);
  wait(1, seconds);
  Motor1.setVelocity(20, percent);
  Motor1.spinFor(reverse, 180, degrees);
  wait(1, seconds);
  Motor1.setVelocity(100, percent);
  Motor1.spinFor(forward, 180, degrees);
}

setMaxTorque

setMaxTorque sets the maximum torque that a motor or motor group can spin at.

Usage:
Motor1.setMaxTorque(value, units);

参数	描述
value	电机或电机组能够旋转的最大扭矩。
units	The unit that represents the torque: percent Nm – Newton meters. InLb – inch pounds. amp – amps.

setPosition

setPosition sets a specific position value to a motor or motor group, which updates the encoder reading.

Usage:
Motor1.setPosition(position, units);

参数	描述
position	指定电机或电机组将旋转到的位置。
units	The unit that will represent the rotation: degrees turns

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Set a new zero, then go to 0°
  Motor1.setPosition(180, degrees);
  Motor1.spinToPosition(0, degrees);
}

setStopping

setStopping sets how a motor or motor group behaves when it stops.

Usage:
Motor1.setStopping(mode);

参数	描述
mode	How the motor or motor group will stop: brake – Stops immediately. coast – Slows gradually to a stop. hold – Stops and resists movement using motor feedback.

setTimeout

setTimeout sets a time limit for how long a motor command will wait to reach its target. If the robot cannot complete the movement within the set time, it will stop automatically and continue with the next command.

Note: The motor’s time limit is used to prevent motor commands that do not reach their target position from stopping the execution of other commands in the stack.

Usage:
Motor1.setTimeout(time, units);

参数	描述
time	电机命令在停止并移动到下一个命令之前运行的最大秒数。
units	The unit that represents the timeout: seconds msec – milliseconds

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Stop a long move after 0.5 seconds
  Motor1.setTimeout(0.5, seconds);
  Motor1.spinFor(forward, 2, turns);
  Motor1.spinToPosition(0, degrees);
}

setReversed

setReversed sets the motor to be reversed. This method works the same as setting the reverse parameter to true when constructing a motor.

Usage:
Motor1.setReversed(reversed);

参数	描述
reversed	A Boolean representing whether or not the motor is reversed: true – Reverse the motor direction. false – Return to the motor’s default configuration.

resetPosition

resetPosition sets the motor or motor group’s position to 0.

Usage:
Motor1.resetPosition();

参数	描述
	该方法没有参数。

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Spin to 360°, then reset the encoder
  Motor1.spinToPosition(360, degrees);
  Motor1.resetPosition();

  // Now spin to 90° from this new zero point
  Motor1.spinToPosition(90, degrees);
}

吸气剂

isDone

isDone returns a Boolean indicating whether a motor or motor group is not currently spinning.

• 1 – The motor or motor group is done spinning.

• 0 – The motor or motor group is still spinning.

Usage:
Motor1.isDone()

参数	描述
	该方法没有参数。

isSpinning

isSpinning returns a Boolean indicating whether a motor or motor group is currently spinning.

• 1 – The motor or motor group is spinning.

• 0 – The motor or motor group is not spinning.

Usage:
Motor1.isSpinning()

参数	描述
	该方法没有参数。

position

position returns the current position of a motor or motor group as a double.

Usage:
Motor1.position(units)

参数	描述
units	The unit that will represent the position: degrees turns

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Spin, then show the final position
  Motor1.spin(forward);
  wait(1, seconds);
  Motor1.stop();
  Brain.Screen.print("Pos: %f", Motor1.position(degrees));
}

velocity

velocity returns the current velocity of a motor or motor group as a double.

Usage:
Motor1.velocity(units)

参数	描述
units	The unit that will represent the velocity: percent rpm – rotations per minute dps – degrees per second

current

current returns the current of a motor or motor group as a double.

Usage:
Motor1.current(units)

参数	描述
units	The unit that represents the current: amp – amps. percent

direction

direction returns the current direction a motor or motor group is spinning in:

• forward

• reverse

Usage:
Motor1.direction()

参数	描述
	该方法没有参数。

power

power returns the current power of the motor.

Usage:
Motor1.power(units)

参数	描述
units	The unit that represents the power: watt

torque

torque returns the current torque of the motor.

Usage:
Motor1.torque(units)

参数	描述
units	The unit that represents the torque: Nm – Newton meters. InLb – inch pounds. amp – amps.

efficiency

efficiency returns the efficiency of the motor as a percent.

Usage:
Motor1.efficiency()

参数	描述
	该方法没有参数。

temperature

temperature returns the current temperature of the motor as a percent.

Usage:
Motor1.temperature(units)

参数	描述
units	The unit that represents the temperature: celsius fahrenheit

count

count returns the number of motors in a motor group as an integer. This method will not work with individual Motors.

Usage:
MotorGroup1.count()

参数	描述
	该方法没有参数。

构造函数

Constructors are used to manually create motor and motor_group objects, which are necessary for configuring a motor or motor group outside of VEXcode.

motor

motor creates an object of the motor Class in the specified port.

Default Usage:
motor Motor1 = motor(port);

Overload Usages:
motor Motor1 = motor(port, reverse); motor Motor1 = motor(port, gearRatio); motor Motor1 = motor(port, gearRatio, reverse);

参数	描述
port	Which Smart Port that the Motor is connected to as PORT followed by the port number, ranging from 1 to 12.
reverse	A Boolean indicating whether or not the Motor’s directions are configured in reverse: true – The Motor is reversed. false – The Motor is not reversed.
gearRatio	电机的齿轮比为双倍。

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Make a reversed motor on Port 1
  motor Motor1 = motor(PORT1, true);
}

motor_group

motor_group creates an object of the motor_group Class in the specified port. A motor_group is a collection of individual motor objects.

Usage:
motor_group MotorGroup1 = motor_group(motor1, motor2);

参数	描述
motor	The configured motor to add to the motor_group. Up to 12 motor objects can be added to the group.

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Create two motors
  motor motorA = motor(PORT1, false);
  motor motorB = motor(PORT6, true);

  // Create a motor group with those motors
  motor_group MotorGroup1 = motor_group(motorA, motorB);
}