Ambient 9 Click

How does it work?

Ambient 9 Click is based on the APDS-9160-003, digital proximity, and ambient light sensing sensor from Broadcom Limited. The ambient light sensor provides a photopic response to light intensity in low light conditions or behind a darkened glass. It approximates the response of the human eye providing direct readout where the output count is proportional to the ambient light level. The proximity detection also operates well from bright sunlight to dark rooms. Additionally, the device can be put into a low-power standby mode providing a very low average power consumption.

In a proximity sensing system, the included IR LED can be pulsed with more than 100 mA of rapidly switching current. The number of LED pulses can be configured by using the pulse step, and the LED modulation frequency can be set from 60 kHz to 100 kHz in 5 steps. Proximity sensing resolution can vary from 8 to 11 bits, and the measurement rate can vary from 6.25 ms to 400 ms. This Click board™ is easy to program and read data because it does not require an overly demanding configuration. In order to read ambient or proximity data, it is only necessary to enable certain registers which can also be seen in an example code that contains easy to use functions that may be used as a reference for the further development.

Ambient 9 Click communicates with the MCU using the standard I2C 2-wire interface. Standard (100 kHz) and Fast (400 kHz) I2C communication modes are available with the device. The I2C bus lines are routed to the dual bidirectional PCA9306 voltage-level translator from Texas Instruments, which allows interfacing with both 3.3V and 5V MCUs. It also generates flexible ambient and proximity programmable interrupt signals routed on the INT pin of the mikroBUS™, which are triggered if upper or lower threshold values are crossed. It is also possible to deactivate a sensor after a certain interrupt event occurred.

This Click Board™ is designed to be operated with both 3.3V and 5V logic levels that can be selected via VCC SEL jumper. This allows for both 3.3V and 5V capable MCUs to use the I2C communication lines properly.

Specifications

Pinout diagram

This table shows how the pinout on Ambient 9 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	5V	Power Supply
Ground	GND	8	GND	GND	9	GND	Ground

Onboard settings and indicators

Ambient 9 Click electrical specifications

Software Support

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

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

Library Description

This library contains API for Ambient 9 Click driver.

Key functions

• Generic function for reading ALS data from senso

• Generic function for reading proximity data from sensor

• Function for enabeling sensor for ALS or proximity

Example Description

This example demonstrates the use of Ambient 9 Click.

 void application_task ( void ) 
 { 
     uint16_t proxy_data; 
     uint32_t als_data; 

     if ( AMBIENT9_ALS == dev_mode ) 
     { 
         als_data = ambient9_als_data( &ambient9 ); 
         log_printf( &logger, " - ALS data: %lu rn", als_data ); 
     } 
     else if ( AMBIENT9_PROXY == dev_mode ) 
     { 
         proxy_data = ambient9_proxy_data( &ambient9 ); 
         log_printf( &logger, " - Proximity data: %u rn", proxy_data ); 
     } 
     Delay_ms ( 100 ); 
 }

The full application code, and ready to use projects can be installed directly from NECTO Studio 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.Ambient9

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 MIKROE compilers.

mikroSDK

This Click board™ is supported with mikroSDK - MIKROE 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.