Decrypt an AES-GCM encrypted bitstream
Syntax
decrypt_bitstream ‑encrypted_file <arg> ‑keyfile <arg> [‑force] [‑quiet]
[‑verbose] <file>
Usage
Name | Description |
---|---|
-encrypted_file
|
Input AES-GCM encrypted bitstream (.bit or .rbt) |
-keyfile
|
File containing encryption keys |
[-force]
|
Overwrite existing file |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
<file>
|
Output decrypted bitstream (.bit, .bin or .rbt) |
Categories
Description
During implementation of secure encrypted UltraScale architecture designs, bitstream-level verification must be performed on the final bitstream against the "golden" bitstream of the Xilinx tested Security Monitor (SecMon) IP.
The decrypt_bitstream
command takes an AES-GCM encrypted bitstream file (.bit or .rbt) from an implemented design that incorporates the SecMon IP, and an encryption key file (.nky or .nkz), and returns an unencrypted bitstream file. The decrypted bitstream can then be used to complete the bitstream verification process.
This command returns the requested file if successful, or returns an error if it fails.
Arguments
-encrypted_file
<arg> - (Required) Specifies the AES-GCM encrypted bitstream (.bit or .rbt) to be decrypted.
-keyfile
<arg> - (Required) Specifies the name of the encryption key file (.nky or .nkz). This is necessary for decrypting the encrypted bitstream.
-force
- (Optional) Overwrite an existing file of the same name.
-quiet
- (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
-verbose
- (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config
command.Example
decrypt_bitstream -encrypted_file C:/Data/myDesign.bit \
-keyfile C:/Data/key.nky -force C:/Data/myDesign_decrypted.bit