Grove - Sunlight Sensor

Grove - Sunlight Sensor is a multi-channel digital light sensor, which has the ability to detect UV-light, visible light and infrared light.

This device is based on SI1151, a new sensor from SiLabs. The Si1151 is a low-power, reflectance-based, infrared proximity, UV index and ambient light sensor with I2C digital interface and programmable-event interrupt output. This device offers excellent performance under a wide dynamic range and a variety of light sources including direct sunlight.

Grove - Sunlight Sensor include an on-bard Grove connector, which help you to connect it your Arduino easily. You can use this device for making some project which need to detect the light, such as a simple UV detector.

The main chip of the device has been updated to SI1151, the tutorial to SI1145 still remain.

Version

Product Version	Changes	Released Date
Grove - Sunlight Sensor v1.0	Initial	Feb 12 2020
Grove - Sunlight Sensor v2.0	replace Si1145 with Si1151-AB00-GMR	Jul 27 2021

Upgradable to Industrial Sensors

With the SenseCAP S2110 controller and S2100 data logger, you can easily turn the Grove into a LoRaWAN® sensor. Seeed not only helps you with prototyping but also offers you the possibility to expand your project with the SenseCAP series of robust industrial sensors.

SenseCAP S210x series industrial sensors provide an out-of-box experience for environmental sensing. Please refer to the S2102 Wireless Light Intensity Sensor with higher performance and robustness for light intensity detection. The series includes sensors for soil moisture, air temperature and humidity, light intensity, CO2, EC, and an 8-in-1 weather station. Try the latest SenseCAP S210x for your next successful industrial project.

SenseCAP Industrial Sensor

S2102 Light

Features

---

• Digital light sensor
• Wide spectrum detection range to improve accuracy.
• Programmable configuration which make it versatile for various applications.
• Detect sunlight directly
• Grove compatible
• I2C Interface(7-bit)

tip

More details about Grove modules please refer to Grove System

Specification

---

Operating Voltage	3.0-5.5V
Working current	3.5mA
Wave length	280-950nm
Default I2C Address	0x60
Operating Temperature	-45-85℃

Hardware Overview

---

• Grove Connector - a 4pin interface, contain VCC, GND, SDA and SCL
• LED - LED Driver pin
• INT - a programmable interrupt output
• SI1151 - IC

Getting Started

---

After this section, you can make Grove - Sunlight Sensor run with only few steps.

SI1145 - Play with Arduino

Materials required

Seeeduino V4.2	Grove - Sunlight Sensor
Get One Now	Get One Now

caution

If this is your first time using Arduino, Please put hand on here to start your Arduino journey.

Connecting hardware

note

If you need a plug more modules on main control board, you may need a Grove base shield which will make your work easy.

Download

Click here to download the library and then add it to the Arduino.

Launch Arduino IDE and click File>Examples>Grove_Sunlight_Sensor>SI1145DEMO to open the test code.

/*
    This is a demo to test Grove - Sunlight Sensor library

*/

#include <Wire.h>

#include "Arduino.h"
#include "SI114X.h"

SI114X SI1145 = SI114X();

void setup() {

    Serial.begin(115200);
    Serial.println("Beginning Si1145!");

    while (!SI1145.Begin()) {
        Serial.println("Si1145 is not ready!");
        delay(1000);
    }
    Serial.println("Si1145 is ready!");
}

void loop() {
    Serial.print("//--------------------------------------//\r\n");
    Serial.print("Vis: "); Serial.println(SI1145.ReadVisible());
    Serial.print("IR: "); Serial.println(SI1145.ReadIR());
    //the real UV value must be div 100 from the reg value , datasheet for more information.
    Serial.print("UV: ");  Serial.println((float)SI1145.ReadUV() / 100);
    delay(1000);
}

Click Tools>Board to choose Arduino UNO and select respective serial port.

Now click Upload(CTRL+U) to burn testing code. Please refer to here for any error prompt .

Review Results

After upload completed, Open Serial Monitor of your Arduino IDE, you can get the data:

note

Vis - visible light, unit in lm
IR - infrared light, unit in lm
UV - UN index

Now, put Grove - Sunlight Sensor under the sun to see if it's a nice day.

SI1151 - Play with Arduino

Materials required

Seeeduino V4.2	Grove - Sunlight Sensor
Get One Now	Get One Now

caution

If this is your first time using Arduino, Please put hand on here to start your Arduino journey.

Connecting hardware

note

If you need a plug more modules on main control board, you may need a Grove base shield which will make your work easy.

Download

Click here to download the library and then add it to the Arduino.

Launch Arduino IDE and click File>Examples>Grove_Sunlight_Sensor>SI1151 to open the test code.

#include "Si115X.h"

Si115X si1151;

/**
 * Setup for configuration
 */
void setup()
{
    Wire.begin();
    Serial.begin(115200);
    if (!si1151.Begin()) {
        Serial.println("Si1151 is not ready!");
        while (1) {
            delay(1000);
            Serial.print(".");
        };
    }
    else {
        Serial.println("Si1151 is ready!");
    }
}

/**
 * Loops and reads data from registers
 */
void loop()
{
    Serial.print("IR: ");
    Serial.println(si1151.ReadIR());
    Serial.print("Visible: ");
    Serial.println(si1151.ReadVisible());

    delay(500);
}

Click Tools>Board to choose Arduino UNO and select respective serial port.

Now click Upload(CTRL+U) to burn testing code. Please refer to here for any error prompt .

Review Results

After upload completed, Open Serial Monitor of your Arduino IDE, you can get the data:

note

Vis - visible light, unit in lm
IR - infrared light, unit in lm
UV - UN index

Now, put Grove - Sunlight Sensor under the sun to see if it's a nice day.

SI1145 - Play with Raspberry Pi

Materials required

Raspberry Pi 4 Model B	Grove - Base Hat for Raspberry Pi	Grove - Sunlight Sensor
Get One Now	Get One Now	Get One Now

Connecting hardware

Step 1. Connect Grove - Sunlight Sensor to port I2C of Grove - Base Hat for Raspberry Pi, Plugged into Raspberry Pi 4 Model B. And then connect the Raspberry Pi 4 Model B with a PC.

Step 2. After accessing the system of Raspberry Pi, git clone Seeed_Python_SI114X and install grove.py by inserting the following command:

pip3 install Seeed-grove.py

Or on supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally from PyPI:

pip3 install seeed-python-si114x

Step 3. To install system-wide (this may be required in some cases):

sudo pip3 install seeed-python-si114x

And you can insert the following command to upgrade the driver locally from PyPI:

pip3 install --upgrade seeed-python-si114x

Software

import seeed_si114x
import time
import signal
def handler(signalnum, handler):
    print("Please use Ctrl C to quit")
def main():
    SI1145 = seeed_si114x.grove_si114x()
    print("Please use Ctrl C to quit")
    signal.signal(signal.SIGTSTP, handler) # Ctrl-z
    signal.signal(signal.SIGQUIT, handler) # Ctrl-\
    while True:
        print('Visible %03d UV %.2f IR %03d' % (SI1145.ReadVisible , SI1145.ReadUV/100 , SI1145.ReadIR),end=" ")
        print('\r', end='')
        time.sleep(0.5)
if __name__  == '__main__':
    main()

Before running the demo code, you must check the corresponding i2c number of the board:

ls /dev/i2c*

If the i2c device works properly, there will be:

/dev/i2c-1

If NOT, use the command sudo raspi-config and reboot to enable the i2c device:

Step 4. Run the demo by the following command:

cd Seeed_Python_SI114X-Si115x

python3 examples/BasicRead.py 

success

The outcome will display as following if everything goes well:

note

Visible refers to visible light of Ambient and UV refers to Ultraviolet (UV) Index while IR means infrared light of Ambient.

SI1151 - Play with Raspberry Pi

Materials required

Raspberry Pi 4 Model B	Grove - Base Hat for Raspberry Pi	Grove - Sunlight Sensor
Get One Now	Get One Now	Get One Now

Connecting hardware

Step 1. Connect Grove - Sunlight Sensor to port I2C of Grove - Base Hat for Raspberry Pi, Plugged into Raspberry Pi 4 Model B. And then connect the Raspberry Pi 4 Model B with a PC.

Step 2. After accessing the system of Raspberry Pi, git clone Grove_Sunlight_Sensor library

git clone git clone [email protected]:Seeed-Studio/Grove_Sunlight_Sensor.git -b Si1151 Si1151_library

Before running the demo code, you must check the corresponding i2c number of the board:

ls /dev/i2c*

If the i2c device works properly, there will be:

/dev/i2c-1

If NOT, use the command sudo raspi-config and reboot to enable the i2c device:

Step 3. Run the demo by the following command:

cd Seeed_Python_SI114X-Si115x

python3 seeed_si115x.py

success

The outcome will display as following if everything goes well:

Visible refers to visible light of Ambient and UV refers to Ultraviolet (UV) Index while IR means infrared light of Ambient. :::

References

Spectrum

The content of this chapter is got from Wikipedia - Spectrum, click to view the original page.

A spectrum (plural spectra or spectrums[1]) is a condition that is not limited to a specific set of values but can vary infinitely within a continuum. The word was first used scientifically within the field of optics to describe the rainbow of colors in visible light when separated using a prism. As scientific understanding of light advanced, it came to apply to the entire electromagnetic spectrum.

Spectrum has since been applied by analogy to topics outside of optics. Thus, one might talk about the spectrum of political opinion, or the spectrum of activity of a drug, or the autism spectrum. In these uses, values within a spectrum may not be associated with precisely quantifiable numbers or definitions. Such uses imply a broad range of conditions or behaviors grouped together and studied under a single title for ease of discussion.

In most modern usages of spectrum there is a unifying theme between extremes at either end. Some older usages of the word did not have a unifying theme, but they led to modern ones through a sequence of events set out below. Modern usages in mathematics did evolve from a unifying theme, but this may be difficult to recognize.

Lumen

The content of this chapter is got from Wikipedia - Lumen (unit), click to view the original page.

The lumen (symbol: lm) is the SI derived unit of luminous flux, a measure of the total "amount" of visible light emitted by a source. Luminous flux differs from power (radiant flux) in that luminous flux measurements reflect the varying sensitivity of the human eye to different wavelengths of light, while radiant flux measurements indicate the total power of all electromagnetic waves emitted, independent of the eye's ability to perceive it. Lumens are related to lux in that one lux is one lumen per square meter.

Ultraviolet index

The content of this chapter is got from Wikipedia - Ultraviolet index, click to view the original page.

The ultraviolet index or UV Index is an international standard measurement of the strength of sunburn-producing ultraviolet (UV) radiation at a particular place and time. The scale was developed by Canadian scientists in 1992, then adopted and standardized by the UN's World Health Organization and World Meteorological Organization in 1994. It is primarily used in daily forecasts aimed at the general public, and is increasingly available as an hourly forecast as well.

The UV Index is designed as an open-ended linear scale, directly proportional to the intensity of UV radiation that causes sunburn on human skin. For example, if a light-skinned individual (without sunscreen or a suntan) begins to sunburn in 30 minutes at UV Index 6, then that individual should expect to sunburn in about 15 minutes at UV Index 12 – twice the UV, twice as fast.

The purpose of the UV Index is to help people effectively protect themselves from UV radiation, which has health benefits in moderation but in excess causes sunburn, skin aging, DNA damage, skin cancer, immunosuppression,[1] and eye damage such as cataracts (see the section Human health-related effects of ultraviolet radiation). Public health organizations recommend that people protect themselves (for example, by applying sunscreen to the skin and wearing a hat and sunglasses) if they spend substantial time outdoors when the UV Index is 3 or higher; see the table below for more-detailed recommendations.

When the day's predicted UV Index is within various numerical ranges, the recommendations for protection are as follows:

Cautionary notes

When interpreting the UV Index and recommendations, be aware that:

• The intensity of UV radiation reaching the surface of the earth depends on the angle of the sun in the sky. Each day, the sun achieves its highest angle (highest intensity, shortest shadows) at solar noon, which only approximately corresponds to 12:00 on clocks. This is because of the differences between solar time and local time in a given time zone. In general, UV risk is high when the sun is directly enough overhead that people's shadows are shorter than their height.
• Likewise, UV intensity can be higher or lower for surfaces at different angles to the horizontal. For example, if people are walking or standing outdoors, UV exposure to the eyes and vertical surfaces of skin, such as the face, can actually be more severe when the sun is lower, such as the end of a summer's day, or winter afternoons on a ski trail. This is partly a consequence of the fact that the measurement equipment upon which the index is based is a flat horizontal surface. UV intensity can nearly double with reflection from snow or other bright surfaces like water, sand, or concrete.
• The recommendations given are for average adults with lightly tan skin. Those with darker skin are more likely to withstand greater sun exposure, while extra precautions are needed for children, seniors, particularly fair-skinned adults, and those who have greater sun sensitivity for medical reasons or from UV exposure in previous days. (The skin's recovery from UV radiation generally takes two days or more to run its course.)
• Because of the way the UV Index is calculated, it technically expresses the risk of developing sunburn, which is caused mostly by UVB radiation. However, UVA radiation also causes damage (photoaging, melanoma). Under some conditions, including most tanning beds, the UVA level may be disproportionately higher than described by the UV Index. The use of broad-spectrum (UVA/UVB) sunscreen can help address this concern.

Schematic Online Viewer

Resources

---

• Schematic in PDF
• Schematic in Eagle File
• Si1145 datasheet
• Github Repositoriy for Grove - Sunlight Sensor
• Spectrum
• Lumen (unit)
• Ultraviolet index
• Grove - Sunlight Sensor v2.0
• SI1151-AB00-GMR Datasheet

Project

The Environment Cube! Know the Land Beneath You! A cube with all the necessary sensors, suitable for a wide range of applications like agriculture. Know the land beneath you!

Tech Support & Product Discussion

Thank you for choosing our products! We are here to provide you with different support to ensure that your experience with our products is as smooth as possible. We offer several communication channels to cater to different preferences and needs.