A library to use the RGB color sensor with a JavaScript microcontroller
npm install rgb-tcs34725rgb-tcs34725
============
A JavaScript driver for the TCS34725 RGB sensor. Use it to find the red, green, blue, or clear levels of anything you point it at. The API gives you access to the raw RGBC data, color temperatures, and lux intensity. You can buy the breakout board from Adafruit.
The chip also has support for threshold interrupts on the clear channel and those APIs have been implemented here but not fully tested.
npm install rgb-tcs34725`Hardware Connections to Tessel
You can connect the module to any of the ports on Tessel:
VIN -> Unconnected
GND -> GND
3V3 -> 3V3
SCL -> SCL
SDA -> SDA
INT -> GPIO 1
LED -> GPIO 2
Example Usage
.js
var tessel = require('tessel');
var rgbLib = require('../');
var rgb = rgbLib.use(tessel.port.A);rgb.on('ready', function() {
setInterval(function() {
rgb.getRawData(function(err, colors) {
if (err) throw err;
console.log('RED:', colors.red);
console.log('GREEN:', colors.green);
console.log('BLUE:', colors.blue);
console.log('CLEAR:', colors.clear);
})
}, 1000);
});
`API
$3
library.use(hardware, callback)` initializes the module on the port of a microcontroller. It returns the rgb object and the callback has the form of callback(err, rgb).`rgb.getRawData(err, colors)` returns rgbc data. colors has red, green, blue, and clear properties. Each of the colors is a 16 bit number.`rgb.calculateColorTemperature(callback(err, temp))` returns the color temperature as a 16 bit number representing Kelvins. The temperature it returns is in units of Kelvin.`rgb.calculateLux(callback(err, lux))` returns the light intensity as a 16 bit number that represents the light intensity.`rgb.enable(callback(err))` enables the module to read colors. It is called automatically when the use function is called.`rgb.disable()` can be used to put the module to sleep and reduce power consumption. Call `rgb.enable()` to wake it back up.`rgb.setIntegrationTime(time, callback)` sets the amount of time integrating values from an ADC (which determines color). Longer times produce more accurate numbers at low light levels. Available times can be found with rgb.integrationTimes.`rgb.setGain(gain, callback)` sets the gain of the ADC. Available gains can be found with rgb.gains`.