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.2. test_lwh2f.sv

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

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

`define lwh2f_test_m        simple_tb.simple_inst.intel_agilex_5_soc_0.\
				intel_agilex_5_soc_0.sm_hps.sundancemesa_hps_inst.\
				lwh2f_bfm_gen.lwh2f_axi4_master_inst.AXI4MAN.bfm

module test_lwh2f#();

localparam A_WIDTH=29;
localparam D_WIDTH=32; 

int i,j;
bit status, f_rw[8], f_incr[8][8];

reg [A_WIDTH-1:0] Addr;		// 29 bit addr
int Data[8];			// 32 bit data

//---------------------------------------------------------------------------------
//----------------------------  BFM Manager (lwh2f)
//---------------------------------------------------------------------------------
initial begin 

  AlteraAxiTransaction wr_resp_tr, rd_resp_tr;

  Data[0] = 'haaaaaaaa;
  Data[1] = 'hbbbbbbbb;
  Data[2] = 'hcccccccc;
  Data[3] = 'hdddddddd;
  
  $display("\n\n\n *************** START OF  LWH2F testing *************** \n\n\n");
  
  `lwh2f_test_m.m_reset();

/////////////////////////////////////////// SINGLE WRITES //////////////////////////
for (i = 0; i < 4; i++) begin
  $display("\n@%0t*********** START OF WRITE #%d TEST *******  LWH2F  ********\n",
  					$time, i);
  Addr = (i * 1<<AXI4_BYTES_4);
  wr_resp_tr = `lwh2f_test_m.manager_bfm_wr_tx( i, Addr );        // id, addr
  wr_resp_tr.set_data_words(Data[i], 0);		// data, index
  wr_resp_tr.set_write_strobes(4'hf, 0);		// strobe, index
  `lwh2f_test_m.put_transaction(wr_resp_tr); 
  `lwh2f_test_m.drive_transaction(); 
  $display("\n@%0t******** END OF   WRITE #%d TEST *****  LWH2F  *****\n",$time, i);
end
/////////////////////////////////////////// SINGLE READS  //////////////////////////
for (i = 0; i < 4; i++) begin
  $display("\n@%0t*********** START OF READ  #%d TEST ******   LWH2F   *********\n",
  			$time, i); 
  Addr = (i * 1<<AXI4_BYTES_4);
  rd_resp_tr = `lwh2f_test_m.manager_bfm_rd_tx( i, Addr );	// id, addr
  rd_resp_tr.set_size(AXI4_BYTES_4);
  `lwh2f_test_m.put_transaction(rd_resp_tr); 
  `lwh2f_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 (0x%h)", 
        		$time, Data[i], Addr );
    end 
  else
        $display ( "@ %t Error: Expected data (%h) at address (0x%h), but got %d", 
        		$time, Data[i], Addr, rd_resp_tr.get_data_words(0));
  $display("\n@%0t****** END OF   READ  #%d TEST ****  LWH2F   ******\n",$time, i);
end
/////////////////////////////////////////// INCR WRITES/READS  /////////////////////
for (i = 0; i < 4; i++) begin
  $display("\n@%0t***** START OF INCR BURST #%d TEST ***   LWH2F  ***\n",$time, i);
  Addr = 16+ (i*1<<AXI4_BYTES_4);
  wr_resp_tr = `lwh2f_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_4); 
  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(4'hf, 0);	// strobe, id
  wr_resp_tr.set_write_strobes(4'hf, 1); 
  wr_resp_tr.set_write_strobes(4'hf, 2); 
  wr_resp_tr.set_write_strobes(4'hf, 3); 
  `lwh2f_test_m.put_transaction(wr_resp_tr);
  `lwh2f_test_m.drive_transaction();

  rd_resp_tr = `lwh2f_test_m.manager_bfm_rd_tx( (4+i), Addr );	// id, addr
  rd_resp_tr.set_burst_length(3); 
  rd_resp_tr.set_size(AXI4_BYTES_4); 
  rd_resp_tr.set_burst_type(BURST_TYPE_INCR); 

fork 
   begin 
	`lwh2f_test_m.put_transaction(rd_resp_tr); 
	`lwh2f_test_m.drive_transaction(); 
   end 
   begin 
	`lwh2f_test_m.put_transaction(wr_resp_tr); 
	`lwh2f_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
#(18000000 - $time)		// wait until time 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    LWH2F ");
else begin
   $display ("\n>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> fail    LWH2F ");
   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 *****      LWH2F    ******\n",$time); 

end     // initial begin

endmodule
Level Two Title