Ambient 15 Click-Platine
Ambient 15 Click-Platine
Overview
Das Ambient 15 Click Board™ ist eine kompakte Zusatzplatine zum Messen der Menge des vorhandenen Umgebungslichts. Diese Platine verfügt über den TSL2584TSV, einen sehr hochempfindlichen Licht-Digital-Konverter mit einer I2C-Schnittstelle, der die Lichtintensität in ein digitales Ausgangssignal von AMS-AG umwandelt. Die nahezu photopische Reaktion des TSL2584TSV erzeugt eine hochgenaue Luxmessung von bis zu 33klx, selbst bei Montage hinter dunklem Glas. Durch das Herausfiltern unerwünschten IR-Lichts kann der Sensor das Umgebungslicht genauer messen und so eine nahezu photopische Reaktion erzeugen. Es wurde entwickelt, um die Helligkeit in verschiedenen Anwendungen basierend auf der Verfügbarkeit von Umgebungslicht, der Helligkeit für optimale Sichtbarkeit und der Energieeffizienz zu steuern. Der Betrieb in einem Temperaturbereich von -40 °C bis 85 °C gewährleistet einen stabilen Betrieb unter extremen Bedingungen. Dieses Click Board™ ist am besten geeignet, um Umgebungslichtdaten zum Anpassen der Helligkeit in Anwendungen zu erhalten, die Energieeinsparung und bessere Sichtbarkeit erfordern.
Die Ambient 15 Click-Platine wird von einer mikroSDK-kompatiblen Bibliothek unterstützt, die Funktionen enthält, die die Softwareentwicklung vereinfachen. Diese Click-Platine™ wird als vollständig getestetes Produkt geliefert und ist bereit für den Einsatz auf einem System, das mit der mikroBUS™-Buchse ausgestattet ist.
How Does The Ambient 15 Click Board™ Work?
The Ambient 15 Click Board™ as its foundation uses the TSL2584TSV, a high sensitivity light-to-digital converter that transforms light intensity into a digital output signal from AMS-AG. Thanks to its near-photopic response, the TSL2584TSV can detect a wide range of highly accurate lux measurements up to 33klx, even when mounted behind dark glass. Filtering out unwanted IR light enables the sensor to accurately measure the ambient light, thus producing a near-photopic response. It also has stable performance over a wide temperature range of -40°C to 85°C, suitable for measuring the present ambient light.
The TSL2584TSV combines one broadband photodiode (visible plus infrared), one infrared-responding photodiode, and, as mentioned before, a photopic infrared-blocking filter on a single CMOS integrated circuit. Two integrating analog-to-digital converters (ADC) convert the photodiode currents into a digital output representing the irradiance measured on each channel. Integration of both channels occurs simultaneously. Upon completion of the conversion cycle, the conversion result is transferred to the Channel 0 and Channel 1 data registers. The transfers are double-buffered to ensure that the integrity of the data is maintained. After the transfer, the device automatically begins the next integration cycle.
The Ambient 15 Click Board™ communicates with MCU using the standard I2C 2-Wire interface to read data and configure settings, supporting Standard Mode operation with a clock frequency of 100kHz and Fast Mode up to 400kHz. Besides, the TSL2584TSV allows choosing the least significant bit (LSB) of its I2C slave address using the SMD jumper labelled ADDR SEL. It also possesses an additional interrupt signal, routed on the INT pin of the mikroBUS™ socket labelled as INT, indicating when a specific interrupt event occurs, such as detecting a meaningful change in light intensity.
The Ambient 15 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
Type | Optical |
Applications | The Ambient 15 Click Board™ be used for obtaining ambient light data for adjusting brightness in applications that require power saving and better visibility |
On-board modules | TSL2584TSV - high sensitivity light-to-digital converter that transforms light intensity into a digital output signal from AMS-AG |
Key Features | Low power consumption, corresponds to a dark window because of high sensitivity, close responsivity to the human eye, I2C interface with selectable slave address, wide illumination range, stable performance over temperature, and more |
Interface | I2C |
Compatibility | mikroBUS |
Click board size | S (28.6 x 25.4 mm) |
Input Voltage | 3.3V |
PINOUT DIAGRAM
This table shows how the pinout of the Ambient 15 Click Board™ 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
Label | Name | Default | Description |
---|---|---|---|
LD1 | PWR | - | Power LED Indicator |
JP1 | ADDR SEL | Left | I2C Address Selection 0/1: Left position 0, Right position 1 |
AMBIENT 15 CLICK ELECTRICAL SPECIFICATIONS
Description | Min | Typ | Max | Unit |
---|---|---|---|---|
Supply Voltage | - | 3.3 | - | V |
Illuminance Measurement Range | 0 | - | 33.000 | lx |
Operating Temperature Range | -40 | +25 | +85 | °C |
Software Support
We provide a library for the Ambient 15 Click Board™ as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.
The package can be downloaded/installed directly from NECTO Studio The package Manager (recommended), downloaded from our LibStock™ or found on MikroE Github account.
Library Description
This library contains API for Ambient 15 Click driver.
Key functions
-
ambient15_set_atime
This function sets the timing register for the selected integration time. -
ambient15_set_gain
This function sets the gain level. -
ambient15_measure_light_level
This function reads the raw ADC data from two channels and then measures the light level in lux based on those readings.
Example Description
This example demonstrates the use of the Ambient 15 Click Board™ by measuring the ambient light level in Lux.
void application_task ( void )
{
if ( !ambient15_get_int_pin ( &ambient15 ) )
{
uint16_t lux;
if ( AMBIENT15_OK == ambient15_measure_light_level ( &ambient15, &lux ) )
{
log_printf ( &logger, " Ambient light level [Lux]: %urnn", lux );
}
}
}
The full application code, and ready to use projects can be installed directly from NECTO Studio The package Manager (recommended), downloaded from our LibStock™ or found on MikroE Github account.
Other MikroE Libraries used in the example:
- MikroSDK.Board
- MikroSDK.Log
- Click.Ambient15
Additional Notes and Information
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
The Ambient 15 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.
Software Support
We provide a library for the Ambient 15 Click Board™ as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.
The package can be downloaded/installed directly from NECTO Studio The package Manager (recommended), downloaded from our LibStock™ or found on MikroE Github account.
Library Description
This library contains API for Ambient 15 Click driver.
Key functions
-
ambient15_set_atime
This function sets the timing register for the selected integration time. -
ambient15_set_gain
This function sets the gain level. -
ambient15_measure_light_level
This function reads the raw ADC data from two channels and then measures the light level in lux based on those readings.
Example Description
This example demonstrates the use of the Ambient 15 Click Board™ by measuring the ambient light level in Lux.
void application_task ( void )
{
if ( !ambient15_get_int_pin ( &ambient15 ) )
{
uint16_t lux;
if ( AMBIENT15_OK == ambient15_measure_light_level ( &ambient15, &lux ) )
{
log_printf ( &logger, " Ambient light level [Lux]: %urnn", lux );
}
}
}
The full application code, and ready to use projects can be installed directly from NECTO Studio The package Manager (recommended), downloaded from our LibStock™ or found on MikroE Github account.
Other MikroE Libraries used in the example:
- MikroSDK.Board
- MikroSDK.Log
- Click.Ambient15
Additional Notes and Information
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
The Ambient 15 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.
Frequently Asked Questions
Have a Question?
Be the first to ask a question about this.