15.3.5 DTSL script

The DTSL script defines the DTSL options using a set of static methods. The option definitions must be available before creating an instance of the configuration class.
To display and modify the DTSL options before connecting, use the Eclipse launcher panel. To display and modify the DTSL options during a DS-5 debug session, use the command line or the Debug Control view.
In Windows 7, the DTSL options values are persisted in your workspace under the directory C:\Users\<user>\Documents\DS-5 Workspace\.metadata\.plugins\com.arm.ds\DTSL. In this directory there is a sub-directory for the platform, in which there is another sub-directory for the debug operation. Within the debug operation directory there are one or more .dtslprops files, whose names match the names option sets in the DTSL Options Dialog. These files are standard Java properties files. The following is the default properties file for the Keil MCBSTM32E Platform, Bare Metal Project, Debug and Trace Debug operation:
options.ETM.cortexM3coreTraceEnabled=true
options.ITM.itmTraceEnabled=true
options.ITM.itmTraceEnabled.itmowner=Target
options.ITM.itmTraceEnabled.itmowner.target.targetITMATBID=2
options.ITM.itmTraceEnabled.itmowner.debugger.DWTENA=true
options.ITM.itmTraceEnabled.itmowner.debugger.PRIVMASK.[15\:8]=true
options.ITM.itmTraceEnabled.itmowner.debugger.PRIVMASK.[23\:16]=true
options.ITM.itmTraceEnabled.itmowner.debugger.PRIVMASK.[31\:24]=true
options.ITM.itmTraceEnabled.itmowner.debugger.PRIVMASK.[7\:0]=true
options.ITM.itmTraceEnabled.itmowner.debugger.STIMENA=0xFFFFFFFF
options.ITM.itmTraceEnabled.itmowner.debugger.TSENA=true
options.ITM.itmTraceEnabled.itmowner.debugger.TSPrescale=none
options.traceBuffer.traceCaptureDevice.clearTraceOnConnect=true
options.traceBuffer.traceCaptureDevice.startTraceOnConnect=true
options.traceBuffer.traceCaptureDevice.traceWrapMode=wrap
options.traceBuffer.traceCaptureDevice=DSTREAM		
The names of the options exactly match the name hierarchy defined in the DTSL script (see the full DTSL script source code to create the configuration options).
When DS-5 Debugger displays the options, it calls the getOptionList() method in the DTSL configuration class to retrieve a data description of the options. It matches these options with the persisted values from the .dtslprops file and transforms this data into an interactive dialog type display for the user. When the user saves the options, the .dtslprops file is updated. After the DTSL configuration instance is created, DTSL calls the optionValuesChanged() method to inform the instance of the configuration settings values. During the debug session, the user can change any option which is marked with an isDynamic=True property.
Related reference
15.6 DTSL options
Non-ConfidentialPDF file icon PDF versionARM DUI0446W
Copyright © 2010-2015 ARM. All rights reserved.