File - 1.0 English

Versal ACAP CIPS Verification IP (DS996)

Document ID
DS996
Release Date
2021-07-14
Version
1.0 English
APIs Inputs Outputs
write_from_file

Initiate an AXI write transaction on one of the AXI-Master ports. The write data is used from the file. Burst type used is INCR. This is a blocking task and returns only after the completion of AXI WRITE transaction. Need to pass FILE_DATA_WIDTH_128 for accessing files with 128-bit data contents.

If FILE_DATA_WIDTH_128 is passed, then the address must be 128-bit aligned.

If FILE_DATA_WIDTH_128 is not passed, then the address must be 32-bit aligned.

For example: versal_cips_0.inst.PS9_VIP_inst.inst.write_from_file("R5_API","write_mgp.txt",40'h8000_0000,4,wrs)

[1023:0] master_name: R5_API or A72_API.

[1023:0] File_name: File name that stores the write data.

[43:0] start_addr: write address

[31:0] wr_size: number of bytes to be written

For 32-bit file contents, wr_size should be in multiples of 4.

For 128-bit file contents, wr_size should be in multiples of 16.

[1:0] response: The slave write response from the following:

[OKAY, EXOKAY,

SLVERR, DECERR]

read_to_file

Initiate an AXI read transaction on one of the AXI-Master ports. The read data is written to a file. Burst type used is INCR. This is a blocking task and returns only after the completion of AXI READ transaction. Need to pass FILE_DATA_WIDTH_128 for accessing files with 128-bit data contents.

If FILE_DATA_WIDTH_128 is passed, then the address must be 128-bit aligned.

If FILE_DATA_WIDTH_128 is not passed, then the address must be 32-bit aligned.

For example: versal_cips_0.inst.PS9_VIP_inst.inst.read_to_file("R5_API","read_mgp0.txt",40'h8000_0000,4,rresp)

[1023:0] master_name: R5_API or A72_API.

[1023:0] file_name: File name that stores the write data.

[43:0] start_addr: write address

[31:0] rd_size: number of bytes to be read.

For 32-bit file contents, rd_size should be in multiples of 4.

For 128-bit file contents, rd_size should be in multiples of 16.

[1:0] response: The slave write response from the following:

[OKAY, EXOKAY,

SLVERR, DECERR]