Examples > Esplora

Esplora Light Calibrator

This sketch shows you how to read and calibrate the Esplora's light sensor. Because light levels vary from one location to another, you need to calibrate the sensor for each location. To do this, you read the sensor for a few seconds, and save the highest and lowest readings as maximum and minimum.

You'll use the sensor's reading to set the brightness of the LED by mapping the values to a smaller range, using the minimum and the maximum values you obtained in the calibration.

Hardware Required

  • Arduino Esplora


Only your Arduino Esplora is needed for this example. Connect the Esplora to your computer with a USB cable and open the Arduino's Serial Monitor.

light sensor and RGB led on the Esplora


Create some variables to hold your maximum and minimum values for the light sensor, and another one to let the Esplora know if the sensor has been calibrated or not.

To send data to your computer, you need to open a serial connection. Use Serial.begin() to open a serial port at 9600 baud on the Esplora.

Use Esplora.readButton() to see if button 1 is being pressed. If it is, call the calibrate() function you'll be writing below.

To read the light sensor, use Esplora.readLightSensor(). This will give you a value between 0 and 1023, which will be stored in a variable.

You'll want to map the value from the sensor to a range that is appropriate for the LED using your maximum and minimum range. The map() function takes 5 arguments, the original value, the minimum value of the sensor, the maximum value of the sensor, the minimum value of the LED (0), and the maximum value of the LED (255). Store this value in a new variable named brightness.

The map() function doesn't limit the values to 0 and 255. If you happen to get sensor readings outside your maximum and minimum values, map() would return values less than 0 or higher than 255. To make sure you stay in that range, call constrain().

To change the color of the LED with your new value between 0 and 255, call Esplora.writeBlue().

Once the light has been calibrated, send the values to the Serial Monitor by calling Serial.print(). You should start to see values reported like this :
light sensor level: 256 blue brightness: 10

These values will not print to the Serial Monitor until you've calibrated the sensor, and the calibrated variable is set to true.

To create your own function called calibrate. To do this, outside of the loop(), type

void calibrate (){


This creates a function named calibrate. All the code you write between the brackets will now be executed whenever you call calibrate() in your sketch.

In calibrate(), use while() to run the code aslong as the button is pressed.

Read the value of the sensor, and save it in a variable. Initially, you had set the minimum value high. Compare the light sensor value for anything lower than that, saving it as the new minimum. Likewise, you set the maximum low and read for anything higher as the new maximum.

Set the calibration variable to true while you're calibrating.

When you release the button, calibrate() will stop running and return to the loop().

SORRY, There is an error at our code repository, please inform to web@arduino.cc

See Also: