EnergyTrace User Guide¶
EnergyTrace ™ technology is a power analyzer tool for CCS that measures the application’s current consumption. The tool can be used stand-alone as a power profiling tool, or in EnergyTrace++ mode within a debug session for code analysis to help optimize the application for ultra-low-power consumption.
EnergyTrace stand-alone Instructions¶
The following discusses the necessary steps to use EnergyTrace in stand-alone-mode on CC26X2R1 LaunchPad. In stand-alone mode, the debugger is not active and the displayed current consumption is what to expect for the final application. As opposite to EnergyTrace++ where the debug interface on the device is active and the current consumption from the debugger will be added to the displayed current.
- Flash the target device with the application to be analyzed.
- Make sure no debug session is active and click the EnergyTrace Button as seen in Figure 125.
- A dialog with instructions on how to use EnergyTrace Stand-alone Measurement
Mode will pop-up. Click
Proceed
to continue. - The first time EnergyTrace is being used within a CCS Workspace some settings
needs to be set. In the EnergyTrace Window, click on the
Advanced Menu
icon and selectPreferences
, as Figure 126. shows.
- Under
Target Connection
, setConnection
toXDS110
andVoltage
to 3300.0 mV.ET-HDR Range Selector
shall be set toLow current, narrower range higher accuracy
. If you want to save the captured data to a .cvs-file for further analysis, selectRaw data to CSV file
. You can also select the battery cell type the application will be using to get an estimated life time of the application. ClickOk
to save the preferences.
- Select how long you want to capture data by clicking the
Select Measurement Duration
button as in Figure 128.
- To start capturing data, click the green play button.
- When EnergyTrace is finished capturing data, review the application’s power profile and have a closer look in the Current graph. Figure 130. shows a zoomed-in current graph of BLE advertising.
EnergyTrace++ Instructions¶
To run EnergyTrace++, which allows more detailed data regarding power consumption, the Target Configuration file must be configured to allow for a different debugging interface. Specifically, to use EnergyTrace++, the debugger must be set to 4-pin cJTAG mode. The following discusses the necessary steps to modify the Target Configuration file and view EnergyTrace++ data on CC26X2R1 LaunchPad.
Warning
In EnergyTrace++ mode, the displayed current consists of the application current consumption AND the device debugger current consumption. Use EnergyTrace stand-alone mode to display only the application current consumption.
EnergyTrace++ Update Target Configuration Instructions¶
- In the CCS, using the Project Explorer, navigate to the
targetConfigs
folder. - Double click on the
*.ccxml
file to open a configuration menu as seen in Figure 131.
- On the bottom of the window, navigate to the
Advanced
tab as seen in Figure 132.
- In the
All Connections
windows pane, click on the highest level from the list tree as seen in Figure 133. - In the
Connection Properties
window pane, modify theJTAG/SWD/cJTAG Mode
parameter tocJTAG (1149.7) 4-pin standard mode
from the dropdown menu as seen in Figure 133.
- After selecting this option, click
Save
in the previousAll Connections
window pane. - Close the
.ccxml
file.
Using EnergyTrace++ Instructions¶
This section assumes the user has already configured their Target Configuration
settings to point use cJTAG (1149.7) 4-pin standard mode
as described in
the EnergyTrace++ Update Target Configuration Instructions section above.
- After the Build has successfully completed,
Debug
the project. - Open the EnergyTrace Tool by clicking the button seen below in Figure 134.
- On the far right of the
EnergyTrace Technology
window, click theSwitch to EnergyTrace++
button as seen in Figure 135.
- You should see an additional
States
tab popup. - Run the Debug session, click the green arrow button (F8).
- You should now be able to observe the enhanced EnergyTrace++ details in the
EnergyTrace Technology
andStates
tabs as seen in Figure 136. and Figure 137.
Troubleshooting¶
If EnergyTrace is not able to properly setup remote controls for the device, try closing CCS, resetting your Evaluation Board and starting again.