Σύστημα μετάδοσης κίνησης#
Εισαγωγή#
The drivetrain class controls how a robot drives and turns. A drivetrain is made of motors and wheels that work together to move the robot.
A drivetrain does not use a Gyro Sensor for heading-based or rotation-based turns. It can drive forward or reverse and turn left or right, but it cannot turn to a specific heading or rotation. For heading-based and rotation-based turns, use the smartdrive class.
This page uses myDrivetrain as the example drivetrain name. Replace it with your own configured name as needed.
Παράγωγες Κλάσεις#
The drivetrain class serves as a base class for the following derived class:
smartdrive- Creates a drivetrain with Gyro Sensor support.
Κατασκευαστές κλάσεων#
1 - Creates a drivetrain using existing
motor_groupobjects for the left and right sides.drivetrain( motor_group &l, motor_group &r, double wheelTravel = 320, double trackWidth = 320, double wheelBase = 130, distanceUnits unit = mm, double externalGearRatio = 1.0 );
2 - Creates a drivetrain using existing
motorobjects for the left and right sides.drivetrain( motor &l, motor &r, double wheelTravel = 320, double trackWidth = 320, double wheelBase = 130, distanceUnits unit = mm, double externalGearRatio = 1.0 );
Καταστροφέας κλάσης#
Destroys the drivetrain object and releases associated resources.
virtual ~drivetrain();
Παράμετροι#
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The left and right motors or motor groups. Both parameters must use the same type: either two |
|
|
The circumference of the drivetrain wheels. The default is |
|
|
The distance between the left and right wheels. The default is |
|
|
The distance between the front and back wheels. The default is |
|
|
The unit for |
|
|
The gear ratio used to adjust drive distances if gears are used. The default is |
Παράδειγμα#
// Create the left and right motor objects.
motor leftMotor = motor(PORT1, false);
motor rightMotor = motor(PORT9, true);
// Create the drivetrain object.
drivetrain myDrivetrain = drivetrain(
leftMotor, // left motor
rightMotor, // right motor
259.34, // wheelTravel
320, // trackWidth
40, // wheelBase
mm, // unit
1.0 ); // externalGearRatio
Συναρτήσεις Μελών#
The drivetrain class includes the following member functions:
Ενέργειες - Μετακίνηση και περιστροφή του ρομπότ.
drive- Moves the robot forward or reverse forever.driveFor- Moves the robot forward or reverse for a specific distance.turn- Turns the robot left or right forever.turnFor- Turns the robot left or right for a specific number of degrees or revolutions.stop- Stops the robot’s movement.
Ρυθμίσεις - Προσαρμόστε τις ρυθμίσεις του συστήματος μετάδοσης κίνησης.
setDriveVelocity- Tells the robot how fast to drive.setTurnVelocity- Tells the robot how fast to turn.setStopping- Tells how the robot will stop moving: by braking, coasting, or holding.setTimeout- Sets how long the robot will try to finish a movement.
Τιμές - Ελέγξτε την κατάσταση της κίνησης.
isDone- Returns whether the robot is finished moving, as a Boolean value.isMoving- Returns whether the robot is moving, as a Boolean value.velocity- Returns how fast the robot is driving.current- Returns how much electrical current the drivetrain is using.power- Returns how quickly the drivetrain is using energy.torque- Returns how much torque the drivetrain is using.efficiency- Returns how efficiently the drivetrain is using power.temperature- Returns how warm the drivetrain is.voltage- Returns the electrical voltage of the drivetrain.
Before calling any drivetrain member functions, a drivetrain object must be created.
/* This constructor is required when using VS Code.
Drivetrain configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */
// Create the left and right motor objects.
motor leftMotor = motor(PORT1, false);
motor rightMotor = motor(PORT9, true);
// Create the drivetrain object.
drivetrain myDrivetrain = drivetrain(
leftMotor, // left motor
rightMotor, // right motor
259.34, // wheelTravel
320, // trackWidth
40, // wheelBase
mm, // unit
1.0 ); // externalGearRatio
Ενέργειες#
οδηγώ#
drive moves the robot forward or reverse forever. The robot will continue to move until it is given another action, like turning or stopping.
1 - Οδηγεί χρησιμοποιώντας την τρέχουσα ταχύτητα κίνησης.
void drive( directionType dir );
Parameters2 - Οδηγεί με την καθορισμένη ταχύτητα.
void drive( directionType dir, double velocity, velocityUnits units );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The direction the robot moves: |
|
|
The velocity to drive with from 0% to 100% when using |
|
|
The velocity unit: |
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
Notesdriveis non-waiting. The project will run the next line of code right away.The robot will continue to move until
stopis called or another drivetrain movement function runs.isDoneandisMovingare not used withdrivebecausedrivedoes not have a target distance.
// Drive forward and back.
myDrivetrain.drive(forward);
wait(2, seconds);
myDrivetrain.drive(reverse, 25, rpm);
wait(2, seconds);
myDrivetrain.stop();
driveFor#
driveFor moves the robot forward or reverse for a specific distance. The project will wait until the robot is done moving before the next line of code runs.
1 - Οδηγεί στην καθορισμένη κατεύθυνση για μια απόσταση χρησιμοποιώντας την τρέχουσα ταχύτητα οδήγησης.
bool driveFor( directionType dir, double distance, distanceUnits units, bool waitForCompletion = true );
2 - Οδηγεί σε μια κατεύθυνση με βάση την τιμή απόστασης χρησιμοποιώντας την τρέχουσα ταχύτητα οδήγησης.
bool driveFor( double distance, distanceUnits units, bool waitForCompletion = true );
3 - Οδηγεί σε μια κατεύθυνση με βάση την τιμή απόστασης στην καθορισμένη ταχύτητα.
bool driveFor( double distance, distanceUnits units, double velocity, velocityUnits units_v, bool waitForCompletion = true );
Parameters4 - Οδηγεί στην καθορισμένη κατεύθυνση για μια απόσταση με την καθορισμένη ταχύτητα.
bool driveFor( directionType dir, double distance, distanceUnits units, double velocity, velocityUnits units_v, bool waitForCompletion = true );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The direction the robot moves: |
|
|
Η απόσταση που διανύει το ρομπότ. |
|
|
The distance unit: |
|
|
The velocity to drive with from 0% to 100% when using |
|
|
The velocity unit: |
|
|
|
Επιστρέφει εάν το ρομπότ έφτασε στην απόσταση-στόχο, ως λογική τιμή.
true- The robot reached the target distance.false- The robot did not finish the movement, or the function returned before the movement completed becausewaitForCompletionwas set tofalse.
Running another drivetrain movement function while
driveForis running will interrupt the current movement.driveForuses a target distance, soisDoneandisMovingcan be used with it.
// Drive 200 mm, then back 200 mm.
myDrivetrain.driveFor(forward, 200, mm);
myDrivetrain.driveFor(reverse, 200, mm);
σειρά#
turn turns the robot left or right forever. The robot will continue to turn until it is given another action, like driving or stopping.
1 - Στροφές χρησιμοποιώντας την τρέχουσα ταχύτητα στροφής.
void turn( turnType dir );
Parameters2 - Στρέφεται με την καθορισμένη ταχύτητα.
void turn( turnType dir, double velocity, velocityUnits units );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The direction the robot turns: |
|
|
The velocity to turn with from 0% to 100% when using |
|
|
The velocity unit: |
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
Notesturnis non-waiting. The project will run the next line of code right away.The robot will continue turning until
stopis called or another drivetrain movement function runs.isDoneandisMovingare not used withturnbecauseturndoes not have a target angle.
// Turn right, then left, then stop.
myDrivetrain.turn(right);
wait(2, seconds);
myDrivetrain.turn(left);
wait(2, seconds);
myDrivetrain.stop();
στροφήΓια#
turnFor turns the robot left or right for a specific number of degrees, revolutions, or raw units. The turn is relative to the current position of the robot. The project will wait until the robot is done turning before the next line of code runs.
1 - Στροφές για την καθορισμένη γωνία χρησιμοποιώντας την τρέχουσα ταχύτητα στροφής.
bool turnFor( double angle, rotationUnits units, bool waitForCompletion = true );
2 - Στρέφεται προς την καθορισμένη κατεύθυνση για μια γωνία χρησιμοποιώντας την τρέχουσα ταχύτητα στροφής.
bool turnFor( turnType dir, double angle, rotationUnits units, bool waitForCompletion = true );
3 - Στρέφεται για την καθορισμένη γωνία με την καθορισμένη ταχύτητα.
bool turnFor( double angle, rotationUnits units, double velocity, velocityUnits units_v, bool waitForCompletion = true );
Parameters4 - Στρέφεται προς την καθορισμένη κατεύθυνση για μια γωνία με την καθορισμένη ταχύτητα.
bool turnFor( turnType dir, double angle, rotationUnits units, double velocity, velocityUnits units_v, bool waitForCompletion = true );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The direction the robot turns: |
|
|
Η ποσότητα που γυρίζει το ρομπότ. |
|
|
The turn unit: |
|
|
The velocity to turn with from 0% to 100% when using |
|
|
The velocity unit: |
|
|
|
Επιστρέφει εάν το ρομπότ έφτασε στη γωνία-στόχο, ως λογική τιμή.
true- The robot reached the target angle.false- The robot did not finish the turn, or the function returned before the turn completed becausewaitForCompletionwas set tofalse.
Running another drivetrain movement function while
turnForis running will interrupt the current movement.turnForuses a target angle, soisDoneandisMovingcan be used with it.
// Turn right, then left.
myDrivetrain.turnFor(right, 90, degrees);
wait(1, seconds);
myDrivetrain.turnFor(left, 90, degrees);
στάση#
stop stops the robot’s movement. If a stopping mode is provided, it controls how the robot stops for this function call.
1 - Σταματά το σύστημα μετάδοσης κίνησης χρησιμοποιώντας την τρέχουσα λειτουργία ακινητοποίησης.
void stop();
Parameters2 - Σταματά το σύστημα μετάδοσης κίνησης χρησιμοποιώντας την καθορισμένη λειτουργία ακινητοποίησης.
void stop( brakeType mode );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
How the robot will stop:
|
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
Examples// Drive forward, then coast to a stop.
myDrivetrain.setDriveVelocity(100, percent);
myDrivetrain.drive(forward);
wait(2, seconds);
myDrivetrain.stop(coast);
Μεταλλάκτες#
setDriveVelocity#
setDriveVelocity tells the robot how fast to drive. A higher percentage makes the robot drive faster and a lower percentage makes the robot drive slower.
Κάθε έργο ξεκινά με το ρομπότ να κινείται με ταχύτητα 50% από προεπιλογή.
Σημείωση: Μια υψηλότερη ταχύτητα κάνει το ρομπότ να κινείται πιο γρήγορα, αλλά μπορεί να είναι λιγότερο ακριβές. Μια χαμηλότερη ταχύτητα κάνει το ρομπότ να κινείται πιο αργά, αλλά μπορεί να είναι πιο ακριβές.
Available Functionsvoid setDriveVelocity(
double velocity,
velocityUnits units );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The velocity to drive with from 0% to 100% when using |
|
|
The velocity unit: |
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
NotesΗ ταχύτητα κίνησης χρησιμοποιείται από μεταγενέστερες συναρτήσεις κίνησης του συστήματος μετάδοσης κίνησης, εκτός εάν παρέχεται μια συγκεκριμένη ταχύτητα στην κλήση της συνάρτησης.
// Drive forward, then coast to a stop.
myDrivetrain.setDriveVelocity(100, percent);
myDrivetrain.drive(forward);
wait(2, seconds);
myDrivetrain.stop(coast);
setTurnVelocity#
setTurnVelocity tells the robot how fast to turn. A higher percentage makes the robot turn faster and a lower percentage makes the robot turn slower.
Κάθε έργο ξεκινά με το ρομπότ να περιστρέφεται με ταχύτητα 50% από προεπιλογή.
Σημείωση: Μια υψηλότερη ταχύτητα κάνει το ρομπότ να περιστρέφεται πιο γρήγορα, αλλά μπορεί να είναι λιγότερο ακριβής. Μια χαμηλότερη ταχύτητα κάνει το ρομπότ να περιστρέφεται πιο αργά, αλλά μπορεί να είναι πιο ακριβής.
Available Functionsvoid setTurnVelocity(
double velocity,
velocityUnits units );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The velocity to turn with from 0% to 100% when using |
|
|
The velocity unit: |
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
NotesΗ ταχύτητα στροφής χρησιμοποιείται από μεταγενέστερες συναρτήσεις στροφής του συστήματος μετάδοσης κίνησης, εκτός εάν παρέχεται συγκεκριμένη ταχύτητα στην κλήση της συνάρτησης.
// Try default, slow, then fast.
myDrivetrain.turnFor(right, 360, degrees);
wait(1, seconds);
myDrivetrain.setTurnVelocity(20, percent);
myDrivetrain.turnFor(right, 360, degrees);
wait(1, seconds);
myDrivetrain.setTurnVelocity(100, percent);
myDrivetrain.turnFor(right, 360, degrees);
setStopping#
setStopping sets how the robot will stop moving: by braking, coasting, or holding.
void setStopping(
brakeType mode );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
How the robot will stop:
|
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
NotesThe stopping mode is used by later
stopcalls unless a specific stopping mode is provided in the function call.If this function is not used, the robot will use
brakewhen stopping.
ορισμός χρονικού ορίου#
setTimeout sets how long the robot will try to finish a movement. If the robot cannot finish in that time, it will stop trying and move on to the next line of code. This keeps the robot from getting stuck on a movement.
void setTimeout(
int32_t time,
timeUnits units );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
Ο χρόνος που μπορεί να προσπαθήσει το ρομπότ για να ολοκληρώσει μια κίνηση. Αυτός θα πρέπει να είναι ένας θετικός ακέραιος αριθμός. |
|
|
The unit of time: |
Αυτή η συνάρτηση δεν επιστρέφει τιμή.
NotesThe timeout only applies to drivetrain functions that move to a target, such as
driveForandturnFor.
// Turn right after driving forward.
myDrivetrain.setTimeout(1, seconds);
myDrivetrain.driveFor(forward, 25, inches);
myDrivetrain.turnFor(right, 90, degrees);
Αποκτητές#
είναιΟλοκληρωμένο#
isDone returns whether the robot is finished moving, as a Boolean value. This can be used to control the timing of other behaviors based on the robot’s movement.
bool isDone( void );
Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.
Return Valuestrue- The robot is finished moving.false- The robot is still moving.
Μετακινείται#
isMoving returns whether the robot is moving, as a Boolean value. This can be used to control the timing of other behaviors based on the robot’s movement.
virtual bool isMoving( void );
Αυτή η συνάρτηση δεν δέχεται καμία παράμετρο.
Return Valuestrue- The robot is moving.false- The robot is not moving.
ταχύτητα#
velocity returns how fast the robot is driving.
It can return velocity as a percentage, in rpm, or in dps. A positive value means the robot is driving forward. A negative value means the robot is driving in reverse.
double velocity(
velocityUnits units );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The unit to return velocity in: |
Returns the drivetrain velocity as a double in the selected unit.
// Show velocity before and during motion.
Brain.Screen.print("Resting: %f", myDrivetrain.velocity(percent));
myDrivetrain.drive(forward, 100, velocityUnits::pct);
wait(1, seconds);
Brain.Screen.newLine();
Brain.Screen.print("Moving: %f", myDrivetrain.velocity(percent));
myDrivetrain.stop();
ρεύμα#
current returns how much electrical current the drivetrain is using. Current is the amount of electricity flowing through the drivetrain. It can be returned in amps (amperes) or as a percentage, depending on the unit.
Μια υψηλότερη τιμή ρεύματος σημαίνει ότι το σύστημα μετάδοσης κίνησης χρησιμοποιεί περισσότερο ηλεκτρικό ρεύμα. Αυτό μπορεί να συμβεί όταν το ρομπότ πιέζει ένα αντικείμενο ή προσπαθεί να κινηθεί όταν αυτό έχει κολλήσει.
Αυτό μπορεί να χρησιμοποιηθεί για να ελέγξετε εάν το σύστημα μετάδοσης κίνησης παρουσιάζει δυσκολίες κατά τη διάρκεια μιας κίνησης. Εάν το ρεύμα παραμείνει υψηλό, το σύστημα μετάδοσης κίνησης μπορεί να θερμανθεί ή να χρησιμοποιήσει την ισχύ λιγότερο αποτελεσματικά.
Available Functions1 - Επιστρέφει το ηλεκτρικό ρεύμα του συστήματος μετάδοσης κίνησης σε αμπέρ.
double current( currentUnits units = currentUnits::amp );
Parameters2 - Επιστρέφει το ηλεκτρικό ρεύμα του συστήματος μετάδοσης κίνησης ως ποσοστό.
double current( percentUnits units );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The unit to return current in: |
|
|
The unit to return current in: |
Returns the drivetrain current as a double in the selected unit.
εξουσία#
power returns how much power the drivetrain is using, measured in watts. Power shows how quickly the drivetrain is using energy.
Μια υψηλότερη τιμή ισχύος σημαίνει ότι το σύστημα μετάδοσης κίνησης χρησιμοποιεί ενέργεια πιο γρήγορα. Αυτό μπορεί να συμβεί όταν το ρομπότ πιέζει ένα αντικείμενο ή προσπαθεί να κινηθεί όταν αυτό έχει κολλήσει.
Αυτό μπορεί να χρησιμοποιηθεί για να συγκρίνετε κινήσεις ή να ελέγξετε αν το σύστημα μετάδοσης κίνησης παρουσιάζει δυσκολίες. Εάν η ισχύς παραμείνει υψηλή, το σύστημα μετάδοσης κίνησης μπορεί να θερμανθεί ή να χρησιμοποιήσει την ενέργεια λιγότερο αποτελεσματικά.
Available Functionsdouble power(
powerUnits units = powerUnits::watt );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The power unit: |
Returns drivetrain power as a double in watts.
ροπή#
Η ροπή δείχνει πόσο δυνατά μπορεί να σπρώξει ή να τραβήξει το σύστημα μετάδοσης κίνησης ενώ οι τροχοί σπινάρουν.
torque returns how much torque the drivetrain is using, measured in Newton-meters (Nm) or inch-pounds (InLb).
Μια υψηλότερη τιμή ροπής σημαίνει ότι το σύστημα μετάδοσης κίνησης πιέζει ή τραβάει πιο δυνατά. Αυτό μπορεί να συμβεί όταν το ρομπότ πιέζει ένα αντικείμενο ή προσπαθεί να κινηθεί όταν αυτό έχει κολλήσει.
Αυτό μπορεί να χρησιμοποιηθεί για να ελεγχθεί εάν το σύστημα μετάδοσης κίνησης δυσκολεύεται ή για να συγκριθεί η ώθηση που χρειάζονται οι διαφορετικές κινήσεις.
Available Functionsdouble torque(
torqueUnits units = torqueUnits::nm );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The unit to return torque in: |
Returns drivetrain torque as a double in the selected unit.
αποδοτικότητα#
efficiency returns how efficiently the drivetrain is using power, as a percentage from 0% to 100%.
Η απόδοση δείχνει πόση από την ισχύ του συστήματος μετάδοσης κίνησης χρησιμοποιείται για κίνηση. Μια υψηλότερη τιμή απόδοσης σημαίνει ότι περισσότερη από την ισχύ του συστήματος μετάδοσης κίνησης χρησιμοποιείται για κίνηση. Μια χαμηλότερη τιμή απόδοσης μπορεί να συμβεί όταν το σύστημα μετάδοσης κίνησης λειτουργεί σκληρά αλλά δεν κινείται πολύ, όπως όταν το ρομπότ έχει κολλήσει ή πιέζει ένα αντικείμενο.
Αυτό μπορεί να χρησιμοποιηθεί για τη σύγκριση κινήσεων ή για τον έλεγχο εάν το σύστημα μετάδοσης κίνησης σπαταλά ενέργεια αντί να τη χρησιμοποιεί για κίνηση.
Available Functionsdouble efficiency(
percentUnits units = percentUnits::pct );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The unit to return efficiency in: |
Returns drivetrain efficiency as a double in the selected unit.
θερμοκρασία#
temperature returns the average temperature of the drivetrain as a percentage from 0% to 100%.
Η θερμοκρασία δείχνει πόσο ζεστοί είναι οι κινητήρες του συστήματος μετάδοσης κίνησης. Μια υψηλότερη θερμοκρασία σημαίνει ότι οι κινητήρες θερμαίνονται ενώ λειτουργούν. Οι κινητήρες θα πρέπει να παραμένουν κάτω από τους 55°C για να συνεχίσουν να λειτουργούν σε πλήρη απόδοση.
Εάν οι κινητήρες υπερθερμανθούν, θα μειώσουν το μέγιστο ρεύμα τους για να προστατευτούν. Στους 70°C, οι κινητήρες θα σταματήσουν να λειτουργούν μέχρι να κρυώσουν.
Αυτό μπορεί να χρησιμοποιηθεί για να ελέγξετε εάν το σύστημα μετάδοσης κίνησης υπερθερμαίνεται κατά τη διάρκεια επαναλαμβανόμενων κινήσεων, μεγάλων διαδρομών ή όταν πιέζει ένα αντικείμενο.
Available Functionsdouble temperature(
percentUnits units );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The unit to return temperature in: |
Returns the average drivetrain temperature as a double in the selected unit.
A returned value of
50%means the average motor temperature is about45°C(113°F).The typical operating temperature range for the drivetrain is about
20°C(68°F) to70°C(158°F).
δυναμικό#
voltage returns the electrical voltage of the drivetrain.
Η τάση είναι η ηλεκτρική πίεση που παρέχεται στους κινητήρες του συστήματος μετάδοσης κίνησης. Αυτή μπορεί να χρησιμοποιηθεί με τιμές ρεύματος και ισχύος για να κατανοηθεί ο τρόπος με τον οποίο το σύστημα μετάδοσης κίνησης χρησιμοποιεί την ηλεκτρική ενέργεια.
Available Functionsdouble voltage(
voltageUnits units = voltageUnits::volt );
Παράμετρος |
Τύπος |
Περιγραφή |
|---|---|---|
|
|
The unit to return voltage in: |
Returns drivetrain voltage as a double in the selected unit.