TMDSEMU110-ETH

User's Guide SPRUIE1A – February 2017 – Revised August 2017 XDS110 EnergyTrace™ HDR Debug Probe Add-On The XDS110 ETHDR is an add-on expansion module to the XDS110 Debug Probe that provides an enhanced HDR (high dynamic range) EnergyTrace™ (ET) capability to the capability that exists on the base XDS110 Debug Probe. 1 2 3 Contents Overview ...................................................................................................................... 1.1 XDS110 ETHDR Feature Summary .............................................................................. 1.2 XDS110 ETHDR System Summary .............................................................................. 1.3 XDS110 ETHDR Overview ........................................................................................ 1.4 XDS110 ETHDR Parts List ........................................................................................ 1.5 PCB Breakoff Sections and Compliance ........................................................................ 1.6 Environmental Information ......................................................................................... Probe Interfaces ............................................................................................................. 2.1 USB Power Interface ............................................................................................... 2.2 Probe Expansion Header .......................................................................................... Functional Description and Operation..................................................................................... 3.1 Physical Connection ................................................................................................ 3.2 Basic Setup for the Debug Connection .......................................................................... 3.3 Energy Trace HDR ................................................................................................. 2 2 2 3 3 3 4 5 5 5 6 6 7 7 List of Figures 1 XDS110 Probe High-Level Block Diagram ............................................................................... 3 2 Expansion Header Signal Mapping 3 Stacking the ETHDR on the XDS110 Probe ............................................................................. 6 4 The XDS110 Probe and ETHDR System 5 Shunt Range Selection...................................................................................................... 9 ....................................................................................... ................................................................................ 5 6 List of Tables 1 Base ET and ETHDR Comparison ........................................................................................ 7 2 ETHDR Measurement Performance ...................................................................................... 7 Trademarks EnergyTrace is a trademark of Texas Instruments. OS X is a trademark of Apple, Inc.. Linux is a registered trademark of Linus Torvalds. Windows is a registered trademark of Microsoft Corporation. Wi-Fi is a registered trademark of Wi-Fi Alliance. SPRUIE1A – February 2017 – Revised August 2017 Submit Documentation Feedback XDS110 EnergyTrace™ HDR Debug Probe Add-On Copyright © 2017, Texas Instruments Incorporated 1 Overview 1 www.ti.com Overview The XDS110 ETHDR is an add-on expansion module to the XDS110 Debug Probe. It provides an enhanced HDR EnergyTrace (ET) capability to the capability that exists on the base XDS110 Debug Probe. 1.1 XDS110 ETHDR Feature Summary • • 1.2 Target supplied power From 1.8 V to 3.6 V – Up to 800 mA Power profiling features – Support for TI EnergyTrace HDR in two ranges: • 1 µA to 120 mA – Higher accuracy but lower peak current • 1 µA to 800 mA – Higher peak current but lower accuracy – Current sampling at 256k sample per second XDS110 ETHDR System Summary The following features are for the combined XDS110 Probe with the XDS110 ETHDR system: • Host platforms supported: – The system supports various versions of Windows®, OS X™, and Linux® operating systems. Consult the documentation for CCS and other development environments for more details. • IDE versions supported: – TI CCS v7.0 and later – IAR (see IAR documentation) – Keil (see Keil documentation) • TI platforms, devices, and ISAs supported: – MSP432 MCUs – CC26xx/13xx Wireless MCUs – CC32xx/31xx Wi-Fi® MCUs – TM4C12x MCUs 2 XDS110 EnergyTrace™ HDR Debug Probe Add-On SPRUIE1A – February 2017 – Revised August 2017 Submit Documentation Feedback Copyright © 2017, Texas Instruments Incorporated Overview www.ti.com 1.3 XDS110 ETHDR Overview Figure 1 shows a high-level diagram of the major functional areas and interfaces of the XDS110 Probe XDS110 ETHDR system. Details of these are described in Section 2. Figure 1. XDS110 Probe High-Level Block Diagram 1.4 XDS110 ETHDR Parts List The XDS110 ETHDR system consists of the following hardware: • The XDS110 ETHDR add-on pod • USB cable (only used for auxiliary power to the ETHDR) 1.5 PCB Breakoff Sections and Compliance The different sections of the EVM may be broken apart for ease of prototyping and development. Note that breaking apart the sections voids the warranty. In addition, the stated performance and compliance specifications of the EVM cannot by guaranteed when sections have been broken apart. If provided, the shielded USB cable is longer than 3m in length. If not, and one is to be purchased for use with this EVM, it is required to be no logner than 3m to retain the stated performance and compliance. SPRUIE1A – February 2017 – Revised August 2017 Submit Documentation Feedback XDS110 EnergyTrace™ HDR Debug Probe Add-On Copyright © 2017, Texas Instruments Incorporated 3 Overview www.ti.com CAUTION This debug probe contains components that can potentially be damaged by electrostatic discharge. Always transport and store the debug probe in the supplied ESD bag when not in use. Handle using an antistatic wristband. Operate on an antistatic work surface. For more information on proper handling, refer to Electrostatic Discharge (ESD) (SSYA010). 1.6 Environmental Information Supply voltage: 4.75 V to 5.5 V at 500 mA Temperature: 0°C to 40°C Humidity: 50% RH 4 XDS110 EnergyTrace™ HDR Debug Probe Add-On SPRUIE1A – February 2017 – Revised August 2017 Submit Documentation Feedback Copyright © 2017, Texas Instruments Incorporated Probe Interfaces www.ti.com 2 Probe Interfaces 2.1 USB Power Interface Additional power for the XDS110 ETHDR add-on is provided through a female Micro-USB B-type connector. The USB interface provides additional power to the entire system, and no additional functionality. For target systems drawing more than 400 mA, connect this USB connector to a power source providing at least 500 mA at 5 V DC. 2.2 Probe Expansion Header The XDS110 ETHDR interfaces to the XDS110 system through the probe expansion header. The header exposes a number of functional interfaces of the TM4C129 debug control CPU, as shown in Figure 2. The use of these signals is reserved for the ETHDR or other add-on modules designed by TI, or designated third parties. 2.2.1 Physical Connection for the Expansion Interface The XDS110 ETHDR supports a 30-pin IDC male socket with .100-inch pitch. The signal mapping for this connection can be found in Figure 2. Figure 2. Expansion Header Signal Mapping SPRUIE1A – February 2017 – Revised August 2017 Submit Documentation Feedback XDS110 EnergyTrace™ HDR Debug Probe Add-On Copyright © 2017, Texas Instruments Incorporated 5 Functional Description and Operation www.ti.com 3 Functional Description and Operation 3.1 Physical Connection The XDS110 ETHDR is connected to the XDS110 Debug Probe by stacking the enclosures, as shown in Figure 3 and Figure 4. Figure 3. Stacking the ETHDR on the XDS110 Probe Figure 4. The XDS110 Probe and ETHDR System 6 XDS110 EnergyTrace™ HDR Debug Probe Add-On SPRUIE1A – February 2017 – Revised August 2017 Submit Documentation Feedback Copyright © 2017, Texas Instruments Incorporated Functional Description and Operation www.ti.com The target power and debug connections are managed through the existing debug and AUX connectors on the XDS110 Probe. No direct connection between the ETHDR and the debug target exists. 3.2 Basic Setup for the Debug Connection The presence of the XDS110 ETHDR does not impact the basic debug connectivity of the system, and the instructions in Section 3.1 of the XDS110 Debug Probe Users Guide (SPRUI94) are still valid. 3.2.1 Probe Supplied Power and ETHDR The addition of the ETHDR enables the XDS110 Debug Probe to supply current up to 800 mA. No additional steps are required to support this, and the power configuration steps in Section 3.1.2.2. of the XDS110 Debug Probe Users Guide (SPRUI94) are still valid. 3.3 Energy Trace HDR 3.3.1 Introduction When combined with the XDS110 Debug Probe, the XDS110 ETHDR provides an enhanced system that can be used for measuring the current consumption of the target. These current consumption measurements can be used to develop power and energy use profiles of the target system. The ETHDR expands the ET capabilities of the XDS110 Debug Probe, and these may be required for higher current use cases, or when precise temporal correlation of power transitions is required. Table 1 shows a high level comparison of the capabilities of the two ET capture types. Table 1. Base ET and ETHDR Comparison 3.3.2 Capability Base ET on XDS110 Probe ETHDR Measurement range 500 nA to 100 mA • 1 µA to 120 mA – low current high accuracy • 1 µA to 800 mA – high current range lower accuracy range Sampling frequency 2 ksps 256 ksps Supply ripple Some ripple due to SW DCDC None Specifications Other than accuracy and sampling frequency, the specifications for a system utilizing the XDS110 ETHDR are identical to the ET specifications found in the XDS110 Debug Probe Users Guide (SPRUI94). 3.3.2.1 Accuracy Table 2 lists the accuracy and range of the ETHDR. Table 2. ETHDR Measurement Performance Low Range High Accuracy 3.3.2.2 High Range Low Accuracy Range Accuracy Range Accuracy 1 µA to 15 µA ±700 nA 1 µA to 70 µA ±3.5 µA 15 µA to 120 mA ±5% 70 µA to 800 mA ±5% Sampling Frequency The XDS110 ETHDR samples target current consumption a 256k samples per second. Thus, the system can reliably catch target power transitions that last 10 microseconds or longer. 3.3.3 Hardware Setup Other than the stacked connection of the XDS110 Probe and the XDS110 ETHDR, the hardware setup is identical to that which is described in Section 3.1 of the XDS110 Debug Probe Users Guide (SPRUI94). SPRUIE1A – February 2017 – Revised August 2017 Submit Documentation Feedback XDS110 EnergyTrace™ HDR Debug Probe Add-On Copyright © 2017, Texas Instruments Incorporated 7 Functional Description and Operation 3.3.4 www.ti.com XDS110 ETHDR Usage in Code Composer Studio When the XDS110 ETHDR is attached to the XDS110 Debug Probe, the ETHDR is used as the power measurement system. The procedure for configuring an ET session, capturing, and displaying data are identical to that defined in Section 3.6 of the XDS110 Debug Probe Users Guide (SPRUI94), with the exception noted below. 3.3.4.1 CCS Setup for ETHDR The ETHDR supports two capture ranges, as noted above. The selection changes the size of the shunt resistor used to measure the target current consumption. The desired range must be specified in the EnergyTrace Technology Preferences dialog that is reached through CCS → Advanced Tools → EnergyTrace Technology. Figure 5 shows this dialog, and highlights the selection radio buttons. 8 XDS110 EnergyTrace™ HDR Debug Probe Add-On SPRUIE1A – February 2017 – Revised August 2017 Submit Documentation Feedback Copyright © 2017, Texas Instruments Incorporated Functional Description and Operation www.ti.com Figure 5. Shunt Range Selection 3.3.5 XDS110 ETHDR Usage Usage With Command Line Utility – soctune The Windows-based CCS installation has an interactive command line utility called stune which can be used for capturing EnergyTrace data to a CSV file. The procedure for using stune is the same as defined in Section 3.6.5 of the XDS110 Debug Probe Users Guide (SPRUI94), with the addition that the ETHDR capture range can be specified using the range option –r “lo | hi” with the energytrace command. The “lo” range selection maps to “Low current, narrower range higher accuracy” and the “hi” range selection maps to “High current, wider range lower accuracy”. If the range option is not specified, the range is set to “lo” by default. SPRUIE1A – February 2017 – Revised August 2017 Submit Documentation Feedback XDS110 EnergyTrace™ HDR Debug Probe Add-On Copyright © 2017, Texas Instruments Incorporated 9 Functional Description and Operation www.ti.com For example: To capture 5 seconds of EnergyTrace with the range set to low range enter the following command: energytrace -D 5000 -o output.csv -r lo et The –D option specified the time in milliseconds. The –o option specifies the output filename. The file format is fixed as CSV. The –r option specifies the range low (lo) or high (hi). To capture 5 seconds of EnergyTrace with the range set to high range enter the following command: energytrace -D 5000 -o output.csv -r hi et The –D option specified the time in milliseconds. The –o option specifies the output filename. The file format is fixed as CSV. The –r option specifies the range low (lo) or high (hi). 10 XDS110 EnergyTrace™ HDR Debug Probe Add-On SPRUIE1A – February 2017 – Revised August 2017 Submit Documentation Feedback Copyright © 2017, Texas Instruments Incorporated Revision History www.ti.com Revision History NOTE: Page numbers for previous revisions may differ from page numbers in the current version. Changes from Original (February 2017) to A Revision .................................................................................................. Page • • • • • Removed XDS110 ETHDR Performance section. .................................................................................... Added PCB Breakoff Sections and Compliance section. ............................................................................ Added Environmental Information section. ............................................................................................ Updated ETHDR Measurement Performance table. ................................................................................. Added XDS110 ETHDR Usage Usage With Command Line Utility – soctune section. ......................................... SPRUIE1A – February 2017 – Revised August 2017 Submit Documentation Feedback Copyright © 2017, Texas Instruments Incorporated Revision History 2 3 4 7 9 11 IMPORTANT NOTICE FOR TI DESIGN INFORMATION AND RESOURCES Texas Instruments Incorporated (‘TI”) technical, application or other design advice, services or information, including, but not limited to, reference designs and materials relating to evaluation modules, (collectively, “TI Resources”) are intended to assist designers who are developing applications that incorporate TI products; by downloading, accessing or using any particular TI Resource in any way, you (individually or, if you are acting on behalf of a company, your company) agree to use it solely for this purpose and subject to the terms of this Notice. TI’s provision of TI Resources does not expand or otherwise alter TI’s applicable published warranties or warranty disclaimers for TI products, and no additional obligations or liabilities arise from TI providing such TI Resources. TI reserves the right to make corrections, enhancements, improvements and other changes to its TI Resources. You understand and agree that you remain responsible for using your independent analysis, evaluation and judgment in designing your applications and that you have full and exclusive responsibility to assure the safety of your applications and compliance of your applications (and of all TI products used in or for your applications) with all applicable regulations, laws and other applicable requirements. You represent that, with respect to your applications, you have all the necessary expertise to create and implement safeguards that (1) anticipate dangerous consequences of failures, (2) monitor failures and their consequences, and (3) lessen the likelihood of failures that might cause harm and take appropriate actions. You agree that prior to using or distributing any applications that include TI products, you will thoroughly test such applications and the functionality of such TI products as used in such applications. TI has not conducted any testing other than that specifically described in the published documentation for a particular TI Resource. You are authorized to use, copy and modify any individual TI Resource only in connection with the development of applications that include the TI product(s) identified in such TI Resource. NO OTHER LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE TO ANY OTHER TI INTELLECTUAL PROPERTY RIGHT, AND NO LICENSE TO ANY TECHNOLOGY OR INTELLECTUAL PROPERTY RIGHT OF TI OR ANY THIRD PARTY IS GRANTED HEREIN, including but not limited to any patent right, copyright, mask work right, or other intellectual property right relating to any combination, machine, or process in which TI products or services are used. Information regarding or referencing third-party products or services does not constitute a license to use such products or services, or a warranty or endorsement thereof. Use of TI Resources may require a license from a third party under the patents or other intellectual property of the third party, or a license from TI under the patents or other intellectual property of TI. TI RESOURCES ARE PROVIDED “AS IS” AND WITH ALL FAULTS. TI DISCLAIMS ALL OTHER WARRANTIES OR REPRESENTATIONS, EXPRESS OR IMPLIED, REGARDING TI RESOURCES OR USE THEREOF, INCLUDING BUT NOT LIMITED TO ACCURACY OR COMPLETENESS, TITLE, ANY EPIDEMIC FAILURE WARRANTY AND ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT OF ANY THIRD PARTY INTELLECTUAL PROPERTY RIGHTS. TI SHALL NOT BE LIABLE FOR AND SHALL NOT DEFEND OR INDEMNIFY YOU AGAINST ANY CLAIM, INCLUDING BUT NOT LIMITED TO ANY INFRINGEMENT CLAIM THAT RELATES TO OR IS BASED ON ANY COMBINATION OF PRODUCTS EVEN IF DESCRIBED IN TI RESOURCES OR OTHERWISE. IN NO EVENT SHALL TI BE LIABLE FOR ANY ACTUAL, DIRECT, SPECIAL, COLLATERAL, INDIRECT, PUNITIVE, INCIDENTAL, CONSEQUENTIAL OR EXEMPLARY DAMAGES IN CONNECTION WITH OR ARISING OUT OF TI RESOURCES OR USE THEREOF, AND REGARDLESS OF WHETHER TI HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. You agree to fully indemnify TI and its representatives against any damages, costs, losses, and/or liabilities arising out of your noncompliance with the terms and provisions of this Notice. This Notice applies to TI Resources. Additional terms apply to the use and purchase of certain types of materials, TI products and services. These include; without limitation, TI’s standard terms for semiconductor products http://www.ti.com/sc/docs/stdterms.htm), evaluation modules, and samples (http://www.ti.com/sc/docs/sampterms.htm). Mailing Address: Texas Instruments, Post Office Box 655303, Dallas, Texas 75265 Copyright © 2017, Texas Instruments Incorporated