diff --git a/docs/static/tutorials/touch-to-run.png b/docs/static/tutorials/touch-to-run.png new file mode 100644 index 00000000..b241e03c Binary files /dev/null and b/docs/static/tutorials/touch-to-run.png differ diff --git a/docs/static/tutorials/touch-to-run/on-touch-dropdown.png b/docs/static/tutorials/touch-to-run/on-touch-dropdown.png new file mode 100644 index 00000000..df736296 Binary files /dev/null and b/docs/static/tutorials/touch-to-run/on-touch-dropdown.png differ diff --git a/docs/static/tutorials/touch-to-run/touch-to-run.gif b/docs/static/tutorials/touch-to-run/touch-to-run.gif new file mode 100644 index 00000000..e01f93d9 Binary files /dev/null and b/docs/static/tutorials/touch-to-run/touch-to-run.gif differ diff --git a/docs/tutorials.md b/docs/tutorials.md index 64c537a3..6e87bd6c 100644 --- a/docs/tutorials.md +++ b/docs/tutorials.md @@ -36,5 +36,11 @@ Step by step guide to coding your @boardname@. "cardType": "tutorial", "url":"/tutorials/run-motors", "imageUrl":"/static/tutorials/run-motors.png" +}, { + "name": "Touch to Run", + "description": "Press the Touch sensor and run a motor.", + "cardType": "tutorial", + "url":"/tutorials/touch-to-run", + "imageUrl":"/static/tutorials/touch-to-run.png" }] ``` \ No newline at end of file diff --git a/docs/tutorials/touch-to-run.md b/docs/tutorials/touch-to-run.md new file mode 100644 index 00000000..7bd44d0e --- /dev/null +++ b/docs/tutorials/touch-to-run.md @@ -0,0 +1,65 @@ +# 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). + +```block +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) + +```block +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. + +```block +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. + +```block +sensors.touch1.onEvent(ButtonEvent.Pressed, function () { + motors.largeA.run(50) +}) +sensors.touch1.onEvent(ButtonEvent.Released, function () { + motors.largeA.stop() +}) +``` + +## Step 5 + +Now, let’s download our program to the brick. Plug your EV3 brick into the computer with the USB cable, and click the blue **Download** button in the bottom left 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?