Library Description

This library holds functions that can be used to write data, read raw data, read and calculate ambiental illumination and check for interrupt occurence.

Key functions:

• void ambient11_write_data ( uint8_t wr_cmd, uint16_t wr_data ) - Writes 16-bit data into register defined by 8-bit command.
• uint16_t ambient11_read_data ( uint8_t wr_cmd ) - Reads data from register defined by 8-bit command.
• float ambient11_calc_illumination ( float typical_res ) - Function is used to calculate ambiental illumination.

Examples description

The application is composed of three sections :

• System Initialization - Initializes I2C module, LOG structure and sets INT pin as input.
• Application Initialization - Initalizes I2C driver, applies low sensitiviti settings ( GAIN = 0, DG = 0, SENS = 1 and IT = 100ms ) and makes an initial log.
• Application Task - (code snippet) This example shows the capabilities of the Ambient 11 click by measuring ambiental illumination and displaying calculated value via USART terminal in luxes.

void application_task ( )
{
    lx_val = ambient11_calc_illumination( resolution );
    FloatToStr( lx_val, log_txt );
    mikrobus_logWrite( "Illumination : ", _LOG_TEXT );
    mikrobus_logWrite( log_txt, _LOG_TEXT );
    mikrobus_logWrite( "lx", _LOG_LINE );
    
    mikrobus_logWrite( "-------------------------", _LOG_LINE );
    Delay_ms( 2000 );
}

Other mikroE Libraries used in the example:

• I2C
• UART
• Conversion

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.