Library Description

The library covers all the necessary functions that enables the usage of the Color 3 Click board. It offers a choice of writing(in normal and special mode) and reading one byte or two bytes of data in and from registers. The library includes a functions for reading clear, red, green, blue (separately or all together) and proximity values. User can, also use functions to apply or check many different settings including, but not limited to: LED drive strength, diode selection, RGBC Gain Value, Set long wait... It is also possible to check the state of INT pin.

Key functions:

• uint16_t color3_readRedData() - Read red data function.
• uint16_t color3_readGreenData() - Read green data function. 
• uint16_t color3_readBlueData() - Read blue data function.

Examples description

The application is composed of the three sections :

• System Initialization - Initializes I2C module, LOG and GPIO structures, sets INT pin as input.
• Application Initialization - Initalizes I2C driver, applies default settings and makes an initial log.
• Application Task - (code snippet) This example demonstrates the use of Color 3 Click board. It reads reflected color values and displays the results on USART terminal.

void applicationTask()
{
    clearData = color3_readClearData();
    WordToStr( clearData, logTxt );
    ltrim( logTxt );
    mikrobus_logWrite( " Clear: ", _LOG_TEXT );
    mikrobus_logWrite( logTxt, _LOG_LINE );

    redData = color3_readRedData();
    WordToStr( redData, logTxt );
    ltrim( logTxt );
    mikrobus_logWrite( " Red: ", _LOG_TEXT );
    mikrobus_logWrite( logTxt, _LOG_LINE );

    greenData = color3_readGreenData();
    WordToStr( greenData, logTxt );
    ltrim( logTxt );
    mikrobus_logWrite( " Green: ", _LOG_TEXT );
    mikrobus_logWrite( logTxt, _LOG_LINE );

    blueData = color3_readBlueData();
    WordToStr( blueData, logTxt );
    ltrim( logTxt );
    mikrobus_logWrite( " Blue: ", _LOG_TEXT );
    mikrobus_logWrite( logTxt, _LOG_LINE );

    mikrobus_logWrite( "-----------------", _LOG_LINE );
    Delay_ms( 1000 );
}

Other mikroE Libraries used in the example:

• I2C
• UART
• Conversions

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.