2021-05-30 08:16:15 -04:00
|
|
|
|
|
|
|
|
[](https://github.com/marketplace/actions/arduino_ci)
|
2021-12-29 07:37:09 -05:00
|
|
|
[](https://github.com/RobTillaart/TSL235R/actions/workflows/arduino-lint.yml)
|
|
|
|
|
[](https://github.com/RobTillaart/TSL235R/actions/workflows/jsoncheck.yml)
|
2021-05-30 08:16:15 -04:00
|
|
|
[](https://github.com/RobTillaart/TSL235R/blob/master/LICENSE)
|
|
|
|
|
[](https://github.com/RobTillaart/TSL235R/releases)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# TSL235R
|
|
|
|
|
|
|
|
|
|
Arduino library for the TSL235R light to frequency convertor.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Description
|
|
|
|
|
|
|
|
|
|
This library does not measure the frequency but has some functions to compensate e.g.
|
|
|
|
|
for wavelength and voltage used.
|
|
|
|
|
|
|
|
|
|
The library is not tested extensively yet.
|
|
|
|
|
|
|
|
|
|
The sensor operating voltage is between 2.7 and 5.5 max.
|
|
|
|
|
|
|
|
|
|
For measurements below 1uW/cm2 one bests measures for multiple seconds
|
|
|
|
|
Above 1 uW/cm2 1 second or shorter is OK.
|
|
|
|
|
|
|
|
|
|
Note that for longer and shorter measurements than 1 second one must convert the
|
2021-12-29 07:37:09 -05:00
|
|
|
value to Hz, which is the number of pulses in 1 second.
|
2021-05-30 08:16:15 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## Connection
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
// PIN 1 - GND
|
|
|
|
|
// PIN 2 - VDD 2.7 V .. 5.5 V
|
|
|
|
|
// PIN 3 - SIGNAL 1 Hz .. 800 KHz
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Interface
|
|
|
|
|
|
|
|
|
|
- **TSL235R(float voltage = 5.0)** constructor, optionally one can give the operational voltage
|
|
|
|
|
to add a small correction (< 1.5%)
|
|
|
|
|
- **float irradiance(uint32_t Hz)** returns the irradiance in uW/cm2.
|
2021-06-04 09:58:39 -04:00
|
|
|
Note that Hz implies the measured pulses for 1 second.
|
2021-05-30 08:16:15 -04:00
|
|
|
- **float irradiance(uint32_t pulses, uint32_t milliseconds)** returns the irradiance in uW/cm2
|
|
|
|
|
This formula is used for other duration than 1 second.
|
|
|
|
|
To get irradiance in W/m2 one must divide by 100.
|
2021-06-04 09:58:39 -04:00
|
|
|
- **float irradiance_HS(uint32_t pulses, uint32_t microseconds)** returns the irradiance in uW/cm2
|
|
|
|
|
This formula is used when the time is measured in microseconds. This is the most accurate measurement.
|
2021-05-30 08:16:15 -04:00
|
|
|
- **float getFactor()** returns the inner conversion factor from Hz to Watt/cm2.
|
2021-12-29 07:37:09 -05:00
|
|
|
- **void setWavelength(uint16_t wavelength = 635)** sets the wavelength so the formulas can use a
|
|
|
|
|
correction factor. At the default wavelength of 635 nm the wavelength correction factor == 1.0
|
2021-05-30 08:16:15 -04:00
|
|
|
- **uint16_t getWavelength()** returns the set wavelength. Convenience function.
|
|
|
|
|
- **float getWaveLengthFactor()** returns the wavelength correction factor.
|
|
|
|
|
As the sensor is most sensitive around 750 nm this value helps to normalize the signal.
|
2021-12-29 07:37:09 -05:00
|
|
|
This works only for (almost) monochromatic light.
|
2021-05-30 08:16:15 -04:00
|
|
|
- **void setVoltage(float voltage)** sets the voltage so the formulas can use a correction factor.
|
|
|
|
|
This voltage correction factor is rather small < 1.5%
|
|
|
|
|
- **float getVoltage()** returns the set voltage. Convenience function.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Operations
|
|
|
|
|
|
|
|
|
|
See examples for typical usage.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Future
|
|
|
|
|
|
2021-12-29 07:37:09 -05:00
|
|
|
- improve documentation
|
|
|
|
|
- test test test
|
|
|
|
|
- investigate hardware solutions for e.g. divide by 100 or so
|
2021-05-30 08:16:15 -04:00
|
|
|
- investigate correction factor for white light and mixed light sources.
|
2021-12-29 07:37:09 -05:00
|
|
|
- investigate calibration factor for timing of processor used.
|
2021-06-04 09:58:39 -04:00
|
|
|
-
|
