diff --git a/docs/about.md b/docs/about.md index 8eb2c70f..d4cbe299 100644 --- a/docs/about.md +++ b/docs/about.md @@ -17,29 +17,31 @@ brick.buttonEnter.onEvent(ButtonEvent.Bumped, () => { }) ``` -The editor work in [most modern browsers](/browsers), work [offline](/offline) once loaded and do not require any installation. +The editor works in [most modern browsers](/browsers). It works [offline](/offline) once loaded and doesn't require any installation. ## Compile and Flash: Your Program! -When you have your code ready, you connect your @boardname@ to a computer via a USB cable -so it appears as a mounted drive (named **EV3**). +When you have your code ready, you connect your EV3 Brick to a computer with a USB cable so it appears as an attached drive (named **@drivename@**). Compilation to machine code from [Blocks](/blocks) or [JavaScript](/javascript) happens in the browser. You save the binary -program to a **.uf2** file, which you then copy to the **EV3** drive, which flashes the device with the new program. +program to a **.uf2** file, which you then copy to the **@drivename@** drive. The process of copying will flash the device with the new program. ### ~ hint -Not seeing the **EV3** drive? Make sure to upgrade your firmware at https://ev3manager.education.lego.com/. +Not seeing the **@drivename@** drive? Make sure to upgrade your firmware at https://ev3manager.education.lego.com/. Try these [troubleshooting](/troubleshoot) tips if you still have trouble getting the drive to appear. ### ~ ## Simulator: Test Your Code -You can run your code using the micro:bit simulator, all within the confines of a web browser. -The simulator has support for the LED screen, buttons, as well as compass, accelerometer, and digital I/O pins. +You can run your code using the @boardname@ simulator, all inside the same browser window. +The simulator has support for the EV3 Brick screen, buttons, sensors, and motors. ```sim brick.buttonEnter.onEvent(ButtonEvent.Bumped, () => { motors.largeA.run(50) + motors.mediumD.run(50) + sensors.touch1.pauseUntil(ButtonEvent.Pressed) + sensors.ultrasonic4.pauseUntil(UltrasonicSensorEvent.ObjectDetected) }) -``` +``` \ No newline at end of file diff --git a/docs/labview.md b/docs/labview.md index 7e254589..34eb20d6 100644 --- a/docs/labview.md +++ b/docs/labview.md @@ -29,9 +29,9 @@ motors.largeA.stop() ## Download to the EV3 -Before you actually run your program on the @boardname@, you can first try it in the simulator. The MakeCode editor includes a simulator in the browser for you to test your code. You can make changes to your program and check them out it the simulator to make sure your code works the way want. The similator knows when you modify your code and it restarts automatically to run the new code. +Before you actually run your program on the EV3 Brick, you can first try it in the simulator. The MakeCode editor includes a simulator in the browser for you to test your code. You can make changes to your program and check them out it the simulator to make sure your code works the way want. The similator knows when you modify your code and it restarts automatically to run the new code. -Once you're ready to transfer your program to the @boardname@, click the ``|Download|`` button and follow the instructions. +Once you're ready to transfer your program to the EV3 Brick, click the ``|Download|`` button and follow the instructions. ## Single motors diff --git a/docs/projects.md b/docs/projects.md index 74274b0f..7efe8e2e 100644 --- a/docs/projects.md +++ b/docs/projects.md @@ -4,6 +4,6 @@ Here are some cool projects that you can build with your @boardname@! ## Basic -Basic projects to build with your @boardname@. +Basic projects to build with your EV3 Brick. Coming soon. \ No newline at end of file diff --git a/docs/reference/console/send-to-screen.md b/docs/reference/console/send-to-screen.md index 2e63bf6a..bea5e3e6 100644 --- a/docs/reference/console/send-to-screen.md +++ b/docs/reference/console/send-to-screen.md @@ -8,7 +8,7 @@ console.sendToScreen(); A "console" is a place for a user to see special messages from a device. It could be something connected to a serial port, a display that shows text, or even a text file. A console is typically used as a place to send information that is added to a message _log_ (a record of messages that are sent from a device). Your program can send log messages using the [console](/reference/console) functions. The MakeCode editor has a console view that lets you see the console output when your program runs in the simulator. -On the @boardname@, the screen can serve as a console too and you can make your console output go there. Before using the console log functions, set the screen as the console output location. +On the EV3 Brick, the screen can serve as a console too and you can make your console output go there. Before using the console log functions, set the screen as the console output location. ## Example diff --git a/docs/reference/motors/stop-all.md b/docs/reference/motors/stop-all.md index 42443b53..544523a8 100644 --- a/docs/reference/motors/stop-all.md +++ b/docs/reference/motors/stop-all.md @@ -10,7 +10,7 @@ The motors stops but any motion caused from previously running the motors contin ## Example -Tank the @boardname@ forward at half speed for 5 seconds and then stop. +Tank the EV3 Brick forward at half speed for 5 seconds and then stop. ```blocks motors.largeAB.tank(50, 50); diff --git a/docs/reference/motors/synced/steer.md b/docs/reference/motors/synced/steer.md index b9155176..669c0238 100644 --- a/docs/reference/motors/synced/steer.md +++ b/docs/reference/motors/synced/steer.md @@ -8,7 +8,7 @@ motors.largeAB.steer(0, 0) A brick driving with two motors can steer itself by changing the speed of one motor compared to the speed of the other. To make a slow turn to the left, you might make the right motor run slightly faster than the left one. To make a fast, or sharp, turn to the right, the left motor could run at least twice as fast as the right one. -The @boardname@ steers by using a percentage value of _follow_ for one of the motors. This means that the motor in the turn direction will rotate slower than the other. It is the _follower_ motor and the other motor is the _drive_ motor. The drive motor runs at a percentage of full speed set in **speed**. The follower motor runs at a percentage of speed of the drive motor. So, it runs at a percentage of a percentage of full speed. +The EV3 Brick steers by using a percentage value of _follow_ for one of the motors. This means that the motor in the turn direction will rotate slower than the other. It is the _follower_ motor and the other motor is the _drive_ motor. The drive motor runs at a percentage of full speed set in **speed**. The follower motor runs at a percentage of speed of the drive motor. So, it runs at a percentage of a percentage of full speed. To make the turn happen you give a _turn ratio_ which is a percentage value of steer to the left or right. If you want to steer to the left at 30% of the of the drive motor speed, use the value of `-30` for **turnRatio**. Left turns use negative values and right turns use positive values. A really sharp turn to the right might use a turn ratio value of `80`. diff --git a/docs/troubleshoot.md b/docs/troubleshoot.md index ffc4654d..49fdd4bb 100644 --- a/docs/troubleshoot.md +++ b/docs/troubleshoot.md @@ -1,10 +1,10 @@ # Troubleshooting download problems -If your're having trouble getting your code onto the @boardname@, try these steps to see if you can fix the problem. +If your're having trouble getting your code onto the EV3 Brick, try these steps to see if you can fix the problem. ## Can I see the **@drivename@** drive on my computer? -When your @boardname@ is connected to your computer, you should see a new drive called **@drivename@** attached. +When your EV3 Brick is connected to your computer, you should see a new drive called **@drivename@** attached. On Windows, it looks like this in Explorer: @@ -43,7 +43,7 @@ To update your firmware, follow these instructions: [Updating and Resetting Firm **Offline firmware update** -If your @boardname@ isn't connected to the internet through a computer, or with some other mobile device, you'll need to do a manual update of the firmware. You need to have the firmware file already downloaded and available on the computer connected to the brick. +If your EV3 Brick isn't connected to the internet through a computer, or with some other mobile device, you'll need to do a manual update of the firmware. You need to have the firmware file already downloaded and available on the computer connected to the brick. To do this, read the instructions in the **Manual Firmware Update** section of the [Firmware Update](https://education.lego.com/en-us/support/mindstorms-ev3/firmware-update) support page. diff --git a/docs/tutorials/line-following.md b/docs/tutorials/line-following.md index de0e1389..ed1a278c 100644 --- a/docs/tutorials/line-following.md +++ b/docs/tutorials/line-following.md @@ -106,6 +106,6 @@ forever(function () { ## Step 8 -Now, plug your @boardname@ 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 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! diff --git a/docs/tutorials/make-an-animation.md b/docs/tutorials/make-an-animation.md index 4014d11b..83838b1c 100644 --- a/docs/tutorials/make-an-animation.md +++ b/docs/tutorials/make-an-animation.md @@ -58,4 +58,4 @@ brick.showString("Press my button!", 1) ## Step 6 -Now, plug your @boardname@ 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 brick. diff --git a/docs/tutorials/music-brick.md b/docs/tutorials/music-brick.md index 39796765..c8f509cb 100644 --- a/docs/tutorials/music-brick.md +++ b/docs/tutorials/music-brick.md @@ -68,7 +68,7 @@ brick.showString("Press my buttons to make music!", 1) ## Step 6 -Now, plug your @boardname@ 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 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! \ No newline at end of file diff --git a/docs/tutorials/object-near.md b/docs/tutorials/object-near.md index b5775957..560c2684 100644 --- a/docs/tutorials/object-near.md +++ b/docs/tutorials/object-near.md @@ -134,6 +134,6 @@ forever(function () { ## Step 10 -Now, plug your @boardname@ 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 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. diff --git a/docs/tutorials/redlight-greenlight.md b/docs/tutorials/redlight-greenlight.md index 88ab97c8..2c27d9a7 100644 --- a/docs/tutorials/redlight-greenlight.md +++ b/docs/tutorials/redlight-greenlight.md @@ -57,6 +57,6 @@ forever(function () { ## Step 5 -Now, plug your @boardname@ 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 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. diff --git a/docs/tutorials/run-motors.md b/docs/tutorials/run-motors.md index 575d8371..7d0409e6 100644 --- a/docs/tutorials/run-motors.md +++ b/docs/tutorials/run-motors.md @@ -227,6 +227,6 @@ brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () { ## Step 13 -Now, plug your @boardname@ 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 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. diff --git a/docs/tutorials/security-alert.md b/docs/tutorials/security-alert.md index 60da6e26..b16da4db 100644 --- a/docs/tutorials/security-alert.md +++ b/docs/tutorials/security-alert.md @@ -100,6 +100,6 @@ In the ``||music:play sound effect until done||`` block, use the drop-down menu ## Step 9 -Now, plug your @boardname@ 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 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! diff --git a/docs/tutorials/touch-sensor-values.md b/docs/tutorials/touch-sensor-values.md index af41e8ee..ef2a81d9 100644 --- a/docs/tutorials/touch-sensor-values.md +++ b/docs/tutorials/touch-sensor-values.md @@ -89,6 +89,6 @@ forever(function () { ## Step 8 -Now, plug your @boardname@ 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 brick. Attach a Large motor to Port A, and a Touch sensor to Port 1 on your brick. Test your program by pressing the ENTER button. When the motor starts, press the touch sensor. Does the motor stop as expected? diff --git a/docs/tutorials/touch-to-run.md b/docs/tutorials/touch-to-run.md index c8e773df..58013c5e 100644 --- a/docs/tutorials/touch-to-run.md +++ b/docs/tutorials/touch-to-run.md @@ -62,6 +62,6 @@ sensors.touch1.onEvent(ButtonEvent.Released, function () { ## Step 5 -Now, plug your @boardname@ 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 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? diff --git a/docs/tutorials/wake-up.md b/docs/tutorials/wake-up.md index 8c39d930..80f21d35 100644 --- a/docs/tutorials/wake-up.md +++ b/docs/tutorials/wake-up.md @@ -50,5 +50,5 @@ brick.showMood(moods.love) ## Step 5 -Now, plug your @boardname@ 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 brick. \ No newline at end of file diff --git a/docs/tutorials/what-animal-am-i.md b/docs/tutorials/what-animal-am-i.md index a99b4d3f..657e436a 100644 --- a/docs/tutorials/what-animal-am-i.md +++ b/docs/tutorials/what-animal-am-i.md @@ -160,6 +160,6 @@ brick.showString("Guess what animal?", 0) ## Step 10 -Now, plug your @boardname@ 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 brick. Test your program with a friend by pressing the right, left, up, and down buttons on your brick. Have your friend guess what animal it is! diff --git a/docs/tutorials/what-color.md b/docs/tutorials/what-color.md index 4d8b0d99..f51ca60d 100644 --- a/docs/tutorials/what-color.md +++ b/docs/tutorials/what-color.md @@ -131,6 +131,6 @@ brick.showString("What color?", 1) ## Step 9 -Now, plug your @boardname@ 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 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.