{"id":4418,"date":"2018-11-19T16:39:54","date_gmt":"2018-11-20T00:39:54","guid":{"rendered":"https:\/\/visualgdb.com\/w\/?p=4418"},"modified":"2018-11-19T17:03:58","modified_gmt":"2018-11-20T01:03:58","slug":"profiling-rtx-based-projects-with-the-instrumenting-profiler","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/arm\/keil\/rtx\/instrumentation\/","title":{"rendered":"Profiling RTX-based Projects with the Instrumenting Profiler"},"content":{"rendered":"

This tutorial shows how to profile the RTX-based projects built\u00a0with the Keil compiler using the\u00a0VisualGDB’s instrumenting profiler. Before you begin, install VisualGDB 5.4\u00a0Preview 10 or later and create a basic RTX-based project by following this tutorial<\/a>.<\/p>\n

The instrumenting profiler works by patching\u00a0some, or all of the\u00a0functions in your program so that they report their run times to VisualGDB.\u00a0This provides more accurate and detailed results compared to the sampling profiler, but also results in higher run-time overhead, as the run time of each instrumented function\u00a0needs to be measured separately.<\/p>\n

    \n
  1. Open the project in Visual Studio and select Analyze->Analyze Performance with VisualGDB: \"01-analyze\"<\/a><\/li>\n
  2. If you have not\u00a0profiled this project before, VisualGDB will suggest automatically referencing the Embedded Profiler framework. Proceed by\u00a0pressing “Yes”:
    \n    \"02-addref\"<\/a><\/li>\n
  3. Open VisualGDB Project Properties and go to the Embedded Frameworks page. As configuring the sampling profiler requires extra steps, we will disable it in this tutorial by checking “Exclude sampling profiler code”. Also set RTOS support to “Keil RTX”:
    \n    \"04-profiler\"<\/a><\/li>\n
  4. Open the main file of your project, include the <SysprogsProfiler.h><\/strong> file and call InitializeInstrumentingProfiler()<\/strong> from the main()<\/strong> function after you configure the system clock:
    \n    \"06-built\"<\/a><\/li>\n
  5. Depending on the version of RTX you are using, you may encounter a “missing thread_switch_helper()<\/strong>” error. If this happens, follow the instructions in this tutorial<\/a> to patch the\u00a0RTX\u00a0interrupt\u00a0handler so that VisualGDB will be able to profile\u00a0low-level RTX functions.<\/li>\n
  6. Click Analyze->Analyze Performance with VisualGDB<\/strong> again, then click “Enable relocation record generation”:
    \n    \"07-reloc\"<\/a><\/li>\n
  7. Click\u00a0“Analyze Performance with VisualGDB” again. Now you will be able to select the functions you would like to profile (VisualGDB will automatically exclude the functions that cannot be profiled). Click “OK” to begin profiling:
    \n    \"08-instrument\"<\/a><\/li>\n
  8. If you are using the default RTX configuration, the initial profiling session will result in an error:
    \n    \"09-error\"<\/a><\/li>\n
  9. Stopping the program in debugger will quickly reveal that RTX has detected a stack underflow:
    \n    \"10-stack\"<\/a><\/li>\n
  10. This can be easily fixed by increasing the RTX dynamic memory size and then\u00a0increasing the sizes of each thread you would like to profile (VisualGDB automatically excludes the idle thread). Add “OS_DYNAMIC_MEM_SIZE=16384” to the preprocessor macros and\u00a0set the “.stack_size = 4096” attribute in the thread1_attr<\/strong> and thread2_attr<\/strong> structures:
    \n    \"11-memsize\"<\/a><\/li>\n
  11. Build the project and start another\u00a0profiling session. VisualGDB will now show\u00a0the real-time call tree for each of the threads, including the number of calls and the time spent in each of the called functions:
    \n    \"12-profilerdata\"<\/a><\/li>\n
  12. You can\u00a0analyze the stack overhead of the VisualGDB’s profiler by setting a breakpoint in the WriteRawFastSemihostingData() function and using the\u00a0debug stack view in Embedded Memory Explorer:
    \n    \"13-stackoverhead\"<\/a>Note that\u00a0this will only show the overhead (size required by the\u00a0profiler\u00a0framework functions), as the gdb debugger won’t be able to unwind the stack past the ReturnHook()<\/strong> function and show the actual stack.<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"

    This tutorial shows how to profile the RTX-based projects built\u00a0with the Keil compiler using the\u00a0VisualGDB’s instrumenting profiler. Before you begin,<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[27],"tags":[53,147,109,175],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/4418"}],"collection":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/comments?post=4418"}],"version-history":[{"count":1,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/4418\/revisions"}],"predecessor-version":[{"id":4431,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/4418\/revisions\/4431"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=4418"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=4418"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=4418"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}