SENSORS/ACTUATORS

ESP8266 - Light Sensor

This tutorial instructs you how to use the light sensor with ESP8266. In detail:

How a light sensor works
How to connect a light sensor to an ESP8266
How to program an ESP8266 to read the value from the light sensor

If you're looking for a light sensor in module form, I recommend checking out the tutorial for the ESP8266 - LDR Light Sensor Module.

Hardware Preparation

1	×	ESP8266 NodeMCU
1	×	Micro USB Cable
1	×	Light Sensor
1	×	10 kΩ resistor
1	×	Breadboard
1	×	Jumper Wires
1	×	(Optional) 5V Power Adapter for ESP8266
1	×	(Optional) ESP8266 Screw Terminal Adapter

Or you can buy the following sensor kit:

DIYables Sensor Kit 30 types, 69 units

Disclosure: Some of the links provided in this section are Amazon affiliate links. We may receive a commission for any purchases made through these links at no additional cost to you. We appreciate your support.

Overview of Light Sensor

The sensor used in this tutorial is a photoresistor, also known as a light-dependent resistor, LDR, or photocell.

It is not only used to detect light, but also to measure the intensity of the surrounding light.

The Light Sensor Pinout

A photoresistor has two pins which do not need to be distinguished, as it is a type of resistor and thus the pins are symmetric.

How It Works

The amount of light that the photoresistor's face is exposed to affects its resistance. By measuring this resistance, we can determine the brightness of the surrounding light.

The value from the light sensor only gives an approximate indication of the intensity of light, not a precise measure of luminous flux. Consequently, it should not be used for applications that need a high degree of accuracy.

ESP8266 - Light Sensor

ESP8266's analog pins can be used as analog inputs. These analog input pins convert the voltage (ranging from 0 volts to VCC) into integer values (ranging from 0 to 1023), referred to as ADC value or analog value.

Connect one pin of the photoresistor to an analog input pin. Using analogRead() function, read the analog value from the pin. This will allow us to determine the light levels relatively.

Wiring Diagram

This image is created using Fritzing. Click to enlarge image

ESP8266 Code

The code below reads the value from the photocell and qualitatively determines the light level.

/* * This ESP8266 NodeMCU code was developed by newbiely.com * * This ESP8266 NodeMCU code is made available for public use without any restriction * * For comprehensive instructions and wiring diagrams, please visit: * https://newbiely.com/tutorials/esp8266/esp8266-light-sensor */ #define LIGHT_SENSOR_PIN A0 // ESP8266 pin ADC0 void setup() { // initialize serial communication at 9600 bits per second: Serial.begin(9600); } void loop() { // reads the input on analog pin (value between 0 and 4095) int analogValue = analogRead(LIGHT_SENSOR_PIN); Serial.print("Analog Value = "); Serial.print(analogValue); // the raw analog reading // We'll have a few threshholds, qualitatively determined if (analogValue < 40) { Serial.println(" => Dark"); } else if (analogValue < 800) { Serial.println(" => Dim"); } else if (analogValue < 2000) { Serial.println(" => Light"); } else if (analogValue < 3200) { Serial.println(" => Bright"); } else { Serial.println(" => Very bright"); } delay(500); }

Detailed Instructions

To get started with ESP8266 on Arduino IDE, follow these steps:

Check out the how to setup environment for ESP8266 on Arduino IDE tutorial if this is your first time using ESP8266.
Wire the components as shown in the diagram.
Connect the ESP8266 board to your computer using a USB cable.
Open Arduino IDE on your computer.
Choose the correct ESP8266 board, such as (e.g. NodeMCU 1.0 (ESP-12E Module)), and its respective COM port.
Copy the code and open it with the Arduino IDE.
Click the Upload button on the Arduino IDE to compile and upload the code to the ESP8266.
Open the Serial Monitor.
Shine a light on the sensor.
Check the Serial Monitor to view the result.

COM6

Send

Analog reading: 163 - Dim Analog reading: 152 - Dim Analog reading: 187 - Dim Analog reading: 188 - Dim Analog reading: 957 - Very bright Analog reading: 972 - Very bright Analog reading: 981 - Very bright

Autoscroll Show timestamp

Clear output

9600 baud

Newline

Light Sensor and LED

When the environment is dark, the code will activate the LED, otherwise it will deactivate it.

/* * This ESP8266 NodeMCU code was developed by newbiely.com * * This ESP8266 NodeMCU code is made available for public use without any restriction * * For comprehensive instructions and wiring diagrams, please visit: * https://newbiely.com/tutorials/esp8266/esp8266-light-sensor */ // constants won't change #define LIGHT_SENSOR_PIN A0 // ESP8266 pin ADC0 connected to light sensor #define LED_PIN 22 // ESP8266 pin GPIO22 connected to LED #define ANALOG_THRESHOLD 500 void setup() { pinMode(LED_PIN, OUTPUT); // set ESP8266 pin to output mode } void loop() { int analogValue = analogRead(LIGHT_SENSOR_PIN); // read the value on analog pin if (analogValue < ANALOG_THRESHOLD) digitalWrite(LED_PIN, HIGH); // turn on LED else digitalWrite(LED_PIN, LOW); // turn off LED }

The wiring diagram for the code above.

ESP8266 NodeMCU Light Sensor LED wiring diagram

This image is created using Fritzing. Click to enlarge image

Video Tutorial

Creating videos is a time-consuming task. If you find video tutorials helpful for your learning, please let us know by subscribing to our YouTube channel . If there is high demand for videos, we will work on creating them.

Challenge Yourself

When the light in your room is dim, activate it automatically.
Refer to ESP8266 - Relay for instructions on how to do this.

ESP8266 - Light Sensor

Hardware Preparation

Overview of Light Sensor

The Light Sensor Pinout

How It Works

ESP8266 - Light Sensor

Wiring Diagram

ESP8266 Code

Detailed Instructions

Light Sensor and LED

Video Tutorial

Challenge Yourself

Language References

Learn More