调试信息工具使用说明.docVIP

调试信息工具使用说明 一．调试信息工具简介 调试信息工具的主要功能是显示、保存和打印组态王开发环境和运行环境运行过程中，驱动程序内部的调试输出信息，便于程序员、测试员和客户分析、解决驱动程序运行过程中出现的问题。 调试信息工具最重要的功能是实现调试信息的过滤显示。可以通过设置的驱动名称和调试信息类别，有选择的显示需要的信息，以利于分析和解决驱动的问题。 同时驱动信息工具还能支持定时保存为rtf文本的功能，方便将信息导出。 调试信息工具需要和驱动开发包2.0.3.2版本配合使用。 二．调试信息工具界面 主界面 调试信息工具的主界面如上图所示。主界面主要包括菜单栏和视图区。视图区显示接收到的驱动信息。 菜单栏 菜单栏主要包括：文件、编辑、查看和打印等几项。以下将主要介绍文件和查看菜单项。 文件：打开配置文件：载入调试信息工具配置文件。 保存配置文件：保存调试信息工具配置文件。 另存信息文件：保存调试信息工具信息文件。 设置存储参数：打开存储设置对话框，设置相关参数。 设置过滤参数：打开信息显示过滤设置对话框，设置相关参数。 查看：开始显示：打开显示开关，开始显示驱动发出的信息。 清除信息：清除视图区中显示的信息。 设置对话框 （1）存储参数设置 存储参数设置如上图所示。需要注意的是，存储参数有信息文件的存储参数和配置文件的存储参数。 其中信息文件的存储路径默认为调试信息工具的当前运行路径，名称默认为KVMess.rtf。可以点击右边的浏览按钮更改存储路径。 信息文件的存储参数中： 每隔×小时保存到文件，指从调试信息工具运行起×小时保存当前视图区的调试信息到信息文件。 超过×M保存为另一文件，指信息文件超过×M大小，就另创建一个文件保存信息，文件名称默认为当前名称后数字加1。如当前信息文件名KVMess.rtf，新文件名就是KVMess1.rtf，再下一文件名为KVMess2.rtf。 配置文件的存储参数中： 保留×天以内的信息，指保留从配置文件创建起×天的信息可以保存。超过×天的信息，视图区将自动删除信息，并且提示保存信息。 （2）显示过滤配置 显示过滤设置如上图所示。 驱动名称为需要显示信息的驱动的名称，和驱动开发的约定一般是驱动动态库的名称（不包括扩展名）。 显示类别为固定的信息类别，包括：接口流程信息，函数流程信息，通讯数据信息，函数内部信息，异常错误信息，自定义信息，远调工具信息。分别以1-7的代码表示。 选择类别为选中要显示的类别信息。选择类别以“类别代码”＋“，”＋“类别代码”的格式显示。如“1,2,5”。 选择类别可以通过显示类别组合框右边的按钮添加。其中，点击“＋”按钮将增加单个类别，点击“A”按钮将增加全部固定类别。 选择类别也可以通过输入的方式添加。注意输入的格式要符合类别信息格式要求。 除了输入固定调试信息类别外，也可以输入自定义的类别。注意类别码应为数字。 是否显示选项说明是否显示该驱动显示项的信息。默认为显示。 在显示配置设置中，可以增加多个驱动显示设置项。注意驱动名称不能重复。 添加、删除、修改按钮的功能分别为增加驱动、删除和修改显示设置项。 对话框下部的列表框即显示当前设置的所有驱动显示设置项。 三．调试信息工具文件说明 调试信息工具配置文件：调试信息工具本身的配置文件，将记录存储设置和过滤设置的信息，以及视图区显示的调试信息。 调试信息工具信息文件：导出的rtf格式的信息文本。包含所有视图区显示的调试信息。 四．调试信息工具使用说明 以下将简要数据调试信息工具的使用步骤 设置过滤参数 首先，应当设置显示信息的过滤参数。 点击菜单项文件―设置过滤参数，弹出显示过滤设置对话框。输入驱动名称，选择或者输入显示类别。点击增加，即可增加此驱动显示设置项。同时，下面的列表框中将进行显示。 调试信息工具支持运行过程中修改信息过滤参数。 开始显示信息 调试信息工具有显示信息的开关。默认初始运行时，此开关为关闭。 信息显示过滤参数设置完后，点击菜单项查看－开始显示，即开始可以采集调试信息。调试信息接收到后，将在视图区从上至下进行显示。 信息显示说明 信息显示的格式为： 时间 信息类别 驱动名称：具体信息 如：2006-03-22 17:30:55:374 [IMPL] DriverTestPro:Client Test。 调试信息工具提供了两种方法来区分不同类别的信息。一种是显示的颜色，一种是加入信息类别。如图所示为所有固定类别的信息的显示示例。 信息类别名称依次为：[IMPL]，[FUNC]，[DATA]，[DETL]，[ERRO]，[USER]，[RMDB]，[OTHR]。 退出调试信息工具，需要先停止显示，然后才能退出。否则将会出