This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
digispark:tutorials:rgb [2013/03/29 07:06] PeterMortensen [Parts:] Unit symbols (e.g. A) are in uppercase, but not if spelled out (ampere). |
digispark:tutorials:rgb [2016/06/09 12:03] (current) |
||
|---|---|---|---|
| Line 34: | Line 34: | ||
| - | Empty kit bag (or if using a raw PCB, aquire parts) and verify contents. | + | Empty kit bag (or if using a raw PCB, acquire parts) and verify contents. |
| **Note for Kickstarter Backers and Pre-orders:** Headers are not included in each kit bag, but the entire order came with more than enough headers for all kits. | **Note for Kickstarter Backers and Pre-orders:** Headers are not included in each kit bag, but the entire order came with more than enough headers for all kits. | ||
| Line 43: | Line 43: | ||
| [[https://s3.amazonaws.com/digispark/images/m/rgb5.jpg|{{https://s3.amazonaws.com/digispark/images/t/rgb5.jpg}}]] | [[https://s3.amazonaws.com/digispark/images/m/rgb5.jpg|{{https://s3.amazonaws.com/digispark/images/t/rgb5.jpg}}]] | ||
| - | When inserting the LED into the board ensure the longest lead of the LED goes through the hole marked ground - this ensure you ahve the LED oriented properly. Solder the LED leads and clip off the excess. | + | When inserting the LED into the board ensure the longest lead of the LED goes through the hole marked ground - this will ensure you have the LED oriented properly. Solder the LED leads and clip off the excess. |
| [[https://s3.amazonaws.com/digispark/images/m/rgb4.jpg|{{https://s3.amazonaws.com/digispark/images/t/rgb4.jpg}}]] | [[https://s3.amazonaws.com/digispark/images/m/rgb4.jpg|{{https://s3.amazonaws.com/digispark/images/t/rgb4.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. | + | Cut two lengths of male headers, one 6 pins long and another 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. | + | **Tip:** Inserting the headers into a breadboard and then placing the board on top can make this process easier. |
| **Note:** If you are using stackable headers, use them here instead of the standard male headers. | **Note:** If you are using stackable headers, use them here instead of the standard male headers. | ||
| Line 63: | Line 63: | ||
| =====Programming:===== | =====Programming:===== | ||
| - | **Note:** The programming sections assumes you've installed the Arduino IDE and the Digispark Add-ons: [[digispark:tutorials:connecting|Connecting and Programming Your Digispark]] | + | **Note:** The programming sections assumes you've installed the Arduino IDE and the Digispark Add-ons: [[digispark:tutorials:connecting|Connecting and Programming Your Digispark]]. |
| - | The RGB shield uses the following pins to control the LEDS: | + | The RGB shield uses the following pins to control the LEDs: |
| - | Pin 0 -> Red | + | Pin 0 -> Red LED |
| - | Pin 1 -> Green | + | Pin 1 -> Green LED |
| - | Pin 2 -> Blue | + | Pin 2 -> Blue LED |
| Turning a color on or off is as simple as this: | Turning a color on or off is as simple as this: | ||
| <code arduino> | <code arduino> | ||
| - | void setup() { | + | void setup() { |
| - | // initialize the LED pins as outputs | + | // Initialize the LED pins as outputs |
| - | pinMode(0, OUTPUT); | + | pinMode(0, OUTPUT); |
| - | pinMode(1, OUTPUT); | + | pinMode(1, OUTPUT); |
| - | pinMode(2, OUTPUT); | + | pinMode(2, OUTPUT); |
| } | } | ||
| void loop() { | void loop() { | ||
| - | digitalWrite(0, HIGH); // turn the Red LED On | + | digitalWrite(0, HIGH); // Turn the red LED On |
| - | delay(1000); // wait for a second | + | delay(1000); // Wait for a second |
| - | digitalWrite(1, HIGH); // turn the Green LED On | + | digitalWrite(1, HIGH); // Turn the green LED On |
| - | delay(1000); // wait for a second | + | delay(1000); // Wait for a second |
| - | digitalWrite(2, HIGH); // turn the Blue LED On | + | digitalWrite(2, HIGH); // Turn the blue LED On |
| - | delay(1000); // wait for a second | + | delay(1000); // Wait for a second |
| - | digitalWrite(0, LOW); // turn the Red LED off | + | digitalWrite(0, LOW); // Turn the red LED off |
| - | digitalWrite(1, LOW); // turn the Green LED off | + | digitalWrite(1, LOW); // Turn the green LED off |
| - | digitalWrite(2, LOW); // turn the Blue LED off | + | digitalWrite(2, LOW); // Turn the blue LED off |
| - | delay(1000); // wait for a second | + | delay(1000); // Wait for one second |
| } | } | ||
| </code> | </code> | ||
| - | **PWM Note:** While Red and green are connected to pins that support PWM, Blue is not - this is because the 3rd PWM pin is used by the USB communications and we figure most will want to use the RGB shield with USB communication. See Examples->DigisparkRGB->DigisparkRGB or Examples->DigisparkUSB->DigiBlink for examples of using software PWM for pin 2 (Blue). | + | **PWM Note:** While the red and green LEDs are connected to pins that support PWM, the blue LED is not - this is because the third PWM pin is used by the USB communications and we figure most will want to use the RGB shield with USB communication. See Examples->DigisparkRGB->DigisparkRGB or Examples->DigisparkUSB->DigiBlink for examples of using software PWM for pin 2 (blue LED). |
| - | If you are not planning to use USB communication: If you want to connect blue to P4 instead of P2 - flip the shield over and you'll see two solder jumpers, one has a little trace connecting its two pads, the other does't - cut the one with the trace and bridge the other with solder this will disconnect blue from P2 and connect it to P4. | + | If you are not planning to use USB communication: If you want to connect the blue LED to P4 instead of P2 - flip the shield over and you'll see two solder jumpers, one has a little trace connecting its two pads, the other doesn't - cut the one with the trace and bridge the other with solder. This will disconnect the blue LED from P2 and connect it to P4. |
| + | |||
| + | In the Arduino IDE, take a look at the Examples -> DigisparkRGB -> DigisparkRGB example for more advanced usage. When using that example you must set your board type as Digispark (Tiny Core) for it to work. | ||
| - | Take a look at the Examples->DigisparkRGB->DigisparkRGB example for more advanced usage. When using that example you must set your board type as Digispark (Tiny Core) for it to work. | ||