You copied the Doc URL to your clipboard.

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 Trace Port Interface Unit (TPIU), which is further linked to the Instrumentation Trace Macrocell (ITM) Stimulus Port on the target, and by making minor changes to project_types.xml file for your board.

To use Streamline with a Cortex-M target:


  1. An operating system that emits ITM messages, for example Keil RTX RTOS, must be running on the target. When using RTX, ensure it was built with debug info and that the DBG_MSG macro is defined.
  2. Connect a DSTREAM unit to the TPIU port on your target.
  3. Make sure your target is connected to your host.


    For Streamline to be compatible with a target, there must be a DSTREAM connection for that board in the configdb that supports debug and trace.
  4. 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:


    The projects_types.xml file for a target is located in <DS-5_install_directory>/sw/debugger/configdb/Boards/<Your_Board_Type>/<Your_Board>/.

    If your target is not available in the default Debug Configuration, then you might need to create a custom Debug Configuration in a separate folder, for example, /home/user/configdb. If you do this then you might also need to copy the Scripts directory from the default location to the custom configdb location.

    This process is explained in more detail here:

  5. 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.
After following these steps, your target should appear in the Connection Browser of the Streamline Data view.