Rocket - tilelink - WidthWidget

Posted 2022-10-06 wjcdx

https://mp.weixin.qq.com/s/pmJcsRMviJZjMwlwYw6OgA

 

简单介绍WidthWidget的实现。

 

??

 

1. 基本介绍

 

用于设定与上游节点连接的数据总线的宽度。根据上下游数据总线宽度的大小关系，在转发消息时进行组合和拆分处理。

 

类参数innerBeatBytes是指与上游节点连接的数据总线所占的字节数：

??

 

2. diplomacy node

 

diplomacy node用于与上下游节点连接，并协商参数。

 

TLWidthWidget的diplomacy node是一个适配器节点：

??

其中：

a. clientFn：用于把TLWidthWidget看到的上游节点的参数，转换为下游节点看到的TLWidthWidget的参数；这里没有变化；

b. managerFn：用于把TLWidthWidget看到的下游节点的参数，转换为上游节点看到的TLWidthWidget节点的参数；这里把beatBytes设定为innerBeatBytes，即上游节点看到TLWidthWidget节点支持的数据总线的宽度是innerBeatBytes个字节；

 

3. lazy module

 

lazy module用于实现内部逻辑。这里主要是适配上下游节点数据总线不同导致的问题，即根据上下游数据总线宽度的大小关系，在转发消息时进行组合和拆分处理。

 

??

 

1) 成对的输入边和输出边

 

??

 

2) 处理channel a/d：

 

??

 

3) 处理channel b/c/e：

 

如果支持Cache，则进行组合或拆分：

??

 

4) splice

 

??

根据上下游连接数据总线宽度的大小关系，分为三种情况：

a. 相等：直连即可，无需适配；

b. 上游大：需要把请求消息拆分成多个小的分片，然后通过下游连接发出去；

c. 上游小：需要把请求消息组合成一个大的消息，然后通过下游连接发出去；

 

因为beatBytes需要是2的幂，所以如果上下游数据总线的宽度不相等，那么一定是整数倍的关系。

 

A. 总线宽度与请求的size

 

数据总线的宽度代表物理能力，实际请求中数据的大小由size域决定：

a. 如果size域大于数据总线宽度，则会分成多个beat而成为burst请求；

b. 如果size域小于数据总线宽度，则数据不会把数据总线占满，而需要使用mask域标识哪些字节包含数据；

 

所以是否组合或拆分，也由size域参与决定。如果size域比上下游数据总线宽度都小，那么就不需要组合或拆分，而可以直接透传。

 

B. 上游总线宽度较大

 

??

a. edgeIn.manager.beatBytes表示输入边即与上游节点连接的数据总线宽度；edgeOut.manager.beatBytes则表示下游连接的数据总线宽度；

b. repeat决定了Repeater是否重复输出保存的数据，repeat由split的结果决定；

c. cated表示上游节点输入的数据，他默认从repeater中接收数据；进而被拆分成两个部分：首先，直接从in.bits.data中取低的与下游数据总线宽度相同位宽的数据，这部分数据不需要Repeater重复；其次，从repeated中取两者总线宽度差值的数据。至于数据是否有意义，则由mask域决定；

d. repeat：如果没有把所有分片向下游发送完成，则需要repeat；如果已经发送完成则不需要repeat；如果size大小小于下游连接的总线宽度，那么可以在一个时钟周期内发送完成，也不需要repeat；

 

C. 上游总线宽度较小

 

需要把上游burst请求的多个beat合并之后，向下游发送：

??

如果上游是一个单beat请求，则不会等下一个单beat请求进行合并，而是直接透传。

 

4. merge

 

用于把上游burst请求的多个beat合并之后，向下游发送。

??

 

1) 基本参数

 

??

其中：

a. ratio是一个整数值（可以被除尽而没有余数）；

b. countBits表示需要多少个位对用来组合的分片进行计数；

 

2) 请求信息

 

??

其中：limit根据当前请求的size域，计算这个请求总共包含多少个可供组合的分片；如果size也大于下游数据总线的宽度，那么这里的limit就限定在下游总线宽度。

 

3) first/last

 

??

其中：

a. count是用于计数的寄存器；

b. first/last表示是第一个和最后一个用于组合的beat；这里last有两种情况：第一，请求size小于下游数据总线宽度，last表示该请求的最后一个beat；第二，请求size大于下游数据总线宽度，last表示下游数据总线宽度可以容纳的最后一个beat；

c. enable是一个位图，与当前beat对应的序号为真，其他位为假；

 

4) corrupt

 

用于在多个beat之间holdcorrupt信号：

??

 

5) in.fire()

 

in.fire()表明来了一个请求：

??

a. 把count加1；

b. 如果是最后一个beat，则把count复位；单beat请求的第一个beat也就是最后一个beat；

 

6) ready/valid

 

??

 

7) edgeOut.data

 

??

a. 如果上游节点不会发起带数据的请求，如Put/Atomic等，那么可以使用默认值0；否则

b. 需要把in.bits.data组合之后装进out.bits.data；

c. out.bits.data的组合跨越了多个beat，也就是多个时钟周期；何时发出由out.valid决定；

 

8) out.bits.mask

 

??

a. 如果请求包含数据，则把in.bits.mask也组合在一起成为下游的mask；

b. 如果请求不包含数据，则直接使用MaskGen生成的mask；

 

9) helper

 

完成组装多beat数据的任务：

??

a. odata：把idata复制多份填满下游数据总线；

b. rdata：已经缓存的数据；

c. pdata：已缓存的数据 + 最后一个beat的数据；

d. mdata：enable中只有当前beat对应的位置的位为1，表示从odata中取出响应位置的idata；其他为0的位从pdata中取值；这样就逐个beat把数据存入rdata中了；

e. 把对应beat的数据存入rdata中，last为真时不需要缓存；

 

5. split

 

与merge类似，下面主要介绍不同点。

 

1) sel

 

??

 

这里的sel用于从in.bits.data中定位数据的正确偏移量。

如果in.bits.data中的数据是满的，那么因为对齐的问题，sel == 0。sel | count == count，就从偏移地址0开始取in.bits.data中的数据。

 

如果in.bits.data中的数据不是满的，那么sel != 0。sel | count 可以定位到正确的偏移量，以从in.bits.data中取数据。下面是一个例子：

??

 

2) sourceMap

 

因为d中不包含address域，所以需要记录请求消息中的address域：

??