Generating a Debug File

You can tell PC-DMIS to generate a debug file. This special text file contains all of the communication data between PC-DMIS and the CMM during measurement routine execution. A debug file can help Hexagon Technical Support resolve certain problems that involve your CMM.

The debug file lists all of the commands that PC-DMIS sends to the CMM, the responses it receives, and the error messages that the controller generates. If you encounter repeatable problems that involve the movement of your CMM in Online mode, you may want to submit that to Hexagon Technical Support.

To generate a debug file, follow this procedure:

  1. From the Machine Options dialog box (Edit | Preferences | Machine Interface Setup), select the Debug tab:

Machine Options dialog box - Debug tab when connected to non-Vision machines

Be sure to modify only the Debug tab. The other tabs on the Machine Options dialog box are used by service personnel to set up your machine.

  1. Select the Log check box.

  2. Type a name for the debug file in the box next to the Log check box. The default file name is debug.txt. You can also precede the file name with a full path to specify the drive and directory where PC-DMIS should send the debug file.

  3. Click Apply and then OK. The dialog box closes.

  4. Execute your measurement routine. When you encounter the error, immediately exit PC-DMIS.

  5. Navigate to the directory that contains your debug file.

  6. Rename the debug file. If you don't rename the debug file, the next time you start PC-DMIS, it automatically overwrites all existing data in the debug file. This results in a loss of data that may be necessary for debugging purposes.

  7. Send the debug file, measurement routine file (.prg), probe file (.prb), and any other necessary files to Hexagon Technical Support.

By default, PC-DMIS sends the debug file to the ProgramData directory. This is typically "C:\ProgramData\Hexagon\PC-DMIS\<version>", where <version> is the version of PC-DMIS you're running.

For details on the default locations for PC-DMIS files, see "Understanding File Locations".

Starting a Fresh Debug File

You can use the DebugLogReset registry entry in the Settings Editor application to specify whether to overwrite all existing data in the debug file or append new data to the file each time you execute a measurement routine. For details, refer to "DebugLogReset" in the "Option" section in the Settings Editor documentation.

Setting Additional Debug Options

You can control the type of debug information that PC-DMIS logs and where it is sent.

Vision Machine Focus Debug Option

When connected to a Vision machine, the Focus mode option is available. For details, see "Machine Options: Debug Tab" in the PC-DMIS Vision documentation.