BM017 Color Sensor I2C Color Sensor with White LED for Illumination

Transcription

1 August 0 BM0 Color Sensor BM0 Color Sensor IC Color Sensor with White LED for Illumination phone 0..0 East First Street Chico, CA Contact Solutions Cubed, LLC for your custom designs: Solutions Cubed is an innovative electronic design firm. We have created successful designs for a myriad of industries including mass produced consumer products, deep-sea robotic components, and encrypted encoders for the banking industry. We love meeting new customers and are interested in hearing about your design needs.

2 August 0 BM0 Color Sensor Product Description: The BM0 module carries one AMS TCS color light-to-digital converter IC. The IC has an IC interface allowing digital systems to measure object color. Red, blue, green, and clear values may be read. The module also has a white LED and MOSFET that may be used to illuminate objects. Voltage level translation circuitry is included allowing the module to interface to V or V logic systems. A.V linear regulator on the module provides power to the color sensor. Red, blue, green, and clear digital color measurements White LED on board may be used to illuminate objects being tested On-board.V regulator Voltage level translation circuitry allows use with V or V logic IC interface Dimensions:

3 August 0 BM0 Color Sensor Specifications: Characteristic Min Typ Max Unit Notes Operating voltage 0 V Input to.v regulator Voltage.V Operating current ma and pull-up resistors 00 Ω Pulled to _IO Color conversion time. 00 ms This is configured via the IC interface Color count 0 Longer conversion time provides higher counts Operating temperature C Pin Functions and Notes # Name Maximum Notes Voltage 0VDC Input voltage for on-board.v regulator 0V Ground return for module.v Normally the output for the.v regulator, can be used as an input to supply.v to the module _IO V Sets the voltage for the IC interface. If your system is a V system apply V here, if it is a.v system then connect or another.v source. _IO IC clock line _IO IC data line INT.V Open-drain output asserted low for various interrupt settings. Pull to.v externally with a.kω resistor is used. _LED.V(V) Power supply for white illuminating LED. There is a Ω resistor in series with the LED. If powering with a V supply you should add a second Ω external to the module to ensure the input sinks less than 0mA. V Gate connection to N-channel MOSFET that turns on illuminating LED.

4 August 0 BM0 Color Sensor User Notes/Tips. Color measurements can be dependent on illumination, the proximity of the object being measured, and the angle of measurement. Ideally you want a well-lit object relatively close to the sensor and parallel to the face of the sensor. You can use look-up tables to calibrate for the light source you are using for illumination. You can also use relative measurements to determine colors. For example if red is greater than green and blue, then the object is likely red.

5 August 0 BM0 Color Sensor Communication Protocol Hardware Usage: The BM0 uses an IC interface to write/read data to/from the TCS color sensor. The color sensor s -bit address is 0x. The IC interface follows the standard IC format. You should review the datasheet for the TCS for more details on the communication protocol and various register functions in the color sensor. This datasheet will only cover basic information. S start condition W write bit (0) R - read bit() A acknowledge(0) P stop condition Master-to-slave Slave-to-master IC Write Format? S Slave address W A Command code A Data byte A Continue if multiple bytes P IC Read Format? S Slave address R A Data byte A Data byte A Continue if multiple bytes P IC Combined Read Format (uses a write to establish register to read from) S Slave address W A Command code A S Slave adddress R A Data A P Command Byte: The command byte is used to set the register address of a write or read operation. Command Byte in this example would be B 0000 or 0xB (hexadecimal) Bits : Bits :0 Normally B 0 see datasheet for Address index value. For example the first color more info address CDATAL is B 000. See the table that follows for the address values of other registers. Example Reading from CDATAL register Slave address Command Slave address and write bit 0x in bits : and 0 in bit 0 code includes CDATAL address and read bit 0x in bits : and in bit 0 CDATAL contents returned S 0x A 0xB A S 0x A Data A P

6 August 0 BM0 Color Sensor Register Definitions: The TCS registers are shown here for reference. For additional details review the TCS datasheet. Address Register Name R/W Register Function -- COMMAND W Used to specify register addresses 0X00 ENABLE R/W Enables the color sensor 0X0 ATIME R/W Conversion integration timer 0X0 WTIME R/W Wait timer 0X0 AILTL R/W Clear interrupt low threshold low byte 0X0 AILTH R/W Clear interrupt low threshold high byte 0X0 AIHTL R/W Clear interrupt high threshold low byte 0X0 AIHTH R/W Clear interrupt high threshold high byte 0X0C PERS R/W Interrupt persistence filter 0X0D CONFIG R/W Configuration byte 0X0F CONTROL R/W Control byte 0X ID R Device ID 0X STATUS R Device status 0X CDATAL R Clear data low byte 0X CDATAH R Clear data high byte 0X RDATAL R Red data low byte 0X RDATAH R Red data high byte 0X GDATAL R Green data low byte 0X GDATAH R Green data high byte 0XA BDATAL R Blue data low byte 0XB BDATAH R Blue data high byte Pseudo Code for Initializing Sensor: To initialize the sensor for operation you need to set the analog integration time in the ATIME register, set the gain on the analog conversion in the CONTROL register, and enable the oscillator and analog converters in the ENABLE register. Color data may then be read from the sensor. #define EnableAddress 0xa0 // register address + command bits #define ATimeAddress 0xa // register address + command bits #define ControlAddress 0xaf // register address + command bits void init_tcs(void) { icwritebuffer[0] = 0xF; WriteicRegisters(,ATimeAddress); // RGBC timing is - contents x.ms = icwritebuffer[0] = 0x00; WriteicRegisters(,ControlAddress); // RGBC gain control 0x00 is gain of icwritebuffer[0] = 0x0; WriteicRegisters(,EnableAddress); // enable ADs and oscillator for sensor }

7 August 0 BM0 Color Sensor Example Code for Reading and Writing: These routines for the Arduino can be used as examples for reading and writing data to the TCS. They use functions from the Wire library. /* Load the icwritebuffer with the data you want to write and then call this routine with appropriate address and command bits and the number of bytes you are writing. */ void WriteicRegisters(byte numberbytes, byte command) { byte i = 0; Wire.beginTransmission(SensorAddressWrite); // Send address with Write bit set Wire.write(command); // Send command, normally the register address for (i=0;i<numberbytes;i++) // Send data Wire.write(icWriteBuffer[i]); Wire.endTransmission(); } delaymicroseconds(00); // allow some time for bus to settle /* Send register address to this function the number of bytes you want to read and it returns the byte value for the register's contents in the icreadbuffer */ byte ReadicRegisters(int numberbytes, byte command) { byte i = 0; Wire.beginTransmission(SensorAddressWrite); // Write address of read to sensor Wire.write(command); Wire.endTransmission(); delaymicroseconds(00); // allow some time for bus to settle Wire.requestFrom(SensorAddressRead,numberbytes); // read data for(i=0;i<numberbytes;i++) icreadbuffer[i] = Wire.read(); Wire.endTransmission(); } delaymicroseconds(00); // allow some time for bus to settle #define ColorAddress 0xb // register address + command bits /* Reads bytes from color registers and converts them to -bit color measurements */ void get_colors(void) { unsigned int clear_color = 0; unsigned int red_color = 0; unsigned int green_color = 0; unsigned int blue_color = 0; ReadicRegisters(,ColorAddress); clear_color = (unsigned int)(icreadbuffer[]<<) + (unsigned int)icreadbuffer[0]; red_color = (unsigned int)(icreadbuffer[]<<) + (unsigned int)icreadbuffer[]; green_color = (unsigned int)(icreadbuffer[]<<) + (unsigned int)icreadbuffer[]; blue_color = (unsigned int)(icreadbuffer[]<<) + (unsigned int)icreadbuffer[]; }

8 August 0 BM0 Color Sensor Register Details: Some registers are defined here for reference. See the TCS datasheet for more details. ENABLE Register (0x00): Used to enable the sensor color conversions. Field Bits Description reserved : Write as 0 AIEN When set RGBC interrupts are enabled WEN When set the wait timer is activated reserved Write as 0 AEN When set color conversions occur PON 0 When set the internal oscillator is running (conversions can occur) ATIME Register (0x0): Sets the integration/conversion time. Example settings are shown below. Max Count = (-ATIME) x.ms Register Time Max Count (loaded into color registers) Value 0xFF.mS 0 0xF ms 00 0xD 0mS 0 0xC0 ms 0x00 ms CONTROL Register (0x0F): The two lowest bits of the CONTROL register are used to set the gain for the analog conversions. Bits : are reserved and should be written as 0. Field Bits Description reserved : Write as 0 AGAIN :0 00 x gain 0 x gain 0 x gain 0x gain Color Registers (0x through 0xB): Color registers are set up as pairs (clear, red, green, and blue) each with a high byte and a low byte. The color measurement can be calculated by Color = xdatah * + xdatal To convert it to a 0-bit measurement use Color = (xdatah * + xdatal) / (-ATIME)

9 August 0 Schematics: P P P _IO P _IO _IO R.K P _IO R.K P P INT P _LED P BM0 Color Sensor U MIC-. C 0.uF VOUT EN ADJ/NC C.uF C 0.uF R.K R.K S G D D G S Q DMNDLDW R Ohm R.K FID FIDUCIAL_CIRCLE FID FIDUCIAL_CIRCLE U TCS INT NC D cool white G Q NDSAN D S PA PB MH mil MH mil

10 August 0 BM0 Color Sensor Application Schematics: POWER OPTIONS V SYSTEM.V SYSTEM VDC -0V _IO INT _LED _IO INT _LED.V BM0 COLOR SENSOR BREAKOUT BOARD SIP BM0 COLOR SENSOR BREAKOUT BOARD SIP ILLUMINATION LED OPTIONS V SYSTEM 0mA LED CURRENT V SYSTEM 0mA LED CURRENT -0V VDC Ohm V = ON 0V = 0FF _IO INT _LED BM0 COLOR SENSOR BREAKOUT BOARD SIP VDC PWM <= 0% _IO INT _LED BM0 COLOR SENSOR BREAKOUT BOARD SIP.V = ON 0V = 0FF 0 ALT..V SYSTEM _IO INT _LED BM0 COLOR SENSOR BREAKOUT BOARD SIP.V SYSTEM ma LED CURRENT _IO INT _LED BM0 COLOR SENSOR BREAKOUT BOARD SIP

11 August 0 BM0 Color Sensor Application Schematics: ARDUINO UNO CONNECTIONS ARDUINO UNO VDC VDC VDC 0 IOREF RESET.V V ARDUINO UNO AREF PWM, PWM, 0 PWM, A0 PWM, A A PWM, A A TXOUT, A RXIN, 0 PWM, 0 _IO INT _LED BM0 COLOR SENSOR BREAKOUT BOARD SIP

12 August 0 BM0 Color Sensor Application Schematics: COLOR SENSOR TO RGB LED ARDUINO UNO VDC VDC 0 IOREF RESET.V V ARDUINO UNO AREF PWM, PWM, 0 PWM, A0 PWM, A A PWM, A A TXOUT, A RXIN, 0 PWM, 0 VDC NC NC BLUE GREEN RED BM0 RGB LED BOARD BREAKOUT BOARD SIP VDC _IO INT _LED BM0 COLOR SENSOR BREAKOUT BOARD SIP