編 者 按

字如其名，來看下Pipeline中throwIt的用法，是怎么個丟棄方式

API

在Stage中，關于throwIt提供了下面的API：

函數中的動作出現了兩個變量的使用：

internal.request.throws

internals.request.throwRoot 那么去到Pipeline里面看都哪里使用到了它。在看之前，先再來回顧下在SpinalHDL中pipeline的編程模型：

在Pipeline的模型里，Pipeline中的任何一級都是一個組合邏輯，如果它要驅動下一級Pipeline，那么其可以通過Connection來和下一級建立連接關系，最后一級則沒有Connection。而在Connection中，則可以進行打拍。也即Stage中負責功能實現，Connection負責實現控制流水線級數，時序優化。

Connection中的作用

在Pipeline的build函數中，其定義了throwOne：

var throwOne = stage.internals.request.throws.nonEmpty generate orR(stage.internals.request.throws)

即如果internals.request.throws如果不為空，那么其中的所有條件取或后賦值給throwOne.

而后，在處理Stage間的連接關系時有：

這里對于驅動該級的Connection，首先將throwOne保留至clThrowOne(l)中，隨后在if判斷中，會為clThrowOneHit(l)聲明為一個Bool()對象。在常用的Connection M2S、S2M中，alwasContainsSlaveToken均為true，故此時throwOne變量將會被賦值為null。

而對于：

if(throwOne != null) c.m.throwIt(throwOne, root = false)

由于此時throwOne重新被賦值為null，故并不會為驅動該Stage的Master調用throwIt，也即throw并不會向前級傳輸。

最終會調用下面的函數來進行Stage間的連接關系：

valarea = l.on(m, s, clFlush(l), clFlushNext(l), clFlushNextHit(l), clThrowOne(l), clThrowOneHit(l))

clThrowOne(l)作為throwHead參數傳入Connection的on函數。以M2S為例，我們來看下其在里面會有哪些動作：

m.ready match {
casenull=>
s.valid := m.valid
(s.payload, m.payload).zipped.foreach(_ := _)
caser => {
if(flush != null&& flushPreserveInput) s.valid clearWhen(flush)
if(throwHead != null) s.valid clearWhen(throwHead)
when(r) {
s.valid := m.valid
}
when(if(holdPayload) m.valid && r elser) {
(s.payload, m.payload).zipped.foreach(_ := _)
}
}
}

可以看到，如果驅動Connection的Master沒有ready信號，那么throwHead是沒有任何作用的。

如果master具備ready信號，如果此時m.ready信號為低電平，那么作為Slave的Stage其input.valid將會在下一拍變為低電平。

Stage中的作用

在Stage中的作用比較簡單，僅internals.request.throwRoot會起作用。在Pipeline中的build函數中：

if(s.request.throwsRoot.nonEmpty){
val doThrow = s.request.throwsRoot.orR
when(doThrow){
s.output.valid := False
}
}

如果throwsRoot不為空，則其中任意一個條件滿足是，Stage中的output.valid會立即清零。

結合Connection中throw的作用，throw會導致當前Stage的input.valid在下一拍清空(input.valid為寄存器)，而默認情況下stage的output.valid（Wire）直接由input.valid驅動，故throwsRoot的作用就是讓Stage的output.valid立即生效。比如說此時input.valid為高電平，ouput.ready也為高電平，throwsRoot將output.valid直接拉低避免當前拍的數據傳輸到下一級，從而實現立即丟掉。

Example

在這個例子中，如果cond為true，則stage2會立即丟掉當前傳輸至output端口的數據。

審核編輯：湯梓紅