Gebruik van het CC2500 Arduino Shield

Software : de Arduino Library

 

Update: het voorbeeld programma en de library zijn aangepast voor Arduino versie 1.0. De nieuwe versie van de applicatie is hier te vinden : a_LiCo_Control_A1.zip , de nieuwe versie van de LivingColors library hier : LivingColors.zip

De software bestaat uit een library voor de Arduino voor het bedienen van een Philips Livingcolors. Hier zit in het verzenden en ontvangen van berichten in en het kan gebruikt worden als basis om tussen twee shields te communiceren.

De library staat hier voor oude versie, en voor versies van Arduino voor 1.0 hier, en moet uitgepakt in de “/libraries” van de Arduino omgeving (in de oudere versies van Arduino is dat “hardware/libraries”). Je moet dus een “<arduino>librariesLivingColors” directory hebben met daarin :

• CC2500.cpp
• CC2500.h
• ColourConversion.cpp
• ColourConversion.h
• keywords.txt
• LivingColors.cpp
• LivingColors.h

De library is hier voor oude versies, en voor versies van Arduino voor 1.0 hier, en in de bestanden zelf uitgebreid gedocumenteerd.

De broncode heeft een GPL licentie. Als je deze code of een product gebaseerd op deze code verspreidt moet dat dus ook met dezelfde licentie. De code is gebaseerd op code van Jeroen Domburg, bekend van Tweakers en diverse hacks, en beschreven in een artikel van Elektuur in de Mei 2008 editie. George Mathijssen heeft de code opgeschoond en aan de praat gekregen als Arduino library.

De library heeft vast bugs. Zo lijkt de RGB naar HSI conversie niet helemaal te kloppen en negeren we de ACK of NACK van de Livingcolors. Fixes, aanpassingen en verbeteringen zijn welkom !

LiCo_Control : een voorbeeld Arduino applicatie.

Om de library te testen de Livincolors te bedienen heb ik een Arduino applicatie gemaakt die je commando’s kan geven via de seriele poort over USB. Je kan hem dan bedienen met Putty of Hyperterminal of iets dergelijks.

Als LiCo klaar is om commando’s stuurt hij een “!”. Is een commando niet begrepen dan stuurt hij een “?”.

De commando’s zijn :

Commando	Functie
r	reset
wn-rrr-ggg-bbb	r, g and b are numbers 000 to 255. Example “w000-255-000” for bright green. n is the lamp number.
hn-hhh-sss-iii	h, s and i are numbers 000 to 255. No example for now. n is the lamp number.
i	print info
nn	turn lamp number n on
fn	turn lamp number noff
ee	e = 0 echo off, e = 1 echo on.
l	listen for adresses. Use i to list adresses.
saabbccddeeffgghhii	store adress in a..i. 9 numbers as 2 digit hex
?	dummy command.

Hier een voorbeeld van het gebruik van deze Arduino applicatie :

In LiCo-Control bedien je de lamp door :

• De lamp aan te doen met de afstand bediening.
• Een verbinding te openen met een terminal applicatie (putty, hyperterminal.. etc.).
• De code van je lampen te leren met “l”..
• .. en dan de lamp te bedienen met de afstandbediening..
• De Arduino luistert dan naar berichten tussen de afstandbediening en de lamp en leert daar de adressen uit.
• Met “i” kan je dan de geleerde adressen printen.
• Met “w0-255-000-000” kan je lamp 0 dan op fel rood zetten (R=255, G=000 eb B=000).
• Met “w1-000-000-010” kan je lamp 1 dan op een beetje baluw zetten.

De geleerde adressen kan je hard in de broncode voor LiCo-Control zetten, je hoeft ze dan niet steeds de adressen te leren.

WheelColor : een voorbeeld Processing applicatie.

WheelColor is een Processing applicatie die commando’s kan sturen naar LiCo_Control. Je kan dan de kleur van de LivigColors instellen met een kleurenwiel. De applicatie is simple en lelijk maar er zit een goed voorbeeld in voor het communiceren met LiCo_Control op een robuste manier.

Hier een voorbeeld van het gebruik van deze Arduino applicatie :

In LiCo-Control bedien je de lamp door :

• De lamp aan te doen met de afstand bediening.
• Een verbinding te openen met een terminal applicatie (putty, hyperterminal.. etc.).
• De code van je lampen te leren met “l”..
• .. en dan de lamp te bedienen met de afstandbediening..
• De Arduino luistert dan naar berichten tussen de afstandbediening en de lamp en leert daar de adressen uit.
• Met “i” kan je dan de geleerde adressen printen.
• Met “w0-255-000-000” kan je lamp 0 dan op fel rood zetten (R=255, G=000 eb B=000).
• Met “w1-000-000-010” kan je lamp 1 dan op een beetje baluw zetten.

De geleerde adressen kan je hard in de broncode voor LiCo-Control zetten, je hoeft ze dan niet steeds de adressen te leren.

Relevante bestanden.

Het schema (als pdf).
De printlayout (als png).
De stuklijst (als txt).
De Arduino versie < 1.0 library (als zip), een Arduino versie 1.0 library (als zip).
Een Arduino versie < 1.0 voorbeeld (als zip), voorbeeld voor Arduino versie 1.0 (als zip).
Een Processing voorbeeld die het Arduino voorbeeld gebruikt (als zip).
De datasheet van de CC2500 chip van TI. (mirror). Er staan belangrijke bugs in de errata op de site van TI !
De datasheet van de CC2500 module van Quasar. (mirror)
De datasheet van de 74LVC125. (mirror)
De datasheet van de LP2950 spannings regelaar. (mirror)
De CC2500 en Atmel op de Arduino gebruiken SPI om te communiceren. TI heeft er een document over gemaakt.