pxt-ev3/docs/tutorials/touch-to-run.md
Galen Nickel 49ab5ec099
Shrink some of the tutorial sentences (#440)
* Shrink some of the tutorial sentences

* Match the less than order for blocks

* Include later tutorials in SUMMARY

* Ditch 'using' in name
2018-04-05 17:32:32 -07:00

68 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Touch to Run
## Introduction @fullscreen
Use the Touch sensor to run a motor.
![Large motor connected to brick](/static/tutorials/touch-to-run/touch-to-run.gif)
## Step 1
Open the ``||sensors:Sensors||`` Toolbox drawer. Drag out **2** ``||sensors:on touch||`` blocks onto the Workspace (you can place these anywhere).
```blocks
sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
})
sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
})
```
## Step 2
In one of the ``||sensors:on touch||`` blocks, use the second drop-down menu to change from ``pressed`` to ``released``.
![Touch sensor action dropdown](/static/tutorials/touch-to-run/on-touch-dropdown.png)
```blocks
sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
})
sensors.touch1.onEvent(ButtonEvent.Released, function () {
})
```
## Step 3
Open the ``||motors:Motors||`` Toolbox drawer. Drag out a ``||motors:run||`` block onto the Workspace, and drop it into the ``||brick:on touch pressed||`` block.
```blocks
sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
motors.largeA.run(50)
})
sensors.touch1.onEvent(ButtonEvent.Released, function () {
})
```
## Step 4
Open the ``||motors:Motors||`` Toolbox drawer. Drag out a ``||motors:stop||`` block onto the Workspace, and drop it into the ``||sensors:on touch released||`` block.
```blocks
sensors.touch1.onEvent(ButtonEvent.Pressed, function () {
motors.largeA.run(50)
})
sensors.touch1.onEvent(ButtonEvent.Released, function () {
motors.largeA.stop()
})
```
## 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.
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?