Setting Up a System to Use the wRTOS WinDbg Extension

To create and configure the supporting directories:

To get the most out of your WinDbg session, we recommend that you create directories to store your application information in. This will make it easier for WinDbg to find everything it needs to decipher a Windows memory dump file.

  1. Create a directory on your system to store symbol files for your wRTOS debugging session. In this walk through we named the directory C:\wRTOS_SYMBOLS.
  2. Copy the PDB files for your RTSS applications and RTDLL binaries to your symbols directory.

Note: The wRTOS WinDbg Extension automatically looks for wRTOS symbols in the wRTOS SDK installation directory under \Symbols\x64\. The wRTOS SDK symbols are listed below. You do not need to manually copy them to your symbols directory.

• wRTOS_HalExt.pdb

• wRTOS_Rtss.pdb

  1. Create a directory on your system to store the source files used to generate your wRTOS applications and RTDLLs. In this walkthrough we named the directory C:\wRTOS_SOURCES.
  2. Create a directory on your system to store copies of the RTSS and RTDLL binaries (executables and RTDLLs). In this walkthrough we named the directory C:\wRTOS_IMAGES.
  3. Click Start > Debugging Tools for Windows (x64) > WinDbg to launch WinDbg.
  4. Select Symbol File Path from the File menu. Browse to the location of the symbols directory you created, then click OK. For more information, see the MSDN article Setting Symbol Paths in WinDbg at https://learn.microsoft.com/en-us/windows-hardware/drivers/debugger/setting-symbol-and-source-paths-in-windbg?redirectedfrom=MSDN.
  5. Select Source File Path from the File menu. Browse to the location of the sources directory you created and then click OK.
  6. Select Image File Path from the File menu. Browse to the location of the images directory you create and then click OK.
  7. Save the workspace (File > Save Workspace).

Note: You may want to obtain Microsoft Windows symbols. For more information, see https://learn.microsoft.com/en-us/windows/win32/dxtecharts/debugging-with-symbols?redirectedfrom=MSDN.

At this point, you can load the wRTOS WinDbg Extension commands. The wRTOS WinDbg Extension extends WinDbg by providing information about the state of the wRTOS subsystem and its applications while analyzing a crash dump. See Using WinDbg Extension Commands for more information.

Related topics: