作者：Han Hong，ADM賽靈思工程師

在一些大型項目的設計中，可能會涉及多個公司或者同一公司多個部門之間的協(xié)作，在最終歸并完整設計時，你需要提交你負責的子模塊的設計，可以以RTL源文件形式提交. 當你希望對你的RTL源文件進行加密，可以在Vivado中采用? IEEE-1735-2014 version 2 (V2)的標準, 對RTL源文件進行加密，允許對方將你的加密RTL源文件應用到Vivado中進行綜合，仿真或者實現(xiàn). 在這里我們會解釋一下在使用源文件加密時的一些基本概念以及一些常見的問題。

許可證(License)： 使用IEEE-1735-2014 version 2標準加密需要獲得AMD-Xilinx授權的許可證。獲取免費許可證的詳細流程可以參考AR-68071.

建議使用公司郵箱發(fā)送郵件，文本使用英語，并告知你使用的Vivado版本. 68071 - Vivado - How do I enable IEEE-1735 Version 2 encryption in Vivado? (xilinx.com)

公開的密鑰(Key) 在Vivado的安裝目錄下可以找到公開的密鑰： ? /Vivado//data/pubkey/

加密命令 encrypt： 加密使用的Vivado中的encrypt命令，可以在GUI下執(zhí)行，也可以在命令行下執(zhí)行 ?GUI下執(zhí)行encrypt命令: ?? 1.打開Vivado界面 ?? 2.在TCL CONSOLE中cd 到目標路徑 ?? 3.在TCL CONSOLE中鍵入encrypt命令，按回車執(zhí)行 ? ??

?在命令行下執(zhí)行encrypt命令: ?? 1. 打開命令行界面，設置Vivado環(huán)境 ?????? C:XilinxVivado2022.1settings64.bat ?? 2. cd 到目標路徑 ?????? cd C: estExamples_2022.1Examples ?? 3. 啟動Vivado TCL模式 ????? vivado -mode tcl ?? 4. 在Vivado的提示符下執(zhí)行encrypt命令 ????? vivado% encrypt -key ./keyfile_ver.txt -lang verilog Example.v - key 選項用來指定加密文件，如果密鑰嵌在源文件中，可以不使用-key選項. - lang 選項用來指定加密文件的類型，systemverilog和Verilog 都選擇verilog即可（vhdl | verilog ）

如果不希望原來的源文件被生成的加密文件覆蓋，可以使用-ext選項，指定新生成的加密文件的后綴，這樣原來的源文件在加密后會依然保留： ? x：encrypt -key ./keyfile_ver.txt -lang verilog Example.v -ext .vp

在原目錄下的文件：? Example.v -> Example.v + Example.vp

如何理解密鑰文件的內容 以下是一個實際的Key文件

`pragma protect version = 2 #用的是IEEE-1735-2014 V2 `pragma protect encrypt_agent = "XILINX" `pragma protect encrypt_agent_info = "Xilinx Encryption Tool 2022" #加入一些關于Key自身的識別信息 `pragma protect begin_commonblock … `pragma protect begin_commonblock #其中包含的內容是常規(guī)權力定義 ‘protect begin_toolblock ... ‘protect end_toolblock=”” #其中包含的內容是工具特有的權力定義 密鑰部分可以直接替換成安裝目錄下的公鑰

以下是幾個Xilinx-AMD定義的，特有的權力定義

xilinx_configuration_visible 是否顯示綜合之后的網(wǎng)表中LUT的配置信息 拒絕的話，只能看到LUT的連接，這些LUT的功能是什么無法看到. xilinx_enable_modification 是否允許使用 Vivado 工具修改受保護區(qū)域內的網(wǎng)表信息（層次結構、連接、LUT 等） xilinx_enable_probing 是否允許客戶在受保護區(qū)域中插入或實例化Vivado 探針工具 xilinx_enable_netlist_export Vivado是否允許導出受保護區(qū)域的網(wǎng)表 xilinx_enable_bitstream 是否允許Vivado 工具導出比特流文件 xilinx_schematic_visibility Vivado是否允許在原理圖或層次結構查看器中顯示受保護區(qū)域的模塊名稱 選擇不可見的話，受保護的cell在原理圖和時序報告中統(tǒng)一顯示為

有條件的權力定義 ?`protect control = ? : 讓加密的文件只在特定的步驟中可以被工具解密讀取. Ex: `protect control decryption = (xilinx_activity==simulation) ? "false" : "true" 代表在Vivado仿真時，條件為true，總的結果是false，所以相關文件只能綜合實現(xiàn)，無法用于仿真. ?

直接把密鑰嵌入到RTL源文件中 允許客戶直接把密鑰的內容直接貼到RTL源文件中protect begin和protect end之間的內容就是用戶原始RTL里的內容. 之前提過嵌入密鑰內容后，不再需要-key的選項. `pragma protect begin User RTL content `pragma protect end

編輯：黃飛

?