Debussy使用指南(上)2006.03.02

Debussy 入门指南（上）

ahan/阿憨

ahan.mail@

Debussy 简介

Debussy 智能调试系统改善了不同层次，门级、RTL和行为级复杂AISC和IC的调试过程。它提供了一个集成Verilog和HDL分析和调试的工具来减少整个芯片设计的时间，提高工程师的工作效率。主要部件有：

nTrace – 一个独立的层次行的源代码分析和浏览工具。

nSchema – 一个面向调试的层次性的原理图生成器。

nWave－一个无比全面的波形分析工具。

nState—一个功能强大的快速验证有限状态机功能的调试工具。

所有Debussy模块全部通过一个智能的数据库和FSDB。信号的数值状态自动链接到所有的窗口。操作直观方便，有上下文和超级链接。例如，紧密的集成环境可以让你找到一个信号的源代码或者原理图和波形图，通过把这个信号拉入源代码窗口中。

Debussy 有两种工作模式：交互模式和后处理模式。使用你设计的HDL 源代码，Debussy 可以生成FSDB（Fast Signal DataBase）。你也可以通过Debussy把VCD或者TimeMill、PowerMill 仿真结果转为FSDB。Debussy支持在读入VCD文件的时候直接转化为FSDB格式。交互模式可以让你实时的控制你的仿真并用图形调试仿真结果。后处理模式可以让你输出仿真的结果通过PLI输出到FSDB文件中。在仿真结束后再到debussy中做交互式调试。

Debussy窗口界面

Debussy是一个多窗口，用户界面简便的应用软件。它可以在Linux，Motif，OpenWindows和其他X－window的系统上运行。下面我们逐一介绍：

nTrace – 一个独立的层次形的源代码分析和浏览工具。

当你启动Debussy，nTrace会显示在中间的窗口中，作为其他窗口创建的主界面。当你在nTrace中打开一个新的设计，Debussy就会关闭存在的nWave和nSchema窗口。

Source Debug Mode（源代码调试模式）

分三个部分，层次浏览窗口，信息浏览窗口和超文本的代码窗口。超文本源代码窗口可以显示设计中的源代码和对于的原理图，这取决于观看的模式的选择。从工具栏中View->Source Code View or Schematic View下拉菜单可以切换模式。

Interactive Mode(交互模式)

通过Tool->Interactive Mode 可以进入交互模式。交互模式是从Debussy界面调用仿真器做调试，个人建议先dump 波形再到debussy做调试。

nWave－一个无比全面的波形分析工具。

窗口又分三个主要界面，信号界面，数值界面和波形界面，基本结构和 nWave

Modelsim的Waveform没有太大区别。

波形窗口中分cursor黄色的光标和Marker白色的标记，默认情况下光标只会停留在signal transition的位置，可以通过Option->Snap来改变，这样子你就可以把光标放在任何位置。在计算delta time的时候可以通过中键来使用Maker，一旦使用了Marker，在Waveform中右键就是展开两个标记之间波形的默认键。在波形窗口中可以打开多个仿真文件，但是一个时间内只有一个有效，可以通过File->Active来选择。我们可以将波形窗口的信号拉弋进入nTrace或者nSchema中，追溯信号的连接关系，或者通过双击Waveform的信号来追溯该信号的驱动源。

nSchema – 一个面向调试的层次性的原理图生成器。

原理图窗口显示了相应源代码的原理图，提供另外一个调试界面。你可以通过菜单或者鼠标进行调试。

nState—一个功能强大的快速验证有限状态机功能的调试工具。

双击原理图窗口或者nTrace窗口中的原理图中的FSM模块或者可以弹出nState 这个窗口。

到此，我们介绍完了Debussy的所有窗口和界面，及其简要的功能，下面我们将按照使用经验介绍Debussy在代码调试中的一些基本使用流程，使用技巧和特殊功能，希望能够给模块级仿真和系统验证者提供快速的入门手册。

Debussy 使用技巧

这部分我们通过一个个专题讲述如何使用Debussy，其中涉及到的例子可以在debussy的安装目录下的/demo可以找到。

（一） 如何加载设计？

方式1：命令行加载设计

> debussy –f run.f &

方式2：菜单命令加载

> debussy（运行调用debussy，出现nTrace界面）

File-> Import Design

选中From File 栏

选中run.f，点击ADD，再点击OK。

上面两种方式Debussy都会自动编译run.f中的所有源文件，而且run.f文件支持-v

这种选项，这样在调用ASIC的时候可以自动加载使用到的库元件。

编译完所有文件之后信息窗口就会显示编译信息，可以通过调用File->View

Import Log在独立的窗口查看详细的信息报告。

（二）如何调用波形窗口和加载波形文件？

nTrace中左上角（如图红色圈内）分别是波形窗口，原理图窗口和源代码窗口的启动键，点击即可启动一个新的窗口。

启动波形窗口之后，选择File->Open，就可以打开波形文件，默认方式是fsdb格式的波形文件，也可以选择vcd格式的，debussy在加载的时候自动转换格式。从nTrace 的层次窗口或者源代码窗口中选中某个模块或者某个信号（使用中键）拉弋到波形窗口中即可显示对模块的IO信号或者对应的信号。注意debussy的波形窗口默认不显示信号的层次结构。也可以通过波形窗口中的Signal－>Get Signals或者点击Get Signal图标来添加信号。

（三） 如何在波形窗口，源代码窗口中追溯信号的驱动源？

在波形窗口中我们可以通过双击信号的波形来追溯信号的驱动源，从而定位错误出现的位置。在源代码窗口中可以通过双击信号的名字来追溯该信号的驱动源。在源代码窗口中也可以通过右键菜单来实现这个功能。在窗口中选择Trace->Reset Traced Signals’s Color可以取消追溯过程中带来的信号高亮度的问题。一般情况下我们是从信号的波形图中某一时刻的波形异常处双击该波形，追溯到源代码窗口中的对应赋值语句，从而找到该时刻的驱动源。

（四）如何让波形，源代码和原理图三个窗口同步显示？

我们可以通过选择Tool->Options->Sync Signal Selection，来同步所有窗口中的信号。一旦你在nWave或者源代码窗口或者原理图窗口选择了任何一个信号，其他两个窗口也会同步显示该信号。

（五）如何反标信号数值到源代码和原理图窗口中？

在很多调试情况下，在源代码窗口显示信号或者总线的数值也有一定的好处。nTrace 提供了这样一个功能，Source->Active Annotation。信号值显示Cursor当前时刻的数值。在原理图窗口中也可以反标，Schematic->Active Annotation。

（六）如何保存当前调试的所有设置和界面？

在你启动debussy到退出debussy之前是一段很长的调试过程，你可以保存当前的调试环境，并在下次调用debussy的时候使用。Debussy自动把当前的调试环境保存在工作目录下的DebussyLog的lastSession.ses中。File->Save Session保存当前调试状态，下次启动后File->Restore Session.

（七）在波形窗口的信号名一栏中使用中键确定添加信号的切入位置。

（八）如何使用Cursor和Marker？

nWave的波形窗口中默认有一个Cursor（黄色）和一个Marker（白色），左键是Cursor，中键是Marker，在波形窗口中右键是放大Cursor和Marker之间波形的快捷键。默认情况下Cursor和Marker都是停留在信号的Transition处，你可以通过点击Wave->Snap Cursor To Transitions关闭或者启动这个功能。

（九）如何给信号起别名？

在某些情况下，为了分析方便，如分析状态机状态跳变，我们可以通过使用起别名的方法。通过使用Waveform->Signal Value Radix ->Add Alias from File或者Waveform->Signal Value Radix ->Browse Alias命令来实现。