ESP8266 Laser Sensor Module Project
This project demonstrates how to interface a laser sensor module with an ESP8266 microcontroller to detect the presence or interruption of a laser beam. The sensor can be used in various applications such as security systems, object detection, and line following robots.
How It Works
A laser module such as the KY-008 is a 650 nm red laser diode on a small carrier board with its current-limiting resistor already fitted. It is not a sensor on its own — it is an emitter. Paired with a detector on the far side of a gap it forms a break-beam sensor, the most reliable way to detect that something has passed a point.
The diode is driven like an LED: a logic HIGH on the signal pin turns it on. Because the beam is collimated it stays narrow over several metres, which is exactly what makes it useful. A photoresistor, photodiode or phototransistor on the opposite side sees a sharp drop in light the instant the beam is interrupted.
Output power is typically around 5 mW — a Class 3R device. That is strong enough to damage the retina on direct viewing, so the beam should always be aimed away from eye level and never pointed at anyone.
Components Needed
- ESP8266 (NodeMCU)
- Laser Sensor Module
- Jumper Wires
- ESP8266 (NodeMCU)
Wiring to the ESP8266 (NodeMCU)
Connect S to D5, the middle pin to the 3.3 V rail and the − pin to GND. The KY-008 already carries its series resistor, so no external component is needed. Driving it from a GPIO is acceptable because the module draws roughly 20–30 mA.
For a break-beam arrangement, mount an LDR or phototransistor directly opposite the laser and read it on A0. Shield the detector from room lighting with a short tube of black heatshrink — ambient light, not the laser, is what limits reliability.
Because the ESP8266 (NodeMCU) runs on 3.3 V logic, check the module's output swing before wiring it directly. A module powered from 5 V can present 5 V on its signal pin, which exceeds the GPIO rating — drop it with a divider or a level shifter.
| Module pin | ESP8266 (NodeMCU) pin | Function |
|---|---|---|
| S (signal) | D5 | Drives the laser on and off |
| Middle | 3V3 | Supply |
| − (GND) | GND | Common ground |
Build and Upload
After uploading the code, open the Serial Monitor.
Observe the messages indicating whether the laser beam is detected or interrupted.
Interrupt the laser beam to test the sensor's response.
Example Code
Break-beam detector: pulse the laser, read the detector, report interruptions. Upload it with the board set to ESP8266 (NodeMCU) and open the Serial Monitor at 115200 baud.
const int LASER_PIN = 5;
const int DETECT_PIN = A0;
const int THRESHOLD = 409; // tune for your optics
bool beamBroken = false;
void setup() {
Serial.begin(115200);
pinMode(LASER_PIN, OUTPUT);
digitalWrite(LASER_PIN, HIGH); // beam on continuously
delay(50); // let the detector settle
}
void loop() {
int light = analogRead(DETECT_PIN);
bool broken = (light < THRESHOLD);
if (broken != beamBroken) { // report edges only
beamBroken = broken;
Serial.println(broken ? "BEAM BROKEN" : "beam restored");
}
delay(10);
}Applications
A laser sensor module turns up in a wide range of projects. These are the uses where it is the right choice rather than a compromise:
- Entry counters for doorways and corridors
- Perimeter and tripwire alarms
- Object counting on a conveyor or chute
- Speed traps, by timing an object across two beams a known distance apart
- Non-contact end stops where a mechanical switch would wear out
Working with the ESP8266 (NodeMCU)
The ESP8266 (NodeMCU) is built around the ESP8266 and runs on 3.3 V logic with roughly 80 KB usable of SRAM and 4 MB on most NodeMCU boards of program flash. These details change how this circuit is wired and what the sketch can do, so they are worth stating plainly before you build.
The ESP8266 is a 3.3 V part and is not 5 V tolerant — feeding a 5 V sensor output straight into a GPIO can damage the chip. Use a divider or level shifter.
There is only one ADC channel, so reading several analog sensors needs an external multiplexer such as a CD4051 or an ADS1115.
D3 (GPIO0), D4 (GPIO2) and D8 (GPIO15) are strapping pins sampled at boot; holding them at the wrong level stops the board starting.
Built-in WiFi means the same sketch can publish readings to a dashboard without extra hardware.
| ESP8266 (NodeMCU) characteristic | Value | Why it matters here |
|---|---|---|
| Logic voltage | 3.3 V | Sensor outputs above this level need a divider or level shifter |
| ADC resolution | 10-bit (0–1023) | Sets how finely an analog reading can be resolved |
| Analog inputs | a single analog channel, A0 | Determines how many analog sensors can share the board |
| PWM outputs | any GPIO via software PWM | Needed for brightness, speed and tone control |
| I²C pins | D2 (SDA, GPIO4) and D1 (SCL, GPIO5) by default | Fixed by hardware — wiring copied from another board may not match |
| Interrupt pins | any GPIO except D0 (GPIO16) | Required for counting fast or asynchronous events |
| Serial | one hardware UART plus a transmit-only second port | Monitor runs at 115200 baud by default |
Troubleshooting
Most problems with this module fall into a handful of categories. Work through these before suspecting the part itself:
- The detector never crosses the threshold — room lighting is swamping the laser. Shield the detector and re-measure both lit and blocked values.
- Detection is intermittent at range — the beam is drifting off the detector. Mount both ends rigidly; a few millimetres of flex is enough to miss.
- The laser is dim or flickering — the GPIO cannot supply enough current. Drive it through a transistor instead.
- Readings invert — an LDR divider can be wired either way round; swap the fixed resistor and sensor positions.
- The sketch compiles but the board resets or behaves erratically — a 5 V module output is being driven into a 3.3 V pin. Measure the signal before connecting it.
- Readings differ from an Arduino tutorial for the same part — the 10-bit ADC returns 0–1023, not 0–1023, so any constant copied from an Uno example needs rescaling.
Taking It Further on the ESP8266 (NodeMCU)
Once the basic reading works, where you go next depends very much on which board you are using. These are the directions that suit the ESP8266 (NodeMCU) specifically:
The obvious extension on an ESP8266 is to stop printing to Serial and publish instead. A few lines using ESP8266WiFi and an HTTP client will push each reading to a dashboard such as ThingSpeak, or to an MQTT broker for home automation.
Running an onboard web server turns the board into its own display: serve a small HTML page that fetches the latest reading over AJAX, and any phone on the network becomes the instrument panel.
For battery operation, deep sleep is essential — the ESP8266 draws around 70 mA with WiFi active but under 20 µA asleep. Wire D0 (GPIO16) to RST so the board can wake itself, take a reading, publish and sleep again.
Notes and Practical Limits
Never look into the beam or aim it at reflective surfaces at eye height. Treat the module as you would any laser pointer, and switch it off in software when the project is idle rather than leaving it permanently lit.
Pulsing the laser and sampling in step with the pulses rejects ambient light far better than a continuous beam. Drive the laser from a timer, read the detector both lit and unlit, and use the difference — this is how commercial break-beam sensors ignore sunlight.