从 v1.0 升级到 v2.0

开始

专题

EV3 MicroPython 2.0 版本于 2020 年 5 月 18 日发布。

本节适用于以前使用过 LEGO MINDSTORMS EV3 MicroPython v1.0 的用户。我们将解释更改内容以及如何升级以从最新改进中受益。

如果您是新用户并且刚刚开始使用 2.0 版，则可以跳过此部分。

升级 microSD 卡

要升级，请下载最新的 microSD 卡文件并按照标准说明进行安装。

请注意，这将删除 SD 卡上的所有现有文件。在你之前升级，请确保您的计算机上仍然有所有项目。如果没有，您可以使用以下命令将文件上传回您的计算机这些说明。

与任何软件更新一样， 更新时要小心 。例如，如果您使用 v1.0 版本开发代码，并且机器人竞赛赛季已经过半，您可能希望暂时坚持使用 v1.0。

v2.0 中的大多数更改都是新功能 ，例如对其他传感器的支持。当然，这不会影响您现有的代码。但是，对现有功能进行了一些更改以提高性能。

升级后，v1.0 中所有最初记录的功能仍将有效。这意味着大多数最初为 v1.0 制作的程序都可以使用 v2.0 microSD 卡映像，无需任何更改。

要尝试此作，只需像以前一样下载并运行原始代码即可。

但是，建议您同时升级 microSD 卡和程序，以确保一切按预期工作。

2.0 版引入了 EV3Brick（）类。您可以使用它来代替旧的 ev3brick 模块。旧的 ev3brick 模块仍然可以使用，但不再推荐或记录。

EV3Brick（）类提高了 EV3 屏幕和 EV3 扬声器的速度和可靠性。它还添加了语音和绘图形状等功能。默认字体大小也更大，以便更轻松地阅读屏幕上的文本。

您可以使用下表作为升级脚本的起点。请参阅 EV3Brick（）类文档，了解所有方法和参数的完整详细信息。

Action	v1.0	v2.0
Initialize your EV3	`from pybricks import ev3brick as brick`	`from pybricks.hubs import EV3Brick ev3 = EV3Brick()`
Light on	`brick.light(Color.RED)`	`ev3.light.on(Color.RED)`
Light off	`brick.light(None)`	`ev3.light.off()`
Read Buttons	`if Button.LEFT in brick.buttons(): print("Left is pressed.")`	`if Button.LEFT in ev3.buttons.pressed(): print("Left is pressed.")`
Play a beep	`brick.sound.beep()`	`ev3.speaker.beep()`
Play a sound file	`brick.sound.file(SoundFile.HELLO)`	`ev3.speaker.play_file(SoundFile.HELLO)`
Text to speech		`ev3.speaker.say("I can say anything!")`
Play notes		`ev3.speaker.play_notes(['C4/4', 'G4/4'])`
Write text at a given position	`brick.display.text("Hello!", (50, 60))`	`ev3.screen.draw_text(50, 60, "Hello!")`
Write text and scroll automatically	`brick.display.text("Hello") brick.display.text("world!")`	`ev3.screen.print("Hello") ev3.screen.print("world!")`
Change font size		`from pybricks.media.ev3dev import Font big_font = Font(size=24) ev3.screen.set_font(big_font)`
Display an image on the screen	`from pybricks.parameters import ImageFile brick.display.image(ImageFile.QUESTION_MARK)`	`from pybricks.media.ev3dev import ImageFile ev3.screen.load_image(ImageFile.Question_MARK)`
Draw shapes on the screen		`ev3.screen.draw_line(30, 30, 30, 100) ev3.screen.draw_box(50, 30, 90, 60) ev3.screen.draw_circle(70, 90, 20, fill=True)`
Read battery voltage	`brick.battery.voltage()`	`ev3.battery.voltage()`

Motor（）类的大多数方法现在默认使用 Stop.HOLD 而不是 Stop.COAST。这提高了大多数应用的准确性。如果您愿意，您仍然可以选择 Stop.COAST。
电机的内部 PID 控制器比以前更精确。如果您在电机已经运行时发出命令，它会根据新给出的命令平滑地调整速度。即使您在快速循环中不断调整速度，这也有效。
配置电机设置的方法已更改。您现在可以使用控制属性更改设置。旧的设置设置器继续存在于实现中，但不再记录它们。
现在支持所谓的 Python 关键字参数 。以前，您只能输入参数值。例如：
```
my_motor.run_angle(500, 90, Stop.HOLD, False) 
```
这仍然是可能的。但您现在可以选择省略可选参数并使用关键字指定其他参数。这可以使您的代码更易于阅读。例如：
```
my_motor.run_angle(500, 90, wait=False) 
```
不再需要导入 pybricks.tools.print。印刷品函数现在内置了。它的工作原理就像 Python 或 MicroPython 一样。
参数中的大多数参数现在具有特定的类型和表示形式。例如，假设您测量一种颜色并打印结果。如果您打印（Color.RED），您将看到参数而不是技术编号。
声音和图像文件已移至专用媒体模块。从旧位置导入它们将在此版本中继续工作，以确保现有脚本仍然有效。

安装旧版本的 Visual Studio Code 扩展

Visual Studio Code 扩展和本文档会自动更新。您仍然可以将现有脚本与更新的扩展一起使用。如果您绝对希望保留旧版本，请在扩展选项卡上查找 EV3 扩展，单击齿轮图标，然后单击安装其他版本 。