c_meyer/pxt-ev3
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Edits from LEGO team review (#676)

Browse Source
This commit is contained in:
Galen Nickel 2018-06-12 06:46:44 -07:00 committed by Peli de Halleux
parent 1d442b7de9
commit 5de5b64e61
15 changed files with 89 additions and 90 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/getting-started.md
View File

@ -7,7 +7,7 @@
{ {
"name": "Prepare", "name": "Prepare",
"imageUrl": "/static/lessons/firmware.png", "imageUrl": "/static/lessons/firmware.png",
"description": "To use Microsoft MakeCode with your EV3 Brick, you will need to install the latest LEGO MINDSTORMS Education EV3 firmware - version 1.10 or higher. Follow these steps to install the latest firmware from LEGO.", "description": "To use Microsoft MakeCode with your EV3 Brick, you will need to install the latest LEGO® MINDSTORMS® Education EV3 firmware. Follow these steps to make sure you're up to date and install the latest firmware if you need to.",
"label": "New? Start Here!", "label": "New? Start Here!",
"labelClass": "red ribbon large", "labelClass": "red ribbon large",
"url": "https://makecode.mindstorms.com/troubleshoot" "url": "https://makecode.mindstorms.com/troubleshoot"

28
docs/troubleshoot.md
View File

@ -1,6 +1,6 @@
# Troubleshooting download problems # Troubleshooting download problems
If your're having trouble getting your code onto the EV3 Brick, try these steps to see if you can fix the problem. If you're having trouble getting your code onto the EV3 Brick, try these steps to see if you can fix the problem.
## Check your **@drivename@** firmware ## Check your **@drivename@** firmware
@ -8,11 +8,11 @@ MakeCode needs a firmware version of **1.10E** or higher installed on your brick
### ~hint ### ~hint
Firmware is the software that runs all the basic operations on your brick. Your programs run with the firmware to make the @boardname@ do all the things you want it to do. Your brick comes with the firmware already installed. You could have a brick with an older version of firmware that needs updating in order for it to work properly with MakeCode. Firmware is the software that runs all the basic operations on your EV3 Brick. Your programs and the firmware work together to make the EV3 Brick do all things you want it to. Your EV3 Brick comes with firmware pre-installed, but it may need to be updated to work properly with MakeCode.
### ~ ### ~
To check the the firmware version on your brick: To check the the firmware version on your EV3 Brick:
1. Go to the **Settings** menu (it's under the wrench tool symbol) 1. Go to the **Settings** menu (it's under the wrench tool symbol)
2. Select **Brick Info** and press ENTER 2. Select **Brick Info** and press ENTER
@ -31,7 +31,7 @@ If your a firmware version level is less than **1.10E**, you need to install an
### ~ hint ### ~ hint
**Recommended:** Upgrade with the **[EV3 Manager](https://ev3manager.education.lego.com/)** **Recommended:** Upgrade with the **[EV3 Device Manager](https://ev3manager.education.lego.com/)**
### ~ ### ~
@ -45,27 +45,27 @@ On Windows, it looks like this in Explorer:
If you don't see the **@drivename@** drive, make sure your brick is powered on and check that your USB connection is good. If you don't see the **@drivename@** drive, make sure your brick is powered on and check that your USB connection is good.
## Is my brick charged and powered on? ## The display on the EV3 Brick is blank
Make sure your brick is charged and powered on. If your brick doesn't turn on, find the charger and plug it into wall power, then connect it to your brick. Does it turn on and start up? Make sure your EV3 Brick is charged and powered on. If your it doesn't turn on, find the charger and plug it into wall power, then connect it to your EV3 Brick. Does it turn on and start up?
## Is my USB connection good? ## I still can't see my @drivename@ drive
Make sure that one end of your USB cable is firmly inserted into the port on the computer and the other end is connected to the brick. If you still can't see the **@drivename@** drive, try a different port on the computer. If that doesn't work then maybe your cable is bad or you need to reset the brick. Make sure that one end of your USB cable is firmly inserted into a USB port on the computer and the other end is connected to the EV3 Brick. If you still can't see the **@drivename@** drive, try a different port on the computer. If that doesn't work then maybe your cable is faulty or you need to reset the EV3 Brick.
## How do I reset my brick? ## How do I reset my EV3 Brick?
If you think your USB connection is good and you still can't see your **@drivename@** drive, try giving the brick a reset. You can follow these steps to reset: If you think your USB connection is good and you still can't see your **@drivename@** drive, try giving the EV3 Brick a reset. You can follow these steps to reset:
1. Using a finger from one hand, press the **Back** button. Keep holding it. 1. Using a finger from one hand, press the **Back** button. Keep holding it.
2. With your other hand, use two fingers to hold down both the **Left** button and the **Enter** button. You hold these at the same time while you're still pressing the **Back** button. 2. With your other hand, use two fingers to hold down both the **Left** button and the **Center** button. You hold these at the same time while you're still pressing the **Back** button.
3. Now, release your finger from the **Back** button. 3. Now, release your finger from the **Back** button.
4. When the brick says "Starting.." you can let go of the **Left** and **Enter** buttons. 4. When the EV3 Brick says "Starting.." you can let go of the **Left** and **Enter** buttons.
You can also watch this [How to Reset](https://www.lego.com/en-us/videos/themes/mindstorms/how-to-reset-the-ev3-p-brick-fbcbdbed398e4e12a7ce30fa662c54be) video to see how to do a reset. You can also watch this [How to Reset](https://www.lego.com/en-us/videos/themes/mindstorms/how-to-reset-the-ev3-p-brick-fbcbdbed398e4e12a7ce30fa662c54be) video.
## LEGO Support ## LEGO Support
If you've checked everything here and can't get the **@drivename@** drive to show up on your computer, you can't make the brick reset, or your program just won't download, then try the [Troubleshooting Walkthrough](https://www.lego.com/en-us/service/help/products/themes-sets/mindstorms/lego-mindstorms-ev3-troubleshooting-walkthrough-408100000009798). If you've checked everything here and can't get the **@drivename@** drive to show up on your computer, you can't make the EV3 Brick reset, or your program just won't download, then try the [Troubleshooting Walkthrough](https://www.lego.com/en-us/service/help/products/themes-sets/mindstorms/lego-mindstorms-ev3-troubleshooting-walkthrough-408100000009798).
You can also find more help at [LEGO Support](https://www.lego.com/en-us/mindstorms/support). You can also find more help at [LEGO Support](https://www.lego.com/en-us/mindstorms/support).

20
docs/tutorials.md
View File

@ -12,14 +12,14 @@ Step by step guides to coding your @boardname@.
"url":"/tutorials/wake-up", "url":"/tutorials/wake-up",
"imageUrl":"/static/tutorials/wake-up.png" "imageUrl":"/static/tutorials/wake-up.png"
}, { }, {
"name": "Make An Animation", "name": "Make an Animation",
"description": "Create a custom animation on your brick screen.", "description": "Create a custom animation on your EV3 Brick Display.",
"cardType": "tutorial", "cardType": "tutorial",
"url":"/tutorials/make-an-animation", "url":"/tutorials/make-an-animation",
"imageUrl":"/static/tutorials/make-an-animation.png" "imageUrl":"/static/tutorials/make-an-animation.png"
}, { }, {
"name": "What Animal Am I?", "name": "What Animal Am I?",
"description": "Create different animal sounds and have someone guess the what the animal is.", "description": "Create different animal effects and have someone guess what the animal is.",
"cardType": "tutorial", "cardType": "tutorial",
"url":"/tutorials/what-animal-am-i", "url":"/tutorials/what-animal-am-i",
"imageUrl":"/static/tutorials/what-animal-am-i.png" "imageUrl":"/static/tutorials/what-animal-am-i.png"
@ -37,7 +37,7 @@ Step by step guides to coding your @boardname@.
```codecard ```codecard
[{ [{
"name": "Run Motors", "name": "Run Motors",
"description": "Use the buttons to start and stop the large and medium motors.", "description": "Use the EV3 Brick buttons to start and stop the Large Motor and Medium Motor.",
"cardType": "tutorial", "cardType": "tutorial",
"url":"/tutorials/run-motors", "url":"/tutorials/run-motors",
"imageUrl":"/static/tutorials/run-motors.png" "imageUrl":"/static/tutorials/run-motors.png"
@ -49,13 +49,13 @@ Step by step guides to coding your @boardname@.
```codecard ```codecard
[{ [{
"name": "Touch to Run", "name": "Touch to Run",
"description": "Press the Touch sensor and run a motor.", "description": "Press the Touch Sensor and run a motor.",
"cardType": "tutorial", "cardType": "tutorial",
"url":"/tutorials/touch-to-run", "url":"/tutorials/touch-to-run",
"imageUrl":"/static/tutorials/touch-to-run.png" "imageUrl":"/static/tutorials/touch-to-run.png"
}, { }, {
"name": "Touch Sensor Values", "name": "Touch Sensor Values",
"description": "Check the value of a Touch sensor and stop a motor if pressed.", "description": "Check the value of a Touch Sensor and stop a motor if pressed.",
"cardType": "tutorial", "cardType": "tutorial",
"url":"/tutorials/touch-sensor-values", "url":"/tutorials/touch-sensor-values",
"imageUrl":"/static/tutorials/touch-sensor-values.png" "imageUrl":"/static/tutorials/touch-sensor-values.png"
@ -67,19 +67,19 @@ Step by step guides to coding your @boardname@.
```codecard ```codecard
[{ [{
"name": "What Color?", "name": "What Color?",
"description": "Use the Color sensor to detect different colors.", "description": "Use the Color Sensor to detect different colors.",
"cardType": "tutorial", "cardType": "tutorial",
"url":"/tutorials/what-color", "url":"/tutorials/what-color",
"imageUrl":"/static/tutorials/what-color.png" "imageUrl":"/static/tutorials/what-color.png"
}, { }, {
"name": "Line Following", "name": "Line Following",
"description": "Use the Color sensor to make a robot follow a line.", "description": "Use the Color Sensor to make a robot follow a line.",
"cardType": "tutorial", "cardType": "tutorial",
"url":"/tutorials/line-following", "url":"/tutorials/line-following",
"imageUrl":"/static/tutorials/line-following.png" "imageUrl":"/static/tutorials/line-following.png"
}, { }, {
"name": "Red Light, Green Light", "name": "Red Light, Green Light",
"description": "Play Red Light, Green Light using the Color sensor and the robot.", "description": "Play Red Light, Green Light using the Color Sensor and the robot.",
"cardType": "tutorial", "cardType": "tutorial",
"url":"/tutorials/redlight-greenlight", "url":"/tutorials/redlight-greenlight",
"imageUrl":"/static/tutorials/redlight-greenlight.png" "imageUrl":"/static/tutorials/redlight-greenlight.png"
@ -103,7 +103,7 @@ Step by step guides to coding your @boardname@.
```codecard ```codecard
[{ [{
"name": "Security Alert", "name": "Security Alert",
"description": "Build an security alert using the infrared sensor.", "description": "Build an security alert using the Infrared Sensor.",
"cardType": "tutorial", "cardType": "tutorial",
"url":"/tutorials/security-alert", "url":"/tutorials/security-alert",
"imageUrl":"/static/tutorials/security-alert.png" "imageUrl":"/static/tutorials/security-alert.png"

19
docs/tutorials/line-following.md
View File

@ -2,7 +2,7 @@
## Introduction @unplugged ## Introduction @unplugged
Make a program to follow a line using the Color sensor and reflected light. Let's test reflected light to see if it's white or black (on the line), and drive our robot accordingly. Make your @boardname@ robot follow a line using the Color Sensor's Reflected Light Intensity Mode.
![Brick with color sensors tracking a yellow line](/static/tutorials/line-following/line-following.gif) ![Brick with color sensors tracking a yellow line](/static/tutorials/line-following/line-following.gif)
@ -36,7 +36,7 @@ forever(function () {
## Step 3 ## Step 3
Open the ``||sensors:Sensors||`` Toolbox drawer. From the **Color Sensor** section, drag out a ``||sensors:color sensor light||`` value block and drop it into the second slot of the ``||logic:0 < 0||`` comparison block, replacing the `0`. Open the ``||sensors:Sensors||`` Toolbox drawer. Drag out a ``||sensors:color sensor light||`` value block and drop it into the second slot of the ``||logic:0 < 0||`` comparison block, replacing the second `0`.
```blocks ```blocks
forever(function () { forever(function () {
@ -50,7 +50,7 @@ forever(function () {
## Step 4 ## Step 4
If the value of the reflected light is greater than 40% (white or very light), our robot is outside the line, so steer to the left. In the ``||logic:0 < 0||`` comparison block change the compared value to `40` replacing `0`. If the value of the reflected light is greater than 40% (white or very light), our robot is outside the line, so steer to the left. In the ``||logic:0 < 0||`` comparison block change the first compared value from `0` to `40`.
```blocks ```blocks
forever(function () { forever(function () {
@ -64,7 +64,7 @@ forever(function () {
## Step 5 ## Step 5
Open the ``||motors:Motors||`` Toolbox drawer. Drag out **2** ``||motors:tank large motors||`` blocks and drop one of them into the ``||logic:if||`` part, and the other into the ``||logic:else||`` part of the ``||logic:if then else||`` block. Open the ``||motors:Motors||`` Toolbox drawer. Drag out **2** ``||motors:tank motors||`` blocks and drop one of them into the ``||logic:if||`` part, and the other into the ``||logic:else||`` part of the ``||logic:if then else||`` block.
```blocks ```blocks
forever(function () { forever(function () {
@ -78,7 +78,7 @@ forever(function () {
## Step 6 ## Step 6
In the first ``||motors:tank large motors||`` block in the ``||logic:if||`` clause, change the speed values of the motors from ``50%``, ``50%`` to ``5%``, ``15%``. This slows down the robot, and steers it to the left (because the **C** motor is driving faster than the **B** motor). In the first ``||motors:tank motors||`` block in the ``||logic:if||`` clause, change the speed values of the motors from ``50%``, ``50%`` to ``5%``, ``15%``. This slows down the robot and steers it to the left (because the **C** motor is driving faster than the **B** motor).
```blocks ```blocks
forever(function () { forever(function () {
@ -92,7 +92,7 @@ forever(function () {
## Step 7 ## Step 7
In the second ``||motors:tank large motors||`` block in the ``||logic:else||`` clause, change the speed values of the motors from ``50%``, ``50%`` to ``15%``, ``5%``. This slows down the robot, and steers it to the right (because the **B** motor is driving faster than the **C** motor). In the second ``||motors:tank motors||`` block in the ``||logic:else||`` clause, change the speed values of the motors from ``50%``, ``50%`` to ``15%``, ``5%``. This slows down the robot and steers it to the right (because the **B** motor is driving faster than the **C** motor).
```blocks ```blocks
forever(function () { forever(function () {
@ -110,11 +110,10 @@ Use the EV3 simulator to try out your code.
![Brick with color sensors tracking a yellow line](/static/tutorials/line-following/line-following.gif) ![Brick with color sensors tracking a yellow line](/static/tutorials/line-following/line-following.gif)
Move the slider under the Color Sensor to change the reflected light and check that motors Move the slider under the Color Sensor to change the reflected light intensity and check that motors are moving as you would expect.
are moving as you would expect!
## Step 9 ## Step 9
Plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the brick. Plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the EV3 Brick.
Attach a Color Sensor to Port 3 of your brick, and attach your brick to a driving base with large motors attached to Ports B and C. See the instructions for building a _Driving Base with Color Sensor Down_. Test your program by positioning your robot to the right of a dark, thick line and then let it drive! Attach a Color Sensor to Port 3 of your EV3 Brick, and attach your brick to a driving base with large motors attached to Ports B and C. See the instructions for building a _Driving Base with Color Sensor Down_. Test your program by positioning your robot to the right of a dark, thick line and then let it drive!

8
docs/tutorials/make-an-animation.md
View File

@ -2,9 +2,9 @@
## Introduction @unplugged ## Introduction @unplugged
Create a custom animation for your @boardname@. Create a custom animation for your EV3 Brick
![Button press on brick](/static/tutorials/make-an-animation/button-pressed.gif) ![Button press on EV3 Brick](/static/tutorials/make-an-animation/button-pressed.gif)
## Step 1 ## Step 1
@ -46,7 +46,7 @@ brick.showString("Press my button!", 1)
## Step 5 ## Step 5
Try out your code in the EV3 simulator! Try out your code in the EV3 Brick simulator!
Press the ``Enter`` button and check that the image shows up as you expected. Press the ``Enter`` button and check that the image shows up as you expected.
@ -64,4 +64,4 @@ brick.showString("Press my button!", 1)
## Step 7 ## Step 7
Plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the brick. Plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the EV3 Brick.

4
docs/tutorials/music-brick.md
View File

@ -25,7 +25,7 @@ brick.showString("Press my buttons to make music!", 1)
## Step 3 ## Step 3
Open the ``||brick:Brick||`` Toolbox drawer. From the **Buttons** section, drag out an ``||brick:on button||`` block onto the Workspace (you can put it anywhere). Open the ``||brick:Brick||`` Toolbox drawer. From the **Buttons** section, drag out an ``||brick:on button||`` block anywhere onto the Workspace.
```blocks ```blocks
brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () { brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
@ -68,7 +68,7 @@ brick.showString("Press my buttons to make music!", 1)
## Step 6 ## Step 6
Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the brick. Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the EV3 Brick.
You can add more ``||brick:on button||`` blocks to the Workspace and create other ``||music:play tone||`` melodies when different buttons are pressed to transform your brick into a musical instrument! You can add more ``||brick:on button||`` blocks to the Workspace and create other ``||music:play tone||`` melodies when different buttons are pressed to transform your brick into a musical instrument!

4
docs/tutorials/object-near.md
View File

@ -134,6 +134,6 @@ forever(function () {
## Step 10 ## Step 10
Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the brick. Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the EV3 Brick.
Attach an Ultrasonic Sensor to Port 4 of your brick. Test your program by putting an object at different distances in front of the Ultrasonic Sensor – an object 50 centimeters or closer should be detected. Attach an Ultrasonic Sensor to Port 4 of your EV3 Brick. Test your program by putting an object at different distances in front of the Ultrasonic Sensor – an object 50 centimeters or closer should be detected.

14
docs/tutorials/redlight-greenlight.md
View File

@ -2,13 +2,13 @@
## Introduction @unplugged ## Introduction @unplugged
Use the ``||sensors:pause color sensor||`` block to play Red Light, Green Light with your @boardname@ robot! Use the ``||sensors:pause until color sensor detected||`` block to play Red Light, Green Light with your @boardname@ robot!
![Brick simulation with color sensor and motors](/static/tutorials/redlight-greenlight/redlight-greenlight.gif) ![Brick simulation with color sensor and motors](/static/tutorials/redlight-greenlight/redlight-greenlight.gif)
## Step 1 ## Step 1
Open the ``||sensors:Sensors||`` Toolbox drawer. Drag out **2** ``||sensors:pause color sensor||`` blocks onto the Workspace, and drop them into the ``||loops:forever||`` loop. Open the ``||sensors:Sensors||`` Toolbox drawer. Drag out **2** ``||sensors:pause until color sensor detected||`` blocks onto the Workspace, and drop them into the ``||loops:forever||`` loop.
```blocks ```blocks
forever(function () { forever(function () {
@ -19,7 +19,7 @@ forever(function () {
## Step 2 ## Step 2
In the first ``||sensors:pause color sensor||`` block, use the second drop-down menu to select the "Green" color. In the second ``||sensors:pause color sensor||`` block, use the second drop-down menu to select the "Red" color. In the first ``||sensors:pause until color sensor detected||`` block, use the second drop-down menu to select the Green color. In the second ``||sensors:pause until color sensor detected||`` block, use the second drop-down menu to select the Red color.
![Color selection dropdown](/static/tutorials/redlight-greenlight/pause-color-sensor-dropdown.png) ![Color selection dropdown](/static/tutorials/redlight-greenlight/pause-color-sensor-dropdown.png)
@ -32,7 +32,7 @@ forever(function () {
## Step 3 ## Step 3
Open the ``||motors:Motors||`` Toolbox drawer. Drag out a ``||motors:tank large motors||`` block onto the Workspace, and drop in between the ``||sensors:pause color sensor||`` blocks. Open the ``||motors:Motors||`` Toolbox drawer. Drag out a ``||motors:tank motors||`` block onto the Workspace, and drop in between the ``||sensors:pause until color sensor detected||`` blocks.
```blocks ```blocks
forever(function () { forever(function () {
@ -44,7 +44,7 @@ forever(function () {
## Step 4 ## Step 4
Open the ``||motors:Motors||`` Toolbox drawer. Drag out a ``||motors:stop all motors||`` block onto the Workspace, and drop it in after the second ``||sensors:pause color sensor||`` block in the ``||loops:forever||`` loop. Open the ``||motors:Motors||`` Toolbox drawer. Drag out a ``||motors:stop all motors||`` block onto the Workspace, and drop it in after the second ``||sensors:pause until color sensor detected||`` block in the ``||loops:forever||`` loop.
```blocks ```blocks
forever(function () { forever(function () {
@ -57,6 +57,6 @@ forever(function () {
## Step 5 ## Step 5
Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the brick. Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the EV3 Brick.
Attach a Color Sensor to Port 3 of your brick, and attach your brick to a driving base with large motors attached to Ports B and C. See the building instructions for: _Driving Base with Color Sensor Forward_. Test your program by putting a green or red piece of paper or LEGO brick in front of the color sensor. Attach a Color Sensor to Port 3 and attach your EV3 Brick to a driving base with Large Motors attached to Ports B and C. See the building instructions for: _Driving Base with Color Sensor Forward_. Test your program by putting a green or red piece of paper or LEGO brick in front of the Color Sensor.

18
docs/tutorials/run-motors.md
View File

@ -2,13 +2,13 @@
## Introduction @unplugged ## Introduction @unplugged
Use the buttons to start and stop the large and medium motors. Use the buttons to start and stop the Large Motor and Medium Motor.
![Motors in simulator running](/static/tutorials/run-motors/run-motors.gif) ![Motors in simulator running](/static/tutorials/run-motors/run-motors.gif)
## Step 1 ## Step 1
Open the ``||brick:Brick||`` Toolbox drawer. Drag out **2** ``||brick:on button||`` blocks onto the Workspace (you can place these anywhere on the Workspace). Open the ``||brick:Brick||`` Toolbox drawer. Drag out **2** ``||brick:on button||`` blocks anywhere onto the Workspace.
```blocks ```blocks
brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () { brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
@ -49,9 +49,9 @@ brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
## Step 4 ## Step 4
The ``||motors:run||`` blocks specify which type of motor to run (Large or Medium), and which port the motor is attached to (Ports A, B, C, or D). The default setting is to run the large motor attached to port A at 50% speed. The ``||motors:run||`` blocks specify which type of motor to run (Large Motor or Medium Motor), and which port the motor is attached to (Ports A, B, C, or D). The default setting is to run the Large Motor attached to Port A at 50% speed.
When we press the Down button, we want our motor to run in the reverse direction. In the ``||motors:run||`` block that is in the ``||brick:on button down pressed||`` block, change the speed value from ``50%`` to ``-50%``. When we press the ``down`` button, we want our motor to run in the reverse direction. In the ``||motors:run||`` block that is in the ``||brick:on button down pressed||`` block, change the speed value from ``50%`` to ``-50%``.
![Motor speed select field](/static/tutorials/run-motors/run-speed-field.png) ![Motor speed select field](/static/tutorials/run-motors/run-speed-field.png)
@ -104,7 +104,7 @@ brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
## Step 7 ## Step 7
For the ``||motors:run||`` blocks that are in the ``||brick:on button left||`` and ``||brick:on button right||`` blocks, use the drop-down menu to select a ``medium motor`` on port ``D``. For the ``||motors:run||`` blocks that are in the ``||brick:on button left||`` and ``||brick:on button right||`` blocks, use the drop-down menu to select a ``medium motor`` on Port ``D``.
| | | | | | | |
|-|-|-| |-|-|-|
@ -146,7 +146,7 @@ brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
## Step 9 ## Step 9
Let’s also change the speed that our Medium motors are running at. In the ``||motors:run medium motor||`` block that is in the ``||brick:on button left||`` block, change the speed from ``50%`` to ``10%``. Let’s also change the speed that our Medium Motor is running at. In the ``||motors:run medium motor||`` block that is in the ``||brick:on button left||`` block, change the speed from ``50%`` to ``10%``.
```blocks ```blocks
brick.buttonUp.onEvent(ButtonEvent.Pressed, function () { brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
@ -206,7 +206,7 @@ brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
## Step 12 ## Step 12
Open the ``||motors:Motors||`` Toolbox drawer. Drag out a ``||motors:stop all motors||`` block onto the Workspace, and drop into the ``||brick:on button||`` enter block. Open the ``||motors:Motors||`` Toolbox drawer. Drag out a ``||motors:stop all motors||`` block onto the Workspace, and drop it into the ``||brick:on button enter||`` block.
```blocks ```blocks
brick.buttonUp.onEvent(ButtonEvent.Pressed, function () { brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
@ -228,6 +228,6 @@ brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
## Step 13 ## Step 13
Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the brick. Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the EV3 Brick.
Attach a Large motor to Port A, and a Medium motor to Port D. Test your program by pressing the different buttons to see whether the correct motors are running as expected. Attach a Large Motor to Port A, and a Medium Motor to Port D. Test your program by pressing the different buttons to see whether the correct motors are running as expected.

16
docs/tutorials/security-alert.md
View File

@ -2,13 +2,13 @@
## Introduction @unplugged ## Introduction @unplugged
The Infrared Sensor uses infrared light waves to detect proximity to the robot. Build an security alert using the infrared sensor. The Infrared Sensor uses infrared light waves to detect proximity to the robot. Build an security alert using the Infrared Sensor.
![Brick in simulator with infrared sensor](/static/tutorials/security-alert/security-alert.gif) ![Brick in simulator with infrared sensor](/static/tutorials/security-alert/security-alert.gif)
## Step 1 ## Step 1
Open the ``||sensors:Sensors||`` Toolbox drawer. Drag out an ``||sensors:on infrared||`` block onto the Workspace (you can place this anywhere). Use the second drop-down menu to select ``detected``. Open the ``||sensors:Sensors||`` Toolbox drawer. Drag out an ``||sensors:on infrared object||`` block onto the Workspace (you can place this anywhere). Select ``detected`` from the second dropdown menu.
![Sensor detect method dropdown selections](/static/tutorials/security-alert/detect-method-dropdown.png) ![Sensor detect method dropdown selections](/static/tutorials/security-alert/detect-method-dropdown.png)
@ -20,7 +20,7 @@ sensors.infrared1.onEvent(InfraredSensorEvent.ObjectDetected, function () {
## Step 2 ## Step 2
Open the ``||brick:Brick||`` Toolbox drawer. From the **Screen** section, drag out a ``||brick:show image||`` block onto the Workspace, and drop it into the ``||sensors:on infrared||`` block. Open the ``||brick:Brick||`` Toolbox drawer. From the **Screen** section, drag out a ``||brick:show image||`` block onto the Workspace, and drop it into the ``||sensors:on infrared object||`` block.
```blocks ```blocks
sensors.infrared1.onEvent(InfraredSensorEvent.ObjectDetected, function () { sensors.infrared1.onEvent(InfraredSensorEvent.ObjectDetected, function () {
@ -42,7 +42,7 @@ sensors.infrared1.onEvent(InfraredSensorEvent.ObjectDetected, function () {
## Step 4 ## Step 4
Open the ``||brick:Brick||`` Toolbox drawer. From the **Buttons** section, drag out a ``||brick:set status light||`` block onto the Workspace, and drop it after the ``||brick:show image||`` block. Open the ``||brick:Brick||`` Toolbox drawer. From the **Buttons** section, drag out a ``||brick:set status light to||`` block onto the Workspace, and drop it after the ``||brick:show image||`` block.
```blocks ```blocks
sensors.infrared1.onEvent(InfraredSensorEvent.ObjectDetected, function () { sensors.infrared1.onEvent(InfraredSensorEvent.ObjectDetected, function () {
@ -53,7 +53,7 @@ sensors.infrared1.onEvent(InfraredSensorEvent.ObjectDetected, function () {
## Step 5 ## Step 5
In the ``||brick:set status light||`` block, use the drop-down menu to select the ``red flash`` light In the ``||brick:set status light to||`` block, use the drop-down menu to select the ``red flash`` light
![Status light selection dropdown list](/static/tutorials/security-alert/set-status-light-dropdown.png) ![Status light selection dropdown list](/static/tutorials/security-alert/set-status-light-dropdown.png)
@ -66,7 +66,7 @@ sensors.infrared1.onEvent(InfraredSensorEvent.ObjectDetected, function () {
## Step 6 ## Step 6
Open the ``||loops:Loops||`` Toolbox drawer. Drag a ``||loops:repeat||`` loop onto the Workspace, and drop it after the ``||brick:set status light||`` block. Open the ``||loops:Loops||`` Toolbox drawer. Drag a ``||loops:repeat||`` loop onto the Workspace, and drop it after the ``||brick:set status light to||`` block.
```blocks ```blocks
sensors.infrared1.onEvent(InfraredSensorEvent.ObjectDetected, function () { sensors.infrared1.onEvent(InfraredSensorEvent.ObjectDetected, function () {
@ -100,6 +100,6 @@ In the ``||music:play sound effect until done||`` block, use the drop-down menu
## Step 9 ## Step 9
Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the brick. Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the EV3 Brick.
Attach an Infrared Sensor to Port 1 of your brick. Test your program by putting an object increasingly closer to the Infrared Sensor – your Intruder Alert should trigger when you get too close! Attach an Infrared Sensor to Port 1 of your Ev3 Brick. Test your program by putting an object increasingly closer to the Infrared Sensor – your Intruder Alert should trigger when you get too close!

4
docs/tutorials/touch-sensor-values.md
View File

@ -2,13 +2,13 @@
## Introduction @unplugged ## Introduction @unplugged
Use the Touch sensor value to stop a running motor. Use the Touch Sensor value to stop a running motor.
![Touch sensor and motor attached to brick](/static/tutorials/touch-sensor-values/touch-to-stop.gif) ![Touch sensor and motor attached to brick](/static/tutorials/touch-sensor-values/touch-to-stop.gif)
## Step 1 ## Step 1
Open the ``||brick:Brick||`` Toolbox drawer. Drag an ``||brick:on button||`` block onto the Workspace, and place it anywhere on the Workspace. Open the ``||brick:Brick||`` Toolbox drawer. Drag an ``||brick:on button||`` block onto the Workspace, and place it anywhere.
```blocks ```blocks
brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () { brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {

8
docs/tutorials/touch-to-run.md
View File

@ -2,13 +2,13 @@
## Introduction @unplugged ## Introduction @unplugged
Use the Touch sensor to run a motor. Use the Touch Sensor to run a motor.
![Large motor connected to brick](/static/tutorials/touch-to-run/touch-to-run.gif) ![Large motor connected to brick](/static/tutorials/touch-to-run/touch-to-run.gif)
## Step 1 ## Step 1
Open the ``||sensors:Sensors||`` Toolbox drawer. Drag out **2** ``||sensors:on touch||`` blocks onto the Workspace (you can place these anywhere). Open the ``||sensors:Sensors||`` Toolbox drawer. Drag out **2** ``||sensors:on touch||`` blocks anywhere onto the Workspace.
```blocks ```blocks
sensors.touch1.onEvent(ButtonEvent.Pressed, function () { sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
@ -62,6 +62,6 @@ sensors.touch1.onEvent(ButtonEvent.Released, function () {
## Step 5 ## Step 5
Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the brick. Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the EV3 Brick.
Attach a Large motor to Port A, and a Touch sensor to Port 1 on your brick. Test your program by pressing and releasing the touch sensor – does the motor start and stop as expected? Attach a Large Motor to Port A, and a Touch Sensor to Port 1 on your EV3 Brick. Test your program by pressing and releasing the touch sensor – does the motor start and stop as expected?

2
docs/tutorials/wake-up.md
View File

@ -16,7 +16,7 @@ brick.showMood(moods.sleeping)
## Step 2 ## Step 2
Notice your brick is snoring with eyes closed in the simulator! Let’s wake her up. Open the ``||brick:Brick||`` Toolbox drawer again. Drag out **2** more ``||brick:show mood||`` blocks and drop them into the ``||brick:on start||`` block also. Notice your EV3 Brick is snoring with eyes closed in the simulator! Let’s wake it up. Open the ``||brick:Brick||`` Toolbox drawer again. Drag out **2** more ``||brick:show mood||`` blocks and drop them into the ``||brick:on start||`` block also.
```blocks ```blocks
brick.showMood(moods.sleeping) brick.showMood(moods.sleeping)

20
docs/tutorials/what-animal-am-i.md
View File

@ -16,21 +16,21 @@ brick.showString("Hello world", 1)
## Step 2 ## Step 2
In the ``||brick:show string||`` block, type the text ``"Guess what animal?"`` to replace ``"Hello world"``. In the ``||brick:show string||`` block, type the text ``"Guess teh animal"`` to replace ``"Hello world"``.
```blocks ```blocks
brick.showString("Guess what animal?", 1) brick.showString("Guess the animal", 1)
``` ```
## Step 3 ## Step 3
Open the ``||brick:Brick||`` Toolbox drawer. From the **Buttons** section, drag out an ``||brick:on button||`` block and put it anywhere in the Workspace. Open the ``||brick:Brick||`` Toolbox drawer. From the **Buttons** section, drag out an ``||brick:on button||`` block anywhere onto the Workspace.
```blocks ```blocks
brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () { brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
         
}) })
brick.showString("Guess what animal?", 1) brick.showString("Guess the animal", 1)
``` ```
## Step 4 ## Step 4
@ -43,7 +43,7 @@ In the ``||brick:on button||`` block, use the drop-down menu to select the ``lef
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () { brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
         
}) })
brick.showString("Guess what animal?", 1) brick.showString("Guess the animal", 1)
``` ```
## Step 5 ## Step 5
@ -63,7 +63,7 @@ brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () { brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
         
}) })
brick.showString("Guess what animal?", 1) brick.showString("Guess the animal", 1)
``` ```
## Step 6 ## Step 6
@ -83,7 +83,7 @@ brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () { brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.expressionsBigSmile) brick.showImage(images.expressionsBigSmile)
}) })
brick.showString("Guess what animal?", 0) brick.showString("Guess the animal", 0)
``` ```
## Step 7 ## Step 7
@ -105,7 +105,7 @@ brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () { brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.objectsPirate) brick.showImage(images.objectsPirate)
}) })
brick.showString("Guess what animal?", 0) brick.showString("Guess the animal", 0)
``` ```
## Step 8 ## Step 8
@ -129,7 +129,7 @@ brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.objectsPirate) brick.showImage(images.objectsPirate)
music.playSoundEffect(sounds.animalsCatPurr) music.playSoundEffect(sounds.animalsCatPurr)
}) })
brick.showString("Guess what animal?", 0) brick.showString("Guess the animal", 0)
``` ```
## Step 9 ## Step 9
@ -155,7 +155,7 @@ brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
brick.showImage(images.objectsPirate) brick.showImage(images.objectsPirate)
music.playSoundEffect(sounds.animalsSnakeHiss) music.playSoundEffect(sounds.animalsSnakeHiss)
}) })
brick.showString("Guess what animal?", 0) brick.showString("Guess the animal", 0)
``` ```
## Step 10 ## Step 10

12
docs/tutorials/what-color.md
View File

@ -2,7 +2,7 @@
## Introduction @unplugged ## Introduction @unplugged
Use the Color sensor to detect different colors. Use the Color Sensor to detect different colors.
![Simulator view with color sensor](/static/tutorials/what-color/color-detector.gif) ![Simulator view with color sensor](/static/tutorials/what-color/color-detector.gif)
@ -24,7 +24,7 @@ brick.showString("What color?", 1)
## Step 3 ## Step 3
Open the ``||sensors:Sensors||`` Toolbox drawer. Drag out **3** ``||sensors:on color sensor detected||`` blocks onto the Workspace (you can place these anywhere). Open the ``||sensors:Sensors||`` Toolbox drawer. Drag out **3** ``||sensors:on color sensor detected||`` blocks anywhere onto the Workspace.
```blocks ```blocks
sensors.color3.onColorDetected(ColorSensorColor.Blue, function () { sensors.color3.onColorDetected(ColorSensorColor.Blue, function () {
@ -57,7 +57,7 @@ brick.showString("What color?", 1)
## Step 5 ## Step 5
Open the ``||brick:Brick||`` Toolbox drawer. From the **Buttons** section, drag out a **3** ``||brick:set status light||`` blocks and drop one of them each into the ``||sensors:on color detected||`` blocks. Open the ``||brick:Brick||`` Toolbox drawer. From the **Buttons** section, drag out **3** ``||brick:set status light||`` blocks and drop one of them each into the ``||sensors:on color sensor detected||`` blocks.
```blocks ```blocks
sensors.color3.onColorDetected(ColorSensorColor.Red, function () { sensors.color3.onColorDetected(ColorSensorColor.Red, function () {
@ -91,7 +91,7 @@ brick.showString("What color?", 1)
## Step 7 ## Step 7
Open the ``||music:Music||`` Toolbox drawer. Drag out **3** ``||music:play sound effect||`` blocks and drop one of them each into the ``||sensors:on color detected||`` blocks after the ``||brick:set status light||`` block. Open the ``||music:Music||`` Toolbox drawer. Drag out **3** ``||music:play sound effect||`` blocks and drop one of them each into the ``||sensors:on color sensor detected||`` blocks after the ``||brick:set status light||`` block.
```blocks ```blocks
sensors.color3.onColorDetected(ColorSensorColor.Red, function () { sensors.color3.onColorDetected(ColorSensorColor.Red, function () {
@ -131,6 +131,6 @@ brick.showString("What color?", 1)
## Step 9 ## Step 9
Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the brick. Now, plug your EV3 Brick into the computer with the USB cable, and click the **Download** button at the bottom of your screen. Follow the directions to save your program to the EV3 Brick.
Attach a Color Sensor to Port 3 of your brick. Test your program by flashing Red, Green and Yellow colored paper or use LEGO bricks in front of the Color Sensor. Attach a Color Sensor to Port 3 of your EV3 Brick. Test your program by flashing Red, Green and Yellow colored paper or use LEGO bricks in front of the Color Sensor.