Component guide · Beginner · 3 min read
TSL2561 Luminosity Sensor

Pinout, Wiring and Code
By Geekobot Learning Team · Updated 29 Oct 2026
On this page
The TSL2561 is a digital light sensor with two photodiodes, one for broadband light and one for infrared only. Subtracting the two gives lux that matches the human eye from 0.1 to about 40,000 lux. It uses I2C at address 0x39 (or 0x29 or 0x49 with the ADDR pin), so up to three fit on one bus.
Key specs at a glance
- Range
- About 0.1 to 40,000 lux
- Channels
- Broadband (visible + IR) and IR-only photodiodes
- Interface
- I2C, address 0x29, 0x39 (default) or 0x49
- Supply
- 2.7 to 3.6 V (modules often 3.3 to 5 V)
- Integration time
- 13.7, 101 or 402 ms
- Gain
- ×1 or ×16
Models in this guide
These are alternatives. Pick the one that fits your project; you only need one.
What the TSL2561 is
Light sources contain different amounts of infrared: sunlight and filament bulbs have a lot, LEDs very little. A plain photodiode sees that infrared too, so its reading does not match what our eyes see. The TSL2561 measures infrared separately and removes it in the lux calculation.
The chip is from TAOS (now ams OSRAM). The TSL2591 is its higher-range successor.
TSL2561 pinout
The pins on the TSL2561 and what each one does.
| Pin | Function |
|---|---|
| VCC / VIN | Supply, 3.3 V (5 V on modules with a regulator) |
| GND | Ground |
| SDA | I2C data |
| SCL | I2C clock |
| ADDR | Address: open 0x39, GND 0x29, VCC 0x49 |
| INT | Interrupt output |
- VCC / VIN
- Supply, 3.3 V (5 V on modules with a regulator)
- GND
- Ground
- SDA
- I2C data
- SCL
- I2C clock
- ADDR
- Address: open 0x39, GND 0x29, VCC 0x49
- INT
- Interrupt output
Wiring the TSL2561
The GY-2561 has a regulator and works from 3.3 or 5 V. Leave ADDR open for 0x39.
| TSL2561 pin | Arduino Uno | ESP32 |
|---|---|---|
| VCC | 5V (or 3.3V) | 3V3 |
| GND | GND | GND |
| SDA | A4 | GPIO 21 |
| SCL | A5 | GPIO 22 |
| ADDR | Open (0x39) | Open (0x39) |
- VCC
- Arduino Uno:
- 5V (or 3.3V)
- ESP32:
- 3V3
- GND
- Arduino Uno:
- GND
- ESP32:
- GND
- SDA
- Arduino Uno:
- A4
- ESP32:
- GPIO 21
- SCL
- Arduino Uno:
- A5
- ESP32:
- GPIO 22
- ADDR
- Arduino Uno:
- Open (0x39)
- ESP32:
- Open (0x39)
Example code
Install "Adafruit TSL2561" and "Adafruit Unified Sensor". A reading of 0 in bright light means the sensor saturated; use a shorter integration time.
#include <Adafruit_Sensor.h>
#include <Adafruit_TSL2561_U.h>
Adafruit_TSL2561_Unified tsl(TSL2561_ADDR_FLOAT, 12345);
void setup() {
Serial.begin(115200);
if (!tsl.begin()) { Serial.println("No TSL2561 found"); while (1); }
tsl.enableAutoRange(true);
tsl.setIntegrationTime(TSL2561_INTEGRATIONTIME_101MS);
}
void loop() {
sensors_event_t e;
tsl.getEvent(&e);
if (e.light) { Serial.print(e.light); Serial.println(" lux"); }
else Serial.println("Saturated: too bright for this setting");
delay(1000);
}Setup and tuning
use 13.7 ms integration and ×1 gain outdoors.
402 ms and ×16 gain resolve down to fractions of a lux.
set different ADDR states for up to three on one bus.
What you need
Shop this list5 of 6 found in our store · ₹1,701
GY-2561 TSL2561 luminosity module: the sensor this guide coversGY-2561 TSL2561 Luminosity Sensor Module – I2C Interface₹499Closest match, check the specs
Elecrow CROWTAIL Digital Light Sensor 1.0 Module – TSL2561 I2C Interface: another version this guide coversELECROW CROWTAIL Digital Light Sensor 1.0₹625- Uno R3 development board: the controller used in the wiring tableFind this part
ESP32-WROOM-32 38-pin development board: for Wi-Fi logging and dashboardsESP32-WROOM-32 38-Pin Development Board₹389
0.96 inch OLED display 128x64: to show readings without a computer0.96" OLED Display 128x64₹139Closest match, check the specs
Dupont jumper wires: for the connectionsDupont Jumper Wires (40 pcs)₹49Closest match, check the specs
Alternatives and when to choose them
- VEML7700: wider range up to 120,000 lux.
- BH1750: simpler, low cost, lux directly.
- Ambient light sensors compared.
Try it: I2c pullup calculator
Change the values and the diagram and results update as you type.
Common mistakes to avoid
- Using long integration and high gain in sunlight, which saturates it.
- Two sensors with the same ADDR setting on one bus.
- Reading lux straight from the broadband channel without the IR correction.
- Mounting it where IR from a heater or remote affects it.
Frequently asked questions
What is the TSL2561's I2C address?
0x39 with ADDR open, 0x29 with ADDR to GND and 0x49 with ADDR to VCC.
What is the maximum lux?
About 40,000 lux; direct sunlight can exceed it.
Why does it read 0 in bright light?
The sensor is saturated; shorten the integration time or lower the gain.
Does it work with 3.3 V boards?
Yes, it is a 3.3 V part.
TSL2561 or TSL2591?
The TSL2591 has more range and resolution; the TSL2561 is cheaper and well documented.
Parts for this guide
Calculators
Terms in this guide
Keep learning
Sources
Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.


