MIKROE-3199

\          Ambient 4 click PID: MIKROE‐3199 Weight: 23 g Ambient 4 click is a light intensity-sensing and measuring Click board™, which features an accurate, light-intensity sensor labeled as BH1721FVC, made by ROHM Corporation. It offers a high measurement accuracy in the range between 1x to 1.35x of the actual light intensity. The spectral response of the sensor is calibrated to closely match the spectral response of the human eye. Thanks to its high level of integration, the sensor requires a minimal number of external components, allowing the Click board™ to incorporate an additional level translating IC, ensuring a reliable data transfer over the industry-standard I2C interface.   The influence of the light source type on the measurement accuracy is quite reduced. The sensor is capable of converting the light intensity from any type of light source, including daylight, fluorescent light, LED light, incandescent light, and so on. It also features a flickering filter, reducing the 50/60 Hz flickering influence. Its low power consumption, compact size, high sensitivity, and a high level of integration, make this sensor an ideal solution for both the IoT light-sensing applications, but also for portable or handheld devices which utilize an accurate light intensity sensing, such as the TFT/LCD screens, keypad backlight, cell phones, digital cameras, and similar. How does it work? As mentioned previously, Ambient 4 click uses the BH1721FVC, a 16-bit digital light sensor with the I2C serial interface, from ROHM Corporation. This sensor has many features that make it a perfect solution for small designs such as the Ambient 4 Click board™. One of these features is certainly its high level of integration, that allows a minimal number of external components, leaving room for an additional I2C level translator IC, labeled as PCA9306, a reliable I2C level translator from Texas Instruments, proven in many designs. This allows a high number of microcontrollers (MCUs) to be interfaced with Ambient 4 click. The BH1721FVC sensor is also immune to flickering and its accuracy is not influenced by the light source type. It is calibrated so its spectral response is closely matched to a spectral response of the human eye. The BH1721FVC sensor of Ambient 4 click can operate in two modes: it can be operated in Low-Resolution mode and High-Resolution mode. While operating in the Low-Resolution mode, the measuring resolution is 8 lx per step. When operated in a High-Resolution mode, the accuracy is 1 lx per step. When sensing very low amounts of light, it is mandatory to use HighResolution mode, since it is not possible to obtain valid results in LowResolution mode. The resolution can be also fine-tuned by changing the measurement time. This is used to increase the sensitivity of the sensor, as well as to reduce the influence of the optical window if one is mounted over the sensor. Increasing of the measurement time allows light amount down to 0.25 lx to be detected. The Low-Resolution mode, in general, allows much shorter measurement times, while high resolution will use longer to place the conversion data on the 16-bit output register. As mentioned already, the spectral response of the sensor is closely matched to the response of the human eye. This means that the sensor outputs highest results for the light spectrum range between 500nm and 650 nm, which includes most of the light energy in the visible light spectrum: this is a color range from cyan to orange. The datasheet of the BH1721FVC offers a more accurate representation of the spectrum response, as well as for other operating parameters. The sensitivity of the sensor is also affected by the incidence angle of the light rays. The BH1721FVC datasheet offers an accurate representation of the sensor's field of view (FOV), but a light source with the incidence angle of ±45˚ will result with the measured ratio of 0.8 times compared to the same light source intensity perpendicular to the surface of the sensor. Since the sensor output result is 16-bit, it is stored in the LSB/MSB format, in two separate output registers. To obtain a measurement data in proper units (Lux, lx), a data conversion has to be performed by the firmware of the host MCU. The datasheet of the BH1721FVC contains these conversion formulas, although Ambient 4 click comes supported by a library that contains the functions that simplify the use of the Click board™. The 16-bit light intensity data is present at the I2C interface output. The I2C bus lines are routed to the aforementioned PCA9306 level translator. This allows interfacing with the wide range of different MCUs, both 3.3V, and 5V. It is worth mentioning that the sensor requires a reset after the power-up sequence, in order to set its internal registers to their defaults. This can be achieved by pulling the DVI line of the sensor to a LOW logic level for at least 1 µs. An onboard SMD jumper labeled as VCC SEL offers a selection of the voltage at which the logic interface is operated (3.3V or 5V). I2C bus lines are routed to the respective mikroBUS™ pins, while the DVT line is routed to the RST pin of the mikroBUS™. Specifications Type Optical Applications This sensor is an ideal solution for both the IoT light sensing applications, and portable or handheld devices which utilize an accurate light intensity sensing, such as the TFT/LCD screens, keypad backlight, cell phones, digital cameras, and similar On-board modules BH1721FVC, a 16-bit digital light sensor with I2C serial interface, from ROHM; PCA9306, an I2C level translator from Texas Instruments Key Features A high resolution and range of light-intensity that can be measured, a spectral response similar to human eye, low power consumption, compact design ideal for building IoT applications, immune to flickering and fluorescent light sources, independent of the light source type, and more Interface I2C Input Voltage 3.3V,5V Compatibility mikroBUS Click board size M (42.9 x 25.4 mm) Pinout diagram This table shows how the pinout on Ambient 4 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 RST 2 RST INT 15 NC 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 Ground GND 8 GND GND 9 GND Reset Chip       Power supply Ground Onboard jumpers and settings Label Name Default Description LD1 PWR - Power LED indicator JP5 VCC SEL Left Logic voltage level selection: left position 3.3V, right position 5V Software support We provide a library for the Ambient 4 Click on our LibStock page , as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards. Library Description The library contains all the necessary functions for working with Ambient 4 click. Key functions:    void ambient4_sendCommand(uint8_t cmd) - Function for send command uint16_t ambient4_readData - Function for read 16bit data void ambient4_deviceReset() - Function for device reset Example description The application is composed of the three sections:  System Initialization - Initializes I2C module and set RST pin as OUTPUT  Application Initialization - Initialization driver init and power ON chip and set resolution mode  Application Task - (code snippet) - Read ambient light in [lx] and logs data to USBUART every 1 sec. void applicationInit()  {   readValue = ambient4_readData();   IntToStr(readValue, demoText);   mikrobus_logWrite(" Ambient light: ", _LOG_TEXT);   mikrobus_logWrite(demoText, _LOG_TEXT);   mikrobus_logWrite(" lx ", _LOG_LINE);   Delay_1sec();  }  The full application code, and ready to use projects can be found on our Libstock page. Other MikroElektronika libraries used in the example:  I2C 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. 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.                                                     https://www.mikroe.com/ambient‐4‐click 10‐23‐18