From c258a5553d7745fb13d712758db7bd4a0e6d5471 Mon Sep 17 00:00:00 2001 From: Galen Nickel Date: Tue, 5 Dec 2017 18:34:02 -0800 Subject: [PATCH] A few edits for 'telegraph' project (#593) --- docs/projects/telegraph.md | 4 ++-- docs/projects/telegraph/code.md | 42 ++++++++++++++++++++------------- docs/projects/telegraph/make.md | 38 ++++++++++++++--------------- 3 files changed, 46 insertions(+), 38 deletions(-) diff --git a/docs/projects/telegraph.md b/docs/projects/telegraph.md index 6822c1e8..953bdc51 100644 --- a/docs/projects/telegraph.md +++ b/docs/projects/telegraph.md @@ -12,8 +12,8 @@ Build a telegraph between two @boardname@s to communicate with your friends! ## Materials -* @boardname@, battery holder and 2 AAA batteries -* Crocodile clips +* 2 @boardname@s, a battery holder, and 2 AAA batteries +* 4 crocodile clips ## Activities diff --git a/docs/projects/telegraph/code.md b/docs/projects/telegraph/code.md index 9c6a9f75..7ada2afa 100644 --- a/docs/projects/telegraph/code.md +++ b/docs/projects/telegraph/code.md @@ -1,12 +1,12 @@ # Code -Let's build the code that, when the user presses the button ``A`` on a @boardname@, will send an impulse over a wire to the receiving @boardname@ and turn an LED on there. +Let's build the code that, when the user presses the button **A** on a @boardname@, will send an impulse over a wire to the receiving @boardname@ and turn on an LED there. -Make sure that the sending and receiving wires run symmetrically across: pin ``P1`` on one @boardname@ is connected to pin ``P2`` on the other, and vice versa, as shown on the pictures in the "Make" section. This way we can use the same code on both @boardname@s . +Make sure that the sending and receiving wires run "symmetrically" between the two boards. That is: pin **1** on one @boardname@ is connected to pin **2** on the other, and vice versa. Just like it's shown in the pictures in the **[make](./make)** section. This way we can use the same code on both @boardname@s . ## Step 1 -We start with a block that digitally writes **high** (value ``1``) to the sending @boardname@'s pin ``P1``. This block can be found in _Pins_ drawer of the Advanced section. +We start with a block that digitally writes **high** value (a digital ``1``) to ``P1`` which sends the value to @boardname@'s pin **1**. This block is found in **Pins** drawer of the Advanced section of the Toolbox. ```blocks pins.digitalWritePin(DigitalPin.P1, 1) @@ -14,7 +14,7 @@ pins.digitalWritePin(DigitalPin.P1, 1) ## Step 2 -To show what we are sending, we add a block to turn on an LED in the centre of the LED display (2,2) using _plot x, y_ : +To show that we are sending the ``1``, we add a block to turn on an LED in the center of the LED display (2, 2) using ``||led:plot x y||``: ```blocks pins.digitalWritePin(DigitalPin.P1, 1) @@ -23,8 +23,8 @@ led.plot(2, 2) ## Step 3 -Now that we know how to send the signal, we only want to be doing it while the button ``A`` is pressed. -Pick an _if_ block from the _Logic_ drawer (you'll need the version with _else_ part that will remain empty for now). Add a check whether the button ``A`` is pressed from the _Input_ drawer and move the blocks from the previous step into _then_ part : +Now that we know how to send the signal, we only want to do it while the button **A** is pressed. +Pick an ``||logic:if then else||`` block from the **Logic** drawer (you'll leave the ``||logic:else||`` part empty for now). Add a check for when button **A** is pressed. Get an ``||inpu:on button pressed||`` from the **Input** drawer and move the blocks from the previous step into ``||logic:then||`` part of the ``||logic:if then else||``: ```blocks if (input.buttonIsPressed(Button.A)) { @@ -36,7 +36,7 @@ if (input.buttonIsPressed(Button.A)) { ## Step 4 -For the _else_ branch (while the button A is not pressed) we want to do the opposite of what we did in the _then_ branch: take the value of pin ``P1`` to **low** (0) and unplot the corresponding LED on the sending @boardname@ : +For the ``||logic:else||`` section (while button **A** is not pressed) we want to do the opposite of what we did in the ``|logic:then||`` section. Which is, make the value of pin ``P1`` go to **low** (digital 0) and unplot the corresponding LED on the sending @boardname@: ```blocks if (input.buttonIsPressed(Button.A)) { @@ -50,8 +50,8 @@ if (input.buttonIsPressed(Button.A)) { ## Step 5 -Let's wrap it all in a forever loop so this code runs in the background, forever checking the button ``A`` and sending the appropriate signal to the receiver. -Modify your code so that your code looks like this. Download the code into one of the @boardname@s, press and release button ``A`` a few times. +Let's wrap it all in a forever loop so this code is running in the background always checking button **A** and sending the appropriate signal to the receiver. +Modify your code to add the blocks below. Download the code onto one of the @boardname@s, press and release button **A** a few times. ```blocks basic.forever(() => { @@ -65,14 +65,17 @@ basic.forever(() => { }) ``` -The sending part is done, so we are going to add the receiving part. +The sending part is done, so now we'll add the receiving part. ## Step 6 -The receiver needs to digitally read from the pin to which the sending @boardname@ will be writing (``P2``) over the wire. Let's start by going to the _Pin_ drawer, adding digital read pin ``P0`` and changing the pin value to ``P2``. -Now we want to examine the value read from ``P2`` and check whether it is **high** (value ``1``) or not. Go to the _Logic_ drawer, first pick an _if_ block, then come back for a comparison operator (=). Plug in our digital read block as one operand and the value ``1`` as the other. -We shall turn the LED in the bottom right corner (4,4) on to indicate that we received **high** and turn it off otherwise. -Your code should look as follows: +The receiver needs to digitally read from the pin where the other @boardname@ sends its value to pin **2** across the wire. Let's start by going to the **Pins** drawer, adding a ``||pins:digital read pin||`` and change the pin value to ``P2``. + +Now, we want to examine the value read from ``P2`` and check whether it's **high** (``1``) or **low** (``0``). Go to the **Logic** drawer and pick an ``||logic:if then else||`` block, then come back for the comparison operator ``||logic:0 = 0||``. Plug in our ``||pins:digital read pin||`` block as one operand and the value ``1`` as the other. + +We'll turn the LED in the bottom right corner (4, 4) on to show that we received a **high** value and turn it off in not. + +Make sure your code looks like this: ```blocks basic.forever(() => { @@ -95,6 +98,11 @@ Your telegraph is ready! ## Step 7 -* Connect the first @boardname@ to your computer using your USB cable and download the telegraph script to it. -* Connect the second @boardname@ to your computer using your USB cable and download the telegraph script to it. -* The first person and second person can take turns pressing button A on their @boardname@s to play the telegraph game! +Ok, let's try it out: + +1. Connect the first @boardname@ to your computer using your USB cable and download the telegraph code to it. +2. Disconnect the first @boardname@. +3. Connect the second @boardname@ to your computer using your USB cable and download the telegraph code to it. +4. Disconnect the second @boardname@. +5. Connect the battery holder to one of the @boardname@s. +6. The first person, and then second person, can take turns pressing button **A** on their own @boardname@s to play the telegraph game! diff --git a/docs/projects/telegraph/make.md b/docs/projects/telegraph/make.md index 5b4bb5c8..1f5b0c94 100644 --- a/docs/projects/telegraph/make.md +++ b/docs/projects/telegraph/make.md @@ -10,60 +10,60 @@ Let's build a telegraph between two @boardname@s. ## Materials -* @boardname@, battery holder and 2 AAA batteries -* Crocodile clips +* 2 @boardname@s, a battery holder, and 2 AAA batteries +* 4 crocodile clips ## Steps -## Step 1 +### Step 1 ![](/static/mb/lessons/banana-keyboard-1.png) -Using the 1st crocodile clip, connect the end of the crocodile clip onto GND pin on the @boardname@. +Connect the end of the **1st** crocodile clip to the **GND** pin on the @boardname@. -## Step 2 +### Step 2 ![](/static/mb/lessons/ornament-chain-2.png) -Using the 2nd crocodile clip, connect the end of the crocodile clip onto the 3V pin on the @boardname@. +Connect the end of the **2nd** crocodile clip to the **3V** pin on the @boardname@. -## Step 3 +### Step 3 ![](/static/mb/lessons/ornament-chain-3.png) -Using the 3rd crocodile clip, connect the end of the crocodile clip onto pin 1 of the @boardname@. +Connect the end of the **3rd** crocodile clip to pin **1** of the @boardname@. -## Step 4 +### Step 4 ![](/static/mb/lessons/ornament-chain-4.png) -Using the 4th crocodile clip, connect the end of the crocodile clip onto pin 2 of the @boardname@. +Connect the end of the **4th** crocodile clip to pin **2** of the @boardname@. -## Step 5 +### Step 5 ![](/static/mb/lessons/ornament-chain-5.png) -Using the 1st crocodile clip, connect the unattached end of the crocodile clip onto the GND on the 2nd @boardname@. +Connect the other end of the **1st** crocodile clip to the **GND** on the second @boardname@. -## Step 6 +### Step 6 ![](/static/mb/lessons/ornament-chain-6.png) -Using the 2nd crocodile clip, connect the unattached end of the crocodile clip onto the 3V pin on the 2nd @boardname@. +Connect the other end of the **2nd** crocodile clip to the **3V** pin on the second @boardname@. -## Step 7 +### Step 7 ![](/static/mb/lessons/ornament-chain-7.png) -Using the 3rd crocodile clip, connect the unattached end of the crocodile clip onto pin 2 of the 2nd @boardname@. +Connect the other end of the **3rd** crocodile clip to pin **2** of the second @boardname@. -## Step 8 +### Step 8 ![](/static/mb/lessons/ornament-chain-8.png) -Using the 4th crocodile clip, connect the unattached end of the crocodile clip onto pin 1 of the 2nd @boardname@ +Connect the other end of the **4th** crocodile clip to pin **1** of the second @boardname@. -## Step 9 +### Step 9 ![](/static/mb/lessons/telegraph-0.png)