pxt-ev3/docs/tutorials/touch-sensor-values.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

2.5 KiB

Using Touch Sensor Values

Introduction @fullscreen

Use the Touch sensor value to stop a running motor.

Touch sensor and motor attached to brick

Step 1

Open the ||brick:Brick|| Toolbox drawer. Drag an ||brick:on button|| block onto the Workspace, and place it anywhere on the Workspace.

brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
	
})

Step 2

Open the ||motors:Motors|| Toolbox drawer. Drag out a ||motors:run|| block onto the Workspace, and drop it into the ||brick:on button|| block.

brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () {
	motors.largeA.run(50)
})

Step 3

Open the ||logic:Logic|| Toolbox drawer. Drag out an ||logic:if then|| block onto the Workspace, and drop it into the ||loops:forever|| block.

forever(function () {
    if (true) {

    }
})

Step 4

Open the ||sensors:Sensors|| Toolbox drawer. Drag out a ||sensors:touch is pressed|| block onto the Workspace, and drop it in the ||logic:if then|| block replacing true.

forever(function () {
    if (sensors.touch1.isPressed()) {

    }
})

Step 5

Open the ||music:Music|| Toolbox drawer. Drag out a ||music:play sound effect|| block onto the Workspace, and drop it under the ||logic:if then|| block.

forever(function () {
    if (sensors.touch1.isPressed()) {
        music.playSoundEffect(sounds.animalsCatPurr)
    }
})

Step 6

In the ||music:play sound effect|| block, use the drop-down menu to select the information touch sound effect.

forever(function () {
    if (sensors.touch1.isPressed()) {
        music.playSoundEffect(sounds.informationTouch)
    }
})

Step 7

Open the ||motors:Motors|| Toolbox drawer. Drag out a ||motors:stop|| block onto the Workspace, and drop it in after the ||music:play sound effect|| block.

forever(function () {
    if (sensors.touch1.isPressed()) {
        music.playSoundEffect(sounds.informationTouch)
        motors.largeA.stop()
    }
})

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.

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?