Same-day dispatch before 2 PM · Free delivery over ₹999 · GST invoices Get the appPrices incl. GST
Geekobot
Snap & SendNEWGeeko AIWhere's myOrder
Log in
Products
  • Projects
    • Component guidesHow parts work, with code you can run
    • Learning pathsFrom your first LED to your first robot
    • Workshops & eventsOnline sessions for makers and classes
    • ElectrolarkFree guided builds, simulator and certificates
    • Students & teachersStudent discount and classroom help
    • CommunityShare builds and ask other makers
    • CalculatorsOhm's law, LED resistor, 555 and 100+ more
    • Circuit builderWire parts and run the circuit, powered by Electrolark
    • Geeko AIAsk what to buy or how to wire it
    • Snap & SendPhotograph a part or list, we find it
    • Part finderAnswer a few questions, get the right part
    • Compatibility checkWill these two parts work together?
    • Compare partsSpecs side by side
    • Business & bulk ordersGST invoices, credit and volume prices
    • Request a quotationSend your list, get a quote
    • Classroom kitsPer-student kits and lab bundles
    • Gift cardsFor students, teams and events
  • Atal Tinkering Lab
BOM to cart
Geekobot

Components, kits and know-how for makers, students, engineers, labs and businesses across India.

Ask Geeko AIOrders, parts and projects, any timeEmail supportReply within 1 working dayGet the Geekobot appAdd it to your home screen, free

Follow us

Shop

  • Boards & SBCs
  • Sensors & Modules
  • IoT & Wireless
  • Drone & FPV
  • 3D Printing
  • Filaments & Resins
  • Motors & Drivers
  • Power & Batteries
  • Semiconductors
  • Passive
  • Displays & LEDs
  • Switches & Relays
  • Wires & Cables
  • Prototyping
  • Tools & Test
  • Robotics
  • STEM Kits
  • Atal Tinkering Lab
  • Mechanical Parts
  • Audio

Orders

  • Track your order
  • Help & support
  • Shipping and delivery
  • Refunds and cancellation
  • Contact us

Learn

  • Projects
  • Geeko AI project assistant
  • Learning paths
  • Guides
  • Calculators
  • Electrolark: free guided builds

Part tools

  • Part finder
  • Compare parts
  • Will it work with my board?

Institutions

  • Classroom kits
  • Atal Tinkering Lab
  • Students & teachers
  • Workshops & Events

Business

  • Business & education
  • Request a quotation
  • BOM bulk upload
  • Quick order by SKU

Company

  • About Geekobot
  • Community
  • Gift cards
  • Terms & conditions
  • Privacy policy
  • Product directory
  • Sitemap

© 2026 Geekobot, a trade name of OLatus Systems Private Limited. All rights reserved.

20, 1st Floor, Neeladri Complex, 10th Cross, Sampige Rd, 2nd Main, Malleshwaram, Bengaluru, Karnataka 560003 · GSTIN 29AACCO0462F1ZM

+91 91810 15607 · connect@geekobot.in · Monday to Saturday, 10 AM to 2 PM IST

UPI · CARDS · NETBANKING · GST INVOICES

ShopProjectsGeeko AIGuides
Compare 0 parts →
Log in

Shop by category

Shop all components
  • Boards & SBCs1,910 products
    • Alternative Single Board Computers
    • Arduino Ecosystem
    • FPGA & Logic Boards
    • Microcontroller & Wireless Boards
    View all
  • Sensors & Modules4,701 products
    • Biomedical & Heart Rate
    • Current, Voltage & Power
    • Force, Weight & Pressure
    • Gas, Weather & Environmental
    View all
  • IoT & Wireless2,314 products
    • RF Modules
    • RFID & NFC
    • Antennas & RF Accessories
    • Cameras & Smart Vision
    View all
  • Drone & FPV3,558 products
    • Flight Control & Navigation
    • FPV Video & Optics
    • Frames & Structural Parts
    • Motors & Propulsion
    View all
  • 3D Printing2,204 products
    • 3D Printers
    • 3D Scanners & Digitizers
    • Laser Engravers & Cutters
    • Material Management & Upgrades
    View all
  • Filaments & Resins1,472 products
    • Filaments
    • Photopolymer Resins
    View all
  • Motors & Drivers463 products
    • BLDC Motor Drivers
    • DC & Geared Motors
    • DC Motor Drivers
    • Linear Actuators & Solenoids
    View all
  • Power & Batteries557 products
    • Battery Holders & Connectors
    • Breadboard Power
    • Chargers & BMS
    • DC-DC Converters
    View all
  • Semiconductors295 products
    • Diodes & Rectifiers
    • Interface & RF Encoder ICs
    • Logic ICs (74xx)
    • Logic ICs (CD4000)
    View all
  • Passive67 products
    • Capacitors
    • Circuit Protection
    • Crystals & Oscillators
    • Inductors
    View all
  • Displays & LEDs572 products
    • 7-Segment & Dot Matrix
    • Addressable LEDs
    • Character LCDs
    • Graphic LCDs
    View all
  • Switches & Relays184 products
    • Keypads & Touch
    • Push Buttons & Tactile
    • Relay Modules
    • Relays
    View all
  • Wires & Cables233 products
    • Board-to-Wire Connectors
    • Crimp & Splice
    • Headers & Dupont
    • Heat Shrink & Sleeving
    View all
  • Prototyping101 products
    • Breadboards
    • Interface Modules
    • PCBs & Perfboards
    View all
  • Tools & Test717 products
    • Bench Power Supplies
    • Hand Tools
    • Measuring Tools
    • Meters & Testers
    View all
  • Robotics180 products
    • Humanoid & Legged Robots
    • Robot Chassis & Platforms
    • Robotic Arms & Grippers
    • Wheels & Casters
    View all
  • STEM Kits268 products
    • Arduino Learning Kits
    • Coding & IoT Kits
    • Early Coding (Ages 3-8)
    • Invention Kits
    View all
  • Atal Tinkering Lab196 products
    • Package 1: Electronics, Robotics, IoT and Sensors
    • Package 2: Rapid Prototyping Tools
    • Package 3: Mechanical, Electrical and Measurement Tools
    • Package 4: Power Supply, Accessories and Safety Equipment
    View all
  • Mechanical Parts212 products
    • Bearings
    • Brackets & Mounts
    • Couplers
    • Fasteners & Standoffs
    View all
  • Audio109 products
    • Amplifier Modules
    • Buzzers & Sirens
    • Speakers
    View all
  1. Home
  2. ›Guides
  3. ›Sensors
  4. ›TSL2561 Luminosity Sensor

Component guide · Beginner · 3 min read

TSL2561 Luminosity Sensor

Pinout, Wiring and Code

By Geekobot Learning Team · Updated 29 Oct 2026

I'm using
Wiring, code and the Run it panels follow your board.
On this page
Short answerWhat the TSL2561 isTSL2561 pinoutWiring the TSL2561Example codeSetup and tuningWhat you needAlternatives and when to choose themTry itCommon mistakesFAQsParts and next steps
Short answer

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.

  • Option 1GY-2561 TSL2561 Luminosity Sensor Module – I2C Interface₹499
  • Option 2Elecrow CROWTAIL Digital Light Sensor 1.0 Module – TSL2561 I2C Interface₹629
01

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.

02

TSL2561 pinout

The pins on the TSL2561 and what each one does.

PinFunction
VCC / VINSupply, 3.3 V (5 V on modules with a regulator)
GNDGround
SDAI2C data
SCLI2C clock
ADDRAddress: open 0x39, GND 0x29, VCC 0x49
INTInterrupt output
PinFunction
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
03

Wiring the TSL2561

The GY-2561 has a regulator and works from 3.3 or 5 V. Leave ADDR open for 0x39.

TSL2561 pinArduino UnoESP32
VCC5V (or 3.3V)3V3
GNDGNDGND
SDAA4GPIO 21
SCLA5GPIO 22
ADDROpen (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)
04

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.

Read lux (Adafruit TSL2561 library) · Arduino C++Verify & upload in Electrolark
#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);
}
05

Setup and tuning

Bright light

use 13.7 ms integration and ×1 gain outdoors.

Dim light

402 ms and ×16 gain resolve down to fractions of a lux.

Several sensors

set different ADDR states for up to three on one bus.

06

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
07

Alternatives and when to choose them

  • ✓VEML7700: wider range up to 120,000 lux.
  • ✓BH1750: simpler, low cost, lux directly.
  • ✓Ambient light sensors compared.
08

Try it: I2c pullup calculator

Change the values and the diagram and results update as you type.

09

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.
10

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

  • GY-2561 TSL2561 Luminosity Sensor Module – I2C Interface
    ₹499View
  • Elecrow CROWTAIL Digital Light Sensor 1.0 Module – TSL2561 I2C Interface
    ₹629View
  • Uno R3 Development Board (No Cable)
    ₹359View
  • ESP32-WROOM-32 38-Pin Development Board
    ₹389View
  • 0.96" OLED Display 128x64
    ₹139View
  • Dupont Jumper Wires (40 pcs)
    ₹49View
Shop Ambient Light, Lux & UV Sensors

Calculators

I2c pullup calculator

Terms in this guide

I2CInter-Integrated Circuit: a two-wire bus (SDA and SCL) that connects many devices by address.

Keep learning

ComparisonBeginnerAmbient Light SensorsAmbient light sensors such as the BH1750, TSL2591, VEML7700 and OPT3001 measure brightness in lux over I2C, so they give accurate readings that do not depend on how you wire a resistor.3 min read · SensorsComponent guideBeginnerVEML7700 Lux SensorThe VEML7700 from Vishay is a 16-bit ambient light sensor that reports lux over I2C at address 0x10.3 min read · SensorsComponent guideBeginnerBH1750 light sensorThe BH1750 is a digital ambient light sensor that reports brightness directly in lux over I2C, from 1 to 65,535 lux.3 min read · SensorsConcept explainerIntermediateI2C ExplainedI2C is a two-wire bus that lets one microcontroller talk to many sensors and displays using a data line (SDA) and a clock line (SCL).4 min read · Electronics Fundamentals

Sources

  • TSL2560/TSL2561 light-to-digital converter datasheet (TAOS / ams)
  • Adafruit TSL2561 library

Written by the Geekobot team from manufacturer datasheets. Always check the datasheet for the exact part and variant you buy.

On this page
Short answerWhat the TSL2561 isTSL2561 pinoutWiring the TSL2561Example codeSetup and tuningWhat you needAlternatives and when to choose themTry itCommon mistakesFAQsParts and next steps
Need a hand?Ask Geeko AI which part fits your project, or talk to the Geekobot team.Ask Geeko AIHelp & support

Parts for this guide (Arduino Uno)3 items · ₹1,328

GY-2561 TSL2561 Luminosity Sensor Module – I2C Interface · ELECROW CROWTAIL Digital Light Sensor 1.0 · Uno R3 CH340G ATmega328p Compatible Development Board

Run itChange the inputs and watch the output

Auto range picks the gain. Direct sun can still saturate it.

Serial monitor115200 baud
319.62 lux

A simulation of the sketch above, so you know what to expect. Real readings vary with your parts and wiring.

Ask the Community

Ask a question