Hard Processor System Component Reference Manual: Agilex™ 3 SoCs

Download PDF
ID 851703
Date 5/30/2025
Public
Document Table of Contents
Document Table of Contents x
1. Introduction to the Agilex™ 3 Hard Processor System Component 2. Configuring the Agilex™ 3 Hard Processor System Component 3. Simulating the Agilex™ 3 HPS Component 4. Simulating the Agilex™ 3 HPS bridges (H2F, LWH2F, and F2SDRAM) 5. Design Guidelines 6. Document Revision History for the Hard Processor System Component Reference Manual Agilex™ 3 SoCs
1. Introduction to the Agilex™ 3 Hard Processor System Component x
1.1. Release Notes 1.2. Micro Processor Unit 1.3. Application Processor Subsystem 1.4. Peripheral Subsystem 1.5. CoreSight* Debug Components 1.6. Interconnect 1.7. FPGA Bridges 1.8. Introduction to the Agilex™ 3 Hard Processor System Component Revision History
1.1. Release Notes x
1.1.1. HPS IP 7.0.0
2. Configuring the Agilex™ 3 Hard Processor System Component x
2.1. Parameterizing the HPS Component 2.2. HPS-FPGA Interfaces 2.3. SDRAM 2.4. HPS Clocks, Reset, Power 2.5. I/O Delays 2.6. Pin Mux and Peripherals 2.7. Generating and Compiling the HPS Component 2.8. Using the Address Span Extender Component 2.9. Configuring the Agilex™ 3 Hard Processor System Component Revision History
2.2. HPS-FPGA Interfaces x
2.2.1. General 2.2.2. HPS FPGA Bridges 2.2.3. DMA Controller Interface 2.2.4. Interrupts
2.2.1. General x
2.2.1.1. Enable MPU Standby and Event Signals 2.2.1.2. Enable General Purpose Signals 2.2.1.3. Enable Debug APB* Interface 2.2.1.4. Enable System Trace Macrocell (STM) Hardware Events 2.2.1.5. Enable SWJ-DP JTAG Interface 2.2.1.6. Enable FPGA Cross Trigger Interface 2.2.1.7. Enable AMBA* Trace Bus (ATB)
2.2.2. HPS FPGA Bridges x
2.2.2.1. FPGA to HPS Subordinate 2.2.2.2. FPGA to SDRAM Subordinate 2.2.2.3. HPS to FPGA Manager 2.2.2.4. Lightweight HPS to FPGA Manager
2.2.4. Interrupts x
2.2.4.1. FPGA-to-HPS 2.2.4.2. HPS-to-FPGA
2.3. SDRAM x
2.3.1. Configurations for HPS IP 2.3.2. Configurations for HPS EMIF IP 2.3.3. Graphical Connections of HPS to HPS-EMIF 2.3.4. Configuration when using ECC 2.3.5. Configuration of HPS EMIF Calibration Settings 2.3.6. Supported Memory Protocols Among Device Families 2.3.7. IO96 Bank and Lane Usage for HPS EMIF 2.3.8. Quartus Report of I/O Bank Usage 2.3.9. Debugging with the External Memory Interface Debug Toolkit
2.4. HPS Clocks, Reset, Power x
2.4.1. Input Clocks 2.4.2. PLL Clocks 2.4.3. Power and Resets
2.4.1. Input Clocks x
2.4.1.1. External Clocks 2.4.1.2. FPGA-to-HPS Clocks 2.4.1.3. Peripheral FPGA Clocks
2.4.2. PLL Clocks x
2.4.2.1. Main PLL Output 2.4.2.2. Peripheral PLL Output 2.4.2.3. MPU Clocks 2.4.2.4. NOC Clocks 2.4.2.5. Peripheral Clocks 2.4.2.6. HPS-to-FPGA User Clocks
2.4.3. Power and Resets x
2.4.3.1. Power Configurations 2.4.3.2. Reset Signals
2.6. Pin Mux and Peripherals x
2.6.1. Pin Mux GUI 2.6.2. EMAC PTP Interface 2.6.3. HPS I/O Open Drain 2.6.4. HPS I/O Locations
2.6.1. Pin Mux GUI x
2.6.1.1. Auto-Place IP 2.6.1.2. Advanced
2.6.1.1. Auto-Place IP x
2.6.1.1.1. Options for NAND, SDMMC, TRACE, TPIU, EMAC
2.6.1.1.1. Options for NAND, SDMMC, TRACE, TPIU, EMAC x
2.6.1.1.1.1. HPS IO Placement Priority
2.6.1.2. Advanced x
2.6.1.2.1. Advanced IP Placement 2.6.1.2.2. Advanced FPGA Placement
3. Simulating the Agilex™ 3 HPS Component x
3.1. Simulation Flows 3.2. Clock and Reset Interface 3.3. FPGA-to-HPS AXI* Subordinate Interface 3.4. FPGA-to-SDRAM AXI* Subordinate Interface 3.5. HPS-to-FPGA AXI* Manager Interface 3.6. Lightweight HPS-to-FPGA AXI* Manager Interface 3.7. Simulating the Agilex™ 3 HPS Component Revision History
3.1. Simulation Flows x
3.1.1. Setting Up the HPS Component for Simulation 3.1.2. Generating the HPS Simulation Model in Platform Designer 3.1.3. RTL Simulation Setup Scripts
3.1.3. RTL Simulation Setup Scripts x
3.1.3.1. QuestaSim* Simulation Steps 3.1.3.2. Cadence® Xcelium* Simulation Steps 3.1.3.3. Synopsys* VCS* MX Simulation Steps 3.1.3.4. Riviera-PRO* Simulation Steps 3.1.3.5. Synopsys* VCS* Simulation Steps 3.1.3.6. VSIM Command Line Aliases and Variables
3.2. Clock and Reset Interface x
3.2.1. Clock Interface 3.2.2. Reset Interface
4. Simulating the Agilex™ 3 HPS bridges (H2F, LWH2F, and F2SDRAM) x
4.1. Setting up the HPS Component for Simulation 4.2. Generating the HPS Simulation Model in Platform Designer 4.3. Editing the TestBench scripts 4.4. Running the TestBench scripts 4.5. Simulating the Agilex™ 3 HPS Bridges (H2F, LWH2F, and F2SRAM) Revision History
4.3. Editing the TestBench scripts x
4.3.1. my_simple_tb.sv 4.3.2. test_lwh2f.sv 4.3.3. test_h2f_128b.sv 4.3.4. test_f2sdram_256b.sv
4.4. Running the TestBench scripts x
4.4.1. Questa* Intel® FPGA Edition Simulation Steps
5. Design Guidelines x
5.1. HPS System Reset Considerations 5.2. Design Guidelines Revision History
1. Introduction to the Agilex™ 3 Hard Processor System Component
2. Configuring the Agilex™ 3 Hard Processor System Component
3. Simulating the Agilex™ 3 HPS Component
4. Simulating the Agilex™ 3 HPS bridges (H2F, LWH2F, and F2SDRAM)
5. Design Guidelines
6. Document Revision History for the Hard Processor System Component Reference Manual Agilex™ 3 SoCs

4.3.3. test_h2f_128b.sv

  1. Change directory to <project directory>/simple_tb/simple_tb/sim/ .
  2. Create a file named test_h2f_128b.sv and edit with contents as shown below. 
    // test_h2f_128b.sv

`timescale 1 ps / 1 ps
import altera_axi_bfm_pkg::*;

module test_h2f_128b#();

`define h2f_test_m     simple_tb.simple_inst.intel_agilex_5_soc_0.intel_agilex_5_soc_0.sm_hps.sundancemesa_hps_inst.h2f_bfm_gen.h2f_axi4_master_inst

localparam ADDR_WIDTH = 38;
localparam DATA_WIDTH = 128;
localparam ID_WIDTH = 4;
localparam USER_WIDTH = 8;

int i,j;
bit status, f_rw[8], f_incr[8][8];
reg [ADDR_WIDTH-1:0] Addr;	// 38 bit addr
reg [DATA_WIDTH-1:0] Data[8];	// 128 bit data

//-----------------------------------------------------------------------------------------------
//----------------------------  BFM Manager (h2f)
//-----------------------------------------------------------------------------------------------
initial begin 
  
  AlteraAxiTransaction wr_resp_tr, rd_resp_tr;
  BaseAxiBfm#(ADDR_WIDTH, DATA_WIDTH, ID_WIDTH, USER_WIDTH) test_m;
  test_m = `h2f_test_m.AXI4MAN.bfm;
  
  Data[0] = 'h11111111_22222222_33333333_44444444;
  Data[1] = 'h22222222_33333333_44444444_55555555;
  Data[2] = 'h33333333_44444444_55555555_66666666;
  Data[3] = 'hbbbbbbbb_cccccccc_dddddddd_eeeeeeee;  
  
  test_m.m_reset();
  test_m.set_config(AXI_CONFIG_MAX_OUTSTANDING_WR, 2);
  test_m.set_config(AXI_CONFIG_MAX_OUTSTANDING_RD, 2);

  $display("\n\n\n\n@%0t, [TESTINFO]: Starting     MANAGER BFM               H2F     \n\n\n\n",$time);

/////////////////////////////////////////// SINGLE WRITES //////////////////////////////////////
for (i = 0; i < 4; i++) begin
  $display("\n@%0t*************** START OF WRITE #%d TEST *******  H2F  ********\n",$time, i);
  Addr = (i * 1<<AXI4_BYTES_16);
  wr_resp_tr = test_m.manager_bfm_wr_tx();
  wr_resp_tr.set_id(i);
  wr_resp_tr.set_awaddr(Addr);
  wr_resp_tr.set_burst_length(0);
  wr_resp_tr.set_size(AXI4_BYTES_16);

  wr_resp_tr.set_data_words(Data[i], 0);
  wr_resp_tr.set_write_strobes(16'hffff, 0);
  test_m.put_transaction(wr_resp_tr); 
  test_m.drive_transaction(); 
  $display("\n@%0t*************** END OF   WRITE #%d TEST *******  H2F  ********\n",$time, i);
end
/////////////////////////////////////////// SINGLE READS  //////////////////////////////////////
for (i = 0; i < 4; i++) begin
  $display("\n@%0t*************** START OF READ  #%d TEST ******   H2F   *********\n",$time, i); 
  Addr = (i * 1<<AXI4_BYTES_16);
  rd_resp_tr = test_m.manager_bfm_rd_tx(i, Addr );	//id, addr
  rd_resp_tr.set_size(AXI4_BYTES_16);
  test_m.put_transaction(rd_resp_tr); 
  test_m.drive_transaction();
    
  if (rd_resp_tr.get_data_words(0) == Data[i]) begin
     f_rw[i]=1'b1;
     $display ("value of f_rw[%d] is %b", i, f_rw[i]);
     $display ( "@ %t  Read correct data (%h) at address (%d)", $time, Data[i], Addr );
  end 
  else
     $display ( "@ %t  Error: Expected data (%h) at address (%d), but got %d", $time, Data[i], Addr, rd_resp_tr.get_data_words(0));
  $display("\n@%0t*************** END OF   READ  #%d TEST ******   H2F   *********\n",$time, i);
end  
/////////////////////////////////////////// INCR WRITES/READS  /////////////////////////////////
for (i = 0; i < 4; i++) begin
   $display("\n@%0t*************** START OF INCR BURST #%d TEST ******   H2F   *********\n",$time, i); 
   Addr = 32+ (i*1<<AXI4_BYTES_16);
   wr_resp_tr = test_m.manager_bfm_wr_tx( (4+i), Addr );	// id, addr
   wr_resp_tr.set_burst_length(3); 
   wr_resp_tr.set_size(AXI4_BYTES_16); 
   wr_resp_tr.set_burst_type(BURST_TYPE_INCR); 
   wr_resp_tr.set_data_words(Data[0], 0);	// data, id
   wr_resp_tr.set_data_words(Data[1], 1); 
   wr_resp_tr.set_data_words(Data[2], 2); 
   wr_resp_tr.set_data_words(Data[3], 3); 
   wr_resp_tr.set_write_strobes(16'hffff, 0);	// strobe, id
   wr_resp_tr.set_write_strobes(16'hffff, 0); 
   wr_resp_tr.set_write_strobes(16'hffff, 0); 
   wr_resp_tr.set_write_strobes(16'hffff, 0); 
   test_m.put_transaction(wr_resp_tr);
   test_m.drive_transaction();

   rd_resp_tr = test_m.manager_bfm_rd_tx( (4+i), Addr ); 
   rd_resp_tr.set_burst_length(3); 
   rd_resp_tr.set_size(AXI4_BYTES_16); 
   rd_resp_tr.set_burst_type(BURST_TYPE_INCR); 

fork 
   begin 
	test_m.put_transaction(rd_resp_tr); 
	test_m.drive_transaction(); 
   end 
   begin 
	test_m.put_transaction(wr_resp_tr); 
	test_m.drive_transaction(); 
   end 
join 

   for (j=0; j<4; j++) begin
     if (rd_resp_tr.get_data_words(j) == Data[j]) begin
       f_incr[i][j]=1'b1;
       $display ( "@ %t  Read correct data (%h) at address (%h)", $time, Data[j], (Addr + j) );      
       end 
    else
       $display ( "@ %t  Error: Expected data (%h) at address (%h), but got %h", $time, Data[j], (Addr + j), rd_resp_tr.get_data_words(j));
    end	   //for j loop
end	//for i loop
/////////////////////////////////////////// CHECK TESTS        /////////////////////////////////
#2000000	// optional delay - if timescale is 1ps/1ps, then  2000000 = 2ns
status=1'b1;	//assume pass
for (i = 0; i < 4; i++)
   if (f_rw[i]!=1'b1)
	status=1'b0;

for (i=0; i<4; i++)
   for (j=0; j<2; j++)
      	if (f_incr[i][j]!=1'b1)
      		status=1'b0;	
	
if (status==1'b1)
   $display ("\n\n>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> pass    H2F ");
else begin
   $display ("\n\n>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> fail    H2F ");
   for (i=0; i<4; i++)
      for (j=0; j<2; j++)
 	 $display (">>>  f_rw[%d] is %b   >>>  f_incr[%d][%d] is %b ", i, f_rw[i], i, j, f_incr[i][j] );
end

$display("\n@%0t**************** END OF TEST ********      H2F    ********\n",$time); 

end     // initial begin
endmodule
Level Two Title