Hard Processor System Component Reference Manual: Agilex™ 5 SoCs

Download PDF
ID 813752
Date 8/15/2025
Public
Document Table of Contents
Document Table of Contents x
1. Introduction to the Agilex™ 5 Hard Processor System Component 2. Configuring the Agilex™ 5 Hard Processor System Component 3. Simulating the Agilex™ 5 HPS Component 4. Simulating the Agilex™ 5 HPS bridges (H2F, LWH2F, F2SDRAM, F2H) 5. Design Guidelines 6. Document Revision History for the Hard Processor System Component Reference Manual Agilex™ 5 SoCs
1. Introduction to the Agilex™ 5 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™ 5 Hard Processor System Component Revision History
1.1. Release Notes x
1.1.1. HPS IP 9.0.0 1.1.2. HPS IP 7.0.0 1.1.3. HPS IP 6.0.0 1.1.4. HPS IP 5.1.0 1.1.5. HPS IP 4.0.0
2. Configuring the Agilex™ 5 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™ 5 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™ 5 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™ 5 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™ 5 HPS bridges (H2F, LWH2F, F2SDRAM, F2H) 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™ 5 HPS Bridges (H2F, LWH2F, F2SRAM, F2H) 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.sv 4.3.4. test_f2sdram.sv 4.3.5. test_f2h.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™ 5 Hard Processor System Component
2. Configuring the Agilex™ 5 Hard Processor System Component
3. Simulating the Agilex™ 5 HPS Component
4. Simulating the Agilex™ 5 HPS bridges (H2F, LWH2F, F2SDRAM, F2H)
5. Design Guidelines
6. Document Revision History for the Hard Processor System Component Reference Manual Agilex™ 5 SoCs

4.3.4. test_f2sdram.sv

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

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

`define DUT		simple_tb.simple_inst	// project name with "_tb" and "_inst"
`define mgr_bfm		`DUT.	axi4_mm_manager_intf_0.axi4_mm_manager_intf_0 
`define sub_bfm		`DUT.	intel_agilex_5_soc_0.intel_agilex_5_soc_0.sm_mpfe.\
				sundancemesa_mpfe_inst.f2sdram_bfm_gen.\
				f2sdram_axi4_slave_inst
`define sub_mem 	`sub_bfm.	host_memory

`define CLK_PATH 	`DUT.	clock_in.out_clk
`define RESET_PATH 	`DUT.	reset_in.out_reset

localparam MGR_ADDR_WIDTH = 32;
localparam MGR_DATA_WIDTH = 256;  // width of the Manager driving the F2SDRAM bridge
localparam MGR_ID_WIDTH = 5;
localparam MGR_USER_WIDTH = 32;

localparam SUB_ADDR_WIDTH = 32;
localparam SUB_DATA_WIDTH = 64;	  // width of the F2SDRAM bridge
localparam SUB_ID_WIDTH = 5;
localparam SUB_USER_WIDTH = 8;

module test_f2sdram#();

int i,j;
bit status, f_rw[8], f_incr[8][8];
reg [MGR_ADDR_WIDTH-1:0] Addr;		// addr reg
reg [MGR_DATA_WIDTH-1:0] mgrData[8];	// MGR data reg
reg [SUB_DATA_WIDTH-1:0] subData[8];	// SUB data reg

//----------------------------------------------------------------------------------
//----------------------------  BFM Manager (f2sdram)
//----------------------------------------------------------------------------------
initial begin 
  AlteraAxiTransaction wr_resp_tr, rd_resp_tr;
  BaseAxiBfm#(MGR_ADDR_WIDTH, MGR_DATA_WIDTH, MGR_ID_WIDTH, MGR_USER_WIDTH) test_m;  
  
  test_m = `mgr_bfm.AXI4MAN.bfm;
  
mgrData[0]='h11111111_22222222_33333333_44444444_55555555_66666666_77777777_88888888;
mgrData[1]='h22222222_33333333_44444444_55555555_66666666_77777777_88888888_99999999;
mgrData[2]='h33333333_44444444_55555555_66666666_77777777_88888888_99999999_aaaaaaaa;
mgrData[3]='h44444444_55555555_66666666_77777777_88888888_99999999_aaaaaaaa_bbbbbbbb;  

  subData[0] = 'h77777777_88888888;  
  subData[1] = 'h55555555_66666666;  
  subData[2] = 'h33333333_44444444;
  subData[3] = 'h11111111_22222222;      
  
  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  F2SDRAM  n\n\n",$time);

/////////////////////////////////////////// SINGLE WRITES //////////////////////////
for (i = 0; i < 4; i++) begin
  $display("\n@%0t******** START OF WRITE #%d TEST ****  F2SDRAM  ****\n",$time, i);
  Addr = (i * 1<<AXI4_BYTES_32);  
  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_32);

  wr_resp_tr.set_data_words(mgrData[i], 0);
  wr_resp_tr.set_write_strobes(32'hffffffff, 0);
  test_m.put_transaction(wr_resp_tr); 
  test_m.drive_transaction(); 
  $display("\n@%0t******** END OF   WRITE #%d TEST ***  F2SDRAM  ****\n",$time, i);
end

/////////////////////////////////////////// SINGLE READS  //////////////////////////
for (i = 0; i < 4; i++) begin
  $display("\n@%0t******** START OF READ  #%d TEST ****  F2SDRAM   ***\n",$time, i); 
  Addr = (i * 1<<AXI4_BYTES_32);    // (i * 1<<AXI4_BYTES_32);  // 0,1,2,3   *  0x20
  rd_resp_tr = test_m.manager_bfm_rd_tx(i, Addr );
  rd_resp_tr.set_size(AXI4_BYTES_32);
  test_m.put_transaction(rd_resp_tr); 
  test_m.drive_transaction();
    
  if (rd_resp_tr.get_data_words(0) == mgrData[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 (0x%h)", 
     		$time, mgrData[i], Addr );
  end 
  else
     $display ( "@ %t  Error: Expected data (%h) at address (0x%h), but got 0x%h", 
     		$time, mgrData[i], Addr, rd_resp_tr.get_data_words(0));
  $display("\n@%0t******** END OF   READ  #%d TEST ***   F2SDRAM   ***\n",$time, i);
end  

/////////////////////////////////////////// INCR WRITES/READS  /////////////////////
for (i = 0; i < 4; i++) begin
   $display("\n@%0t****** START OF INCR BURST #%d TEST **  F2SDRAM  **\n",$time, i); 
   Addr = 32+ (i*1<<AXI4_BYTES_32);
   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_32); 
   wr_resp_tr.set_burst_type(BURST_TYPE_INCR); 
   wr_resp_tr.set_data_words(mgrData[0], 0);	// data, id
   wr_resp_tr.set_data_words(mgrData[1], 1); 
   wr_resp_tr.set_data_words(mgrData[2], 2); 
   wr_resp_tr.set_data_words(mgrData[3], 3); 
   wr_resp_tr.set_write_strobes(32'hffffffff, 0);	// strobe, id
   wr_resp_tr.set_write_strobes(32'hffffffff, 0); 
   wr_resp_tr.set_write_strobes(32'hffffffff, 0); 
   wr_resp_tr.set_write_strobes(32'hffffffff, 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_32); 
   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) == mgrData[j]) begin
       f_incr[i][j]=1'b1;
       $display ( "@ %t  Read correct data (%h) at address (%h)", 
       		$time, mgrData[j], (Addr + j) );      
       end 
    else
       $display ( "@ %t  Error: Expected data (%h) at address (%h), but got %h", 
       		$time, mgrData[j], (Addr + j), rd_resp_tr.get_data_words(j));
    end	   //for j loop
end	//for i loop

/////////////////////////////////////////// CHECK TESTS        /////////////////////
//#2000	// optional delay - if timescale is 1ps/1ps, then  2000ps = 2ns
#(18000000 - $time)		// wait until a certain time

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>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> pass    F2SDRAM ");
else begin
   $display ("\n>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> fail    F2SDRAM ");
   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

end     // initial begin


//----------------------------------------------------------------------------------
//----------------------------  BFM Subordinate
//----------------------------------------------------------------------------------

initial begin 
  AlteraAxiTransaction wr_resp_tr, rd_resp_tr;
  byte_t init_buf[]; 
  int k;

  BaseAxiBfm#(SUB_ADDR_WIDTH, SUB_DATA_WIDTH, SUB_ID_WIDTH, SUB_USER_WIDTH) test_s;  
  test_s =`sub_bfm.AXI4SUB.bfm;
  test_s.s_reset(); 
  
  // Configure BFM as needed
  test_s.set_config(AXI_CONFIG_MAX_OUTSTANDING_WR, 2);
  test_s.set_config(AXI_CONFIG_MAX_OUTSTANDING_RD, 2);
  // Create response transactions
  wr_resp_tr = test_s.subordinate_bfm_wr_resp_tx();
  rd_resp_tr = test_s.subordinate_bfm_rd_resp_tx();

  fork 
    //Initialise the memory 
    init_buf = new[8]; 
    init_buf = {<<byte_t{8'hff}}; 
    
    for (k = 0; k < 256; k++)
      `sub_bfm.host_memory.initialize_data(k, init_buf);       
    
  join 

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

  fork 
    forever begin
       test_s.put_transaction(wr_resp_tr);
       test_s.drive_transaction();
    end
    forever begin
       test_s.put_transaction(rd_resp_tr);
       test_s.drive_transaction();
    end
  join
  
end		// initial begin

endmodule
Level Two Title