1142 User Guide: Difference between revisions
No edit summary |
|||
| (10 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
__NOINDEX__ | |||
<metadesc>The Phidget Light Sensor measures light intensities of up to 1000 lux and connects to an Analog Input or VINT Hub port.</metadesc> | |||
[[Category:UserGuide]] | [[Category:UserGuide]] | ||
==Getting Started== | ==Getting Started== | ||
{{UgSensorIntro|1142|Light Sensor 1000 lux|Voltage Input port}} | |||
Next, you will need to connect the pieces: | |||
[[Image:1142_0_Connecting_The_Hardware.jpg|400px|right|link=]] | |||
#Connect the | # Connect the 1142 to the HUB0000 with the Phidget cable. | ||
#Connect the | # Connect the HUB0000 to your computer with the USB cable. | ||
= | <br clear="all"> | ||
{{UGIntroDone|1142}} | |||
{{ | ==Using the 1142== | ||
{{UGcontrolpanelSensor|1142|HUB0000}} | |||
{{UGSensorVoltageInput|1142|illuminance (lux)}} | |||
{{ | |||
==Technical Details== | ==Technical Details== | ||
The human eye is less sensitive to changes in light intensity than the 1142, but is able to see a wider range. | ===General=== | ||
The human eye is less sensitive to changes in light intensity than the 1142, but is able to see a wider range. The Human eye range is from 50 µlx (starlight) to 100 klx (extremely bright sunny day). The 1142, on the other hand, is able to measure from 1 lx (Moonlight) to 1000 lx (TV studio lighting). If you notice noise on the signal that you cannot perceive yourself, it could be due to incandescent light flicker, or other varying light sources. | |||
The 1142 is | The 1142 is non-ratiometric which means that you cannot rely on the sensor saturating at 5 volts. To be conservative, interpret a sensor voltage greater than 4.75V as saturated, with the true light level being unknown. | ||
===Sensitivity Response=== | ===Sensitivity Response=== | ||
The 1142 uses the APDS-9002 light sensor package. The following graph illustrates the sensor's sensitivity to specific wavelengths of light: | |||
[[File:APDS9002.jpg|link=|center|600px]] | |||
[[File:APDS9002.jpg|link=| | |||
===Formulas=== | ===Formulas=== | ||
The formula to translate | {{UGSensorFormula|illuminance (lux)}} The formula to translate voltage into illuminance is: | ||
:<math> | :<math> | ||
\text{ | \text{Illuminance (lux)} = m \times (\text{Voltage} \times 200) + b \! | ||
</math> | </math> | ||
Where 'm' and 'b' are calibration values found on the label on the underside of the 1142. If for some reason you can't use the calibration values that come with the sensor, you can use the generalized values of ''' m = 1.478777''' and '''b = 33.67076''' to get a rough approximation. | Where 'm' and 'b' are calibration values found on the label on the underside of the 1142. If for some reason you can't use the calibration values that come with the sensor, you can use the generalized values of ''' m = 1.478777''' and '''b = 33.67076''' to get a rough approximation. | ||
{{UGasens}} | {{UGasens}} | ||
{{UGnext|}} | |||
{{ | |||
Latest revision as of 20:38, 8 May 2018
Getting Started
Welcome to the 1142 user guide! In order to get started, make sure you have the following hardware on hand:
- 1142 - Light Sensor 1000 lux
- Any Phidget with a Voltage Input port, here are some compatible products. We will be using the VINT Hub for this guide.
- USB cable and computer
- Phidget cable
Next, you will need to connect the pieces:
- Connect the 1142 to the HUB0000 with the Phidget cable.
- Connect the HUB0000 to your computer with the USB cable.
Now that you have everything together, let's start using the 1142!
Using the 1142
Phidget Control Panel
In order to demonstrate the functionality of the 1142, we will connect it to the HUB0000, and then run an example using the Phidget Control Panel on a Windows machine.
The Phidget Control Panel is available for use on both macOS and Windows machines. If you would like to follow along, first take a look at the getting started guide for your operating system:
Linux users can follow the getting started with Linux guide and continue reading here for more information about the 1142.
First Look
After plugging in the 1142 into the HUB0000, and the HUB0000 into your computer, open the Phidget Control Panel. You will see something like this:
The Phidget Control Panel will list all connected Phidgets and associated objects, as well as the following information:
- Serial number: allows you to differentiate between similar Phidgets.
- Channel: allows you to differentiate between similar objects on a Phidget.
- Version number: corresponds to the firmware version your Phidget is running. If your Phidget is listed in red, your firmware is out of date. Update the firmware by double-clicking the entry.
The Phidget Control Panel can also be used to test your device. Double-clicking on an object will open an example.
Voltage Input
Double-click on a Voltage Input object in order to run the example:
General information about the selected object will be displayed at the top of the window. You can also experiment with the following functionality:
- Modify the change trigger and/or data interval value by dragging the sliders. For more information on these settings, see the data interval/change trigger page.
- Select the 1142 from the Sensor Type drop-down menu. The example will now convert the voltage into illuminance (lux) automatically. Converting the voltage to illuminance (lux) is not specific to this example, it is handled by the Phidget libraries, with functions you have access to when you begin developing!
Technical Details
General
The human eye is less sensitive to changes in light intensity than the 1142, but is able to see a wider range. The Human eye range is from 50 µlx (starlight) to 100 klx (extremely bright sunny day). The 1142, on the other hand, is able to measure from 1 lx (Moonlight) to 1000 lx (TV studio lighting). If you notice noise on the signal that you cannot perceive yourself, it could be due to incandescent light flicker, or other varying light sources.
The 1142 is non-ratiometric which means that you cannot rely on the sensor saturating at 5 volts. To be conservative, interpret a sensor voltage greater than 4.75V as saturated, with the true light level being unknown.
Sensitivity Response
The 1142 uses the APDS-9002 light sensor package. The following graph illustrates the sensor's sensitivity to specific wavelengths of light:
Formulas
The Phidget libraries can automatically convert sensor voltage into illuminance (lux) by selecting the appropriate SensorType. See the Phidget22 API for more details. The formula to translate voltage into illuminance is:
Where 'm' and 'b' are calibration values found on the label on the underside of the 1142. If for some reason you can't use the calibration values that come with the sensor, you can use the generalized values of m = 1.478777 and b = 33.67076 to get a rough approximation.
Phidget Cable
The Phidget Cable is a 3-pin, 0.100 inch pitch locking connector. Pictured here is a plug with the connections labelled. The connectors are commonly available - refer to the Analog Input Primer for manufacturer part numbers.
What to do Next
- Programming Languages - Find your preferred programming language here and learn how to write your own code with Phidgets!
- Phidget Programming Basics - Once you have set up Phidgets to work with your programming environment, we recommend you read our page on to learn the fundamentals of programming with Phidgets.
