TSL2572EVM

REV 1.0 TSL2572 EVM USER’S GUIDE TSL2572 LIGHT-TO-DIGITAL AMBIENT LIGHT SENSOR EVALUATION SYSTEM October 2012 ESTABLISHING BASIC FUNCTIONALITY ................................... 3 TSL2572 EVM GRAPHICAL USER INTERFACE (GUI) ............ 4 SOFTWARE OVERVIEW ................................................. 4 INPUT SIDE, “FUNCTIONAL” TAB ................................ 6 INPUT SIDE, “REGISTER” TAB ..................................... 7 OUTPUT SIDE, “REGISTER” TAB ............................... 10 OUTPUT SIDE, “FUNCTIONAL” TAB .......................... 10 OUTPUT SIDE, “PLOT” TAB ....................................... 11 “LUXEQ” AND “LUXEQPLOT” TABS .......................... 12 RESOURCES ............................................................................. 12 ams PROVIDES CUSTOMER SUPPORT IN VARIED TECHNICAL AREAS. SINCE ams DOES NOT POSSESS FULL ACCESS TO DATA CONCERNING ALL OF THE USES AND APPLICATIONS OF CUSTOMERS’ PRODUCTS, ams ASSUMES NO RESPONSIBILITY FOR CUSTOMER PRODUCT DESIGN OR THE USE OR APPLICATION OF CUSTOMERS’ PRODUCTS OR FOR ANY INFRINGEMENTS OF PATENTS OR RIGHTS OF OTHERS WHICH MAY RESULT FROM ams’ ASSISTANCE. www.ams.com 1 OF 12 Ambient Light Sensor INITIAL HARDWARE SETUP The software should be installed prior to connecting any hardware to the computer. Follow the instructions found in the Quick Start Guide (QSG). This will load the required driver for the USB interface and also the control software and graphical user interface (GUI). The hardware consists of the Controller EVM v2.1 motherboard, the TSL2572 evaluation daughterboard and a USB interface cable. When the USB cable is connected the green LED should light up indicating that power is being received via the USB interface, and the motherboard processor is running. If the green LED does not light up, check the USB cable connections; unplug the USB cable and try again. If the green LED still does not light, check the PC for USB error messages. See the Resources section at the end of this document for additional assistance. ams PROVIDES CUSTOMER SUPPORT IN VARIED TECHNICAL AREAS. SINCE ams DOES NOT POSSESS FULL ACCESS TO DATA CONCERNING ALL OF THE USES AND APPLICATIONS OF CUSTOMERS’ PRODUCTS, ams ASSUMES NO RESPONSIBILITY FOR CUSTOMER PRODUCT DESIGN OR THE USE OR APPLICATION OF CUSTOMERS’ PRODUCTS OR FOR ANY INFRINGEMENTS OF PATENTS OR RIGHTS OF OTHERS WHICH MAY RESULT FROM ams’ ASSISTANCE. www.ams.com 2 OF 12 Ambient Light Sensor ESTABLISHING BASIC FUNCTIONALITY The software should be started using the desktop icon or by double clicking the DigitalLightSensor.exe file from the installation directory. The default installation directory, depending on the device and the operating system you are using, is: C:\Program Files\ams\TSL2572_EVM C:\Program Files (x86)\ams\TSL2572_EVM Windows 32 bit operating systems Windows 64 bit operating systems A different install path may be selected by the user. When started, two windows will open on the PC. The top window, or Parent Window (PW), is not typically needed and may be placed out of the way. The bottom window, or Child Window (CW), is the main user interface and should be positioned on the screen for easy access. Clicking on the red “X” on the PW will close both windows and terminate the application. Clicking on the red “X” on the CW will close only the CW. The “Functional” tabs on both the left and right side of the main display (bottom window) will be selected by default. On the right side, numbers should be changing, showing that the ALS function is operational. By changing the ambient light source or waving your hand over the sensor at 172ms Integration Time < 172ms Saturation = 65,535 Saturation = ((Integration Time / 2.7) x 1024) – 1 WAIT TIME When the software initializes, a default wait period of 2.7mS is inserted between each ALS execution. This duration can be adjusted in 2.72mS steps from 0 to 696mS. A wait multiplier (WLONG=1) may also be used to multiply the wait period by 12x. Using these controls the duration of the wait may be adjusted from none (WEN=0) to 8.3 seconds (WEN=1, WLONG=1, WTIME=0x00). The Wait Time list box provides a quick mechanism for setting preselected wait periods from 2.72mS to 696mS. The wait period is completely disabled by setting WEN=0 (Enable Register (0x00, bit3)). ams PROVIDES CUSTOMER SUPPORT IN VARIED TECHNICAL AREAS. SINCE ams DOES NOT POSSESS FULL ACCESS TO DATA CONCERNING ALL OF THE USES AND APPLICATIONS OF CUSTOMERS’ PRODUCTS, ams ASSUMES NO RESPONSIBILITY FOR CUSTOMER PRODUCT DESIGN OR THE USE OR APPLICATION OF CUSTOMERS’ PRODUCTS OR FOR ANY INFRINGEMENTS OF PATENTS OR RIGHTS OF OTHERS WHICH MAY RESULT FROM ams’ ASSISTANCE. www.ams.com 6 OF 12 Ambient Light Sensor INPUT SIDE, “REGISTER” TAB “Control” Sub Tab The Register tab provides for direct control of the registers of the device. The Control sub-tab allows enabling and disabling functionality in the part and also controls the wait time multiplier (WLONG). Additionally, a list box provides options for turning ON all parts (All On) of the device or turning OFF all parts (All Off) of the device simultaneously. • • • • Enable Register (0x00) – Provides the ON/OFF control of the device. Check boxes are provided to allow selection of specific functions on the device: 1. PON – Power on. Activates internal oscillator. When =0 device is in standby. 2. AEN – ALS Enable. Writing a one (1) enables the ALS 3. WEN – Wait Enable. Writing a one (1) activates the wait timer. 4. AIEN – ALS Interrupt Enable. Writing a one (1) enables the ALS interrupt. 5. SAI – Stop After Interrupt. Stops processing at the end of any cycle which causes an interrupt. WTIME (0x03) – Wait time in 2.72ms increments, unless the WLONG bit is set, in which case the wait time is multiplied by 12. The number to the right is the computed WTIME. See the ATIME note in the ALS Sub Tab description. Config Register (0x0D) – Controls the wait time multiplication factor of x12. 1. WLONG – Wait Long. When checked (=1) enables the wait multiplier. ams PROVIDES CUSTOMER SUPPORT IN VARIED TECHNICAL AREAS. SINCE ams DOES NOT POSSESS FULL ACCESS TO DATA CONCERNING ALL OF THE USES AND APPLICATIONS OF CUSTOMERS’ PRODUCTS, ams ASSUMES NO RESPONSIBILITY FOR CUSTOMER PRODUCT DESIGN OR THE USE OR APPLICATION OF CUSTOMERS’ PRODUCTS OR FOR ANY INFRINGEMENTS OF PATENTS OR RIGHTS OF OTHERS WHICH MAY RESULT FROM ams’ ASSISTANCE. www.ams.com 7 OF 12 Ambient Light Sensor “ALS” Sub Tab The ALS tab shows the registers associated with ambient light sensing control. Register values in hex are shown on the left, preselected values are available in list boxes in the middle, and actual values are shown on the right. • ATIME Register (0x01) controls the ALS integration time. The actual time is: (256-ATIME) * 2.72 ms • Note: The column on the right is the computed value for ATIME and is always correct. Sometimes the value shown in the list box will be one of the preselected values but it has not been selected. If this happens the number will not be the same as the computed number for WTIME on the Control Sub-Tab. The computed value is the one that is correct. This can be fixed by selecting a preselected value from the list box or by cycling the register value UP/DOWN or DOWN/UP. This will set the list box value or clear the value from the list box so the screen is correct. Control Register (0x0F) – Controls the ALS gain settings. 1. AGAIN – Adjusts the ALS input gain. Valid values are 1x, 8x, 16x, and 120x. 2. AGL – ALS Gain Lowered. Reduces ALS gain by a factor of 6. This feature can only be used when AGAIN is set to 1x or 8x. It does not function for higher gain levels. “ALS Interrupt” Sub Tab This tab contains the settings for controlling the generation of ALS interrupts to a control processor. The AILT and AIHT values are 16 bit thresholds for the upper and lower trigger points. Each is set using two 8-bit registers. Another control (APERS) establishes the required persistence of the interrupt signal. Also on this screen is a button that will automatically generate the register values to provide threshold settings 25% higher and lower than the currently measured amount of ambient light. • • ALS Interrupt Low Threshold (0x04, 0x05) – Low light threshold for ALS interrupt. 1. AILTL (0x04) – The lower 8 bits of the 16 bit low threshold value. 2. AILTH (0x05) – The upper 8 bits of the 16 bit low threshold value. ALS Interrupt High Threshold (0x06, 0x07) – High light threshold for ALS interrupt. 1. AIHTL (0x06) – The lower 8 bits of the 16 bit high threshold value. ams PROVIDES CUSTOMER SUPPORT IN VARIED TECHNICAL AREAS. SINCE ams DOES NOT POSSESS FULL ACCESS TO DATA CONCERNING ALL OF THE USES AND APPLICATIONS OF CUSTOMERS’ PRODUCTS, ams ASSUMES NO RESPONSIBILITY FOR CUSTOMER PRODUCT DESIGN OR THE USE OR APPLICATION OF CUSTOMERS’ PRODUCTS OR FOR ANY INFRINGEMENTS OF PATENTS OR RIGHTS OF OTHERS WHICH MAY RESULT FROM ams’ ASSISTANCE. www.ams.com 8 OF 12 Ambient Light Sensor • 2. AIHTH (0x07) – The upper 8 bits of the 16 bit high threshold value. APERS (0x0C) – The APERS field (bits 3:0) controls the number of times the ALS interrupt threshold (AILT, AIHT) is exceeded before the interrupt is generated. Setting a zero means an interrupt is generated on every ALS reading. The meaning of the other settings is shown in this table. APERS Value Consecutive Out of Range ADC Values • 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Every 1 2 3 5 10 15 20 25 30 35 40 45 50 55 60 The +/-25% button takes the current ambient light reading and automatically computes new values for the AILT and AIHT registers, each with a 25% wider latitude. ams PROVIDES CUSTOMER SUPPORT IN VARIED TECHNICAL AREAS. SINCE ams DOES NOT POSSESS FULL ACCESS TO DATA CONCERNING ALL OF THE USES AND APPLICATIONS OF CUSTOMERS’ PRODUCTS, ams ASSUMES NO RESPONSIBILITY FOR CUSTOMER PRODUCT DESIGN OR THE USE OR APPLICATION OF CUSTOMERS’ PRODUCTS OR FOR ANY INFRINGEMENTS OF PATENTS OR RIGHTS OF OTHERS WHICH MAY RESULT FROM ams’ ASSISTANCE. www.ams.com 9 OF 12 Ambient Light Sensor OUTPUT SIDE, “REGISTER” TAB The value of internal registers is displayed on this tab. Register values cannot be set here. To set registers use the Register tab on the input side of the screen. A button is provided for clearing the ALS interrupt (AINT). The current interrupt status is also shown. The C0DATA and C1DATAvalues are the ADC values for the Ch 0 and Ch 1 photodiode. Each is read via two 8-bit registers. • • • • ID (0x12) – The ID register provides the value for the part number. Status (0x13) – Internal status. The Interrupts active and ALS valid bits are here. The contents of the register is decoded as follows: 1. “ALS OK” or “ALS Not OK” will be displayed based on the AVALID bit. 2. “AINT True” or “AINT False” is displayed to indicate whether the ALS interrupt bit is set. Clicking on this Clear button will clear the ALS interrupt. Note that if the proper conditions exist, the interrupt may be raised again immediately. C0DATA (0x14, 0x15): 1. C0DATA (0x14) – The lower 8 ADC bits of the Ch 0 photodiode. 2. C0DATAH (0x15) – The upper 8 ADC bits of the Ch 0 photodiode. 3. The full 16-bit value is displayed, in black, next to the C0DATA fields. C1DATA (0x16, 0x17): 1. C1DATA (0x16) – The lower 8 ADC bits of the Ch 1 photodiode. 2. C1DATAH (0x17) – The upper 8 ADC bits of the Ch 1 photodiode. 3. The full 16-bit value is displayed, in red, next to the C1DATA fields. OUTPUT SIDE, “FUNCTIONAL” TAB The Ch 0 and Ch 1 photodiodes output values are shown, and their ratio is calculated and shown. LUX is computed and displayed. When saturation approaches, “> 75% Saturated” will appear below the LUX values. There is a scaling factor in the box below LUX will scale the LUX value. This is useful for scaling for configurations such as dark glass. ams PROVIDES CUSTOMER SUPPORT IN VARIED TECHNICAL AREAS. SINCE ams DOES NOT POSSESS FULL ACCESS TO DATA CONCERNING ALL OF THE USES AND APPLICATIONS OF CUSTOMERS’ PRODUCTS, ams ASSUMES NO RESPONSIBILITY FOR CUSTOMER PRODUCT DESIGN OR THE USE OR APPLICATION OF CUSTOMERS’ PRODUCTS OR FOR ANY INFRINGEMENTS OF PATENTS OR RIGHTS OF OTHERS WHICH MAY RESULT FROM ams’ ASSISTANCE. www.ams.com 10 OF 12 Ambient Light Sensor OUTPUT SIDE, “PLOT” TAB The two photodiode readings and the calculated Lux can be displayed vs. time on a graph. The sample graph shows all outputs for a static system. Multipliers (selected from the list boxes) may be used to scale the display accordingly. On this plot the Ch1 photodiode is scaled by a factor of 10x relative to the other plotted signals. ams PROVIDES CUSTOMER SUPPORT IN VARIED TECHNICAL AREAS. SINCE ams DOES NOT POSSESS FULL ACCESS TO DATA CONCERNING ALL OF THE USES AND APPLICATIONS OF CUSTOMERS’ PRODUCTS, ams ASSUMES NO RESPONSIBILITY FOR CUSTOMER PRODUCT DESIGN OR THE USE OR APPLICATION OF CUSTOMERS’ PRODUCTS OR FOR ANY INFRINGEMENTS OF PATENTS OR RIGHTS OF OTHERS WHICH MAY RESULT FROM ams’ ASSISTANCE. www.ams.com 11 OF 12 Ambient Light Sensor “LUXEQ” AND “LUXEQPLOT” TABS The “LuxEq” tab on the Input Side and the “LuxEqPlot” tab on the Output Side are used together when developing a custom Lux equation. Refer to Designer’s Notebook number 28 (DN28), “Developing a Custom Lux Equation,” for information regarding the use of these tabs. RESOURCES TSL2572 datasheet TMD2571 datasheet Quick Start Guide (QSG) Designer’s Notebooks For additional information regarding the TSL2572, please refer to the datasheet. For information regarding the installation of the TSL2572 EVM host application please refer to the Quick Start Guide. Designer’s Notebooks dealing with various aspects of optical measurement and optical measurement applications are available. All content is available on the ams website www.ams.com ams PROVIDES CUSTOMER SUPPORT IN VARIED TECHNICAL AREAS. SINCE ams DOES NOT POSSESS FULL ACCESS TO DATA CONCERNING ALL OF THE USES AND APPLICATIONS OF CUSTOMERS’ PRODUCTS, ams ASSUMES NO RESPONSIBILITY FOR CUSTOMER PRODUCT DESIGN OR THE USE OR APPLICATION OF CUSTOMERS’ PRODUCTS OR FOR ANY INFRINGEMENTS OF PATENTS OR RIGHTS OF OTHERS WHICH MAY RESULT FROM ams’ ASSISTANCE. www.ams.com 12 OF 12