User Tools

Site Tools


holiday:assembly

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
holiday:assembly [2016/12/21 23:34]
digistump created
holiday:assembly [2016/12/27 14:15] (current)
digistump [Step 7 (optional)]
Line 1: Line 1:
 ======Holiday Lights! Assembly Tutorial====== ======Holiday Lights! Assembly Tutorial======
  
-=====Product Description:​===== +This is an unassembled kit and requires basic soldering. This is designed for use with the Digispark development board, which is included.
-[[https://​s3.amazonaws.com/​digispark/​images/​m/​digiled1.jpg|{{https://​s3.amazonaws.com/​digispark/​images/​t/​digiled1.jpg}}]][[https://​s3.amazonaws.com/​digispark/​images/​m/​digiled5.jpg|{{https://​s3.amazonaws.com/​digispark/​images/​t/​digiled5.jpg}}]] +
- +
- +
-This is an unassembled kit and requires basic soldering. This is designed for use with the Digispark development board, which is not included. +
  
 =====Parts - All Kits===== =====Parts - All Kits=====
Line 12: Line 7:
 ^ Part       ^ Quantity ​         ^Identification^ ^ Part       ^ Quantity ​         ^Identification^
 | Tree, Dove, or Menorah PCB|1| | | Tree, Dove, or Menorah PCB|1| |
-| 10M Ohm 1/4W Resistor|1 (2 for Menorah)| | +| 10M Ohm 1/4W Resistor|1 (2 for Menorah)| ​Brown-Black-Blue Gold 
-| WS2812B type 5mm through hole LED|9 (13 for Dove)||+| WS2812B type 5mm through hole LED|9 (13 for Dove)| |
 | 3xAAA Battery Holder with Foam Tape on Back| 1| | | 3xAAA Battery Holder with Foam Tape on Back| 1| |
 | Digispark USB Development Board| 1| | | Digispark USB Development Board| 1| |
Line 24: Line 19:
 ^ Part       ^ Quantity ​         ^Identification^ ^ Part       ^ Quantity ​         ^Identification^
 | 5V Passive 12mm Buzzer|1| | | 5V Passive 12mm Buzzer|1| |
- 
- 
- 
- 
  
  
Line 40: Line 31:
  
 Adafruit has this excellent guide that starts with the tools needed and then shows detailed pictures, including some of the common problems that beginners experience (http://​learn.adafruit.com/​adafruit-guide-excellent-soldering) Adafruit has this excellent guide that starts with the tools needed and then shows detailed pictures, including some of the common problems that beginners experience (http://​learn.adafruit.com/​adafruit-guide-excellent-soldering)
 +
 +Also, a more kid friendly format - here is a great comic book style How to Solder tutorial: http://​mightyohm.com/​files/​soldercomic/​FullSolderComic_EN.pdf
  
 **We assume for these assembly instructions that you know the basics of thru-hole soldering. If you don't check out the links above, these boards are very easy to solder - we promise!** **We assume for these assembly instructions that you know the basics of thru-hole soldering. If you don't check out the links above, these boards are very easy to solder - we promise!**
Line 46: Line 39:
 =====Assembly:​===== =====Assembly:​=====
  
 +
 +===== Step 1 =====
  
 Empty kit bag (or if using a raw PCB, aquire parts) and verify contents. ​ Empty kit bag (or if using a raw PCB, aquire parts) and verify contents. ​
  
-[[https://​s3.amazonaws.com/​digispark/​images/​m/​digiled1.jpg|{{https://​s3.amazonaws.com/​digispark/​images/​t/​digiled1.jpg}}]] +**Tree Kit** 
- +{{ :holiday:treecontents.jpg?​direct&​500 ​|}}
- +
-When inserting the LED into the board ensure the two longer leads of the LED goes through the holes marked data out and ground (see photo) - this ensures you have the LED oriented properly. Solder the LED leads and clip off the excess. +
- +
-[[https://​s3.amazonaws.com/​digispark/​images/​m/​digiled2.jpg|{{https://​s3.amazonaws.com/​digispark/​images/​t/​digiled2.jpg}}]] +
- +
-[[https://​s3.amazonaws.com/​digispark/​images/​m/​digiled3.jpg|{{https://​s3.amazonaws.com/​digispark/​images/​t/​digiled3.jpg}}]] +
- +
-Insert the capacitor on the top of the board (as shown), solder leads on bottom. Orientation of the capacitor does not matter. +
- +
-[[https://​s3.amazonaws.com/​digispark/​images/​m/​digiled4.jpg|{{https://​s3.amazonaws.com/​digispark/​images/​t/​digiled4.jpg}}]] +
- +
-Cut a length of male headers 6 pins long and one 3 pins long. Insert into corresponding positions (on the bottom of the board) and solder each pin.+
  
-**Tip:** Inseting the headers into a breadboard and then placing the board on top can make this process easier.+**Dove Kit** 
 +{{ :​holiday:​dovecontents.jpg?​direct&​500 |}}
  
-**Note:** If you are using stackable headers, use them here instead of the standard male headers.+**Menorah Kit** 
 +{{ :​holiday:​menorahcontents.jpg?​direct&​500 |}}
  
 +===== Step 2 =====
  
-When inserting ​the LED into the board ensure the two longer leads of the LED goes through the holes marked data out and ground (see photo) - this ensures you have the LED oriented properly. Solder the LED leads and clip off the excess.+Assemble Digispark with Female Headers as shown here: [[digispark:​tutorials:​headers|Soldering Headers to the Digispark]]
  
-[[https://​s3.amazonaws.com/​digispark/​images/​m/​digiled5.jpg|{{https://​s3.amazonaws.com/​digispark/​images/​t/​digiled5.jpg}}]]+===== Step 3 =====
  
-Your DigiLED shield is complete!+Solder LEDs to boards. ​
  
-**Note:** On the back of the shield there is a solder patch to activate pin 5 instead ​of pin 1 as the digital input. ​ If you are not using the DigiLED as a shield onto the DigiSpark Pro and planning on running it at a distance, you only need to connect the specified digital pin (Pin 1) and bottom 3 pins (5V, GND, VIN).  You do not need to connect all 6 pins on the right-hand side of the shield.+When inserting ​the LED into the board ensure ​the two longer leads of the LED goes through ​the holes marked data out (DO) and ground ​(GND) (see photos) - this ensures you have the LED oriented properlySolder ​the LED leads and clip off the excess. The leads of the LED go into the holes in order, except for the Menorah - see picture below for correct order for those kits.
  
-=====Chaining:=====+{{ :holiday:​led.jpg?​nolink|}}
  
-When chaining multiple DigiLED'​s together, you only need to connect 3 points as a daisy chain using VCC, DO>​DI ​and GND.  ​+**Tree ​and Dove**
  
-For example, LED #1 would need the top 3 pins VCC, DO (out) and GND to connect to DigiLED #2's VCC, DI (in) and GND on the second row from the bottom of the board +{{ :​holiday:​treeled.jpg?​direct&​600 |}}
  
-If you added LED #3 you would need to connect DigiLED #2's top three pins to the second row from the bottom on DigiLED #3 and so-on and so forth. ​ After DigiLED 1, the side pins and 5V, GND, VIN should not be connected, only the three input and output points for chaining. ​+**Menorah**
  
-=====Programming:=====+{{ :holiday:​menorahled.jpg?​direct&​600 |}}
  
-**Note:** The programming sections assumes you've installed the Arduino IDE and the Digispark Add-ons+{{ :holiday:​menorahledback.jpg?​direct&​600 |}}
  
-Download and install the NeoPixel library: https://​github.com/​adafruit/​Adafruit_NeoPixel+===== Step 4 =====
  
-Set the Pin to 1Number of LEDs to 1 (unless you have chained more on), and format to NEO_RGB + NEO_KHZ800+Insert ​the resistor(s) - two for Menorahone for Tree and Dove - in the locations indicated on the bottom ​(side with "​Holidays 2016" printed ​on it) of the board (as shown), solder leads on top side. Orientation of the resistor does not matter.
  
-If you have a single DigiLED, the following code sample will make it continuously cycle through white, cyan, violet, yellow, red, green and blue+{{ :​holiday:​resistorspot.jpg?​direct&​500 |}}
  
-<code arduino> 
-// Based on NeoPixel Ring simple sketch (c) 2013 Shae Erisson 
-// released under the GPLv3 license ​ 
-#include <​Adafruit_NeoPixel.h>​ 
  
-// Which pin on the Digispark is connected to the DigiLED? +{{ :​holiday:​resistorinstalled.jpg?direct&​400 |}}
-#define PIN            1+
  
-// How many DigiLEDs are attached to the Digispark? 
-#define NUMPIXELS ​     1 
  
-// When we setup the NeoPixel library, we tell it how many pixels, and which pin to use to send signals. 
-// For the WS2812B type through hole LED used by the DigiLED, ​ NEO_RGB + NEO_KHZ800 is the correct data format 
-Adafruit_NeoPixel pixels = Adafruit_NeoPixel(NUMPIXELS,​ PIN, NEO_RGB + NEO_KHZ800);​ 
  
-int delayval ​500; // delay for half a second+===== Step 5 =====
  
-void setup()  +Cut a length of male headers 6 pins long and one 3 pins longInsert into corresponding positions ​(on the bottom of the boardand solder each pin on the top side.
-+
-  pixels.begin(); // This initializes ​the NeoPixel library. +
-  pixels.show();​ // Initialize all pixels to '​off'​ +
-}+
  
-void loop() +**Tip:** Inseting the headers into the Digispark and then placing the board on top can make this process easier.
-+
-  // pixels.Color takes RGB values, from 0,0,0 up to 255,​255,​255 +
-  // in Red,​Green,​Blue order+
  
-  pixels.setPixelColor(0,​ pixels.Color(255,​ 255, 255)); //white +{{ :​holiday:​headers.jpg?​direct&​300 |}} 
-  ​pixels.show();​ // This sends the updated pixel color to the hardware. +===== Step 6 - TREE KIT ONLY =====
-  delay(delayval);​ // Delay for a period of time (in milliseconds).+
  
-  pixels.setPixelColor(0pixels.Color(0, 255, 255)); //cyan +Insert the speaker in the locations indicated on the bottom ​(side with "​Holidays 2016" printed on it) of the board (as shown)solder leads on top sideMatch the side shown in the image below as the "​+"​ side with the side of the speaker with a "​+" ​(on the sticker on the speaker).
-  pixels.show(); +
-  delay(delayval);​+
  
-  pixels.setPixelColor(0,​ pixels.Color(255,​ 0, 255)); //violet +{{ :​holiday:​speakerplus.jpg?​direct&​500 |}}
-  pixels.show();​ +
-  delay(delayval);​+
  
-  pixels.setPixelColor(0,​ pixels.Color(255,​ 255, 0)); //yellow +After soldering remove the sticker for full volume
-  pixels.show();​ +
-  delay(delayval);​+
  
-  pixels.setPixelColor(0,​ pixels.Color(255,​ 0, 0)); //red +{{ :​holiday:​speaker.jpg?​direct&​300 |}}
-  pixels.show();​ +
-  delay(delayval);​+
  
-  pixels.setPixelColor(0,​ pixels.Color(0,​ 255, 0)); //green 
-  pixels.show();​ 
-  delay(delayval);​ 
  
-  pixels.setPixelColor(0, pixels.Color(0,​ 0, 255)); //blue +===== Step 7 (optional=====
-  pixels.show();​ +
-  delay(delayval)+
-+
-</​code>​+
  
-If you have more than one DigiLED daisy-chained, ​the following code will make all the DigiLEDs light up green. You need to change ​the NUMPIXELS variable to the number ​of DigiLEDs you have chained together.+Prepare ​the battery holder by bending ​the two pins on the back of it straight.
  
-<code arduino>​ +Remove ​the backing form the foam tape on the back of the battery holder.
-// Based on NeoPixel Ring simple sketch (c) 2013 Shae Erisson +
-// released under the GPLv3 license to match the rest of the AdaFruit NeoPixel library +
-#include <​Adafruit_NeoPixel.h>+
  
-// Which pin on the Arduino is connected to the NeoPixels?​ +Insert the battery holder  ​on the bottom (side with "​Holidays 2016" printed on it) into the two holes as shown on the photos, solder leads on top side.
-#define PIN            1+
  
-// How many NeoPixels are attached to the Arduino? +**IMPORTANT NOTE**: Please ensure ​the wires on the bottom of the battery holder do not make contact with the LED pins or anything else under the battery holder, if they do we suggest using some tape (electrical or masking) to protect them from shorting out.
-#define NUMPIXELS ​     1+
  
-// When we setup the NeoPixel library, we tell it how many pixels, and which pin to use to send signals+**Tree** 
-// Note that for older NeoPixel strips you might need to change the third parameter--see the strandtest +{{ :​holiday:​treebattlocations.jpg?​direct&​500 |}} 
-// example for more information on possible values. +{{ :​holiday:​treebatteryholder.jpg?​direct&​300 |}}
-Adafruit_NeoPixel pixels = Adafruit_NeoPixel(NUMPIXELS,​ PIN, NEO_RGB + NEO_KHZ800);​+
  
-int delayval = 500; // delay for half a second+**Dove** 
 +{{ :​holiday:​dovebattlocation.jpg?​direct&​500 |}} 
 +{{ :​holiday:​dovebattholder.jpg?​direct&​300 |}}
  
-void setup() { +**Menorah** 
-  ​pixels.begin();​ // This initializes the NeoPixel library+{{ :​holiday:​menorahbattpins.jpg?​direct&​500 |}} 
-}+{{ :​holiday:​menorahbattlocation.jpg?​direct&​300 |}}
  
-void loop() { +===== Your Holiday Lights! Kit is complete! =====
-  // For a set of NeoPixels the first NeoPixel ​is 0, second is 1, all the way up to the count of pixels minus one. +
-  for(int i=0;​i<​NUMPIXELS;​i++){ +
-    // pixels.Color takes RGB values, from 0,0,0 up to 255,​255,​255 +
-    pixels.setPixelColor(i,​ pixels.Color(0,​150,​0));​ // Moderately bright green color. +
-    pixels.show();​ // This sends the updated pixel color to the hardware. +
-    delay(delayval);​ // Delay for a period of time (in milliseconds). +
-  } +
-+
-</​code>​+
  
 +[[:​holiday|Go back to the main Holiday Lights Wiki page to see the tutorials on using your kit.]]
  
holiday/assembly.1482392076.txt.gz · Last modified: 2016/12/21 23:34 by digistump