diff --git a/docs/getting-started.md b/docs/getting-started.md index 978d4b2c..31a2ab33 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -7,8 +7,8 @@ to make real programs that work! ### Happy face -You should see three blocks in the editor to the left. -These are a block with a smiley face, ... +There are three blocks in the editor (the area to the left). +They should look like this: ```blocks basic.forever(() => { @@ -29,6 +29,10 @@ basic.forever(() => { }); ``` +When you run this program, you will see a smiley face, then a blank +screen, then a smiley again -- it never stops! (That's because of the +``forever`` block.) + To move your program from your computer to the BBC micro:bit: * Connect your micro:bit to the computer with the USB cable. * Click **Compile**. @@ -37,8 +41,11 @@ To move your program from your computer to the BBC micro:bit: ### Happy unhappy face -Let's draw an unhappy face instead of the blank screen. Click on the dots in the ``show leds`` block -until it matches the blocks below. +Draw an unhappy face instead of the blank screen. Click on the dots +in the second ``show leds`` block until it matches the blocks below. +Now you have an **animation** (cartoon) that shows a happy face, +then an unhappy one, then a happy one again, forever (or until +you turn off your micro:bit)! ```blocks basic.forever(() => { @@ -67,7 +74,8 @@ To move your program from your computer to the BBC micro:bit: ### Your turn! -Pile up more ``show leds`` blocks to create your animation! Create an animation with at least 5 images. +Pile up more ``show leds`` blocks to create your animation! Create an +animation with at least 5 pictures. What does this animation show? ```blocks basic.forever(() => { @@ -78,6 +86,13 @@ basic.forever(() => { # . . . # . # # # . `) + basic.showLeds(` + . . . . . + . # . # . + . . . . . + # # # # # + . . . . . + `) basic.showLeds(` . . . . . . # . # . @@ -90,7 +105,21 @@ basic.forever(() => { . # . # . . . . . . # # # # # + . . . # # + `) + basic.showLeds(` . . . . . + # . # . . + . . . . . + # . . . # + . # # # . + `) + basic.showLeds(` + . . . . . + . . # . # + . . . . . + # . . . # + . # # # . `) }); ``` @@ -103,28 +132,38 @@ To move your program from your computer to the BBC micro:bit: #### ~hint -You can find the ``show leds`` block under the **Basic** category. +You can find the ``show leds`` block in the **Basic** part of the editor. + #### ~ -### Button A and B +### Button A and button B -This program will show the word `banana` on the LED +This program will show the word **anteater** on the LED screen when you press button `A`. ```blocks input.onButtonPressed(Button.A, () => { - basic.showString("banana"); + basic.showString("anteater"); }); ``` Now try to unscramble these blocks in the editor so that the micro:bit -shows **apple** when you press button `B`. +shows **banana** when you press button `B`. ```shuffle input.onButtonPressed(Button.B, () => { - basic.showString("apple"); + basic.showString("banana"); }); ``` +#### ~hint + +You can find the letter `B` by clicking the letter `A` on the +``onButtonPressed`` block. + +#### + +Can you combine these blocks so your program shows **anteater** when +you press `A`, but **banana** when you press `B`? ### Shake @@ -133,7 +172,7 @@ You can find when someone is shaking the BBC micro:bit by checking its slowing down). Unscramble these blocks in the editor to show a frownie when someone -shakes the micro:bit. +shakes the micro:bit. (Ouch!) ```shuffle input.onGesture(Gesture.Shake, () => { @@ -150,13 +189,14 @@ input.onGesture(Gesture.Shake, () => { You can also find when someone is tilting the micro:bit left or right, face up or face down, and logo up or logo down (the logo is the yellow -oval picture at the top of the board). +oval picture at the top of the board). Tilting a micro:bit like this +is called a **gesture**. Try to build a Rock Paper Scissors game where you tilt the micro:bit left to show paper, right to show scissors, and down to show rock. -Unscramble these blocks in the editor and try this program on the -micro:bit itself! +Unscramble these blocks in the editor and try this program on a real +micro:bit! ```shuffle input.onGesture(Gesture.TiltLeft, () => { @@ -188,7 +228,7 @@ input.onGesture(Gesture.TiltRight, () => { ### Pins You can also use the pins as buttons. (The pins are the holes in the -metal bar at the bottom of the micro:bit board.) For example, hold +metal stripe at the bottom of the micro:bit board.) For example, hold the ``GND`` button with one hand and touch the ``0`` pin (called ``P0``) with your other hand to tell the micro:bit you're pressing it. @@ -209,4 +249,15 @@ input.onPinPressed(TouchPin.P0, () => { ### Your turn! Use the screen, buttons, gestures, and pins to make your own fun game -with the BBC micro:bit! +with the BBC micro:bit! What about some of these? + +* A backpack burglar alarm +* Daily news broadcaster for your class +* Animated jewelry +* A _complete_ animated cartoon +* A calculator +* A music box + +These are all things you can make with the BBC micro:bit by itself. +Just think what you can do if you connect the micro:bit's pins to +extra parts like microphones and other **sensors**!