Bambilight – a cheap bluetooth Ambilight clone

06 May 2012


Boat (27) 
Not the Boat (12) 


Recent articles

25 Apr 2017

Ubuntu 16.10 LXC host on ZFS Root, with EFI and Time Machine

Still completely unrelated to boats, but I needed somewhere to put this. Here is a blow-by-blow guide to installing a minimal Ubuntu 16.10 to a ZFS root, booted from EFI, which as used as a LXC host to act as an Apple "Time Machine" destination.
mike 25 Apr 2017 at 17:20
14 Mar 2017

How to connect any serial device to the internet

A completely generic script that will proxy serial devices over HTTP, turning USB-things into internet-things.
mike 14 Mar 2017 at 23:00

This is my TV. I hate cables, so when I was planning this I routed all the cables I'd ever need behind the wall. HDMI, TV Aerial, speaker, ethernet, and a power socket. I forgot to route USB.

If I want to use an Atmolight this is a problem. Lights behind the TV that change color require a cable to the computer. They also require a power supply and, apparently, quite an extensive and expensive list of parts. My other problem is that the IR remote receiver plugged into my computer is just above the floor, and the receiver keeps getting covered by the rug. My solution is an Atmolight clone controlled by Bluetooth. It draws power for the chip from USB (so can be powered by the USB sockets on the TV) with a separate supply to power the LEDs. When done it will relay IR commands from its built-in IR receiver to the computer via Bluetooth. Atmolight was a DIY version of the orginal Philips Ambilight, so as this is a Bluetooth version I have therefore christened it "Bambilight" and take childish pleasure in trampling over not one but two trademarks.


  • 1 x Teensy 2.0. I love this board, it's simple to use, well documented and cheap for what it does.
  • 1 x BTM-400 Bluetooth module, with breakout board. Optional - the board and code can also communicate over USB
  • 2 x ULN2803 octal Darlington array in DIL package
  • 5m roll of SMD RGB LEDs.
  • 1 x Infrared photo-detector.
  • Some PCB Sockets and pins.
  • A 12V power supply and matching PCB mountable socket. You probably want 2.1mm, which seems to be the standard for 12V power
  • Copper PCB for etching, the final board is about 70mm x 40mm

Total cost of the above is probably about USD$55. The roll of SMD mounted LEDs bumps up the cost and was the second solution I tried - the first involved wiring my own strips and using the 5V from USB to power them. Disaster. Even with a dual-power USB cable you can only get 1A which limits you to about 12 RGB leds (at 20ma per color). These cast great pools of light onto the walls at irregular intervals, and were hard to stick to the TV. The SMD strip can be chopped into sections, has a sticky backing so fits really easily, but runs off 12v and so requires a separate power supply - at 0.6A/m you need a power supply that will put out about 0.6A x 4m = 2.4A (30W) to around the edge of a 46" TV. I hardwired a second cable into my recessed wall plug behind the TV for power.


I designed the board in Eagle, which took me a long time to get to grips with - I'm still not 100% satisfied with it, but you can download the board, Eagle schematic and source code from this link. My first etch had holes that were too small, which was fixed with a re-edit in Photoshop.

This gave me the chance to add some text, and a measurement bar - my second print effort failed after etching and drilling the board because the ****ing printer had been set to scale the image by not enough to be obvious, but just enough to be useless. I ended up printing to plain paper, verifying the size then photocopying onto transparency acetate. The image is at 600dpi and the text is flipped horizontally - put it this way up on your lightbox with the photosensitive copper board on top and it will etch the right way round. Something I learned after my first print effort.


The Bluetooth chip is an SMD board and is optionally supplied with a breakout board. This had pins wired horizontally, which is really annoying, so I unsoldered and replaced with pins that point down from the board.

I then drilled the board - I can't imagine doing this without a 0.7mm bit, a Dremel and a Dremel drill press as lining these up by hand would be impossible. The bit will self-align to the stripped hole in the middle of each solder pad, so it's not as daunting as it first appears. The Jellybaby is for sizing, I didn't have any coins. Once drilled I ran three wires on the top of the board as indicated by the red lines on the photo - here's the top view.

Then started soldering the components, cheap bits first. Watch the orientation of the darlington arrays. Another lesson I learned shortly after switching the board design to using a 12V strip of leds is that it's much easier to solder a socket than to try then fail to desolder your expensive IC.

Here's the board with the Teensy and Bluetooth boards in place. The yellow linking wire on top saved me some hairy routing below - it connects Teensy pin B0 with the RESET pin on the Bluetooth module. I ate the Jellybaby.

LEDs and install

The LED strips are really easy to work with, each group of 3 is wired in series to run off 12V, so you can cut the strips after every 3 LEDs as needed. Solder wire terminated with a 4-pin header to each section, making sure to order the pins R, G, B and 12v. Then plug these into the headers on the board, with 12V towards the edge of the board. (I have double headers, a legacy of my first design. You don't need them). Then plug the board USB into a USB socket on your TV - any will do, it's only for 5V supply - and the 12V supply into the 2.1mm DC socket you can see poking out of the top-left of the board. Assuming you've programmed the Teensy you can then tuck this out of sight behind the TV.


Here's the code I uploaded to the Teensy (note this can be done before or after the chip is in place - progamming a Teensy is that easy). There are 12 LED channels plus IR and bluetooth control so I'm using just about every I/O pin on the board, and controlling the LED brightness by bit-bashing the PWM. This isn't pretty but it works.

#include "IRremote.h"


#define MODE_LEDON 0
#define MODE_LEDOFF 1
#define MODE_SLEEP 2
#define BUFLEN 32

#define IRTX 10                 // C7 wired but not used
#define IRRX 11                 // D6
#define BTKEY 9                 // C6
#define BTRESET 0               // B0
#define OUTPUTLOW0 15           // Set to input, wired to low

byte pins[NUMLEDS] = {
    19, 20, 21,                 // 1st clockwise from USB   F4 F1 F0
    18, 17, 16,                 // 2nd clockwise from USB   F5 F6 F7
    4, 5, 6,                    // 3rd clockwise from USB   B7 D0 D1
    3, 2, 1,                    // 4th clockwise from USB   B3 B2 B1
byte rgb[NUMLEDS];
byte gamma[256];

float gammapower = 2.0;         // LED brightness based on gamma = 2.0
byte count = 0, i = 0, buflength = 0;
byte ledmode = MODE_LEDON;
boolean debug = false;
byte buf[BUFLEN];
decode_results results;

IRrecv irrecv(IRRX);
void dopwm();
void setrgb(byte *, byte);
void readcommand(int);
void btcmd(HardwareSerial bt, char*msg);
HardwareSerial bt = HardwareSerial();


void setup() {
    for (int i=0;i<256;i++) {
        gamma[i] = (byte)(pow(i/255.0, gammapower) * 255 + 0.5);

    for (int i=0;i<NUMLEDS;i++) {
       if (pins[i] < 255) {
           pinMode(pins[i], OUTPUT);
           digitalWrite(pins[i], HIGH);
    pinMode(OUTPUTLOW0, INPUT);
    pinMode(IRRX, INPUT);
    pinMode(BTKEY, OUTPUT);
    pinMode(BTRESET, OUTPUT);


    // Reset BT device
    digitalWrite(BTRESET, LOW);
    digitalWrite(BTRESET, HIGH);
    digitalWrite(BTKEY, HIGH);

    // Initialize, set name
    btcmd(bt, "AT+INIT");
    btcmd(bt, "AT+NAME=Bambilight");
    btcmd(bt, "AT+PSWD=0000");
    // Enter BT slave mode
    digitalWrite(BTKEY, LOW);

    // Initialize all LEDs to off
    for (int i=0;i<NUMLEDS;i++) {
        buf[i] = 0;
    setrgb(buf, NUMLEDS);

void loop() {
    while (Serial.available()) {
    while (bt.available()) {

    if (irrecv.decode(&results)) {
        // Not currently used, need to patch boblightd first

// Read command from "buf", which could be set from BT or USB serial
void readcommand(int v) {
    if (i != 0 || v == 255) {
        buf[i] = v;
        if (buflength !=0 && (i == buflength || i == BUFLEN-1)) {
            if (buf[3] == 15 || buf[3] == 12 || buf[3] == 9 || buf[3] == 3) {  // SETRGB
                setrgb(buf + 4, buf[3]);
            i = 0;
        } else {
            if (i == 3 && v < 16) {     // SETRGB
                buflength = v + 3;
    if (debug) {
        Serial.print("read ");
        Serial.print(" @");

// Set the RGB value for the LEDS - b is array of "numleds" values
// from 0 (off) to 255 (full).
void setrgb(byte* b, byte numleds) {
    int i;
    for (i=0;i<numleds;i++) {
        rgb[i] = gamma[b[i]];
    for (i=numleds;i<NUMLEDS;i++) {
        rgb[i] = 0;

// PWM the led bits. for each x=rgb[i], pin is on from 0..x and off from x+1..255
// count is unsigned byte so wraps at 255. Called in busy loop so nothing complex.
void dopwm() {
    for (int i=0;i<NUMLEDS;i++) {
        if (pins[i] < 255) {
            byte val = rgb[i];
            if (ledmode == MODE_LEDON && count == 0 && val != 0) {
                digitalWrite(pins[i], HIGH);
            } else if (ledmode != MODE_LEDON || (count == val + 1)) {
                digitalWrite(pins[i], LOW);

void btcmd(HardwareSerial bt, char *msg) {
    if (debug) {
        Serial.print("Sending '");
    int v, j = 0;
    while (( != 10) {
        if (v >= 0) {
            buf[j++] = (byte)v;
    buf[j] = 0;
    delay(100);         // I found I needed this to work reliably.

Or click here to download with a Makefile (which works on OS X and should work on Linux too). "make upload" to upload via the normal Teensy Uploader. The LEDs are controlled using the Atmolight protocol, which is spoken by Boblight: install this on your Linux box, connect to the Bluetooth chip using bluez-simple-agent and rfcomm bind as described here, then setup the following in /etc/boblight.conf

port  19333

name  bambilight
output  /dev/rfcomm0
channels 12
type  atmo
interval 40000
rate  9600
delayafteropen  1000000

name  red
rgb  FF0000

name  green
rgb  00FF00

name  blue
rgb  0000FF

name  top
color  red  bambilight 1
color  green  bambilight 2
color  blue  bambilight 3
hscan  0 100
vscan  0 50

name  right
color  red     bambilight 4
color  green   bambilight 5
color  blue    bambilight 6
hscan  50 100
vscan  0 100

name  bottom
color  red  bambilight 7
color  green  bambilight 8
color  blue  bambilight 9
hscan  0 100
vscan  50 100

name  left
color  red     bambilight 10
color  green   bambilight 11
color  blue    bambilight 12
hscan  0 50
vscan  0 100


Nothing to it. Install the XBMC Boblight addon, run boblightd, XBMC will automatically find it and, er, Bob's your uncle.


  • Unlike here we're configuring the bluetooth chip directly. Just trying to run the commands in sequence failed, the chip seems to need time to respond. I've catered for this by adding delays - 500ms during reset, 500ms after, then 100ms after each command. This works, it may be more conservative than necessary.
  • The Bambilight can be controlled via Bluetooth or via USB - if no bluetooth is required, drop that chip from the circuit and don't #define BLUETOOTH in the source code.
  • There is an occasional brief flicker from the LEDs, say one every 5-10 minutes for a few ms of a second. No doubt this is down to my cheap bit-banging approach, but it's barely noticable and (for me) not a problem.
  • The IR receiver is wired in and should work in theory (I'm having trouble with the RC-6 protocol used by my remote, the others seem to work) but boblightd needs to be patched to relay the response from the device to the Linux IR subsystem. Patching boblightd looks relatively simple, but I don't know how Linux talks to the IR system, particularly as it changed recently. So this part of the project on hold.
  • For my own record, this build required: 3 attempts to build UV LED-based PCB etcher, 4 main PCB boards (1 backwards, 1 misscaled, 1 running LEDs off 5V and final one), 2 Teensys (blew first one up desoldering from board 3), 4 Darlingtons (blew two up on board 3), 12 LEDs & resistors (discarded for SMD roll after board 3).