Connecting to a Cortex®-M device using DSTREAM
You can capture data for Streamline on a Cortex-M device by connecting a DSTREAM unit to the Instrumentation Trace Macrocell (ITM) Stimulus Port on the target and making minor changes to project_types.xml file for your board.
To connect Streamline to a Cortex-M target:
- Build the RTX library with debug info and the preprocessor define DBG_MSG. ITM instrumentation requires this.
- Connect a DSTREAM unit to the ITM port on your target.
Make sure your target is connected to your host.
NoteFor Streamline to be compatible with a target, there must already be a DSTREAM connection for that board in the configdb that supports debug and trace.
Add the following lines of code to the project_types.xml for your
board at the end of the activity XML node that corresponds to the DSTREAM debug
and trace connection:
<streamline_setup_script> <name>CDB://../../../Scripts/streamline_setup_script_m3.py</name> <arguments></arguments> </streamline_setup_script>
The projects_types.xml file for a target is located in <
Open this file and add the above lines to the DSTREAM
activitynode. If your target is not available in the default Debug Configuration, then you may need to create a custom Debug Configuration in a separate folder. For example, /home/user/configdb.
This process is explained in more detail here:
- Reset the target after a capture starts in order to enable RTX to output the ITM task switch information. Task names are only emitted over ITM at the time of the task creation.