Debussy基本操作（包括怎么打开hierarchy）

Debussy的基本操作(一， nTrace)

http://blog.sina.com.cn/s/blog_72c14a3d01015p46.html

Debussy是Novas公司提供的在IC设计中得到广泛应用的debug工具。最初的时候，Debussy有unix/linux和window版本的，但大概在2005年之后，Novas就只推出unix/linux的版本了，而且后面软件的名字也改了。

Debussy是非常好用的一个debug工具，在IC设计行业里，是大名鼎鼎的，在我做设计的这么多年里，几乎每天都会用到。但由于在FPGA行业里，很多从业人员都是在window环境下做开发，再加上对Debussy不是很熟悉，所以用它做Debug的人的比例并不是太高，特别是FPGA的初学者。

我比较推荐用modelsim（或者其他的一种仿真工具）做仿真（通过引用debussy的api函数，dump波形），用debussy做debug的FPGA设计流程。关于modelsim+Debussy的仿真、debug流程我在另外一个文章里做了比较详细的介绍，这里不再涉及相关的内容，只是介绍windows下，Debussy软件的一些常用的操作。

Debussy实际上是由下面几个相对独立但又可以相互联系的模块构成的：

nTrace：用来trace信号的load或者driver。

nWave：用来打开后缀为fsdb的波形文件，查看信号的波形。

nSchema： 用来查看设计的原理图。

nState： 用来查看状态机的状态。

需要注意的是，windows环境下，打开软件时，默认打开的是nTrace。然后可以在nTrace的界面里，通过菜单打开其他的模块。

先说nTrace。

打开Debussy软件（如果你不知道怎么安装，怎么打开软件的话，那就先搞定这些再说了），会出现如下的界面：

软件的界面跟其他很多windows下面的软件界面没啥区别。上边的是菜单栏，快捷菜单什么的。左边是design的层次列表窗口，右边是对应design模块的代码窗口。下边是log信息窗口。但因为刚刚打开软件，还没有载入design，所以我们什么也看不到。

首先第一步我们要做的是，加载design。File -> Import Design，选择From File。看下面的对话框。从左下角的窗口里选择design所在的目录，然后从右下角的窗口里选择要加载的design文件并双击之，文件会出现在Design Files的框里，然后单击OK按钮，design就被加载到软件里了。

这个时候软件会进入下面的界面。可以看到，三个窗口都有了对应的信息。

再回过头来说可以加载到软件中的design文件。如果你所有的design都在一个文件里，比如说verilog文件（扩展名为.v），那么你直接把这个文件加载进去就可以。如果你的design是分布在多个文件里的，那么你可以一次把所有的design都选择上，然后加载。那还有一种方法就是在一个扩展名为.f的文件里把所有的design文件（包括某些IP的库）列出来（可以是绝对路径，也可以是相对路径），然后加载这个.f文件。在上面的操作中，我们实际上就是加载一个包含了所有design文件的run.f文件。run.f文件的内容如下：

加载design文件以后，在左边的窗口里，显示出来的是整个design的层次列表。这个是软件根据你加载的文件，自动给整理出来的。

如果你需要看design中哪一个层次模块，就在这个窗口里双击这个模块。双击以后，该模块的内容就在右边的窗口里显示出来了，比如我们双击UART，那么右边窗口就会出现UART 模块的内容。如下图所示：

如果你的design的层次模块很多，用下拉菜单找起来很不方便，但你却对design非常熟悉。那么你可以在左边的窗口里点鼠标右键，选择Show Navigation EditBox或者直接Ctrl+s快捷键，结果是在左边窗口的上方，出现一个编辑框，在这里你可以直接输入你要查看的模块的层次结构，具体的效果你可以按这个步骤试一试。如下图所示：

如果你要查找uart这个模块里的某一个信号，比如TX_CLK，那么你就先在层次列表里找到UART，双击之，使之内容显示在右边列表里，然后在查找对话框里输入TX_CLK，最后点查找（向上或者向下）。这个时候，就会依次高亮显示uart中出现的TX_CLK。你也可以把鼠标放到一个信号上，然后按鼠标中键，一直按着不放，把信号拖到查找框里，最后放开中键，这个时候，你选中的信号就到了查找框里了，可以省去你输入信号的功夫了。另外就是你查找一个信号以后，这个信号会留存在查找框里，下次你再查找这个信号的话，也可以直接在查找框的下拉列表里选择这个信号。

其实nTrace的一个最重要也是最优秀的功能就是可以自动trace一个信号的driver和load。如果我们想知道UARTSM的driver，那么我们直接双击UARTSM就可以了。双击以后，首先右边窗口会转移到UARTSM的driver的语句上，在窗口左侧有标记显示出来。

这里UARTSM有两个driver，都给显示出来了。那如果一个信号有很多个driver，一屏幕显示不出来，那么，会显示出最先找到的一个。我们可以从下面的log窗口里查看其他driver的信息，如下图。这里给出了UARTSM的两个driver的信息，并给出了统计数据。如果我们要看某一个driver的代码，直接在log窗口双击该driver，你可以试一下看看有什么效果。

如果你要看一个信号的load，那么把鼠标放到这个信号上，然后右键，选择trace load，那么这个时候，窗口里就会显示出该信号的load。因为很多情况下，信号的load会有很多，那么这个时候一屏幕是很难显示出来的，所以更重要的就是看下面的log窗口了，这里也会列出来所有的load。比如下图:

通过上面的介绍，你就会发现，在nTrace里通过trace信号driver和load的动作，可以很方便的弄清楚信号之间的连接关系，对于debug来讲，是非常有效的。