Color 13 Click

How does it work?

Color 13 Click as its foundation uses the APDS-9999, an RGB and proximity sensor with 940nm VCSEL from Broadcom Limited. The APDS-9999 uses four individual channels of red, green, blue, and IR in a specially designed matrix arrangement allowing the device to have an optimal angular response and accurate RGB spectral response with high Lux accuracy over various light sources. The device detects light intensity under multiple lighting conditions and through different attenuation materials, including dark glass.

The APDS-9999 is configurable as ambient light and RGB sensor. It is also fast enough to provide proximity detection (PS) information at a high repetition rate, operating well from bright sunlight to dark rooms. PS resolution can be varied from 8 to 11 bits, with the measurement rate from 6.25ms to 400ms. To offset unwanted reflected light from the cover glass, a PS intelligent cancellation level register allows for an on-chip subtraction of the ADC count contributed by any unwanted reflected light from the cover glass.

The addition of the micro-optics lenses within the module provides highly efficient transmission and reception of infrared energy, lowering overall power dissipation. In addition, the APDS-9999 can be put into a low-power standby mode providing low average power consumption.

Color 13 Click communicates with MCU using the standard I2C 2-Wire interface to read data and configure settings, supporting Fast Mode operation with a clock frequency up to 400kHz. It also features an intelligent interrupt function that generates independent light and proximity interrupt signals, available on the INT pin of the mikroBUS™ socket, which reduces power consumption by eliminating polling communication traffic between the sensor and MCU.

This Click board™ can be operated only with a 3.3V logic voltage level. The board must perform appropriate logic voltage level conversion before use with 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 13 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 13 Click electrical specifications

Software Support

We provide a library for the Color 13 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 13 Click driver.

Key functions:

• color13_cfg_setup – Config Object Initialization function.
• color13_init – Initialization function.

Examples description

This application showcases ability of click board to read RGB and IR data from device. Also it can be configured to read proximity data and ALS data in lux units.

The application is composed of three sections :

void application_task ( void ) 
{
    switch ( example_type )
    {
        case COLOR13_EXAMPLE_PS_LS:
        {
            color13_proximity_als_example( );
            break;
        }
        case COLOR13_EXAMPLE_RGB:
        {
            color13_rgb_example( );
            break;
        }
        default:
        {
            log_error( &logger, " Select example!" );
            break;
        }
    }
    Delay_ms( 500 );
}

The full application code, and ready to use projects can be found on our LibStock page.

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.

• MikroSDK.Board
• MikroSDK.Log
• Click.Color13

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. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message.

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.