mirror of
https://github.com/pybricks/pybricks-api.git
synced 2026-09-12 09:37:25 +00:00
doc: nomenclature and registered signs
This commit is contained in:
Laurens Valk
@@ -275,7 +275,7 @@
|
||||
y="371.39371"
|
||||
x="267.87827"
|
||||
id="tspan966"
|
||||
sodipodi:role="line">Search for your EV3 brick</tspan></text>
|
||||
sodipodi:role="line">Search for your EV3 Brick</tspan></text>
|
||||
<circle
|
||||
r="19.024944"
|
||||
cy="389.61261"
|
||||
@@ -331,7 +331,7 @@
|
||||
y="87.784927"
|
||||
x="507.35178"
|
||||
id="tspan876"
|
||||
sodipodi:role="line">Select your EV3 brick</tspan></text>
|
||||
sodipodi:role="line">Select your EV3 Brick</tspan></text>
|
||||
<circle
|
||||
r="19.024944"
|
||||
cy="49.884659"
|
||||
@@ -382,7 +382,7 @@
|
||||
id="tspan1014"
|
||||
x="267.87827"
|
||||
y="209.69101"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Roboto Slab';-inkscape-font-specification:'Roboto Slab';fill:#404140;fill-opacity:1;stroke-width:0.60486054">Connect your EV3 brick with the USB cable</tspan></text>
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Roboto Slab';-inkscape-font-specification:'Roboto Slab';fill:#404140;fill-opacity:1;stroke-width:0.60486054">Connect your EV3 Brick with the USB cable</tspan></text>
|
||||
<text
|
||||
id="text1020"
|
||||
y="183.34192"
|
||||
|
||||
|
Before Width: | Height: | Size: 18 KiB After Width: | Height: | Size: 18 KiB |
@@ -176,7 +176,7 @@
|
||||
y="392.7229"
|
||||
x="245.8266"
|
||||
id="tspan999"
|
||||
sodipodi:role="line">Project on the EV3 brick</tspan></text>
|
||||
sodipodi:role="line">Project on the EV3 Brick</tspan></text>
|
||||
<circle
|
||||
transform="scale(1,-1)"
|
||||
r="13.407484"
|
||||
@@ -280,5 +280,5 @@
|
||||
id="tspan1043"
|
||||
x="362.9353"
|
||||
y="534.04382"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Roboto Slab';-inkscape-font-specification:'Roboto Slab';fill:#404140;fill-opacity:1;stroke-width:0.60486054">Delete file from the EV3 brick</tspan></text>
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Roboto Slab';-inkscape-font-specification:'Roboto Slab';fill:#404140;fill-opacity:1;stroke-width:0.60486054">Delete file from the EV3 Brick</tspan></text>
|
||||
</svg>
|
||||
|
||||
|
Before Width: | Height: | Size: 12 KiB After Width: | Height: | Size: 12 KiB |
@@ -247,5 +247,5 @@
|
||||
y="244.96677"
|
||||
x="37.086269"
|
||||
id="tspan4615"
|
||||
sodipodi:role="line">EV3 brick</tspan></text>
|
||||
sodipodi:role="line">EV3 Brick</tspan></text>
|
||||
</svg>
|
||||
|
||||
|
Before Width: | Height: | Size: 11 KiB After Width: | Height: | Size: 11 KiB |
@@ -238,5 +238,5 @@
|
||||
x="44.944031"
|
||||
y="85.230988"
|
||||
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-family:'Roboto Slab';-inkscape-font-specification:'Roboto Slab';fill:#404140;fill-opacity:1;stroke-width:0.60486054"
|
||||
id="tspan3762">the EV3 brick</tspan></text>
|
||||
id="tspan3762">the EV3 Brick</tspan></text>
|
||||
</svg>
|
||||
|
||||
|
Before Width: | Height: | Size: 10 KiB After Width: | Height: | Size: 10 KiB |
@@ -5,7 +5,7 @@ This example program makes the robot move the black wheel hub stacks around fore
|
||||
|
||||
You can find building instructions for the robot on the `LEGO Education website <https://le-www-live-s.legocdn.com/sc/media/lessons/mindstorms-ev3/building-instructions/ev3-model-core-set-robot-arm-h25-56cdb22c1e3a02f1770bda72862ce2bd.pdf>`_.
|
||||
|
||||
Tip: When building the robot, reverse the orientation of the EV3 brick such that the microSD card is easily accessible.
|
||||
Tip: When building the robot, reverse the orientation of the EV3 Brick such that the microSD card is easily accessible.
|
||||
|
||||
.. figure:: ../images/robot_arm.jpg
|
||||
:width: 90 %
|
||||
|
||||
+4
-4
@@ -5,12 +5,12 @@ This guide shows you how to get started writing MicroPython programs for your
|
||||
LEGO® MINDSTORMS® EV3 robots. You'll learn to do so in two steps:
|
||||
|
||||
- :doc:`Installation <startinstall>`: First you'll prepare your computer and
|
||||
your EV3 brick by collecting and installing the required tools. You'll also learn
|
||||
how to turn the EV3 brick on and off and to navigate the menu on the screen.
|
||||
your EV3 Brick by collecting and installing the required tools. You'll also learn
|
||||
how to turn the EV3 Brick on and off and to navigate the menu on the screen.
|
||||
|
||||
- :doc:`Creating and running programs <startrun>`: Next, you'll learn how to
|
||||
create a program and download it to the EV3 brick. You'll also learn how to
|
||||
start that program from your computer or from the EV3 brick.
|
||||
create a program and download it to the EV3 Brick. You'll also learn how to
|
||||
start that program from your computer or from the EV3 Brick.
|
||||
|
||||
After you've run the first demo program, you'll be ready to try out the example
|
||||
programs and start inventing your own programs.
|
||||
|
||||
+10
-10
@@ -52,7 +52,7 @@ You'll write your MicroPython programs using Visual Studio Code. Follow the step
|
||||
Preparing the microSD card
|
||||
-----------------------------------------------------------
|
||||
|
||||
To make it possible to run MicroPython programs on your EV3 brick, you'll now learn how to install the required tools on your microSD card.
|
||||
To make it possible to run MicroPython programs on your EV3 Brick, you'll now learn how to install the required tools on your microSD card.
|
||||
|
||||
If the microSD card contains files you want to keep, make sure to create a backup of its contents first. See :ref:`managing files on the EV3 <managefiles>` to learn how to backup your previous MicroPython programs if necessary.
|
||||
|
||||
@@ -85,34 +85,34 @@ To update the microSD card, download a new image file using the link above and f
|
||||
|
||||
You do not need to erase the contents of the microSD card first. This is done automatically when you flash the new image file.
|
||||
|
||||
Using the EV3 brick
|
||||
Using the EV3 Brick
|
||||
-----------------------------------------------------------
|
||||
|
||||
Make sure the EV3 brick is turned off. Insert the microSD card you prepared into the microSD card slot on the EV3 brick, as shown below.
|
||||
Make sure the EV3 Brick is turned off. Insert the microSD card you prepared into the microSD card slot on the EV3 Brick, as shown below.
|
||||
|
||||
.. figure:: images/sd.png
|
||||
:width: 75 %
|
||||
:alt: sd
|
||||
:align: center
|
||||
|
||||
Inserting the flashed microSD card into the EV3 brick
|
||||
Inserting the flashed microSD card into the EV3 Brick
|
||||
|
||||
|
||||
Turning the EV3 brick on and off
|
||||
Turning the EV3 Brick on and off
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
Turn on the EV3 brick by pressing the dark gray center button.
|
||||
Turn on the EV3 Brick by pressing the dark gray center button.
|
||||
|
||||
The boot process may take several minutes. While booting, the EV3 brick status light turns orange and blinks intermittently, and you'll see a lot of text on the EV3 screen. The EV3 brick is ready for use when the status light turns green.
|
||||
The boot process may take several minutes. While booting, the EV3 Brick status light turns orange and blinks intermittently, and you'll see a lot of text on the EV3 screen. The EV3 Brick is ready for use when the status light turns green.
|
||||
|
||||
To turn the EV3 brick off, open the shutdown menu with the back button, and then select *Power Off* using the center button, as shown below.
|
||||
To turn the EV3 Brick off, open the shutdown menu with the back button, and then select *Power Off* using the center button, as shown below.
|
||||
|
||||
.. figure:: images/onoff.png
|
||||
:width: 65 %
|
||||
:alt: devicebrowser
|
||||
:align: center
|
||||
|
||||
Turning the EV3 brick off
|
||||
Turning the EV3 Brick off
|
||||
|
||||
Viewing motor and sensor values
|
||||
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
||||
@@ -131,7 +131,7 @@ Going back to the original firmware
|
||||
|
||||
You can go back to the LEGO® firmware and your LEGO programs at any time. To do so:
|
||||
|
||||
1. Turn the EV3 brick off as shown above.
|
||||
1. Turn the EV3 Brick off as shown above.
|
||||
2. Wait for the screen and brick status light to turn off.
|
||||
3. Remove the microSD card.
|
||||
4. Turn the EV3 on.
|
||||
|
||||
+16
-16
@@ -1,13 +1,13 @@
|
||||
Creating and running programs
|
||||
=============================
|
||||
|
||||
Now that you've set up your computer and EV3 brick, you're ready to start writing programs.
|
||||
Now that you've set up your computer and EV3 Brick, you're ready to start writing programs.
|
||||
|
||||
To make it easier to create and manage your programs, let's first have a quick look at how MicroPython projects and programs for your EV3 robots are organized.
|
||||
|
||||
Programs are organized into *project folders*, as shown below. A project folder is a directory on your computer that contains the main program (**main.py**) and other optional scripts or files. This project folder and all of its contents will be copied to the EV3 brick, where the main program will be run.
|
||||
Programs are organized into *project folders*, as shown below. A project folder is a directory on your computer that contains the main program (**main.py**) and other optional scripts or files. This project folder and all of its contents will be copied to the EV3 Brick, where the main program will be run.
|
||||
|
||||
This page shows you how to create such a project and how to transfer it to the EV3 brick.
|
||||
This page shows you how to create such a project and how to transfer it to the EV3 Brick.
|
||||
|
||||
|
||||
.. figure:: images/projectstructure.png
|
||||
@@ -43,13 +43,13 @@ If you are new to MicroPython programming, we recommend that you keep the existi
|
||||
|
||||
|
||||
|
||||
Connecting to the EV3 brick with Visual Studio Code
|
||||
Connecting to the EV3 Brick with Visual Studio Code
|
||||
-----------------------------------------------------------
|
||||
|
||||
To be able to transfer your code to the EV3 brick, you'll first need to connect the EV3 brick to your computer with the mini-USB cable and configure the connection with Visual Studio Code. To do so:
|
||||
To be able to transfer your code to the EV3 Brick, you'll first need to connect the EV3 Brick to your computer with the mini-USB cable and configure the connection with Visual Studio Code. To do so:
|
||||
|
||||
- Turn the EV3 brick on
|
||||
- Connect the EV3 brick to your computer with the mini-USB cable
|
||||
- Turn the EV3 Brick on
|
||||
- Connect the EV3 Brick to your computer with the mini-USB cable
|
||||
- Configure the USB connection as shown:
|
||||
|
||||
.. figure:: images/connecting.png
|
||||
@@ -57,14 +57,14 @@ To be able to transfer your code to the EV3 brick, you'll first need to connect
|
||||
:alt: alt
|
||||
:align: center
|
||||
|
||||
Configuring the USB connection between the computer and the EV3 brick
|
||||
Configuring the USB connection between the computer and the EV3 Brick
|
||||
|
||||
Downloading and running a program
|
||||
-----------------------------------------------------------
|
||||
|
||||
You can press the F5 key to run the program. Alternatively, you can start it manually by going to the *debug* tab and clicking the green start arrow, as shown below.
|
||||
|
||||
When the program starts, a pop-up toolbar allows you to stop the program if necessary. You can also stop the program at any time using the back button on the EV3 brick.
|
||||
When the program starts, a pop-up toolbar allows you to stop the program if necessary. You can also stop the program at any time using the back button on the EV3 Brick.
|
||||
|
||||
If your program produces any output with the :mod:`print <.tools>` command, this is shown in the output window.
|
||||
|
||||
@@ -78,7 +78,7 @@ If your program produces any output with the :mod:`print <.tools>` command, this
|
||||
Expanding the example program
|
||||
-----------------------------------------------------------
|
||||
|
||||
Now that you've run the basic code template, you can expand the program to make a motor move. First, attach a Large Motor to Port B on the EV3 brick, as shown below.
|
||||
Now that you've run the basic code template, you can expand the program to make a motor move. First, attach a Large Motor to Port B on the EV3 Brick, as shown below.
|
||||
|
||||
|
||||
.. figure:: images/firstprogram.png
|
||||
@@ -86,7 +86,7 @@ Now that you've run the basic code template, you can expand the program to make
|
||||
:alt: alt
|
||||
:align: center
|
||||
|
||||
The EV3 brick with a Large Motor attached to port B.
|
||||
The EV3 Brick with a Large Motor attached to port B.
|
||||
|
||||
Next, edit *main.py* to make it look like this:
|
||||
|
||||
@@ -96,23 +96,23 @@ This program makes your robot beep, rotate the motor, and beep again with a high
|
||||
|
||||
.. _managefiles:
|
||||
|
||||
Managing files on the EV3 brick
|
||||
Managing files on the EV3 Brick
|
||||
-----------------------------------------------------------
|
||||
|
||||
After you've downloaded a project to the EV3 brick, you can run, delete, or back up programs stored on it using the device browser:
|
||||
After you've downloaded a project to the EV3 Brick, you can run, delete, or back up programs stored on it using the device browser:
|
||||
|
||||
.. figure:: images/files.png
|
||||
:width: 100 %
|
||||
:alt: alt
|
||||
:align: center
|
||||
|
||||
Using the device browser to manage files on your EV3 brick
|
||||
Using the device browser to manage files on your EV3 Brick
|
||||
|
||||
|
||||
Running a program without a computer
|
||||
-----------------------------------------------------------
|
||||
|
||||
You can run previously downloaded programs directly from the EV3 brick.
|
||||
You can run previously downloaded programs directly from the EV3 Brick.
|
||||
|
||||
To do so, find the program using the *file browser* on the EV3 screen and press the center button key to start the program.
|
||||
|
||||
@@ -121,4 +121,4 @@ To do so, find the program using the *file browser* on the EV3 screen and press
|
||||
:alt: alt
|
||||
:align: center
|
||||
|
||||
Starting a program using the buttons on the EV3 brick
|
||||
Starting a program using the buttons on the EV3 Brick
|
||||
|
||||
Reference in New Issue
Block a user