NetBurner 3.1
Task Scan

TaskScan is an network connected debugging tool that can be used to view the RTOS tasks and status of your running NetBurner application. This tool is unique in that it is active in the release build of your code, rather than the debug build which is compiled without optimization. It is very useful to determine such things as why a specific task is not running the way you had anticipated, if it is waiting on other tasks, and its call stack. TaskScan is only active when the PC program generates a request, so it will not impact your release code execution speed otherwise.

The init() function will automatically include taskmon.h and call EnableTaskMonitor(). TaskScan requires that you have the Executable and Linking Format (ELF) file for the specific application that is running on your NetBurner device. The .elf file is created by the compiler each time you build your application. It contains information TaskScan needs to link the application executable to the source code and task information. For example, if you have a project named MyProject, a file named MyProject.elf will be created.

TaskScan is commonly used for:

  • Determining which tasks are running, their state and call stack.
  • Looking for blocked tasks.

TaskScan can be started from:

  • From the Windows NetBurner program group
  • From a command line. The path is: .exe

TaskScan FAQ

  • You must have a valid IP address and mask that can communicate with your PC that is running TaskScan
  • TaskScan essentially takes a snapshot picture of what your application is doing at the time your press the Scan button. It does not otherwise impact the application
  • You must have the exact .elf file used to create the application that is running on your NetBurner device to get valid information


After starting the Task Scan application use the Browse button to locate your project's elf file, and the Find button to locate the IP address.

TaskScanStart.jpg
Starting Task Scan

Then select the Scan button:

TaskScanResult.jpg
Scan Results


TaskScanKey.jpg
Task Scan Icons