new tutorials

espruino · Mar 26, 2015 · 23c4cf3 · 23c4cf3
1 parent 62d8e7b
commit 23c4cf3
Show file tree

Hide file tree

Showing 16 changed files with 529 additions and 8 deletions.
diff --git a/boards/EspruinoBoard.md b/boards/EspruinoBoard.md
@@ -75,6 +75,10 @@ Links to tutorials that you can do using **just** the Espruino board:
 
 * APPEND_USES: Only Espruino Board
 
+Tutorials using the Espruino Board:
+
+* APPEND_USES: EspruinoBoard
+
 Power
 ----
 

diff --git a/boards/Pico.md b/boards/Pico.md
@@ -23,6 +23,15 @@ Pinout
 
 * APPEND_PINOUT: PICO_R1_3
 
+<span style="color: red">**Note:** There is no built-in fuse on the Espruino Pico. You should check that your circuit does not contain shorts with a volt meter *before you plug it into USB*, or you may damage your board.</span>
+
+Tutorials
+--------
+
+Tutorials using the Pico Board:
+
+* APPEND_USES: Pico
+
 Layout
 -----
 

diff --git a/devices/WS2811/5mm.jpg b/devices/WS2811/5mm.jpg
diff --git a/info/Espruino Kits.md b/info/Espruino Kits.md
@@ -65,6 +65,14 @@ Espruino Pico KickStarter
 | [[WIZnet]] W550io Ethernet        |             |                |  1               |
 | [[KeyPad]]                        |             |                |  1               |
 
+### Starter Kit tutorials
+
+These are suitable for the Ultimate Toy Kit, as well as the Geek Kit (if you own breadboard and Jumper Wires).
+
+* APPEND_USES: PicoStarterKit
+
+There are plenty of other [[Tutorials]] that can be used with the Pico, but those above deal with exactly the contents of the Starter Kit.
+
 
 Original Espruino KickStarter
 -------------------------

diff --git a/tutorials/Pico Buttons.md b/tutorials/Pico Buttons.md
@@ -3,7 +3,7 @@ Pico Buttons
 ===========
 
 * KEYWORDS: Pico,LCD,Hello World
-* USES: Pico,Button
+* USES: Pico,Button,PicoStarterKit
 
 Introduction
 -----------

diff --git a/tutorials/Pico Infrared.md b/tutorials/Pico Infrared.md
@@ -3,7 +3,7 @@ Pico Infrared Transmit and Receive
 ===============
 
 * KEYWORDS: Pico,Infrared,IR,VS1838B
-* USES: Pico,IRReceiver,VS1838B
+* USES: Pico,IRReceiver,VS1838B,PicoStarterKit
 
 Introduction
 -----------

diff --git a/tutorials/Pico LCD Hello World.md b/tutorials/Pico LCD Hello World.md
@@ -3,7 +3,7 @@ Pico LCD Display Hello World
 =========================
 
 * KEYWORDS: Pico,LCD,Hello World
-* USES: Pico,PCD8544
+* USES: Pico,PCD8544,PicoStarterKit
 
 Introduction
 -----------

diff --git a/tutorials/Pico Light Sensor.md b/tutorials/Pico Light Sensor.md
@@ -3,7 +3,7 @@ Pico Light Sensor
 ===============
 
 * KEYWORDS: Pico,LDR,Light,Brightness
-* USES: Pico,LDR
+* USES: Pico,LDR,PicoStarterKit
 
 Introduction
 -----------
@@ -27,8 +27,8 @@ Wiring Up
 We're going to set up a very simple [Voltage Divider](http://en.wikipedia.org/wiki/Voltage_divider) circuit, with a known resistor on one side and the [Light Dependent Resistor](/LDR) on the other.
 
 * Plug your Espruino Pico into a breadboard with the USB connector on the left-hand side. 
-* With a Jumper wire, connect the bottom left pin to the '-' rail of the breadboard
-* With a Jumper wire, connect the bottom pin 3rd from the left to the '+' rail of the breadboard
+* With a Black Jumper wire, connect the bottom left pin (GND) to the '-' rail of the breadboard
+* With a Red Jumper wire, connect the bottom pin 3rd from the left (3.3v) to the '+' rail of the breadboard
 * Connect the [LDR](/LDR) between the top right pin (A5) and the '-' rail
 * Connect the 10,000 Ohm resistor between the top right pin (A5) and the '+' rail
 

diff --git a/tutorials/Pico Piano.md b/tutorials/Pico Piano.md
@@ -3,7 +3,7 @@ Pico Piano
 =========
 
 * KEYWORDS: Pico,Piano,Sound,Music,Stylophone,Waveform
-* USES: Pico,Speaker,Waveform
+* USES: Pico,Speaker,Waveform,PicoStarterKit
 
 Introduction
 -----------

diff --git a/tutorials/Pico Vibration.md b/tutorials/Pico Vibration.md
@@ -3,7 +3,7 @@ Pico Vibration
 ===============
 
 * KEYWORDS: Pico,Vibration,SW18010P,Shake
-* USES: Pico,Vibration,SW18010P
+* USES: Pico,Vibration,SW18010P,PicoStarterKit
 
 Introduction
 -----------

diff --git a/tutorials/Slot Machine.md b/tutorials/Slot Machine.md
@@ -0,0 +1,145 @@
+<!--- Copyright (c) 2015 Gordon Williams, Pur3 Ltd. See the file LICENSE for copying permission. -->
+Slot Machine
+=========
+
+* KEYWORDS: Pico,Fruit Machine,Slot Machine
+* USES: Pico,WS2811,PicoStarterKit
+
+Introduction
+-----------
+
+We'll make a simple [Slot Machine](http://en.wikipedia.org/wiki/Slot_machine) with 4 LEDs. When the button is pressed, they'll each 'spin', changing colour until they slow down.
+
+You'll Need
+----------
+
+* An Espruino [[Pico]]
+* 4x 5mm [WS2811/APA106](/WS2811) LED lights
+* [[Breadboard]]
+* 3x Jumper Wires
+* A 47uF (or greater) Capacitor
+
+Wiring Up
+--------
+
+![Final wiring](final.jpg)
+
+* Plug your Espruino Pico into a breadboard with the USB connector on the left-hand side. 
+* With a Black Jumper wire, connect the bottom left pin (GND) to the '-' rail of the breadboard
+* With a Red Jumper wire, connect the bottom pin 2nd from the left (5v) to the '+' rail of the breadboard
+* With a Yellow Jumper wire, connect the the top pin 2nd from the left (B15) to a column of pins to the right of the Pico
+* Connect the capacitor across the '+' and '-' rails on the bottom 2 rows. Make your you get it th eright way around ('-' is marked with a stripe)
+
+Now the tricky part... The LED lights need wiring up to GND and VCC, and also need their data pins connected together.
+
+![APA106 pinout](apa106.jpg)
+
+* Take the first LED, and figure out which pins are which using the diagram above. Hold it so the plastic part is facing up, and the two shorter pins are on the left. The slightly flat side of the plastic bit should be on the right-hand side.
+
+* Bend the left and right pins (data in/out) towards the left and right, and bend the middle two pins towards you (beinding the shorter one on middle-left slight more).
+* Then push the LED into the breadboard: 
+  * The Leftmost pin (data in) should be in the same column as the yellow jumper wire
+  * The Middle-left pin (5V) should be in the row right at the bottom marked with '+;
+  * The Middle-right pin (GND) should be in the second from bottom row marked with '-;
+  * The Rightmost pin (data out) should be 4 columns away from the leftmost pin
+* Now repeat with the other 3 LEDs. The only difference should be that the leftmost pin of each new LED should be in the same column as the rightmost pin of the one before (you need to chain data out to data in)
+
+Now check the wiring is correct and that the pins of the LEDs are not shorted out (see the picture below). *If 5v and GND are the wrong way around, you could destroy your LEDs.*
+
+![Wiring up](wiring.jpg)
+
+
+Software
+-------
+
+Ok, now we've got that sorted we can experiment with sending data to the LEDs. When you plug the board into USB the 4 lights should light up blue. If not, check that they're properly seated in the breadboard.
+
+On the left-hand side of the Web IDE, paste the following:
+
+```
+var leds = new Uint8ClampedArray(4*3);
+SPI2.setup({baud:3200000, mosi:B15});
+function updateLEDs() { SPI2.send4bit(leds, 0b0001, 0b0011); }
+updateLEDs();
+```
+
+This creates a blank array of data for the 4 LEDs, sets up SPI, and then sends the data to them (turning them off). There are 4 LEDs, each of which have a byte for red, green, and blue (so 12 elements in total).
+
+Try changing what's in the array, and re-sending the data:
+
+```
+leds[0] = 255; // 1st red
+leds[3+1] = 255; // 2nd green
+leds[6+2] = 255; // 3rd blue
+updateLEDs();
+```
+
+So now we've got the LEDs working, we'll make the slow machine. To do it, we'll create a class for each 'wheel' of the slot machine. You can either copy and paste this into the right-hand side of Espruino, and click 'Send to Espruino'.
+
+```
+var leds = new Uint8ClampedArray(4*3);
+SPI2.setup({baud:3200000, mosi:B15});
+function updateLEDs() { SPI2.send4bit(leds, 0b0001, 0b0011); }
+
+
+function Wheel(ledOffset) {
+  this.ledOffset = ledOffset;
+  // velocity
+  this.vel = 0;
+  // position
+  this.pos = Math.random();
+}
+
+// Give the wheel a random speed
+Wheel.prototype.spin = function() {
+  this.vel = 1+Math.random()*10;
+};
+
+/* each step of animation, decrease the wheel's
+velocity and move it onwards */
+Wheel.prototype.step = function() {
+  this.vel *= 0.98;
+  this.pos += this.vel*0.02;
+  // make sure the position is always between 0 and 1
+  this.pos -= Math.floor(this.pos);
+  // update the colour to one of six. We don't use 255
+  // here because we'd basically blind ourselves!
+  var col = [
+    [63,0,0],
+    [47,47,0],
+    [0,63,0],
+    [0,47,47],
+    [0,0,63],
+    [47,0,47]][Math.floor(this.pos*6)];
+  // set the colour in the LEDs array
+  leds.set(col, this.ledOffset);
+};
+
+var wheels = [
+  new Wheel(0*3),
+  new Wheel(1*3),
+  new Wheel(2*3),
+  new Wheel(3*3),
+  ];
+
+
+function step() {
+  // update the movement and set up the LEDs array
+  for (var i in wheels)
+    wheels[i].step();
+  // send to the LEDs
+  updateLEDs();
+}
+
+function spin() {
+  for (var i in wheels)
+    wheels[i].spin();
+}
+
+// update the LEDs 50 times a second
+setInterval(step, 20);
+// when the button is pressed, spin!
+setWatch(spin, BTN, {repeat:true, edge:"rising", debounce: 100});
+```
+
+Now you can just rpess the button to 'spin' the Slot machine. If your LEDs flicker initially, I'm afraid this will be because your 
diff --git a/tutorials/Slot Machine/apa106.jpg b/tutorials/Slot Machine/apa106.jpg
diff --git a/tutorials/Slot Machine/final.jpg b/tutorials/Slot Machine/final.jpg
diff --git a/tutorials/Slot Machine/wiring.jpg b/tutorials/Slot Machine/wiring.jpg
diff --git a/tutorials/Snake.jpg b/tutorials/Snake.jpg