![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bg1.png)
User's Guide
SLAU282 – April 2009
TSC2117EVM-K
This user’s guide describes the operation of the TSC2117EVM-K evaluation module (EVM). The EVM
features a TSC2117 touch screen controller with stereo audio codec, amplifiers for speakers and
headphones and a digital signal processing module. Together with the USB-MODEVM board, the
TSC2117 Control Software and a PC running Windows™ XP it is a plug-and-play solution to evaluate the
capabilities of the TSC2117.
The information in a caution or a warning is provided for your protection. Read each caution and warning
carefully.
Contents
1 EVM Overview ............................................................................................................... 2
1.1 Introduction .......................................................................................................... 2
1.2 Box Contents ........................................................................................................ 2
1.3 Related Documentation From Texas Instruments .............................................................. 2
2 EVM + PC .................................................................................................................... 3
2.1 EVM Preparation .................................................................................................... 3
2.2 Control Software .................................................................................................... 4
2.3 Installation ........................................................................................................... 4
2.4 Concepts ............................................................................................................. 4
2.5 Main Window ........................................................................................................ 5
2.6 Dialogs and Active Objects ........................................................................................ 6
3 EVM Hardware ............................................................................................................. 19
3.1 Connectors and Jumpers......................................................................................... 19
3.2 EVM Schematics .................................................................................................. 22
3.3 EVM Bill of Materials .............................................................................................. 23
Appendix A USB-MODEVM Schematic ...................................................................................... 25
Appendix B USB-MODEVM Bill of Materials ................................................................................ 26
Appendix C USB-MODEVM Protocol ......................................................................................... 28
1 TSC2117 EVM + USB MODEVM.......................................................................................... 3
2 Main Window ................................................................................................................. 5
3 Initialization Script ........................................................................................................... 7
4 Command Dialog ............................................................................................................ 8
5 Register Inspector ........................................................................................................... 9
6 Clock and Digital Signal Routing ......................................................................................... 11
7 Digital Configuration: Codec Clock / PLL ............................................................................... 12
8 Advanced Clock Settings. ................................................................................................. 13
9 Audio Interface .............................................................................................................. 14
10 Touch Screen Active Object .............................................................................................. 15
11 SAR ADC Data ............................................................................................................. 16
12 Automatic Gain Control .................................................................................................... 17
13 DRC Transfer Function and DRC Dialog ............................................................................... 18
I2S, I2C are trademarks of Koninklijke Philips Electronics N.V.
Windows is a trademark of Microsoft Corporation.
SPI is a trademark of Motorola, Inc.
SLAU282 – April 2009 TSC2117EVM-K 1
Submit Documentation Feedback
List of Figures
![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bg2.png)
EVM Overview
1 EVM Overview
1.1 Introduction
www.ti.com
List of Tables
1 Analog I/O ................................................................................................................... 19
2 Touch Screen ............................................................................................................... 19
3 GPI ........................................................................................................................... 19
4 Jumpers ..................................................................................................................... 20
5 Expansion Connectors P12/J12 .......................................................................................... 20
6 Expansion Connectors P22/J22 .......................................................................................... 21
7 Power Supply ............................................................................................................... 21
B-1 USB-MODEVM Bill of Materials .......................................................................................... 26
C-1 USB Control Endpoint HIDSETREPORT Request .................................................................... 28
C-2 Data Packet Configuration ................................................................................................ 28
C-3 GPIO Pin Assignments .................................................................................................... 31
The TSC2117EVM-K features a TSC2117 touch screen controller with stereo audio codec, amplifiers for
speakers and headphones and a digital signal processing module.
Together with the USB-MODEVM board, the TSC2117 Control Software and a PC running Windows XP, it
is a plug-and-play solution to evaluate the capabilities of the TSC2117.
The USB-MODEVM board contains a TAS1020B streaming audio USB controller, which enumerates as a
USB audio class device.
When the USB-MODEVM + TSC2117 EVM is connected to a PC running Microsoft Windows XP, it will be
recognized as a sound card. Once the TSC2117 is configured using the TSC2117 control software, any
audio playback and record software on the PC that uses the Windows audio subsystem (sound card) can
use the TSC2117.
Besides configuration, the TSC2117 control software allows evaluation of the touch screen module of the
TSC2117. The TSC2117 is compatible with 4 wire resistive touch screens (not provided by TI).
1.2 Box Contents
The following items ship with the TSC2117EVM-K:
• TSC2117 EVM
• USB-MODEVM
The control software required to operate the EVM is available from the TSC2117 product folder at
http://www.ti.com
1.3 Related Documentation From Texas Instruments
TSC2117 data sheet (SLAS550 )
TSC2117EVM-K 2 SLAU282 – April 2009
Submit Documentation Feedback
![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bg3.png)
TSC2117_RGZ_EVM
SW2
J6 Speakers
J1 LineIn
USB-MODEVM
J8
J4 Touchscreen
Headphones
J7 USB
ONOFF
www.ti.com
2 EVM + PC
This chapter explains how to use the TSC2117 EVM with a PC running Windows XP.
2.1 EVM Preparation
To interface the TSC2117 EVM with a PC using USB, plug the TSC2117 EVM onto the USB-MODEVM as
shown in Figure 2 1. TSC2117 EVM + USB MODEVM.
EVM + PC
2.1.1 Analog Signal Connections
• Connect a headphone to J8 (3,5 mm jack)
• Connect 8- Ω speakers to J6 (4 screw terminal)
• Connect a line-level audio source to J1 (3,5 mm jack)
2.1.2 Touch Screen Connections
The TSC2117 EVM is compatible with 4-wire resistive touch screens. Connect the touch screen to J4 (X+,
X–, Y+, Y–).
Note: USB-MODEVM configuration
To control the TSC2117 from the PC via the USB-MODEVM, set switch SW2 position 1, 3, 4,
5, 6, 7 to ON and position 2 and 8 to OFF.
– Left speaker to SPLN and SPLP
– Right speaker to SPRN and SPRP
Figure 1. TSC2117 EVM + USB MODEVM
SLAU282 – April 2009 TSC2117EVM-K 3
Submit Documentation Feedback
![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bg4.png)
EVM + PC
2.2 Control Software
2.3 Installation
www.ti.com
The TSC2117 control software exposes most features of the TSC2117 through an intuitive graphical user
interface.
Note: Before Windows on the PC can use the TSC2117EVM-K as a sound card, the TSC2117 on
the EVM must be configured (sampling rate, audio routing, internal amplifier settings etc.)
with the TSC2117 control software.
Download the TSC2117 control software (SLAC264 ) from the TSC2117 product folder at http://www.ti.com
and launch the program (SLAC264 ).
This file is a self-extracting archive. The default target folder is:
C:\Program Files\Texas Instruments\TSC2117
Click the Unzip button to complete the installation.
The TSC2117 control software is now available in the target folder. The name of the executable is
TSC2117.exe
To launch the TSC2117 control software, navigate to the target folder with the Windows Explorer and
double click TSC2117.exe.
2.4 Concepts
The TSC2117 control software presents a block diagram view of the TSC2117 (or select modules within
the TSC2117).
The block diagram consists of active objects that can react to user input (for example switches or
amplifiers with variable gain that show a volume control on a mouse click event).
Note: Each active object will change color to red if the mouse cursor is above the object. Clicking
the object will trigger its function.
Some active objects are linked to control register(s) of the TSC2117 in a two way fashion. If an EVM is
connected, the control software will update the appropriate register(s) whenever an active object is
triggered. If a register that is linked to an active object is changed via other components (for example the
script interpreter or the register inspector), the active object will change its state accordingly.
The control software will automatically detect a TSC2117EVM-K once it is connected to a USB port of the
PC.
If no TSC2117EVM-K is connected to the PC, the control software changes to a simulation mode, where it
is possible to retrieve script commands based on user input within the block diagram.
TSC2117EVM-K 4 SLAU282 – April 2009
Submit Documentation Feedback
![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bg5.png)
www.ti.com
2.5 Main Window
EVM + PC
Figure 2. Main Window
At the top of the main window is a tool bar with buttons to change between four different use cases of the
TSC2117:
• Full featured TSC2117
• Playback only
• Record only
• Touch Screen only
By default, the control software displays the full featured block diagram of the TSC2117.
Each use case has its own initialization script, which will run if a use case is selected by clicking on one of
the use case buttons. The initialization script contains register settings for the TSC2117 to configure the
device for a specific use case.
The toolbar contains a control that determines the zoom factor. Change the zoom by selecting the desired
zoom factor.
To move the block diagram, click on a blank area within the block diagram and drag the diagram with the
mouse.
At the bottom of the main window is a status bar that provides information about the state of the
communication between the control software and the TSC2117EVM-K. It also shows hints about elements
in the block diagram, for example the I2C page and register / bit location of a selected switch.
Audio signal paths (both digital and analog) will change color from black to
• Blue for left audio output
• Turquoise for right audio output
SLAU282 – April 2009 TSC2117EVM-K 5
Submit Documentation Feedback
![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bg6.png)
EVM + PC
• Magenta for audio input
once they are activated via switches. This feature visualizes all audio paths and immediately highlights if a
path is disabled.
2.5.1 Using Active Objects
Moving the mouse pointer over an active object will light up the active object (the color of the object turns
red).
For example, the Class-A/B HP Driver left amplifier active object will turn from its inactive state to its active
state when the mouse pointer enters the amplifier symbol:
www.ti.com
Clicking the activated object will trigger its function. In the case of the amplifier active object, the function
is a volume control. Moving the volume control slider changes the volume setting of the amplifier (it is also
possible to change the volume by clicking onto the number within the amplifier symbol and typing the new
gain setting).The control software updates the appropriate register in the TSC2117 and as a result the
volume on the headphone output will change accordingly.
2.6 Dialogs and Active Objects
The TSC2117 control software contains several dialog windows that give access to additional features.
Most dialogs are linked to active objects and are opened by clicking on the active object.
A few dialogs are not linked to active objects and are opened using the View menu.
6 TSC2117EVM-K SLAU282 – April 2009
Submit Documentation Feedback
![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bg7.png)
www.ti.com
2.6.1 Init Script Dialog
Each use case , , , owns a unique initialization script which will automatically run when a
TSC2117EVM-K is detected or if the user selects another use case.
To show or edit the initialization script, choose View->Init Script … from the main window menu bar.
EVM + PC
Figure 3. Initialization Script
Click the Run button to run the script again. For further information about the script syntax, see Figure 3 .
SLAU282 – April 2009 TSC2117EVM-K 7
Submit Documentation Feedback
![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bg8.png)
EVM + PC
2.6.2 Command Dialog
Open the command dialog (View->Command … ) to write, edit, load, save and run command scripts.
Command scripts are text files that contain commands to communicate with the TSC2117. The syntax is
described in Figure 4 .
www.ti.com
Figure 4. Command Dialog
• The main area of the command dialog is command buffer (editable text) which contains the command
script. To run the command script, click the Run button.
• The smaller read only text area on the right side of the command dialog displays control data read
from the TSC2117. The Clear button clears the Read Data field.
• The one line text edit field on the left bottom allows single command execution.
• The Record check box enables recording of commands generated by the control software.
Figure 4 shows a recording of the volume control for the left Class-A/B HP Driver amplifier (note that the
Record checkbox is checked).
A single command to read four bytes starting at address 0x28 was executed and the result is displayed in
the Read Data field.
TSC2117EVM-K 8 SLAU282 – April 2009
Submit Documentation Feedback
![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bg9.png)
www.ti.com
2.6.3 Register Inspector
The register inspector dialog (View->Register Inspector … ) gives access to all registers of the TSC2117.
EVM + PC
Figure 5. Register Inspector
The register inspector displays the content of the TSC2117 registers. The control software will read all
TSC2117 registers when a TSC2117EVM-K is detected. To force reading the content of one page, click
the Refresh button.
• The Page edit field selects the page to be displayed.
• The addr column shows the address of the registers within the selected page in decimal notation.
• The description column contains a description for each register. If the register has no function
assigned, it is declared Reserved.
• The data columns show the data of each register (one byte). The first data column uses decimal
notation, the second uses hexadecimal notation. It is possible to change the register value by clicking
into one of the data fields and typing the new value (either decimal or hexadecimal).
• The numbered columns show the register content in binary notation. Read/Write bits are shown solid
black or red; read only bits are gray or dark red. Red numbers represent bits that recently changed. To
change a single writeable bit, click on the bit and it will flip.
SLAU282 – April 2009 TSC2117EVM-K 9
Submit Documentation Feedback
![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bga.png)
EVM + PC
2.6.4 DAC Filter
One of the digital signal processing blocks of the TSC2117 implements five digital biquad filters. The DAC
digital filter dialog (View->DAC Filter … ) allows real time graphical manipulation of the digital filters.
The control software will automatically configure the digital signal processing block when the DAC digital
filter dialog is opened.
www.ti.com
The digital filter dialog limits the range of each digital biquad filter to +/-12[dB] (this is an arbitrary limitation
for demonstration purposes).
• Each biquad has its own unique handle with a unique color. Each handle will light up white if the
mouse pointer is in the vicinity, showing that it can be selected. To change the frequency and gain of a
biquad, grab and drag its handle.
It is also possible to change the gain using the slider for each biquad.
• Each biquad can be configured for parametric EQ, Shelf Treble or Shelf Bass. If it is configured for EQ,
press the shift key before selecting the handle to adjust the bandwidth of the EQ using the mouse
pointer.
• Due to digital range limitations, the biquads will automatically scale, if the biquad coefficients exceed
the limitations.
The coordinate system will shift accordingly to reflect the resulting attenuation.
• To avoid clipping, add additional attenuation with the Attenuate slider.
• To retrieve the biquad coefficients, open the command dialog (see 0) and check Record.
TSC2117EVM-K 10 SLAU282 – April 2009
Submit Documentation Feedback
![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bgb.png)
www.ti.com
2.6.5 Clock and Digital Signal Routing
The TSC2117 has a flexible and complex clock and digital signal routing architecture.
Two processors can connect to the TSC2117 using two separate I2S™ interfaces: The primary I2S
interface has dedicated pins whereas the secondary I2S interface signals can be assigned to a selection
of pins.
The TSC2117 has an on-chip clock generation module which can be configured to generate the sampling
rate, modulator clocks, converter clocks, bit clock and word clock.
Click on the “Digital Audio Processing Serial Interface” active object (if it is not within the current scope of
the main window, drag the block diagram to the left until the active object appears). This will change the
block diagram to the clock and digital signal routing diagram:
EVM + PC
Figure 6. Clock and Digital Signal Routing
The clock and digital signal routing diagram shows the current state of the TSC2117 routing configuration
and allows interactive manipulation.
• Each clock or signal source has its own unique color. For example, the BCLK signal from the internal
clock generation module has a turquoise color.
• To trace the routing of a specific signal, follow its color. The example in Figure 6 shows that the BCLK
signal from the internal clock generation module is routed to the primary I2C™ BCLK pin (which is
configured as an output), to the secondary I2S BCLK signal (which is not connected to a pin) and to
the BCLK input of the codec (ADC and DAC within the TSC2117).
• To change the definition of a pin (input or output), click the active object (arrow) that belongs to the pin.
Only pins that can change between input and output are linked to such an active object. The clock
routing diagram will automatically change to reflect the new routing.
• Some of the switches within the diagram are active objects, which can be manipulated using the
mouse pointer. Other switches open or close depending on the state of the associated pin.
• To assign a pin to a signal of the secondary I2S interface, choose one of the available pins in the drop
down box that belongs to the signal. The list of available pins will change automatically depending on
the assignment of other signals to pins.
• Click on the “Back To Codec” active object to return to the previous block diagram.
• Click on the “Internal Clock Gen Module” active object to display the digital configuration dialog.
SLAU282 – April 2009 TSC2117EVM-K 11
Submit Documentation Feedback
![](/html/b9/b966/b96680b1a19d3864e0073dc4eb837becf723c0233b5e3a0b4f7ccd4a92512d94/bgc.png)
EVM + PC
2.6.6 Digital Configuration
www.ti.com
The digital configuration dialog gives access to the codec clock and PLL settings as well as the audio
interface settings.
To open the digital configuration dialog, navigate to the clock and digital signal routing diagram (see
Figure 6 ) and click on the “Internal Clock Gen Module” active object.
Figure 7. Digital Configuration: Codec Clock / PLL
The digital configuration dialog contains two tabs, one for the Codec Clock / PLL settings and one for the
Audio Interface settings.
The Codec Clock / PLL settings tab (see Figure 7 ) enables simple generation of PLL and clock divider
settings based on the available input frequency and the desired sample rate:
1. Choose the clock input using the Clock Input drop down box.
2. Type the available input frequency in the Input Frequency edit field.
3. Type the desired sample rate in the Sample Rate edit field of the ADC. By default, the DAC sample
rate equals the ADC sample rate. Uncheck DAC Fs = ADC Fs and enter the DAC sample rate for
different sample rates.
4. The Engine OSR and Instructions fields affect the miniDSP. Please contact your TI representative for
further information about the miniDSP.
5. The Results list shows all clock settings that fulfill the chosen parameters. Double click on one of the
results to program the TSC2117 with the new settings.
Each result has the following columns:
12 TSC2117EVM-K SLAU282 – April 2009
Submit Documentation Feedback