|
勇敢的芯伴你玩轉Altera FPGA連載34：Verilog代碼書寫規范 特權同學，版權所有 配套例程和更多資料下載鏈接： http://pan.baidu.com/s/1i5LMUUD 
雖然沒有“國際標準”級別的Verilog或VHDL代碼書寫規范可供參考，但是相信每一個稍微規范點的做FPGA設計的公司都會為自己的團隊制定一套供參考的代碼書寫規范。畢竟一個團隊中，大家的代碼書寫格式達到基本一致的情況下，相互查閱、整合或移植起來才會“游刃有余”。因此，希望初學者從一開始就養成好的習慣，盡量遵從比較規范的書寫方式。話說“幸福的家庭都是一樣的，不幸的家庭各有各的不幸”，我們也相信，盡管不同的公司為自己的團隊制定的Verilog或VHDL代碼書寫規范可能略有差異，但是真正好的書寫規范應該都是大同小異的。所以，對于網絡上漫天飛舞的書寫規范，筆者本著“取其精華去其糟粕”的精神和大家一同分享。這里也不刻意區分verilog和VHDL書寫規范上的不同，只是談論一些基本的可供遵循的規范。 標識符 包括語法保留的關鍵詞、模塊名稱、端口名稱、信號名稱、各種變量或常量名稱等。語法保留的關鍵詞是不可以作為后面幾種名稱使用的，Verilog和VHDL的主要關鍵字如下： Verilog關鍵詞 always endmodule medium reg tranif0 and end primitive module release tranif1 assign endspecify nand repeattri attribute endtable negedge rnmos tri0 begin endtask nmos rpmos tri1 buf event nor rtrantriand bufif0 for not rtranif0 trior bufif1 force notif0 rtranif1 trireg case forever notif1 scalared unsigned casex fork or signed vectored casez function output small wait cmos highz0 parameter specify wand deassign highz1 pmos specparam weak0 default if posedge strength weak1 defparam ifnone primitive strong0 while disable initial pull0 strong1 wire edge inout pull1 supply0 wor else input pulldown supply1 xnor end integer pullup table xor endattribute join remos task endcase large real time endfunction macromodule realtime tran VHDL關鍵詞 abs downto library postponed subtype access else linkage procedure then after elsif literal process to aliasend loop pure transport all entity map range type and exit mod record unaffected architecture file nand register units array for new reject until assert function next rem use attribute generate nor report variable begin generic not return wait block group null rol when body guarded of ror while buffer if on select with bus impure open severity xnor case in or shared xor component inertial others signal configuration inout out sla constant is package sra disconnect label port srl 除了以上這些保留的關鍵詞不可以作為用戶自定義的其他名稱，verilog和VHDL還有以下的一些用戶自定義命名規則必須遵循： ● 命名中只能夠包含字母、數字和下劃線“_”（verilog的命名還可以包含符號“$”）。 ● 命名的第一個字符必須是字母（verilog的命名授字符可以是下劃線“_”，但一般不推薦這么命名）。 ● 在一個模塊中的命名必須是唯一的。 ● VHDL的命名中不允許連續出現多個下劃線“_”，也不允許下劃線“_”是命名的最后一個字符。 關于模塊名稱、端口名稱、信號名稱、各種變量或常量名稱等的命名，有很多推薦的規則可供參考，如下： ● 盡可能使用能表達名稱具體含義的英文單詞命名，單詞名稱過長時可以采用易于識別的縮寫形式替代，多個單詞之間可以用下劃線“_”進行分割。 ● 對于出現頻率較高的相同含義的單詞，建議統一作為前綴或后綴使用。 ● 對于低電平有效的消耗，通常加后綴“_n”表示。 ● 在同一個設計中，盡可能的統一大小寫的書寫規范。（很多規范里對命名的大小寫書寫格式有要求，但是筆者這里不做詳細規定，大家可以根據自己的需要設定。） 格式 這里的格式主要是指每個代碼功能塊之間、關鍵詞、名稱或操作符之間的間距（行間距、字符間距）規范。得體的代碼格式不僅看起來美觀大方，而且便于閱讀和調試。關于格式，可能不同的公司也都有相關的規范要求，筆者在此建議大家盡量遵循以下一些原則： ● 每個功能塊（如verilog的always邏輯、VHDL的process邏輯）之間盡量用一行或數行空格進行隔離。 ● 一個語法語句一行，不要在同一行寫多個語法語句。 ● 單行代碼不宜過長，所有代碼行長度盡量控制在一個適當的便于查看的范圍。 ● 同層次的語法盡量對齊，使用Tab鍵（通常一個Tab對應四個字符寬度）進行縮進。 ● 行尾不要有多余的空格。 ● 關鍵詞、各類名稱或變量、操作符相互間都盡量保留一個空格以作隔離。 注釋 Verilog的注釋有“/* */”以及“//”兩種方式。“/*”左側和“*/”右側之間的部分為注釋內容，此注釋可以用在行前、行間、行末或多行中；“//”后面的內容為注釋，該注釋只可用在行末（當然了，它也可以頂個，那么意味著整行都是注釋）。 VHDL的注釋只有“--”一種。類似verilog的“//”，“--”后面的內容為注釋，該注釋只可用在行末。 注釋的擺放和寫法通常也有講究，幾個要點歸納如下： ● 每個獨立的功能模塊都要有簡單的功能描述，對輸入輸出信號功能進行描述。 ● 無論習慣在代碼末注釋還是代碼上面注釋，同一個模塊或工程中盡量保持一致。 ● 注釋內容簡明扼要，不要過于冗長或寫廢話（例如：add = add+1; //add自增）。 |
