Zum Inhalt springen

WSAL17146 – TSL25911 Light Sensor/en

Aus JW Tech Wiki
Version vom 6. September 2026, 00:35 Uhr von JWTechPublisher (Diskussion | Beiträge) (Freigegebene technische Dokumentation veröffentlicht; Text-only und noindex)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

Documentation notice: This technical documentation was independently rewritten from an archived supplier source. Check technical details and commands against the product version and manufacturer documentation before use.

Summary

The TSL25911 is a digital ambient light sensor with an I2C interface. It measures ambient light intensity and outputs the value via I2C.

Related products at JW Tech

Technical overview

  • Core chip: TSL25911FN, combines a wideband photodiode pair (visible + infrared) on a single CMOS IC.
  • Two integrated ADCs convert photodiode current into digital values; illuminance in lux is derived using an empirical formula.
  • I2C device address: 0x29 (7-bit); shifted, the 8-bit equivalent is 0x52.
  • Operating voltage: 3.3 V or 5 V, thanks to an onboard voltage translator.
  • Sensitivity up to 188 µLux, dynamic range up to 600 M:1.
  • Infrared-noise environments can be measured precisely thanks to the infrared-responding photodiode.
  • The INT pin provides a programmable interrupt output with upper and lower thresholds.
  • Dimensions: 27 mm × 20 mm, mounting hole 2.0 mm.

Commands and examples – verify before use: 

sudo raspi-config
sudo reboot
wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.60.tar.gz
tar zxvf bcm2835-1.60.tar.gz
cd bcm2835-1.60/
sudo ./configure
sudo make
sudo make check
sudo make install
sudo apt-get install wiringpi
cd /tmp
wget https://project-downloads.drogon.net/wiringpi-latest.deb
sudo dpkg -i wiringpi-latest.deb
gpio -v
sudo apt-get install p7zip-full
wget https://files.waveshare.com/upload/b/bc/TSL2591X_Light_Sensor_code.7z
7z x TSL2591X_Light_Sensor_code.7z -r -o./TSL2591X_Light_Sensor_code
sudo chmod 777 -R TSL2591X_Light_Sensor_code
sudo git clone https://github.com/waveshare/TSL2591X-Light-Sensor
cd TSL2591X_Light_Sensor_code/TSL2591x_Light_Sensor_code/RaspberryPi/c

Notes and version constraints

  • The exact register addresses and the precise empirical formula for lux calculation are not provided in the text; they must be taken from the TSL25911 datasheet.
  • The example projects reference external downloads (WiringPi, BCM2835, GitHub). The availability of these resources may change over time.
  • If GPIO malfunctions occur after using BCM2835/Python, restart the Raspberry Pi, as direct register access can cause conflicts.
  • Serial output for STM32 requires the correct COM port selection and a baud rate of 115200; otherwise data will be missing or garbled.
  • If the output is zero or initialization fails, the pin wiring must be checked.

Source and revision record