diff --git a/source/_images/connecting.svg b/source/_images/connecting.svg index da3253a..b95318d 100644 --- a/source/_images/connecting.svg +++ b/source/_images/connecting.svg @@ -275,7 +275,7 @@ y="371.39371" x="267.87827" id="tspan966" - sodipodi:role="line">Search for your EV3 brick + sodipodi:role="line">Search for your EV3 Brick Select your EV3 brick + sodipodi:role="line">Select your EV3 Brick Connect your EV3 brick with the USB cable + 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 Project on the EV3 brick + sodipodi:role="line">Project on the EV3 Brick Delete file from the EV3 brick + 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 diff --git a/source/_images/overview.svg b/source/_images/overview.svg index 9ec0216..0059c3d 100644 --- a/source/_images/overview.svg +++ b/source/_images/overview.svg @@ -247,5 +247,5 @@ y="244.96677" x="37.086269" id="tspan4615" - sodipodi:role="line">EV3 brick + sodipodi:role="line">EV3 Brick diff --git a/source/_images/sd.svg b/source/_images/sd.svg index ae3b86a..5921096 100644 --- a/source/_images/sd.svg +++ b/source/_images/sd.svg @@ -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 + id="tspan3762">the EV3 Brick diff --git a/source/examples/robot_arm_h25.rst b/source/examples/robot_arm_h25.rst index 791b9cd..f36c110 100644 --- a/source/examples/robot_arm_h25.rst +++ b/source/examples/robot_arm_h25.rst @@ -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 `_. -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 % diff --git a/source/index.rst b/source/index.rst index 45732c4..4725806 100644 --- a/source/index.rst +++ b/source/index.rst @@ -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 `: 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 `: 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. diff --git a/source/startinstall.rst b/source/startinstall.rst index 4a50d6f..a992f67 100644 --- a/source/startinstall.rst +++ b/source/startinstall.rst @@ -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 ` 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. diff --git a/source/startrun.rst b/source/startrun.rst index daf68cd..d9a4a77 100644 --- a/source/startrun.rst +++ b/source/startrun.rst @@ -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