Texas Instruments OPT3004DTSEVM User manual

User’s Guide
OPT3004DTSEVM User's Guide
ABSTRACT
This user’s guide describes the characteristics, operation, and use of the OPT3004DTSEVM evaluation module.
It discusses how to set up and configure the software and hardware, and reviews various aspects of the program
operation. Throughout this document, the terms evaluation board, evaluation module, and EVM are synonymous
with the OPT3004DTSEVM. This document also includes an electrical schematic, printed circuit board (PCB)
layout drawings, and a parts list for the EVM.
www.ti.com
SBOU274 – DECEMBER 2021
Submit Document Feedback
OPT3004DTSEVM User's Guide 1
Copyright © 2021 Texas Instruments Incorporated

Table of Contents
1 Trademarks..............................................................................................................................................................................3
2 Overview..................................................................................................................................................................................4
2.1 OPT3004DTSEVM Kit Contents........................................................................................................................................ 4
2.2 Related Documentation from Texas Instruments............................................................................................................... 5
3 OPT3004DTSEVM Hardware.................................................................................................................................................. 6
3.1 Theory of Operation for the OPT3004DTSEVM.................................................................................................................7
3.2 OPT3004DTSEVM Hardware Overview............................................................................................................................ 7
4 OPT3004DTSEVM Software................................................................................................................................................... 8
4.1 Hardware Requirements.................................................................................................................................................... 8
4.2 Software Installation...........................................................................................................................................................8
4.3 Typical OPT3004DTSEVM Hardware Setup....................................................................................................................12
4.4 Launching the OPT3004EVM Software........................................................................................................................... 14
4.5 OPT3004EVM Software Operation.................................................................................................................................. 15
5 Schematic, PCB Layout, and Bill of Materials................................................................................................................... 20
5.1 Coupon Board.................................................................................................................................................................. 20
5.2 Motherboard.....................................................................................................................................................................23
6 Troubleshooting....................................................................................................................................................................27
6.1 Microsoft Windows 7 Manual Driver Installation.............................................................................................................. 27
Table of Contents www.ti.com
2OPT3004DTSEVM User's Guide SBOU274 – DECEMBER 2021
Submit Document Feedback
Copyright © 2021 Texas Instruments Incorporated

List of Figures
Figure 2-1. Hardware Included with OPT3004DTSEVM Kit........................................................................................................ 4
Figure 3-1. OPT3004DTSEVM Hardware Setup......................................................................................................................... 6
Figure 4-1. OPT3004DTSEVM Software-Installation File............................................................................................................8
Figure 4-2. OPT3004DTSEVM Software-Installation Launch......................................................................................................9
Figure 4-3. OPT3004DTSEVM Software-Installation Prompts.................................................................................................... 9
Figure 4-4. OPT3004DTSEVM Software-Installation Prompts.................................................................................................. 10
Figure 4-5. OPT3004DTSEVM Software-Installation Prompts.................................................................................................. 10
Figure 4-6. OPT3004DTSEVM Software-Installation Prompts.................................................................................................. 11
Figure 4-7. OPT3004DTSEVM Software-Installation Prompts.................................................................................................. 11
Figure 4-8. OPT3004DTSEVM Software-Installation Prompts.................................................................................................. 12
Figure 4-9. Typical Hardware Connection................................................................................................................................. 13
Figure 4-10. Typical Response After Connecting OPT3004DTSEVM to the Computer............................................................ 13
Figure 4-11. OPT3004 Main Operation Screen......................................................................................................................... 14
Figure 4-12. Hardware Error Message...................................................................................................................................... 14
Figure 4-13. GUI Capture Running............................................................................................................................................15
Figure 4-14. Latte Scripts Window.............................................................................................................................................17
Figure 4-15. Registers View.......................................................................................................................................................18
Figure 5-1. OPT3004 Coupon Board Schematic....................................................................................................................... 20
Figure 5-2. PCB Top Layer........................................................................................................................................................ 21
Figure 5-3. PCB Bottom Layer...................................................................................................................................................21
Figure 5-4. PCB Top-Layer Assembly Drawing......................................................................................................................... 22
Figure 5-5. PCB Bottom-Layer Assembly Drawing....................................................................................................................22
Figure 5-6. OPTMBEVM Schematic.......................................................................................................................................... 23
Figure 5-7. PCB Top Layer........................................................................................................................................................ 24
Figure 5-8. PCB Bottom Layer...................................................................................................................................................24
Figure 5-9. PCB Top-Layer Assembly Drawing......................................................................................................................... 25
Figure 5-10. PCB Bottom-Layer Assembly Drawing..................................................................................................................25
Figure 6-1. OPT3004DTSEVM on Microsoft® Windows® 7 With Drivers not Installed..............................................................27
1 Trademarks
Windows 10®, Microsoft®, and Windows® are registered trademarks of Microsoft Corporation.
All trademarks are the property of their respective owners.
www.ti.com Trademarks
SBOU274 – DECEMBER 2021
Submit Document Feedback
OPT3004DTSEVM User's Guide 3
Copyright © 2021 Texas Instruments Incorporated

2 Overview
The OPT3004 is an ambient light sensor (ALS) with a digital output integrated circuit. It uses a two-wire interface
that works with the I2C protocol making it ideal for many applications. The OPT3004DTSEVM is a platform for
evaluating the performance of the OPT3004 under various conditions. The OPT3004DTSEVM consists of two
PCBs. The first is the OPTMB EVM board that communicates with the computer, provides power, and sends
and receives appropriate digital signals. The second is the OPT3004DTS coupon board, which contains the
OPT3004DTS and its support circuitry.
2.1 OPT3004DTSEVM Kit Contents
Table 2-1 summarizes the contents of the OPT3004DTSEVM kit. Figure 2-1 shows the included hardware.
Contact the Texas Instruments Product Information Center nearest you if any component is missing. It is highly
recommended that you also check the OPT3004DTS product folder on the TI web site at www.ti.com to verify
you have the latest versions of the released software.
Table 2-1. OPT3004DTSEVM Kit Contents
Item Quantity
OPT3004 coupon board
(Installed on OPTMBEVM) 1
OPTMBEVM board 1
USB type A to type C cable 1
Figure 2-1. Hardware Included with OPT3004DTSEVM Kit
Overview www.ti.com
4OPT3004DTSEVM User's Guide SBOU274 – DECEMBER 2021
Submit Document Feedback
Copyright © 2021 Texas Instruments Incorporated

2.2 Related Documentation from Texas Instruments
The following documents provide information regarding Texas Instruments' integrated circuits used in the
assembly of the OPT3004DTSEVM. This user's guide is available from the TI web site under literature number
SBOU274. Any letter appended to the literature number corresponds to the document revision that is current at
the time of the writing of this document. The latest revision can be found by clicking the link Table 2-2 and is also
available from the TI web site, the Texas Instruments' Literature Response Center at [phone], and the
Product Information Center at [phone]. When ordering, identify the document by both title and literature
number.
Table 2-2. Related Documentation
Document Literature Number
OPT3004 product data sheet SBOS929
www.ti.com Overview
SBOU274 – DECEMBER 2021
Submit Document Feedback
OPT3004DTSEVM User's Guide 5
Copyright © 2021 Texas Instruments Incorporated

3 OPT3004DTSEVM Hardware
Figure 3-1 shows the system setup for the OPT3004DTSEVM. The computer runs the graphical user interface
(GUI) software that communicates with the OPTMBEVM board over a USB connection. The OPTMBEVM has a
USB Type C port and ships with a USB-C to USB-A cable. The OPTMBEVM board acts as a bridge between
the software running on the PC and the OPT3004DTS coupon board. The MSP430 on the OPTMBEVM recieves
USB commands from the PC and communicates with the OPT3004DTS over I2C.
Figure 3-1. OPT3004DTSEVM Hardware Setup
OPT3004DTSEVM Hardware www.ti.com
6OPT3004DTSEVM User's Guide SBOU274 – DECEMBER 2021
Submit Document Feedback
Copyright © 2021 Texas Instruments Incorporated

3.1 Theory of Operation for the OPT3004DTSEVM
The OPT3004 coupon consists of the OPT3004 IC, decoupling capacitor, and 8 pins. The pins create
connections for the power, I2C, and an interrupt signal between the coupon and the EVM motherboard. For
evaluation purposes the coupon can be removed from the moherboard to use with other platforms. The
motherboard also has an unpopulated 5-pin header footprint for easy access to the supply, ground, I2C and
inturrupt lines.
3.2 OPT3004DTSEVM Hardware Overview
The EVM ships with the coupon plugged into the motherboard. If not already assembled, the basic hardware
setup for the OPT3004DTSEVM involves plugging the coupon board into the motherboard socket. Take special
care to make sure the coupon is oriented correctly as shown in Figure 2-1. Then connect the USB cable. This
section presents the details of this procedure.
CAUTION
Many of the components on the OPT3004DTSEVM are susceptible to damage by electrostatic
discharge (ESD). Customers are advised to observe proper ESD handling precautions when
unpacking and handling the EVM, including the use of a grounded wrist strap at an approved ESD
workstation.
www.ti.com OPT3004DTSEVM Hardware
SBOU274 – DECEMBER 2021
Submit Document Feedback
OPT3004DTSEVM User's Guide 7
Copyright © 2021 Texas Instruments Incorporated

4 OPT3004DTSEVM Software
This section describes the installation and operation of the OPT3004DTSEVM software. The OPT3004DTSEVM
uses the TI Latte software, which is avaiable for download on the EVM page.
4.1 Hardware Requirements
The OPT3001EVM software has been tested on the Windows 10® operating system (OS) with United States
regional settings. The software should function correctly on other Windows operating systems.
4.2 Software Installation
The OPT3004DTSEVM software is available through the OPT3004DTSEVM Product Folder on the TI web site
(www.ti.com). To install the software to your computer, navigate to the OPT3004DTSEVM software, and open
the installer directory. Launch the OPT3004DTSEVM installation file, OPT3004DTS_EVM_Latte.exe, as shown
in the figure below.
Figure 4-1. OPT3004DTSEVM Software-Installation File
OPT3004DTSEVM Software www.ti.com
8OPT3004DTSEVM User's Guide SBOU274 – DECEMBER 2021
Submit Document Feedback
Copyright © 2021 Texas Instruments Incorporated

The OPT3004EVM software then begins the installation process, as shown in Figure 4-2.
Figure 4-2. OPT3004DTSEVM Software-Installation Launch
Follow the prompts as shown in Figure 4-3 to Figure 4-8 to install the OPT3004DTSEVM software.
Figure 4-3. OPT3004DTSEVM Software-Installation Prompts
www.ti.com OPT3004DTSEVM Software
SBOU274 – DECEMBER 2021
Submit Document Feedback
OPT3004DTSEVM User's Guide 9
Copyright © 2021 Texas Instruments Incorporated

Figure 4-4. OPT3004DTSEVM Software-Installation Prompts
Figure 4-5. OPT3004DTSEVM Software-Installation Prompts
OPT3004DTSEVM Software www.ti.com
10 OPT3004DTSEVM User's Guide SBOU274 – DECEMBER 2021
Submit Document Feedback
Copyright © 2021 Texas Instruments Incorporated

Figure 4-6. OPT3004DTSEVM Software-Installation Prompts
Figure 4-7. OPT3004DTSEVM Software-Installation Prompts
www.ti.com OPT3004DTSEVM Software
SBOU274 – DECEMBER 2021
Submit Document Feedback
OPT3004DTSEVM User's Guide 11
Copyright © 2021 Texas Instruments Incorporated

Figure 4-8. OPT3004DTSEVM Software-Installation Prompts
The OPT3004EVM GUI software is now installed.
4.3 Typical OPT3004DTSEVM Hardware Setup
Plug the male USB-C cable to the OPTMBEVM board and then plug the male USB-A cable into the computer.
The green light will light up on the EVM as shown in the figure below.
OPT3004DTSEVM Software www.ti.com
12 OPT3004DTSEVM User's Guide SBOU274 – DECEMBER 2021
Submit Document Feedback
Copyright © 2021 Texas Instruments Incorporated

Figure 4-9. Typical Hardware Connection
The figure below shows the typical response when the EVM is plugged into the USB port of the computer for
the first time. Typically, the computer responds with a Found New Hardware, USB Device pop-up dialog window.
The pop-up window then typically changes to Found New Hardware, USB Human Interface Device. This pop-up
indicates that the device is ready to be used.
Figure 4-10. Typical Response After Connecting OPT3004DTSEVM to the Computer
Connect the EVM via USB to the PC. If Windows shows a notification that a driver is not found for the device
connected, see the instructions to manually install drivers in Section 6.1 before proceeding.
www.ti.com OPT3004DTSEVM Software
SBOU274 – DECEMBER 2021
Submit Document Feedback
OPT3004DTSEVM User's Guide 13
Copyright © 2021 Texas Instruments Incorporated

4.4 Launching the OPT3004EVM Software
With the OPT3004DTSEVM properly connected, launch the Latte EVM GUI software from the Windows Start
menu. The software launches with a screen similar to that shown in Figure 4-11.
Figure 4-11. OPT3004 Main Operation Screen
If the message shown in Figure 4-12 appears when the OPT3004EVM GUI software is launched, this means
that the EVM motherboard was not detected. Check the USB connection and that the motherboard appears in
the device manager as shown. A green light will appear on the motherboard if it is recieving power from the PC
and the GUI "start capture" button has not been clicked.
Figure 4-12. Hardware Error Message
OPT3004DTSEVM Software www.ti.com
14 OPT3004DTSEVM User's Guide SBOU274 – DECEMBER 2021
Submit Document Feedback
Copyright © 2021 Texas Instruments Incorporated

4.5 OPT3004EVM Software Operation
This section primarily discusses how to operate the OPT3004EVM software. The GUI has a primary window
that is used to configure and read from the OPT3004DTSEVM, along with two other windows that are used to
access different features of the OPT3004DTSEVM. Basic GUI functionality and a description of the tabs are also
presented in this section.
4.5.1 Getting Started
To quickly start using the device, click the "Operation Select" dropdown and select "Continuous" to bring the
device out of power down mode. Then click "Start Capture" to begin data capture. The green LED on the
motherboard will turn off. Lux data will appear above the lux plot as shown. The plot will also start to populate
with the device lux readings.
Figure 4-13. GUI Capture Running
If the GUI is not responsive, check the other Latte scripts window, which is minimized by default. If the message
"Operation I2C Register Read for command [REGRx01] Failed." is displayed this means that the OPT3004 IC or
coupon is not detected by the motherboard. Ensure the coupon is plugged in and properly oriented.
4.5.2 Feature Descriptions
Lux Plot
In the center of the GUI window you will see a plot showing the lux reading from the device on the y-axis and
the sample number on the x-axis. The plot settings can be tweaked by right clicking on the plot. The x-axis and
y-axis options under the right-click menu allow the range of x and y-axes displayed to be changed. There is also
an auto option that will dynamically change the range to match the data. Scrolling will zoom in to or zoom out
from the plot. Left-clicking and dragging will display a yellow rectangle that will, upon releasing the mouse, zoom
the data to the rectangle drawn. Right-clicking and dragging up or down zooms the y-axis. Right-clicking and
dragging right or left will zoom the x-axis. Right clicking and selecting "View All" will reset the view.
Drop down Selectors
At the top left of the plot are two drop down selectors.
www.ti.com OPT3004DTSEVM Software
SBOU274 – DECEMBER 2021
Submit Document Feedback
OPT3004DTSEVM User's Guide 15
Copyright © 2021 Texas Instruments Incorporated

The operation select dropdown allows device operating mode to be switched between power down and
continuous capture modes. The oneshot mode of the device is not exposed by the EVM GUI.
The mode select drop down changes the device gain range setting mode. The device supports automatic gain
control (ACG), which is the recommended mode setting for most use cases, or the gain range of the device can
be selected manually using this dropdown.
The device supports two conversion times: 100ms and 800ms, which can be selected using the respective
dropdown.
The display sample count selects how many samples are displayed on the x-axis of the plot.
Save to file
The set save to file name check box allows the data captured in the GUI to be dumped to a CSV file. Clicking
this check box will display a windows file selector screen. Select the directory to store the CSV and set the name
for the CSV. After clicking save the GUI will wait for you to click the start capture button to start saving data and
susequently it will wait for a click on the stop capture button to copy all the data into the indicated CSV file. When
capturing data with save enabled, the GUI will initially dump the data to temporary .npy files. After clicking stop
capture this data is written over to the CSV file and .npy files removed.
Mean, Std, and the Blue Slider
There is a blue slider on the lux plot shown on the right side of the plot in the figure. Mean and Std columns in
the table where capture data is displayed are calculated from only the data within the blue slider. Left-clicking on
the middle of this slider and dragging moves the slider. Left-clicking on the edge of either side of the slider and
dragging will adjust the size of the slider. This allows the mean and standard deviation of the distance, phase,
and amplitude to be computed for any continuous portion of the displayed data. If capture is running this data
updates in real-time along with the data in the Live column.
Scripts Window
When Latte is launched the GUI window appears front and center. However, there is a second window that is
minimized at launch. This is the scripts window and exposes some more advanced features of the Latte platform
that will be described below.
OPT3004DTSEVM Software www.ti.com
16 OPT3004DTSEVM User's Guide SBOU274 – DECEMBER 2021
Submit Document Feedback
Copyright © 2021 Texas Instruments Incorporated

Figure 4-14. Latte Scripts Window
www.ti.com OPT3004DTSEVM Software
SBOU274 – DECEMBER 2021
Submit Document Feedback
OPT3004DTSEVM User's Guide 17
Copyright © 2021 Texas Instruments Incorporated

The scripts window also provides access to the device registers view that displays the stored value of the device
registers and allows them to be changed directly. Launch the registers view by double clicking on the "Registers
View" button under the "Device List" box on the right side of the screen.
Figure 4-15. Registers View
Overview of Device Registers
Register x00 is the result register and provides the output data from the device as an exponent and mantissa
value indicated as e and r in the register view.
Register x01 is the configuration register and provides feedback about the state of the device; the bit names and
full descriptions are shown in the OPT3004 data sheet. Each of the read-only status bits are greyed out and
cannot be changed.
Registers x02 and x03 enforce low and high limits, respectively, on the output ranges (exponent) and values
(mantissa) from the OPT3004. These registers are not included in the register view.
Additional Features of the Scripts Window
Hidden IDE Window
OPT3004DTSEVM Software www.ti.com
18 OPT3004DTSEVM User's Guide SBOU274 – DECEMBER 2021
Submit Document Feedback
Copyright © 2021 Texas Instruments Incorporated

The Latte program runs a number of python scripts in the background to capture and display data from the EVM.
These scripts allow for initialization of the device including loading calibration data from the EVM flash memory,
launching a live view window with measurement plot and readings, and additional functionality such as reading
from the flash and selecting a specific LED current for the device to use. For advance users or users looking for
more flexibility when using the OPT3101EVM these python scripts are available in an integrated development
environment (IDE) window that is minimized when TI-Latte is launched. The IDE window allows advanced users
to customize the existing scripts or write new scripts.
After launching Latte, expand the OPT3004DTS directory on the left hand side of the window under Files
by clicking the triangle to the left of the directory name. This displays the OPT3004DTSEVM folder. Further
expanding the OPT3004DTSEVM folder will display all the example scripts as shown in the figure.
devInit.py
Open the devInit.py script by clicking on the corresponding file in the OPT3004DTSEVM folder on the left side of
the screen. This displays the contents of the script on the center of the window. With devInit.py still selected in
TI-Latte, click Run>Buffer from the top menu bar of TI-Latte (or press F5) to run the script. Once completed, the
live view GUI is opened in a new window. More details on the live view GUI are given in the following section.
Additional info is also displayed in the log window in the lower left- hand corner of the main window.
04-launchGUI.py
A liveview GUI window is launched when running the devInit.py script. This allows data from the OPT3004 to be
viewed on a graph in real time. The GUI is created in the launchGUI.py example script. When running devInit.py,
the launchGUI.py script is automatically run. However, if the GUI window is closed it can be re-launched by
directly running the launchGUI.py script. To do this, select the launchGUI.py script and click Run>Buffer or press
F5. Figure 4-13 shows the live GUI plot.
www.ti.com OPT3004DTSEVM Software
SBOU274 – DECEMBER 2021
Submit Document Feedback
OPT3004DTSEVM User's Guide 19
Copyright © 2021 Texas Instruments Incorporated

5 Schematic, PCB Layout, and Bill of Materials
5.1 Coupon Board
5.1.1 Schematic
Figure 5-1 shows the schematic of the OPT3004DTS coupon board. C1 is a bypass capacitor for device VDD.
Figure 5-1. OPT3004 Coupon Board Schematic
Schematic, PCB Layout, and Bill of Materials www.ti.com
20 OPT3004DTSEVM User's Guide SBOU274 – DECEMBER 2021
Submit Document Feedback
Copyright © 2021 Texas Instruments Incorporated