传动系统

介绍

The drivetrain includes wheels and motors that control how the robot drives and turns. Drivetrains can be found in builds like the Code Base 2.0, Super Car, or a custom robot.

Drivetrains use the Inertial Sensor in the Brain to detect crashes and help the robot move and turn precisely. At the start of each project, the drivetrain calibrates the Inertial Sensor automatically. Keep the robot still for about 2 seconds during calibration, so the robot can move and turn correctly.

There are many ways to code the drivetrain. Below is a list of all Drivetrain blocks:

动作——移动和转向机器人。

• drive — Moves the robot forward or reverse forever.

• drive for — Moves the robot forward or reverse for a specific distance.

• drive until — Moves the robot forward or reverse until the Eye Sensor detects an object or the robot detects a crash.

• turn — Turns the robot left or right forever.

• turn for — Turns the robot left or right for a specific number of degrees.

• turn to heading — Turns the robot to face a specific heading from -359 to 359 degrees. The robot will turn the shortest direction to reach the target heading.

• turn to rotation — Turns the robot to a specific rotation.

• stop driving — Stops the robot’s movement.

设置 — 调整传动系统设置。

• set drive velocity — Tells the robot how fast to drive.

• set turn velocity — Tells the robot how fast to turn.

• set drive stopping — Tells how the robot will stop moving: by braking, coasting, or holding.

• set drive timeout — Sets how many seconds the robot will try to finish a movement.

• set drive heading — Changes the robot’s current heading to a new heading.

• set drive rotation — Changes the robot’s current rotation to a new rotation.

数值 — 检查移动状态。

• drive is done — Reports whether the robot is finished moving.

• drive heading — Reports the robot’s current heading from 0 to 359 degrees.

• drive rotation — Reports the robot’s current rotation.

• drive velocity — Reports how fast the robot is driving, as a percentage from -100% to 100%.

行动

驾驶

The drive stack block moves the robot forward or reverse forever. The robot will continue to move until it is given another action, like turning or stopping.

驱动 [向前 v]

参数	描述
方向	The direction the robot moves: forward or reverse.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Drive forward then stop.]
驱动 [向前 v]
等待 (2) 秒
驱动停止

开车去

The drive for stack block moves the robot forward or reverse for a specific distance. The project will wait until the robot is done moving before the next block in the stack runs.

驱动 [向前 v] [100] [毫米 v] ▶

参数	描述
方向	The direction the robot moves: forward or reverse.
距离	The distance the robot drives. This can be an integer or a decimal.
单元	The distance unit: mm (millimeters) or inches.
and don’t wait	Select the arrow ( ▶ ) to expand the block to say and don’t wait, so the next block in the stack will run right away.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Drive back and forth.]
驱动 [向前 v] [100] [毫米 v] ▶
驱动 [反 v] [4] [英寸 v] ▶

开车直到

The drive until stack block moves the robot forward or reverse until the Eye Sensor detects an object or the robot detects a crash.

驱动 [向前 v] 直到 [对象 v] ▶

参数	描述
方向	The direction the robot moves: forward or reverse.
状况	The condition that stops the robot: object or crash.
and don’t wait	Select the arrow ( ▶ ) to expand the block to say and don’t wait, so the next block in the stack will run right away.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Turn right after a crash.]
驱动 [向前 v] 直到 [撞毁 v] ▶
[右 v] 转 (90) 度 ▶

转动

The turn stack block turns the robot left or right forever. The robot will continue to turn until it is given another action, like driving to stopping.

[右 v] 转

参数	描述
方向	The direction the robot turns: left or right.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Turn right and left, then stop.]
[右 v] 转
等待 [2] 秒
[左 v] 转
等待 [2] 秒
驱动停止

转向

The turn for stack block turns the robot left or right for a specific number of degrees. The turn is relative to the current position of the robot. The project will wait until the robot is done turning before the next block in the stack runs.

[右 v] 转 (90) 度 ▶

参数	描述
方向	The direction the robot turns: left or right.
角度	The number of degrees the robot turns. This can be an integer or a decimal.
and don’t wait	Select the arrow ( ▶ ) to expand the block to say and don’t wait, so the next block in the stack will run right away.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Turn right then left.]
[右 v] 转 (90) 度 ▶
[左 v] 转 (90) 度 ▶

转向航向

A heading is the direction the robot’s brain is facing, measured in degrees. The turn to heading stack block turns the robot to face a specific heading from -359 to 359 degrees. The robot will turn the shortest direction to reach the target heading.

The starting heading is 0 degrees.

The project will wait until the robot is done turning before the next block in the stack runs.

归位至 [90] 度 ▶

参数	描述
标题	The direction the robot should face as an integer, from -359 to 359 degrees.
and don’t wait	Select the arrow ( ▶ ) to expand the block to say and don’t wait, so the next block in the stack will run right away.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Turn to face the cardinal directions.]
归位至 [90] 度 ▶
等待 [1] 秒
归位至 [180] 度 ▶
等待 [1] 秒
归位至 [270] 度 ▶
等待 [1] 秒
归位至 [0] 度 ▶

转向旋转

The turn to rotation stack block turns the robot to a specific rotation.

Rotation is how much the robot has turned, measured in degrees. At the beginning of a project, the rotation value is set to 0 degrees. Rotation can also be set using the set drive rotation block.

Rotation values are absolute. This means the direction of the turn depends on the robot’s current rotation. Turning right increases the rotation, and turning left decreases the rotation.

For example, if the robot starts at 0 degrees and you turn to a rotation of 720 degrees, it will turn right twice. If you then turn to a rotation of 360 degrees, it will turn left once, because 360 is less than 720.

The project will wait until the robot is done turning before the next block in the stack runs.

转向至 (90) 度 ▶

参数	描述
旋转	The rotation value, in degrees, that the robot will turn to. This can be an integer.
and don’t wait	Select the arrow ( ▶ ) to expand the block to say and don’t wait, so the next block in the stack will run right away.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Make one full turn to the right.]
转向至 [360] 度 ▶
[Make another full turn to the right.]
转向至 [720] 度 ▶
[Make one full turn to the left, returning to 360 degrees.]
转向至 [360] 度 ▶

停止驾驶

The stop driving stack block stops the robot’s movement.

驱动停止

参数	描述
	该块没有参数。

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Drive forward then stop.]
驱动 [向前 v]
等待 (2) 秒
驱动停止

Settings

设置驱动速度

The set drive velocity stack block tells the robot how fast to drive. A higher percentage makes the robot drive faster and a lower percentage makes the robot drive slower.

Every project begins with the robot driving at 50% velocity by default.

Note: A higher velocity makes the robot drive faster, but it may be less precise. A lower velocity makes the robot drive slower, but be more precise.

set drive velocity to [50] %

参数	描述
速度	The velocity to drive with from 0% to 100%.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Drive at different velocities.]
驱动 [向前 v] [100] [毫米 v] ▶
等待 [1] 秒
[Drive slow.]
set drive velocity to [20] %
驱动 [向前 v] [100] [毫米 v] ▶
等待 [1] 秒
[Drive fast.]
set drive velocity to [100] %
驱动 [向前 v] [100] [毫米 v] ▶

设置转弯速度

The set turn velocity stack block tells the robot how fast to turn. A higher percentage makes the robot turn faster and a lower percentage makes the robot turn slower.

Every project begins with the robot turning at 50% velocity by default.

Note: A higher velocity makes the robot turn faster, but it may be less precise. A lower velocity makes the robot turn slower, but be more precise.

set turn velocity to [50] %

参数	描述
速度	The velocity to turn with from 0% to 100%.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Turn at different velocities.]
[右 v] 转 [180] 度 ▶
等待 [1] 秒
[Turn fast.]
set turn velocity to [100] %
[右 v] 转 [180] 度 ▶

设置驱动器停止

The set drive stopping stack block sets how the robot will stop moving: by braking, coasting, or holding.

设定驱动停止模式为 [刹车 v]

参数	描述
停止行为	How the robot will stop: brake — Stops immediately. coast — Slows to a stop. hold — Stops immediately and holds the wheels’ position.

If this block is not used, the robot will use brake when stopping.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Drive, then coast to a stop.]
set drive velocity to [100] %
设定驱动停止模式为 [滑行 v]
驱动 [向前 v]
等待 [2] 秒
驱动停止

设置驱动器超时

The set drive timeout stack block sets how many seconds 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 block in the stack. This keeps the robot from getting stuck on a movement.

设定驱动超时为 [1] 秒

参数	描述
时间	The number of seconds the robot can try to finish a movement. This can be a whole number or a decimal.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Drive as far as possible for 1 second before turning right.]
设定驱动超时为 [1] 秒
驱动 [向前 v] [25] [英寸 v] ▶
[右 v] 转 [90] 度 ▶

设置驾驶航向

A heading is the direction the robot’s brain is facing, measured in degrees. The set drive heading stack block changes the robot’s current heading to a new heading value.

For example, if the robot has turned to face right, setting the heading to 0 degrees makes that right-facing position the new 0 degrees. Then the robot can turn to other positions based on that new heading.

设定底盘归位至 [0] 度

参数	描述
标题	The heading value, in degrees, to set for the robot. This can be a whole number from 0 to 359.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Face the new 0 degree heading.]
设定底盘归位至 [90] 度
归位至 [0] 度 ▶

设置驱动器旋转

Rotation is how much the robot has turned, measured in degrees. At the beginning of a project, the rotation value is set to 0 degrees. The set drive rotation stack block changes the robot’s current rotation to a new value.

For example, if the robot has made two full turns to the right, its rotation value will be 720 degrees. Setting the rotation to 0 degrees will reset that rotation from 720 to 0 degrees. Then the robot can turn to rotations based on that new value.

设定底盘转向至 (0) 度

参数	描述
旋转	The rotation value, in degrees, to set for the robot. This can be an integer.

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Spin counterclockwise two times.]
设定底盘转向至 [720] 度
转向至 [0] 度 ▶

价值观

drive is done

The drive is done Boolean block reports whether the robot is finished moving. This can be used to control the timing of other behaviors based on the robot’s movement.

• True — The robot is finished moving.

• False — The robot is still moving.

This block works together with the following drivetrain blocks that have the and don’t wait parameter: drive for, drive until, turn for, turn to heading, and turn to rotation.

<驱动已结束?>

参数	描述
	该块没有参数。

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Turn when the drivetrain is done moving forward.]
驱动 [向前 v] [100] [毫米 v] ◀ 并且不等待
等待 [0.25] 秒
永久循环
如果 <驱动已结束?> 那么
[右 v] 转 [180] 度 ▶
退出循环
否则
打印 [Still moving...] ▶
等待 [0.1] 秒
清除所有行

行驶方向

A heading is the direction the robot’s brain is facing, measured in degrees. The drive heading reporter block reports that heading from 0 to 359 degrees.

The robot’s starting heading is 0 degrees.

(底盘归位角度值)

参数	描述
	该块没有参数。

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Display the heading while turning.]
[右 v] 转 [450] 度 ◀ 并且不等待
永久循环
清除所有行
打印 (底盘归位角度值) ▶
等待 [0.1] 秒

驱动旋转

Rotation is how much the robot has turned, measured in degrees. At the beginning of a project, the rotation value is set to 0 degrees. The drive rotation reporter block reports the robot’s current rotation.

Turning right increases the rotation, and turning left decreases the rotation. For example, making two full turns to the right will report a rotation of 720 degrees.

(底盘转向角度值)

参数	描述
	该块没有参数。

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Display the rotation while turning.]
[右 v] 转 [450] 度 ◀ 并且不等待
永久循环
清除所有行
打印 (底盘转向角度值) ▶
等待 [0.1] 秒

驱动速度

The drive velocity reporter block reports how fast the robot is driving, as a percentage from -100% to 100%.

A positive value means the robot is driving forward. A negative value means the robot is driving in reverse.

(驱动速度为%)

参数	描述
	该块没有参数。

例子

当开始 :: hat events
[Build Used: Code Base 2.0]
[Display the velocity of the robot before and while moving.]
打印 [Start: ] ▶
打印 (驱动速度为%) ▶
设定光标至下一行
驱动 [向前 v]
等待 [0.5] 秒
打印 [Moving: ] ▶
打印 (驱动速度为%) ▶
驱动停止