This is the documentation page for the RGB clock kit.
- 1 Overview
- 2 Assembly instructions
- 3 External resources
- 4 Pinout
- 5 Jumper settings
- 6 Programming
- 7 The software
- 7.1 Default operation
- 7.1.1 Test modes
- 7.1.2 Loading custom bitmaps
- 7.1.3 Setting the time
- 7.1.4 Reading back the time
- 7.1.5 Adjusting the white-balance
- 7.1.6 Jump to bootloader
- 7.1 Default operation
- 8 Technical Specifications:
- 9 Future hardware enhancements
- 10 Future software enhancements
- 11 Changelog
Driver PCB for up to 64 common-anode RGB LEDs, or 192 normal LEDs.
The PCB is designed for 1:3 multiplexing of the LEDs, and is equipped with 8 74HC595 shift registers (configured as 4 16-bit deep registers), 64 current-limiting resistors (220 Ohm by default) and 3 FETs to switch the cathode groups on-and-off.
The PCB is equipped with a BitWizard-standard 20-pin IO connector, designed to work together with our USB-multio PCB, but it is also possible to connect our FTDI-ATmega, USB-bigmultio or Cyclone dev board, or one of your own boards, like for example an Arduino.
SV1-SV8 are the connectors for the RGB LEDs. SV1-SV8 are connected to IC1-IC8.
IC1 and IC5 are configured as one 16-bit deep shift register. Qa-Qh are connected to IC1, and Qi-Qp are connected to IC5.
IC2 and IC6 are configured as one 16-bit deep shift register. Qa-Qh are connected to IC2, and Qi-Qp are connected to IC6.
IC3 and IC7 are configured as one 16-bit deep shift register. Qa-Qh are connected to IC3, and Qi-Qp are connected to IC7.
IC4 and IC8 are configured as one 16-bit deep shift register. Qa-Qh are connected to IC4, and Qi-Qp are connected to IC8.
The control pins (!OE, LATCH, !RESET, CLK) of all shift registers are connected in parallel.
SER0 is connected to IC1.
SER1 is connected to IC2.
SER2 is connected to IC3.
SER3 is connected to IC4.
It is therefore required to update all shift registers at the same time.
LED Driver PCB
- First, decide if you want to use 4 pushbutton switches (for the default firmware), 4 LEDs, or a mix (for custom firmware).
- SW1 and R65 or D7 and R71
- SW2 and R66 or D6 and R72
- SW3 and R67 or D5 and R73
- SW4 and R68 or D4 and R74
- Mount all necessary SMD components. Which component should go where, can be found in the table below.
- cut the header strips to the right length. Our suggestion:
- cut the first strip in one 10-pin long strip, and 5 6-pin long strips.
- cut the second header in 3 6-pin strips, and one 4-pin strip.
- solder all headers in place
- solder the desired switches in place
Component Value IC1-IC8 74HC595 R1-R64 220R R65-R68 10K R69-R74 1K C1-C8 100nF C9 10uF T1-T3 N-channel FET D1 Double Diode (BAT54S for example) D2-D7 LED SW1-SW4 Pushbutton
Building your own clock-face
If you are not buying the laser-cut clock-face that we offer, you'll be building one yourself. A consideration is that at about 20cm radius, the legs of the LEDs are long enough to form the R, G and B common lines. If you make the clock larger, you'll have to run three wires along the leds....
The "puzzle" line between the four segments stems from the fact that the laser-cutter that we have access to only goes so big. And it comes in handy for transport. The laser-cutter could handle up to 30cm outer diameter. And it could handle half a clock at once. But the 4-fold symmetry looks nice.
Connecting the LEDs
Counting clockwise, starting at the LED to the right of the topmost LED:
Output Pin# Connector Qp 8 SV6 Qo 7 SV6 Qn 6 SV6 Qm 5 SV6 Ql 4 SV6 Qk 3 SV6 Qj 2 SV6 Qi 1 SV6 Qg 7 SV2 Qf 6 SV2 Qe 5 SV2 Qd 4 SV2 Qc 3 SV2 Qb 2 SV2 Qa 1 SV2
All R, G and B pins should be connected in parallel.
This is the same for each quadrant, only the connector numbers differ.
Putting it all together
Version 1.0 uses 12pin headers to connect to the LEDs, but unfortunately, 12-pin ICD connectors don't exist, so we used 14-pin ICD connectors.
Pay close attention then connecting the 14-pin connectors to the PCB! Pin 1 through 12 should line up, and pin 13 and 14 should be "floating".
As can be seen in this image, the left ICD connectors are a bit further towards the USB connector, and the right ICD connectors are a bit further to the switches. Also, the reset switch isn't mounted. We decided we would never use it, so left it out. Your version will come equipped with a reset switch
After hooking everything up, you should end up with something like this:
SV10 is connected as follows
|connector pin number||pin name||multiio AVR pin name|
|14||external clock source||PB4|
SV1 through SV8 are connected as follows:
SV9 can be used to connect an external clock source, or a servo motor, or...
|3||connected to pin14 of SV10|
Pin 3 has two clamping diodes attached, to limit the voltage range to GND-0.6V and VCC+0.6V.
We are considering connecting this pin through a very large valued resistor directly to the mains. In that case the clamping diodes are neccessary. The better option would be to use an optocoupler or something like that....
- D2 is connected to VCC from SV10
- D3 is connected to USB power
- D4 is connected to pin17 from SV10
- D5 is connected to pin18 from SV10
- D6 is connected to pin15 from SV10
- D7 is connected to pin16 from SV10
- Switch1 (next to R71) is connected to pin16 from SV10
- Switch2 (next to R72) is connected to pin15 from SV10
- Switch3 (next to R73) is connected to pin18 from SV10
- Switch4 (next to R74) is connected to pin17 from SV10
JP1: Power supply selection.
Open: LED driver board and microcontroller board have individual power supplies
Closed: VCC from LED driver board and microcontroller board are connected.
- If you want to measure the powerconsumption of the LEDs, you can connect your ammeter here.
Please refer to http://www.bitwizard.nl/wiki/index.php/Usbio#programming for information on programming the controller PCB.
The software supplied by BitWizard, is designed to run on the BitWizard USB-Multio board, but it should be possible to port it to other boards.
A zipfile containing the latest source code can be downloaded here: http://www.bitwizard.nl/rgb_clock/
As of software version 20120208, there are several (test) modes included. These can be accessed with the "m" command. Usage:
jumps to the LED test mode.
Mode 0 (default)
PWM routine: Enabled.
Bitmap generation: Enabled.
Allows you to, for example, send your own RGB bitmaps to the clock with the "D", "E", and "F" commands.
PWM routine: Enabled.
Bitmap generation: Disabled.
Sllows you to manually turn colors on and off, and also send your own bitmaps.
PWM routine: Disabled.
Bitmap generation: Disabled.
Perfect for testing your LEDs and soldering work. This mode automatically generates a test sequence.
PWM routine: Enabled.
Bitmap generation: Enabled, but using a test bitmap.
Loading custom bitmaps
This is only possible is some test modes.
Identical for each quadrant
Use the "d" command (only works in mode 2):
The value should be in hex. However, it might be easyer to think binary. Each bit represents an LED.
For example, to light each even LED:
Or for each odd LED:
Only one color is active in this mode. To change the active color, use the "r", "g", and "b" commands. To turn on the red LEDs, and turn off the green and blue LEDs:
The same goes for the "g" and "b" commands, only the colors differ.
If you send the data quick enough (for example, with a script), it should be possible to generate some nice effects.
Complete RGB bitmap
Use the "D", "E", and "F" commands (only works in mode 1):
This is a little bit more complicated than the previous option, but gives you a lot more possibilities.
The "D" command controls the red LEDs.
The "E" command controls the green LEDs.
The "F" command controls the blue LEDs.
To turn all red LEDs on, and all green and blue LEDs off:
D ff ff ff ff ff ff ff ff E 00 00 00 00 00 00 00 00 F 00 00 00 00 00 00 00 00
Each nibble represents one LED in each quadrant. Let's call the quadrants 1, 2, 4, and 8. Quadrant 1 is the bottom right, quadrant 2 top right, quadrant 4 top left, and quadrant 8 bottom left.
We only have 15 LEDs, so one of the 16 nibbles is not used:
D ff ff ff ff fx ff ff ff ^
Nibble x (also marked with a ^) is not in use.
Table of which nibble represents which LED:
D ff|ff ff ff ff ff ff ff x| | | | | | | LED 0 x | | | | | | | LED 1 | x| | | | | | LED 2 |x | | | | | | LED 3 | | x| | | | | LED 4 | |x | | | | | LED 5 | | | x| | | | LED 6 | | |x | | | | LED 7 | | | |x | | | LED 8 | | | | | x| | LED 9 | | | | |x | | LED 10 | | | | | | x| LED 11 | | | | | |x | LED 12 | | | | | | | x LED 13 | | | | | | |x LED 14
So, for example:
To light the first 5 red LEDs in quadrant 2:
D 22 22 02 00 00 00 00 00
To light the first 5 red LEDs in quadrant 2 and 4:
D 66 66 06 00 00 00 00 00
To light the first 5 red LEDs in quadrant 2, and the last 5 red LEDs in quadrant 4:
D 22 22 02 00 00 40 44 44
The syntax is identical for green and blue, but you should use the "E" and "F" command instead of the "D" command.
Setting the time
It is possible to set the time over a USB-serial port, using the "T" command.
T [hh] [mm] [ss]
With hh, mm, and ss in hexadecimal. For example:
T 10 2F D
sets the time to 16:47:13 .
At BitWizard, we use the following script (we called it tsync) to set the time:
#!/bin/sh h=`(echo obase=16 ;date +"%H" )| bc` m=`(echo obase=16 ;date +"%M" )| bc` s=`(echo obase=16 ;date +"%S" )| bc` echo T $h $m $s
Forward the output of this script to the clock, to set the time:
./tsync > /dev/ttyACM0
Switch 2: Push to jump one hour forward Switch 3: Push to jump 1 minute forward Switch 4: Push to reset the seconds to 0
Reading back the time
The "t" command outputs the current time on the clock over the serial interface:
CDC usbio/usbmultiio Wed Jan 11 18:28:22 CET 2012 > t 11:2F:03.02E0 >
The time is printed in hex, in hh:mm:ss:milliseconds
Adjusting the white-balance
Setting the white-balance can be done with the "B" command.
B [rValue] [gValue] [bValue]
Values are in hex. Example (this is the default setting):
B 7800 7E00 0000
This means the red LED is on from 0x0000 until 0x7800, green is on from 0x7800 until 0x7E00, and green is on from 0x7E00 until 0x0000.
This counter counts from 0x0000 to 0xBB80.
Because the interrupt routine takes some time too, there is a minimum interval between two interrupts. This minimum was measured to be between 0x600 and 0x700. I recommend you do not set the interval between two interrupts shorter than about 0x800.
REW: Hmm. Apparently the defaults do not listen to me. :-(
Tom: They do to me...
Jump to bootloader
If you want to flash the controller, you need to switch to the bootloader. You can do this by pressing the pushbutton, of if you're lazy (or if the clock is hanging on a wall on the other side of the room) you can do it by issuing the "z" command.
Power usage: Approximately 30mA with default firmware.
Future hardware enhancements
- Replace 2 12-pin connectors by 1 20-pin connector
- Add numbers to the pushbutton switches
Future software enhancements
- Initial public release