代碼規(guī)范的文檔，就是一份設(shè)計(jì)工程師的血淚史。

命名規(guī)范

命名規(guī)范包括模塊命名規(guī)范和代碼命名規(guī)范，代碼命名需要有確定的含義，提高代碼可讀性和可維護(hù)性。模塊名命名規(guī)范處理好認(rèn)，一眼就能把看出你是哪個(gè)IP里面的一個(gè)子模塊之外，更重要的一個(gè)原因是防止兩個(gè)module重名 ，比如你把模塊起名叫，shift_reg_dly_module，但是整個(gè)soc中可能會(huì)有其他IP也叫這個(gè)module名，這樣同名不同工的文件，會(huì)影響集成級(jí)的工作。

所以代碼規(guī)范module命名這樣，子系統(tǒng)_子模塊_function_module。例如ddr_shift_reg_dly_module。避免模塊名重名。

綜合自動(dòng)插時(shí)鐘門(mén)控

并不是所有的寄存器都需要帶復(fù)位，這樣規(guī)范顛覆初入行的朋友認(rèn)知。有研究表明，帶復(fù)位的寄存器和不帶復(fù)位的寄存器相比，面積會(huì)相差10%。但是這樣也有一個(gè)原則，就是控制寄存器必須帶復(fù)位，數(shù)據(jù)寄存器可以不復(fù)位，但是不能用去做條件。

計(jì)數(shù)器，必須有使能端和清零端，不允許裸奔

always @(posedge clk or negedge rst_n)begin
  if(rst_n == 1'b0)begin
    o_cnt[7:0] <= 8’d0;
  end
  else if(cnt_clr == 1’b1)begin
    o_cnt[7:0] <= 8’d0;
  end
  else if (cnt_en == 1’b1)begin
    o_cnt[7:0] <= o_cnt[7:0] + 1'b1;
  end
end

數(shù)據(jù)寄存器帶使能打拍鎖存使用

always @(posedge clk)begin
  if(data_vld)
    dout[63:0] <= din;
end

這種寫(xiě)法綜合自動(dòng)插時(shí)鐘門(mén)控，而且不帶復(fù)位。注意不能裸奔。

always @(posedge clk)begin
    dout[63:0] <= din;
end

這樣寫(xiě)就GG了

優(yōu)先使用spram

有一種代碼規(guī)范是要求必須使用spram，single port ram。即使有同時(shí)讀寫(xiě)的需求，也自己做邏輯，將讀寫(xiě)分開(kāi)做。強(qiáng)烈這么要求的原因是，有研究數(shù)據(jù)表明，在某工藝下，spram比dpram的面積基本會(huì)小30%。

30%的memory收益，這個(gè)收益還是很猛的。

memory規(guī)范操作

Memory必須先寫(xiě)后讀，讀寫(xiě)使能默認(rèn)復(fù)位值必須是無(wú)效值。不用的時(shí)候不允許讀，否則會(huì)出現(xiàn)上電后芯片的memory一直掃描讀寫(xiě)，徒增功耗。

Memory的數(shù)據(jù)讀出必須鎖存后使用。

memory和logic分開(kāi)

Memory不散在邏輯中，將memory的讀寫(xiě)控制端口都從IP的頂層伸出統(tǒng)一管理，為的是mem方便統(tǒng)一替換處理。而且后端實(shí)現(xiàn)上memory放邊擺開(kāi)。

方便不同工藝的適配，比如你要換一個(gè)工藝，那你的memory要全部替換，就要在logic里面找，假如有些工藝十分惡心，要加個(gè)寄存器或者輸出到寄存器上，你就要一層層穿線到頂層寄存器模塊。作為IP供應(yīng)商也應(yīng)該做好memory的wrapper提供給客戶，方便客戶替換。

后端實(shí)現(xiàn)memory放邊擺開(kāi)，logic要也考慮到memory的走線，所以對(duì)于memory的入口和出口都要是寄存器。不然PR出了問(wèn)題，該做的還是得做。

模塊必須寄存器入寄存器出

在后端布局布線過(guò)程中，邏輯少的模塊之間還好，但harden之間有邏輯交互，兩個(gè)harden的距離并不一定擺的位置靠近。如果不是寄存器入寄存器出，會(huì)導(dǎo)致兩個(gè)harden之間交互的信號(hào)時(shí)序差。造成工作反復(fù)。

自研IP不建議用`define來(lái)定義參數(shù)

要求用parameter，define使用要謹(jǐn)慎，因?yàn)閐efine是全局定義的，如果再使用過(guò)程中不當(dāng)，沒(méi)有undef掉，可能會(huì)影響其他IP的同名define值。正確使用沒(méi)問(wèn)題，無(wú)對(duì)錯(cuò)，遵守公司代碼規(guī)范即可 。

審核編輯：劉清