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

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

許可證(License)： 使用IEEE-1735-2014 version 2標(biāo)準(zhǔn)加密需要獲得AMD-Xilinx授權(quán)的許可證。獲取免費(fèi)許可證的詳細(xì)流程可以參考AR-68071.

建議使用公司郵箱發(fā)送郵件，文本使用英語(yǔ)，并告知你使用的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 到目標(biāo)路徑 ?? 3.在TCL CONSOLE中鍵入encrypt命令，按回車執(zhí)行 ? ??

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

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

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

如何理解密鑰文件的內(nèi)容 以下是一個(gè)實(shí)際的Key文件

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

以下是幾個(gè)Xilinx-AMD定義的，特有的權(quán)力定義

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

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

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

編輯：黃飛

?