From 600d7fd21a6ce56d99b9749695667f1f35ab4de5 Mon Sep 17 00:00:00 2001 From: Tom Igoe Date: Sun, 20 Jun 2021 20:19:40 -0400 Subject: [PATCH] Update readme.md --- LightSensors/readme.md | 62 ++++++++++++++++++++++-------------------- 1 file changed, 32 insertions(+), 30 deletions(-) diff --git a/LightSensors/readme.md b/LightSensors/readme.md index 9386509..768cc2b 100644 --- a/LightSensors/readme.md +++ b/LightSensors/readme.md @@ -1,28 +1,26 @@ # Light Sensors +This page covers a variety of light sensors, most of which are either single-channel or three- or four-channel sensors (RGB or RGBC). There are also a few specialty sensors, like the MAX30105 sensor which can be used for pulse oximetry or the APDS-9960 sensor which can measure RGB as well as sensing gesture and proximity. There is a separate page for [multi-channel spectral sensors](spectral-sensors). + +## Luminosity Sensors +TSL2591 - Light levels, visible & IR +* [Adafruit breakout board](https://www.adafruit.com/product/1980) +* [Adafruit library](https://github.com/adafruit/Adafruit_TSL2591_Library) +* [Datasheet](https://github.com/adafruit/Adafruit_TSL2591_Library) + + +## RGB Sensors ISL29125 - RGB with IR blocking filter * [Sparkfun breakout board](https://www.sparkfun.com/products/12829) * [Sparkfun library](https://github.com/sparkfun/SparkFun_ISL29125_Breakout_Arduino_Library) * [Datasheet](https://www.renesas.com/us/en/www/doc/datasheet/isl29125.pdf) +## RGBC Sensors TCS34725 - 4-channel, red, green, blue, clear * [Adafruit breakout board](https://www.adafruit.com/product/1334) * [Adafruit library](https://github.com/adafruit/Adafruit_TCS34725) * [Datasheet](https://ams.com/documents/20143/36005/TCS3472_DS000390_2-00.pdf/6e452176-2407-faaf-a590-d526c78c7432) -TSL2591 - Light levels, visible & IR -* [Adafruit breakout board](https://www.adafruit.com/product/1980) -* [Adafruit library](https://github.com/adafruit/Adafruit_TSL2591_Library) -* [Datasheet](https://github.com/adafruit/Adafruit_TSL2591_Library) - -GA1AS202L - ambient light -* [Adafruit breakout board](https://www.adafruit.com/product/1384) -* [Datasheet](https://www.digchip.com/datasheets/download_datasheet.php?id=3860632&part-number=GA1A1S202WP) - -APDS9301 - ambient light sensor -* [Sparkfun breakout board](https://www.sparkfun.com/products/retired/14350) part is retired -* [Sparkfun library](https://www.sparkfun.com/products/retired/14350) part is retired -[Datasheet](https://cdn.sparkfun.com/assets/3/2/c/0/8/AV02-2315EN0.pdf) APDS9960 - RGB and gesture * [Sparkfun breakout board](https://www.sparkfun.com/products/12787) @@ -33,38 +31,42 @@ APDS9960 - RGB and gesture * [Arduino Library](https://www.arduino.cc/en/Reference/ArduinoAPDS9960) * [Datasheet](https://docs.broadcom.com/docs/AV02-4191EN) +## Specialty Sensors + MAX30105 - red, IR, green, for pulse oximetry and particle detection * [Sparkfun breakout board](https://www.sparkfun.com/products/14045) * [Sparkfun library](https://github.com/sparkfun/SparkFun_MAX3010x_Sensor_Library) * [Datasheet](https://datasheets.maximintegrated.com/en/ds/MAX30105.pdf) * Being replaced by [MAX30101](https://datasheets.maximintegrated.com/en/ds/MAX30101.pdf) -AS7262 - 6 channel: red, orange, yellow, green, blue, and violet. - -AS7263 - 6-channel with Near infrared -* [Adafruit breakout board (AS7262)](https://www.adafruit.com/product/3779) -* [Sparkfun breakout board (AS7262)](https://www.sparkfun.com/products/14347) -* [Sparkfun breakout board (AS7263)](https://www.sparkfun.com/products/14351) -* [Adafruit library](https://github.com/adafruit/Adafruit_AS726x) -* Sparkfun breakout board -* [Sparkfun library](https://github.com/sparkfun/Qwiic_Spectral_Sensor_AS726X) -* [Sparkfun hookup guide](https://learn.sparkfun.com/tutorials/as726x-nirvi) -* [Datasheet AS7262](https://ams.com/documents/20143/36005/AS7262_DS000486_2-00.pdf/0031f605-5629-e030-73b2-f365fd36a43b) -* [Datasheet AS7263](https://ams.com/documents/20143/36005/AS7263_DS000476_1-00.pdf/4bd22964-7fe0-2053-3e97-906f0836182f) +## Discontinued Sensors +GA1AS202L - ambient light +* [Adafruit breakout board](https://www.adafruit.com/product/1384) +* [Datasheet](https://www.digchip.com/datasheets/download_datasheet.php?id=3860632&part-number=GA1A1S202WP) -AS7341 - 11-channel with NIR and clear -* [AMS library](https://ams.com/documents/20143/36005/AS7341_SW000273_3-00.zip/f0248ade-918b-a9ba-d403-dc2115bee266) in Documents/application notes/I2C interface with Arduino -* [Datasheet](https://media.digikey.com/pdf/Data%20Sheets/Austriamicrosystems%20PDFs/AS7341_DS.pdf) -* [More info](https://ams.com/as7341-11-channel-spectral-sensor-eval-kit#tab/tools) +APDS9301 - ambient light sensor +* [Sparkfun breakout board](https://www.sparkfun.com/products/retired/14350) part is retired +* [Sparkfun library](https://www.sparkfun.com/products/retired/14350) part is retired +[Datasheet](https://cdn.sparkfun.com/assets/3/2/c/0/8/AV02-2315EN0.pdf) -## Publications +## Background Reading * Rune Madsen's [Programming Design Systems](https://programmingdesignsystems.com/) book is a great intro to visual design and programming and his chapters on color are a helpful intro to color theory for understanding sensors and LED color mixing: * [A Short History of Color Theory](https://programmingdesignsystems.com/color/a-short-history-of-color-theory/index.html#a-short-history-of-color-theory-xZzRFOZ) * [Color Models and Color Spaces](https://programmingdesignsystems.com/color/color-models-and-color-spaces/index.html#color-models-and-color-spaces-JDQ1fRD) * A pretty good [introduction to colorimetry](https://medium.com/hipster-color-science/a-beginners-guide-to-colorimetry-401f1830b65a) +* A quick introduction to [Melanopic Equivalent Daylight Illuminace (EDI)](https://biosinstitute.org/melanopic-equivalent-daylight-illuminance/) +* [CIE Position Statement on Non-Visual Effects of Light](http://cie.co.at/files/CIE%20Position%20Statement%20-%20Proper%20Light%20at%20the%20Proper%20Time%20(2019)_0.pdf) +* [User Guide to the α-opic Toolbox +for implementing CIE S 026](http://files.cie.co.at/CIE%20S%20026%20alpha-opic%20Toolbox%20User%20Guide.pdf) +* [Userguide to the Equivalent Daylight (D65) +Illuminance Toolbox](https://www.nsvv.nl/wp-content/uploads/2019/03/CIE-S-026-EDI-Toolbox-Userguide-vE1.05x.pdf) +* White paper from AMS: [Chip-scale spectral sensing: +understanding the new uses +for ultra-precise light-source +measurement ](https://ams.com/documents/20143/215005/ams_WhitePaper_Chip-scale_spectral_sensing_022021.pdf) * AMS Application Note: [DN40-Rev 1.0 – Lux and CCT Calculations using ams Color Sensors](https://ams.com/documents/20143/80162/ColorSensors_AN000166_1-00.pdf/c0b4a4b4-9948-f2a7-f8a1-36a8208bd0a9) * [Accurate method for computing correlated color temperature](https://www.osapublishing.org/DirectPDFAccess/271508BC-9A43-6E9C-75B4043231D56AE2_344803/oe-24-13-14066.pdf?da=1&id=344803&seq=0&mobile=no) * [Correlated Color Temperature Determination for LED Modules Using a Digital Color Sensor](https://www.scientificbulletin.upb.ro/rev_docs_arhiva/full3fa_651029.pdf)