Troubleshooting DSTREAM-PT Trace

Troubleshooting problems encountered when capturing DSTREAM-PT trace


Introduction Troubleshooting Steps Platform Configuration RTM Log Analysis Check 1 Check 2 Check 3 Manual delay setting Results Example RTM Log

Platform Configuration

To enable the RTM advanced logging, the DSTREAM-PT configuration items need to be present and active in the platform configuration. How you work with and setup the configuration items is based on how the platform configuration is or was generated.

Below are the different options for the platform configuration you are working with.

Click on the below option that best fits the platform configuration you are using and follow the instructions provided:

  • If you created a new platform configuration with the Arm Development Studio Hardware Connection Wizard or the Platform Configuration Editor (PCE).

    The DSTREAM-PT configuration items will automatically by added to the platform configuration's .sdf.  However, in Arm Development Studio 2019.0, the DSTREAM-PT configuration items are not enabled by default.  To enable the DSTREAM-PT configuration items and RTM advanced logging feature, perform the following steps:

    1. Open the platform configuration .sdf as a text file.
      1. In Arm Development Studio, expand the ExtensionDB in the Project Explorer view, right-clicking on the .sdf, and selecting Open withText Editor.
    2.   Add HTML comments around the <trace_capture type="parallel"> configuration item block like below

      <!--

      <trace_capture type="parallel">

      ...

      </trace_capture>

      -->

    3. Remove the HTML comments around the <trace_capture type="DSTREAM-PT"> configuration item block (i.e delete <!-- and --> around the <trace_capture type="DSTREAM-PT"> section).
    4. Set ENABLE_ADDITIONAL_RTM_LOGGING to 1 (i.e. <config_item name="ENABLE_ADDITIONAL_RTM_LOGGING">1</config_item>).
    5. Click FileSave.
    6. If you are editing the .sdf outside Arm Development Studio, rebuild the configuration database in Arm Development Studio by clicking WindowPreferencesArm DSConfiguration DatabaseRebuild database.

    Click here for an example .sdf with the ENABLE_ADDITIONAL_RTM_LOGGING configuration item set.

    Note: If you wish to use the configuration items for the DSTREAM or DSTREAM-ST after making these changes to the .sdf, you will need to comment out the <trace_capture type="DSTREAM-PT"> configuration item block and un-comment the <trace_capture type="parallel"> configuration item block. Not performing this action might prevent the trace delay signals from being set correctly.

     

  • If you are using an existing platform configuration with a .rcf and/or .sdf file.

    Existing platform configurations might contain:

    • Just a .rcf file.
    • Just a .sdf file.
    • .rcf and .sdf files.

    Platform configurations with any of the above contents will allow the RTM advanced logging feature to be enabled.

    You need to add the DSTREAM-PT configuration items to the .rcf or .sdf.  If the platform configuration contains both a .rcf and a .sdf, the DSTREAM-PT configuration items need to be added to just the .rcf.

    To add the DSTREAM-PT configuration items and enable RTM advanced logging feature, perform the following steps:

    1. Open the platform configuration .rcf or .sdf as a text file.
      1. In Arm Development Studio, if the platform configuration is in the ExtensionDB, you can do this by expanding the ExtensionDB in the Project Explorer view, right-clicking on the .rcf or .sdf, and selecting Open withText Editor.
    2.   Add HTML comments around the <trace_capture type="parallel"> configuration item block like below

      <!--

      <trace_capture type="parallel">

      ...

      </trace_capture>

      -->

    3. Right underneath the commented out <trace_capture type="parallel"> configuration item block, copy and paste all the DSTREAM-PT configuration items from the text file here.
    4. Set ENABLE_ADDITIONAL_RTM_LOGGING to 1 (i.e. <config_item name="ENABLE_ADDITIONAL_RTM_LOGGING">1</config_item>).
    5. Click FileSave.
    6. If you are editing the .rcf or .sdf outside Arm Development Studio, rebuild the configuration database in Arm Development Studio by clicking WindowPreferencesArm DSConfiguration DatabaseRebuild database.

    Click here for an example .rcf and Click here for an example .sdf with the ENABLE_ADDITIONAL_RTM_LOGGING configuration item set.

    Note: If you wish to use the configuration items for the DSTREAM or DSTREAM-ST after making these changes to the .sdf or .rcf, you will need to comment out the <trace_capture type="DSTREAM-PT"> configuration item block and un-comment the <trace_capture type="parallel"> configuration item block.  Not performing this action might prevent the trace delay signals from being set correctly.


  • If you are using an existing platform configuration with a .rvc file.

    Platform configurations created with earlier Arm tools (like older DS-5 versions) might not contain a .sdf file, but will have a .rvc file.  To add the DSTREAM-PT configuration items to the .rvc and enable RTM advanced logging feature, perform the following steps:

    1. Open the platform configuration .rvc as a text file.
      1. In Arm Development Studio, you can do this by expanding the ExtensionDB in the Project Explorer view, right-clicking on the .rvc, and selecting Open withText Editor.
    2. Add HTML comments around the <DataList Type = "Branch"> configuration item block like below
      <!-- 

      <DataList Type = "Branch">

      ...           

      </DataList>

      -->

    3.  Add the DSTREAM-PT RTM configuration items from here after the commented out <DataList Type = "Branch"> configuration item block. 

    4. Set ENABLE_ADDITIONAL_RTM_LOGGING to 1 (i.e. <ENABLE_ADDITIONAL_RTM_LOGGING Type = "Int32">1</ENABLE_ADDITIONAL_RTM_LOGGING>).
    5. Click FileSave.
    6. If you are editing the .rvc outside Arm Development Studio, rebuild the configuration database in Arm Development Studio by clicking WindowPreferencesArm DSConfiguration DatabaseRebuild database.

    Click here for an example .rvc with the ENABLE_ADDITIONAL_RTM_LOGGING configuration item set.

    Note: If you wish to use the configuration items for the DSTREAM or DSTREAM-ST after making these changes to the .rvc, you will need to comment out the added<DataList Type = "Branch"> configuration item block and un-comment the original <DataList Type = "Branch"> configuration item block.  Not performing this action might prevent the trace delay signals from being set correctly.


Previous Next