Color 2 Click

How does it work?

Color 2 Click is based on the ISL29125, a low power, high sensitivity, red, green, and blue color light sensor (RGB) with a compatible I2C interface from Renesas. The ISL29125’s state-of-the-art photodiode array provides an accurate RGB spectral response and excellent light source to light source variation, designed to reject IR in light sources allowing the device to operate in environments from sunlight to dark rooms. It detects red, green, and blue in various lighting conditions, outputting high-resolution data in a measuring range from 0.152 lux to 10,000 lux. Both the range and output resolution are selectable through an I2C interface.

After light is converted to the current during the light-to-signal process, the current output is converted to a digital count by an on-chip analog-to-digital converter with an integrating architecture. The ADC converter resolution is selectable from 12 or 16 bits, with its conversion time inversely proportional to the ADC resolution. The ADC also provides two programmable ranges to accommodate different lighting conditions dynamically. For dim conditions, the ADC can be configured at its high sensitivity (low optical) range, while for bright conditions, it can be configured at its low sensitivity (higher optical) range. The ISL29125 also incorporates an IR blocking filter, allowing this Click board™ to operate even under a dark glass cover.

This Click board™ communicates with MCU using the standard I2C 2-Wire interface to read data and configure settings, supporting a Fast Mode operation up to 400kHz. Besides, it also possesses an interrupt feature, routed to the INT pin of the mikroBUS™ socket, which serves as an alarm or monitoring function to determine whether the ambient light level exceeds the upper threshold or goes below the lower threshold. The user can also configure the persistency of the interrupt pin, which reduces the possibility of false triggers, such as noise or sudden spikes in ambient light conditions.

This Click board™ can be operated only with a 3.3V logic voltage level. The board must perform appropriate logic voltage level conversion before using MCUs with different logic levels. However, the Click board™ comes equipped with a library containing functions and an example code that can be used as a reference for further development.

Specifications

Pinout diagram

This table shows how the pinout on Color 2 Click corresponds to the pinout on the mikroBUS™ socket (the latter shown in the two middle columns).

Notes	Pin					Pin	Notes
	NC	1	AN	PWM	16	NC
	NC	2	RST	INT	15	INT	Interrupt
	NC	3	CS	RX	14	NC
	NC	4	SCK	TX	13	NC
	NC	5	MISO	SCL	12	SCL	I2C Clock
	NC	6	MOSI	SDA	11	SDA	I2C Data
Power Supply	3.3V	7	3.3V	5V	10	NC
Ground	GND	8	GND	GND	9	GND	Ground

Onboard settings and indicators

Color 2 Click electrical specifications

Software Support

We provide a library for the Color 2 Click as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.

Package can be downloaded/installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Library Description

This library contains API for Color 2 Click driver.

Key functions

• Function read blue color data from ISL29125

• Function read byte of data from register address of ISL29125

• Function write byte of data to ISL29125

Example Description

Example demonstrates use of Color 2 click.

 void application_task ( void ) 
 { 
     //  Task implementation. 

     uint16_t value_red_color; 
     uint16_t value_green_color; 
     uint16_t value_blue_color; 
     uint8_t is_color; 
     float color_value; 

     color_value = color2_get_color_value( &color2 ); 
     is_color = color2_get_color( color_value ); 

     value_green_color = color2_read_green( &color2 ); 
     value_red_color = color2_read_red( &color2 ); 
     value_blue_color = color2_read_blue( &color2 ); 

     switch(is_color) 
     { 
         case 1: 
         { 
             log_printf( &logger, "    *** ORANGE ***"); 
             break; 
         } 
         case 2: 
         { 
             log_printf( &logger, "    *** RED ***"); 
             break; 
         } 
         case 3: 
         { 
             log_printf( &logger, "    *** PINK ***"); 
             break; 
         } 
         case 4: 
         { 
             log_printf( &logger, "    *** PURPLE ***"); 
             break; 
         } 
         case 5: 
         { 
             log_printf( &logger, "    *** BLUE ***"); 
             break; 
         } 
         case 6: 
         { 
             log_printf( &logger, "    *** CYAN ***"); 
             break; 
         } 
         case 7: 
         { 
             log_printf( &logger, "    *** GREEN ***"); 
             break; 
         } 
         case 8: 
         { 
             log_printf( &logger, "    *** YELLOW ***"); 
             break; 
         } 
         default: 
         { 
             break; 
         } 
     } 

     log_printf( &logger, "----------------------"); 

     log_printf( &logger, " Red  value  : %d", value_red_color); 
     log_printf( &logger, " Green  value  : %d", value_green_color); 
     log_printf( &logger, " Blue  value  : %d", value_blue_color); 

     log_printf( &logger, "----------------------"); 

     Delay_1sec(); 
     Delay_1sec(); 
     Delay_1sec(); 
 }

The full application code, and ready to use projects can be installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Other Mikroe Libraries used in the example:

• MikroSDK.Board
• MikroSDK.Log
• Click.Color2

Additional notes and informations

Depending on the development board you are using, you may need USB UART click, USB UART 2 Click or RS232 Click to connect to your PC, for development systems with no UART to USB interface available on the board. UART terminal is available in all MikroElektronika compilers.

mikroSDK

This Click board™ is supported with mikroSDK – MikroElektronika Software Development Kit. To ensure proper operation of mikroSDK compliant Click board™ demo applications, mikroSDK should be downloaded from the LibStock and installed for the compiler you are using.

For more information about mikroSDK, visit the official page.