rocket diplomacy学习

Diplomacy

diplomacy是什么？

diplomacy是一个参数协商框架，用于可参数化配置拓扑结构的生成。

引用于Diplomatic Design Patterns: A TileLink Case Study。
该文档将讲解一个极简的基于diplomacy的拓扑。介绍如何构建一个可参数化配置的加法器以及配套的测试模块。

diplomatic加法器及testbench

首先描述一个电路，一个2-to-1加法器。测试结构，需要一个顶层的testbench，两个输入驱动，一个简单的模拟器。

该电路的可配置参数为数据的宽度。在参数的协商过程中，拓扑结构期望得到两个宽度相同的输入数据。如果宽度不同，从驱动器到模拟器都将使用较小的宽度进行运算。

import chipsalliance.rocketchip.config.{Config, Parameters}
import chisel3._
import chisel3.internal.sourceinfo.SourceInfo
import chisel3.stage.ChiselStage
import chisel3.util.random.FibonacciLFSR
import freechips.rocketchip.diplomacy.{SimpleNodeImp, RenderedEdge, ValName, SourceNode, NexusNode, SinkNode, LazyModule, LazyModuleImp}

参数协商及传输

在拓扑结构中，共享一个数据宽度参数。所有发送或者接受参数信息的模块必须配有一个或多个nodes。
在每对nodes之间，可能有一条或多条edges。参数协商的工作由edges完成，确保连接着的nodes间的参数同步。edges带有方向，以箭头表示其方向，由source指向sink。

diplomacy希望用户描述一个由nodes组成的有向无环图（directed acyclic multigraph），箭头的方向为downward，其反方向为upward。

参数

在该例子中，需要电路同步一个scala Int，作为数据宽度，也就是线宽。为表述的更加清晰，我们定义出明确的case class作为我们所需的参数。尽管内容有些重复，包含有相同类型的信息。

case class UpwardParam(width: Int)
case class DownwardParam(width: Int)
case class EdgeParam(width: Int)

node实现

在node implementation或者简称NodeImp中，对参数在图中如何传递以及参数如何在nodes间协商进行描述。
该例子中，我们使用SimpleNodeImp，能够完成相同参数的协商，在edge上传递相同的