Texas Instruments TSC2117EVM-K User manual

User's GuideSLAU282 – April 2009
TSC2117EVM-K
This user’s guide describes the operation of the TSC2117EVM-K evaluation module (EVM). The EVMfeatures a TSC2117 touch screen controller with stereo audio codec, amplifiers for speakers andheadphones and a digital signal processing module. Together with the USB-MODEVM board, theTSC2117 Control Software and a PC running Windows™ XP it is a plug-and-play solution to evaluate thecapabilities of the TSC2117.
The information in a caution or a warning is provided for your protection. Read each caution and warningcarefully.
Contents1 EVM Overview ............................................................................................................... 21.1 Introduction .......................................................................................................... 21.2 Box Contents ........................................................................................................ 21.3 Related Documentation From Texas Instruments .............................................................. 22 EVM + PC .................................................................................................................... 32.1 EVM Preparation .................................................................................................... 32.2 Control Software .................................................................................................... 42.3 Installation ........................................................................................................... 42.4 Concepts ............................................................................................................. 42.5 Main Window ........................................................................................................ 52.6 Dialogs and Active Objects ........................................................................................ 63 EVM Hardware ............................................................................................................. 193.1 Connectors and Jumpers......................................................................................... 193.2 EVM Schematics .................................................................................................. 223.3 EVM Bill of Materials .............................................................................................. 23Appendix A USB-MODEVM Schematic ...................................................................................... 25Appendix B USB-MODEVM Bill of Materials ................................................................................ 26Appendix C USB-MODEVM Protocol ......................................................................................... 28
List of Figures
1 TSC2117 EVM + USB MODEVM.......................................................................................... 32 Main Window ................................................................................................................. 53 Initialization Script ........................................................................................................... 74 Command Dialog ............................................................................................................ 85 Register Inspector ........................................................................................................... 96 Clock and Digital Signal Routing ......................................................................................... 117 Digital Configuration: Codec Clock / PLL ............................................................................... 128 Advanced Clock Settings. ................................................................................................. 139 Audio Interface .............................................................................................................. 1410 Touch Screen Active Object .............................................................................................. 1511 SAR ADC Data ............................................................................................................. 1612 Automatic Gain Control .................................................................................................... 1713 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 1Submit Documentation Feedback

1 EVM Overview
1.1 Introduction
1.2 Box Contents
1.3 Related Documentation From Texas Instruments
EVM Overview www.ti.com
List of Tables
1 Analog I/O ................................................................................................................... 192 Touch Screen ............................................................................................................... 193 GPI ........................................................................................................................... 194 Jumpers ..................................................................................................................... 205 Expansion Connectors P12/J12 .......................................................................................... 206 Expansion Connectors P22/J22 .......................................................................................... 217 Power Supply ............................................................................................................... 21B-1 USB-MODEVM Bill of Materials .......................................................................................... 26C-1 USB Control Endpoint HIDSETREPORT Request .................................................................... 28C-2 Data Packet Configuration ................................................................................................ 28C-3 GPIO Pin Assignments .................................................................................................... 31
The TSC2117EVM-K features a TSC2117 touch screen controller with stereo audio codec, amplifiers forspeakers and headphones and a digital signal processing module.
Together with the USB-MODEVM board, the TSC2117 Control Software and a PC running Windows XP, itis 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 aUSB audio class device.
When the USB-MODEVM + TSC2117 EVM is connected to a PC running Microsoft Windows XP, it will berecognized as a sound card. Once the TSC2117 is configured using the TSC2117 control software, anyaudio playback and record software on the PC that uses the Windows audio subsystem (sound card) canuse the TSC2117.
Besides configuration, the TSC2117 control software allows evaluation of the touch screen module of theTSC2117. The TSC2117 is compatible with 4 wire resistive touch screens (not provided by TI).
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 athttp://www.ti.com
TSC2117 data sheet (SLAS550 )
TSC2117EVM-K 2 SLAU282 – April 2009Submit Documentation Feedback

2 EVM + PC
2.1 EVM Preparation
TSC2117_RGZ_EVM
SW2
J6 Speakers
J1 Line In
USB-MODEVM
J8
J4 Touchscreen
Headphones
J7 USB
ON OFF
2.1.1 Analog Signal Connections
2.1.2 Touch Screen Connections
www.ti.com EVM + PC
This chapter explains how to use the TSC2117 EVM with a PC running Windows XP.
To interface the TSC2117 EVM with a PC using USB, plug the TSC2117 EVM onto the USB-MODEVM asshown in Figure 2 1. TSC2117 EVM + USB MODEVM.
Figure 1. TSC2117 EVM + USB MODEVM
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.
•Connect a headphone to J8 (3,5 mm jack)•Connect 8- Ωspeakers to J6 (4 screw terminal)– Left speaker to SPLN and SPLP– Right speaker to SPRN and SPRP•Connect a line-level audio source to J1 (3,5 mm jack)
The TSC2117 EVM is compatible with 4-wire resistive touch screens. Connect the touch screen to J4 (X+,X–, Y+, Y–).
SLAU282 – April 2009 TSC2117EVM-K 3Submit Documentation Feedback

2.2 Control Software
2.3 Installation
2.4 Concepts
EVM + PC www.ti.com
The TSC2117 control software exposes most features of the TSC2117 through an intuitive graphical userinterface.
Note: Before Windows on the PC can use the TSC2117EVM-K as a sound card, the TSC2117 onthe 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.comand launch the program (SLAC264 ).
This file is a self-extracting archive. The default target folder is:
C:\Program Files\Texas Instruments\TSC2117Click the Unzip button to complete the installation.
The TSC2117 control software is now available in the target folder. The name of the executable isTSC2117.exe
To launch the TSC2117 control software, navigate to the target folder with the Windows Explorer anddouble click TSC2117.exe.
The TSC2117 control software presents a block diagram view of the TSC2117 (or select modules withinthe TSC2117).
The block diagram consists of active objects that can react to user input (for example switches oramplifiers 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. Clickingthe 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 isconnected, the control software will update the appropriate register(s) whenever an active object istriggered. If a register that is linked to an active object is changed via other components (for example thescript 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 thePC.
If no TSC2117EVM-K is connected to the PC, the control software changes to a simulation mode, where itis possible to retrieve script commands based on user input within the block diagram.
TSC2117EVM-K 4 SLAU282 – April 2009Submit Documentation Feedback

2.5 Main Window
•Full featured TSC2117
•Playback only
•Record only
•Touch Screen only
www.ti.com 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 theTSC2117:
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 ofthe use case buttons. The initialization script contains register settings for the TSC2117 to configure thedevice for a specific use case.
The toolbar contains a control that determines the zoom factor. Change the zoom by selecting the desiredzoom factor.
To move the block diagram, click on a blank area within the block diagram and drag the diagram with themouse.
At the bottom of the main window is a status bar that provides information about the state of thecommunication between the control software and the TSC2117EVM-K. It also shows hints about elementsin 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 5Submit Documentation Feedback

2.5.1 Using Active Objects
2.6 Dialogs and Active Objects
EVM + PC www.ti.com
•Magenta for audio input
once they are activated via switches. This feature visualizes all audio paths and immediately highlights if apath is disabled.
Moving the mouse pointer over an active object will light up the active object (the color of the object turnsred).
For example, the Class-A/B HP Driver left amplifier active object will turn from its inactive state to its activestate when the mouse pointer enters the amplifier symbol:
Clicking the activated object will trigger its function. In the case of the amplifier active object, the functionis a volume control. Moving the volume control slider changes the volume setting of the amplifier (it is alsopossible to change the volume by clicking onto the number within the amplifier symbol and typing the newgain setting).The control software updates the appropriate register in the TSC2117 and as a result thevolume on the headphone output will change accordingly.
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.
6TSC2117EVM-K SLAU282 – April 2009Submit Documentation Feedback

2.6.1 Init Script Dialog
Each use case , , , owns a unique initialization script which will automatically run when a
www.ti.com EVM + PC
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.
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 7Submit Documentation Feedback

2.6.2 Command Dialog
EVM + PC www.ti.com
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 isdescribed in Figure 4 .
Figure 4. Command Dialog
•The main area of the command dialog is command buffer (editable text) which contains the commandscript. 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 readfrom 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 theRecord checkbox is checked).
A single command to read four bytes starting at address 0x28 was executed and the result is displayed inthe Read Data field.
TSC2117EVM-K 8 SLAU282 – April 2009Submit Documentation Feedback

2.6.3 Register Inspector
www.ti.com EVM + PC
The register inspector dialog (View->Register Inspector …) gives access to all registers of the TSC2117.
Figure 5. Register Inspector
The register inspector displays the content of the TSC2117 registers. The control software will read allTSC2117 registers when a TSC2117EVM-K is detected. To force reading the content of one page, clickthe 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 functionassigned, it is declared Reserved.•The data columns show the data of each register (one byte). The first data column uses decimalnotation, the second uses hexadecimal notation. It is possible to change the register value by clickinginto 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 solidblack or red; read only bits are gray or dark red. Red numbers represent bits that recently changed. Tochange a single writeable bit, click on the bit and it will flip.
SLAU282 – April 2009 TSC2117EVM-K 9Submit Documentation Feedback

2.6.4 DAC Filter
EVM + PC www.ti.com
One of the digital signal processing blocks of the TSC2117 implements five digital biquad filters. The DACdigital 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 digitalfilter dialog is opened.
The digital filter dialog limits the range of each digital biquad filter to +/-12[dB] (this is an arbitrary limitationfor demonstration purposes).•Each biquad has its own unique handle with a unique color. Each handle will light up white if themouse pointer is in the vicinity, showing that it can be selected. To change the frequency and gain of abiquad, 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 mousepointer.
•Due to digital range limitations, the biquads will automatically scale, if the biquad coefficients exceedthe 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 2009Submit Documentation Feedback

2.6.5 Clock and Digital Signal Routing
www.ti.com EVM + PC
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 I2Sinterface has dedicated pins whereas the secondary I2S interface signals can be assigned to a selectionof pins.
The TSC2117 has an on-chip clock generation module which can be configured to generate the samplingrate, 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 ofthe main window, drag the block diagram to the left until the active object appears). This will change theblock diagram to the clock and digital signal routing diagram:
Figure 6. Clock and Digital Signal Routing
The clock and digital signal routing diagram shows the current state of the TSC2117 routing configurationand allows interactive manipulation.•Each clock or signal source has its own unique color. For example, the BCLK signal from the internalclock 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 BCLKsignal from the internal clock generation module is routed to the primary I2C™ BCLK pin (which isconfigured as an output), to the secondary I2S BCLK signal (which is not connected to a pin) and tothe 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 clockrouting diagram will automatically change to reflect the new routing.•Some of the switches within the diagram are active objects, which can be manipulated using themouse 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 dropdown box that belongs to the signal. The list of available pins will change automatically depending onthe 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 11Submit Documentation Feedback

2.6.6 Digital Configuration
EVM + PC www.ti.com
The digital configuration dialog gives access to the codec clock and PLL settings as well as the audiointerface settings.
To open the digital configuration dialog, navigate to the clock and digital signal routing diagram (seeFigure 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 theAudio Interface settings.
The Codec Clock / PLL settings tab (see Figure 7 ) enables simple generation of PLL and clock dividersettings 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 samplerate equals the ADC sample rate. Uncheck DAC Fs = ADC Fs and enter the DAC sample rate fordifferent sample rates.4. The Engine OSR and Instructions fields affect the miniDSP. Please contact your TI representative forfurther information about the miniDSP.5. The Results list shows all clock settings that fulfill the chosen parameters. Double click on one of theresults to program the TSC2117 with the new settings.
Each result has the following columns:
12 TSC2117EVM-K SLAU282 – April 2009Submit Documentation Feedback

www.ti.com EVM + PC
•PLL: On or Off•P,R,J,D: PLL configuration•NADC, MADC: ADC clock dividers•AOSR: ADC over-sampling factor•FsADC: ADC sampling rate•NDAC, MDAC: DAC clock dividers•DOSR: DAC over-sampling factor•FsDAC: DAC sampling rate
Click the Advanced …button to show the advanced clock settings dialog.
Figure 8. Advanced Clock Settings.
The advanced clock settings dialog gives direct access to the PLL and codec clock dividers. It willrecalculate the clock results dynamically whenever a parameter is changed.
The internally generated bit clock signal (BCLK) can be derived from several sources and divided by aninteger number. Select the desired source with the Source drop down box, choose the divisor and enablepower to the divider, if required.
It is possible to put out a clock signal CLKOUT. Select the clock source, the divider and the destination pinusing the advanced clock settings dialog.
SLAU282 – April 2009 TSC2117EVM-K 13Submit Documentation Feedback

2.6.7 Audio Interface
EVM + PC www.ti.com
The Audio Interface tab ( see Figure 9 ) contains controls to manipulate the digital audio interface:
Figure 9. Audio Interface
Use the Format drop down box to change the digital audio interface format:•I2S•DSP
•Right Justified•Left Justified
For details about the digital audio interface formats see the TSC2117 data sheet (SLAS550 ), 5.4 AUDIODIGITAL I/O INTERFACE.
The Word Length drop down box defines the number of bits per audio word.
The DIN/DOUT offset defines where the data for the ADC or from the DAC is located in the bit-stream.This is required for TDM (DSP) interface format.
TSC2117EVM-K 14 SLAU282 – April 2009Submit Documentation Feedback

2.6.8 Touch Screen
The Touch Screen is implemented as an active object in the block diagram for the full TSC2117 and inthe block diagram for touch screen operation . It is labeled “Touchscreen”.
www.ti.com EVM + PC
Once activated, the touch screen active object configures the TSC2117 touch screen module forConversion Mode 2 and starts polling the TSC2117 touch screen registers with a period of 50 ms.
The inside of the touch screen active object (rectangle) shows the current coordinates (X and Y) and adrawing based on touch screen input.
Figure 10. Touch Screen Active Object
To change the touch screen module parameters, click on the touch screen active object. This will displaythe touch screen dialog.
To clear the touch screen drawing, open the touch screen dialog and click on the Clear button.
SLAU282 – April 2009 TSC2117EVM-K 15Submit Documentation Feedback

2.6.9 SAR ADC Data
the block diagram for the full TSC2117 .
EVM + PC www.ti.com
The results of the SAR ADC data conversions are available in an active object labeled SAR Data within
Once activated, the SAR data active object configures the TSC2117 touch screen module for ConversionMode 9 and starts polling the TSC2117 SAR data registers with a period of 50 ms.
The inside of the SAR data active object (rectangle) shows the conversion results for IN1, IN2, BAT andTEMP.
Figure 11. SAR ADC Data
To change the SAR ADC module parameters, click on the SAR data active object. This will display theSAR ADC dialog.
TSC2117EVM-K 16 SLAU282 – April 2009Submit Documentation Feedback

2.6.10 AGC
within the block diagram for the full TSC2117 .
www.ti.com EVM + PC
The TSC2117 has an automatic gain control module, which is accessible by an active object labeled AGC
Clicking on the AGC active objects opens the AGC Dialog:
Figure 12. Automatic Gain Control
If the AGC is enabled, the TSC2117 will adjust the gain of the analog audio input signal amplifier so thatthe input signal level for input signal amplitudes above the noise threshold approximates the target level.•The main display in the AGC dialog shows the Amplitude of the ADC output data in decibel with 0dBequal to a full scale signal.•
– The target level line can be adjusted using the mouse pointer. It will change color to red if it themouse pointer is in the vicinity, indicating that it can be moved (click and drag).– The noise threshold line is also adjustable•The small display on the left shows the ADC output data•The AGC Gain field shows the applied gain (if the AGC is enabled) and allows setting a maximum gainusing the slider.
Advanced AGC controls are available by clicking the More button. This will reveal further controls to adjustvarious AGC parameters.
SLAU282 – April 2009 TSC2117EVM-K 17Submit Documentation Feedback

2.6.11 Digital Volume Control and DRC
Each is accessible by a active objects labeled DVol within the block diagram for the full TSC2117 andthe playback use case .
EVM + PC www.ti.com
The TSC2117 has digital volume control and dynamic range compression modules for each DAC channel.
Clicking on the DVol active object opens the DAC Vol dialog, which contains a slider to set the digitalvolume and several options. Checking the DRC option reveals the DRC transfer function.
Figure 13. DRC Transfer Function and DRC Dialog
The horizontal axis of the DRC transfer function shows the input to the DRC and the vertical axis showsthe output of the DRC. The green line shows the gain below the DRC threshold, the magenta coloredhorizontal line shows the DRC threshold and the red line shows the gain above the DRC threshold.
The DRC transfer function will change depending on the digital volume setting and the DRC threshold.
Click on the DRC transfer function to reveal the DRC dialog, which contains a slider to change the DRCthreshold.
TSC2117EVM-K 18 SLAU282 – April 2009Submit Documentation Feedback

3 EVM Hardware
3.1 Connectors and Jumpers
www.ti.com EVM Hardware
This chapter contains information about the EVM Hardware (switches, jumpers, schematics).
Table 1. Analog I/O
Connector Function
J1 MIC/LINE inJ2 1 IN12 IN23 IN34 AGNDJ3 1 REF2 AGNDJ5 1 LN (speaker filtered)2 LP (speaker filtered)3 RN (speaker filtered)4 RP (speaker filtered)J6 1 SPLN (speaker)2 SPLP (speaker)3 SPRN (speaker)4 SPRP (speaker)J7 1 BATT2 GNDJ8 HeadphonesJ9 Headphones (filtered)J10 1 HPL2 AGND
3 HPR
Table 2. Touch Screen
Connector Function
J4 1 Y–2 X–3 Y+4 Y–P11 10 Y–12 X–14 Y+16 Y–
Table 3. GPI
Connector Function
W19 1 GPI12 GPI23 GPI3
SLAU282 – April 2009 TSC2117EVM-K 19Submit Documentation Feedback

EVM Hardware www.ti.com
Table 4. Jumpers
Jumper Function Positions Default
W1 IOVDD select 1-2: 1.8V 1-2: 1.8V2-3: 3.3VW9 MIC bias select 1-2: TSC2117 1-2: TSC21172-3: 3.3VW10 IN1 select 1-2: ext J2 not populated2-3: on-board VW11 IN2 select 1-2: ext J2 not populated2-3: on-board VW12 IN3 select 1-2: ext J2 not populated2-3: on-board VW13 REF select 1-2: ext J3 not populated2-3: on-board VW14 HPL 16 Ωload 1-2: add load not populatedW15 HPR 16 Ωload 1-2: add load not populatedW16 HPL CAP bypass 1-2: bypass not populatedW17 HPR CAP bypass 1-2: bypass not populatedW18 Firmware select 1-2: select EVM 1-2: select EVMW19 HPL CAP bypass 1-2: bypass 1-2: TSC21172-3: 3.3VW20 Reset source 1-2: reset from USB-MODEVM not populated
Table 5. Expansion Connectors P12/J12
Pin Number Signal Description
P12.1/J12.1 NCP12.2/J12.2 NCP12.3/J12.3 SCLK SPI™ Serial ClockP12.4/J12.4 DGND Digital GroundP12.5/J12.5 NCP12.6/J12.6 NCP12.7/J12.7 SS SPI Chip SelectP12.8/J12.8 NCP12.9/J12.9 NCP12.10/J12.10 DGND Digital GroundP12.11/J12.11 MOSI SPI MOSI Slave Serial Data InputP12.12/J12.12 NCP12.13/J12.13 MISO SPI MISO Slave Serial Data OutputP12.14/J12.14 RESET TAS1020B ResetP12.15/J12.15 NCP12.16/J12.16 SCL I2C Serial ClockP12.17/J12.17 NCP12.18/J12.18 DGND Digital GroundP12.19/J12.19 NCP12.20/J12.20 SDA I2C Serial Data Input/Output
TSC2117EVM-K 20 SLAU282 – April 2009Submit Documentation Feedback