pxt-ev3/docs/tutorials/run-motors.md
Galen Nickel ac81067f82
Tutorial format and macro fixes (#425)
* Tutorial format and macro fixes

* Remove branded names
2018-04-04 15:12:55 -07:00

7.3 KiB
Raw Blame History

Run motors

Introduction @fullscreen

Use the buttons to start and stop the large and medium motors.

Motors in simulator running

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).

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

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

})

Step 2

In the ||brick:on button|| blocks, use the drop-down menu to select the up and down buttons.

Button dropdown selection

brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {

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

})

Step 3

Open the ||motors:Motors|| Toolbox drawer. Drag out 2 ||motors:run|| blocks onto the Workspace, and drop one of them each into the ||brick:on button|| blocks.

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

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. When we press the Down button, we want our motor to run in the reverse direction.

In the Run block that is in the On Button Down pressed block, change the speed value from 50% to -50%.

Motor speed select field

brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(50)
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(-50)
})

Step 5

Now, lets add a Medium motor, and specify how many rotations we want the motor to run for. Open the ||brick:Brick|| Toolbox drawer. Drag out 2 |brick:on button|| blocks onto the Workspace. In the ||brick:on button|| blocks, use the drop-down menu to select the left and right buttons.

brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(50)
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(-50)
})
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {

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

})

Step 6

Open the ||motors:Motors|| Toolbox drawer. Drag out 2 ||motors:run|| blocks onto the Workspace, and drop one of them each into the ||brick:on button left|| and ||brick:on button right|| blocks.

brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(50)
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(-50)
})
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(50)
})
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(50)
})

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 medium motor D.

Select motor on a port dropdown

brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(50)
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(-50)
})
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
    motors.mediumD.run(50)
})
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
    motors.mediumD.run(50)
})

Step 8

In the ||motors:run medium motor|| blocks, click on the plus icon (+) to expand the blocks. Change the number of rotations from 0 to 5.

brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(50)
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(-50)
})
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
    motors.mediumD.run(50, 5, MoveUnit.Rotations)
})
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
    motors.mediumD.run(50, 5, MoveUnit.Rotations)
})

Step 9

Lets 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%.

brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(50)
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(-50)
})
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
    motors.mediumD.run(10, 5, MoveUnit.Rotations)
})
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
    motors.mediumD.run(50, 5, MoveUnit.Rotations)
})

Step 10

In the ||motors:run medium motor|| block that is in the ||brick:on button right|| block, change the speed from 50% to 100%.

brick.buttonUp.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(50)
})
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () {
    motors.largeA.run(-50)
})
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () {
    motors.mediumD.run(10, 5, MoveUnit.Rotations)
})
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () {
    motors.mediumD.run(100, 5, MoveUnit.Rotations)
})

Step 11

Finally, lets add a way to stop all our motors from running. Open the ||brick:Brick|| Toolbox drawer. Drag out an ||brick:on button|| block onto the Workspace.

brick.buttonUp.onEvent(ButtonEvent.Pressed, function () { 
    motors.largeA.run(50) 
}) 
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () { 
    motors.largeA.run(-50) 
}) 
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () { 
    motors.mediumD.run(10, 5, MoveUnit.Rotations) 
}) 
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () { 
    motors.mediumD.run(100, 5, MoveUnit.Rotations) 
}) 
brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () { 
 
})

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.

brick.buttonUp.onEvent(ButtonEvent.Pressed, function () { 
    motors.largeA.run(50) 
}) 
brick.buttonDown.onEvent(ButtonEvent.Pressed, function () { 
    motors.largeA.run(-50) 
}) 
brick.buttonLeft.onEvent(ButtonEvent.Pressed, function () { 
    motors.mediumD.run(10, 5, MoveUnit.Rotations) 
})
brick.buttonRight.onEvent(ButtonEvent.Pressed, function () { 
    motors.mediumD.run(100, 5, MoveUnit.Rotations) 
}) 
brick.buttonEnter.onEvent(ButtonEvent.Pressed, function () { 
    motors.stopAll() 
}) 

Step 13

Now, lets download our program to the brick. Plug your @boardname@ 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 Medium motor to Port D. Test your program by pressing the different buttons to see whether the correct motors are running as expected.