Forum Discussion
SD Card Boot
Hi,
I have an Agilex 5 Modular Development Board which I can boot with the supplied SD Card.
I have tried to update to the latest image at Index of /2025.04/gsrd/agilex5_mk_a5e065bb32aes1_gsrd/,
However, after programming an SD Card with this image, as far as I can tell, my board doesn't boot. I get no output from the serial port so I don't have any way of debugging.
Please can you help with any advice how to proceed to diagnose what is going wrong?
Many thanks
Malcolm
36 Replies
- BrianSune_Froum
Contributor
Thank you for op this ticket again.
Under investigation we found that the das-uboot 2023 had no issue while latest 2025 not even pass the spl LD compile.
Meanwhile, the A2 settings and partition for RAW is same between u-boot-socfpga 2024 and das-uboot 2023.
With on the above info altera u-boot-socfpga 2025 aligned with the latest 2025 das u-boot.
However, only u-boot-socfpga 2025 able to compiled w/o issue but unable to load the RAW partition properlly.
Please help or guide what settings are correct.
- BrianSune_Froum
Contributor
Issue solved. The U-Boot 2025 .01 or 0.4 both changed and the configurations are no longer work from default defconfig.
The boot now can work .
- SueC_Altera
Contributor
Thanks for posting your solution, Brian.
Just for clarity - are you saying the 2025 Uboot works or no?
Thanks,
Sue
- BrianSune_Froum
Contributor
All user got to change the "socfpga_cyclone5_defconfig" in order of only MMC/SD card Boot normally.
Both 2025.01 and 2025.04 after modification will work but you got to know how to set the SPL settings.
- SueC_Altera
Contributor
Thank you Brian. I'll ask the team to make that clearer in the documentation.
Sue
- RolandoS_Altera
Occasional Contributor
Hello Brian,
I am in charge of updating the build instructions related to Agilex 5 and we want to improve these as much as we can. Could you please provide more details of the configuration that you needed to do to boot successfully?
Were you using the instructions provided in https://altera-fpga.github.io/rel-25.1.1/embedded-designs/agilex-5/e-series/premium/boot-examples/ug-linux-boot-agx5e-premium/ to build your SPL for the modular dev-kit?
You mentioned that you needed to change socfpga_cyclone5_defconfig, may I know why you started with this defconfing instead of the one specific for Agilex 5 ( socfpga_agilex5_defconfig )?
Thanks in advanceRolando
- malcolm_locke
New Contributor
Hi Rolando, I am pleased to hear that you are updating the build instructions for Agilex 5! I have been trying to follow the instructions in this link
for the Boot from QSPI but have given up as, having got around a number of errors, I managed to create and program my QSPI, only for to fail to boot (I can't even open the Serial Port), at which point I have no way to debug what is happening...
One error that I have relates to bl31.bin which i built successfully in the Boot from SD Card stage, but when I run bitbake in the QSPI stage, i get this error:
DEBUG: Executing shell function do_compile cp: cannot stat '/home/malc/agilex5_top/yocto/build/tmp/deploy/images/agilex5_dk_a5e065bb32aes1/bl31.bin': No such file or directory WARNING: /home/malc/agilex5_top/yocto/build/tmp/work/agilex5_dk_a5e065bb32aes1-poky-linux/u-boot-socfpga/v2025.04+git/temp/run.do_compile.19724:163 exit 1 from 'cp /home/malc/agilex5_top/yocto/build/tmp/deploy/images/agilex5_dk_a5e065bb32aes1/${file} /home/malc/agilex5_top/yocto/build/tmp/work/agilex5_dk_a5e065bb32aes1-poky-linux/u-boot-socfpga/v2025.04+git/build/${config}/${file}' WARNING: Backtrace (BB generated script): #1: do_compile, /home/malc/agilex5_top/yocto/build/tmp/work/agilex5_dk_a5e065bb32aes1-poky-linux/u-boot-socfpga/v2025.04+git/temp/run.do_compile.19724, line 163 #2: main, /home/malc/agilex5_top/yocto/build/tmp/work/agilex5_dk_a5e065bb32aes1-poky-linux/u-boot-socfpga/v2025.04+git/temp/run.do_compile.19724, line 301
PS. I am using WSL2.
In the boot from QSPI section, it is unclear what, if anything I need to do with the SD Card...
Also, on this page:
HPS GSRD User Guide - Altera FPGA Developer Site
The 2 links below don't work.
Prebuilt Binaries¶
The Agilex 5 Modular Development Kit GSRD binaries are located at https://releases.rocketboards.org/2025.08/:
Boot Source LinkSD Card https://releases.rocketboards.org/2025.08/gsrd/agilex5_modular_gsrd/ QSPI https://releases.rocketboards.org/2025.08/qspi/agilex5_modular_qspi/ and, in this section the link to rocketboards doesn't work.
Booting from QSPI¶
This section presents how to boot from QSPI. One notable aspect is that you need to wipe the SD card partitioning information, as otherwise U-Boot SPL could find a valid SD card image, and try to boot from that first.
Wipe SD Card
Either write 1MB of zeroes at the beginning of the SD card, or remove the SD card from the HPS Daughter Card. You can use dd on Linux, or Win32DiskImager on Windows to achieve this.
Write QSPI Flash
1. Power down board
2. Set MSEL dipswitch S4 on SOM to JTAG: OFF-OFF
3. Power up the board
4. Download and extract the JIC image, then write it to QSPI:
wget https://releases.rocketboards.org/2025.08/qspi/agilex5_mk_a5e065bb32aes1_qspi/agilex_flash_image.hps.jic.tar.gz tar xf agilex_flash_image.hps.jic.tar.gz jtagconfig --setparam 1 JtagClock 16M quartus_pgm -c 1 -m jtag -o "pvi;agilex_flash_image.hps.jic"
If you can sort out these issues that would be a great help...
Thanks
Malcolm
- RolandoS_Altera
Occasional Contributor
Hi Malcom
I confirmed that the links in the Agilex 5 GSRD pages pointing to the binaries is incorrect, the correct paths are the following:
Agilex 5 Modular Dev Kit:
SD Card: https://releases.rocketboards.org/2025.08/gsrd/agilex5_mk_a5e065bb32aes1_gsrd/
QSPI: https://releases.rocketboards.org/2025.08/qspi/agilex5_mk_a5e065bb32aes1_qspi/
Agilex 5 Premium Dev Kit:
SD Card: https://releases.rocketboards.org/2025.08/gsrd/agilex5_dk_a5e065bb32aes1_gsrd/
QSPI: https://releases.rocketboards.org/2025.08/qspi/agilex5_dk_a5e065bb32aes1_qspi/
I will fix this in our GSRD pages.
Related to the need of wipe the SDCard, this is only needed when building the binaries using the GSRD flow. This happens because the U-Boot SPL tries to find the u-boot.itb from the different boot devices starting with the SDCard. If you look at the HPS GHRD Linux Boot Examples page (https://altera-fpga.github.io/rel-25.1.1/embedded-designs/agilex-5/e-series/modular/boot-examples/ug-linux-boot-agx5e-modular/#boot-from-sd-card), this line changes the list of devices in which it will try to boot from, keeping only mmc, which corresponds to the SD Card.
sed -i 's/u-boot,spl-boot-order.*/u-boot\,spl-boot-order = \&mmc;/g' arch/arm/dts/socfpga_agilex5_socdk-u-boot.dtsi
Related to the errors that you are seeing when building the binaries, it's possible that a package could be missing in the WSL2 environment when building the RootFS, but what is weird is that in this page https://altera-fpga.github.io/rel-25.1.1/embedded-designs/agilex-5/e-series/modular/boot-examples/ug-linux-boot-agx5e-modular, you just use the rootfs in the Linux boot stage and shouldn't affect that you see something on the serial console. The U-Boot SPL is the first binary that HPS executes and this is included as part of the bitstream provided to the system. This bitstream includes the hardware design(.sof) and the SPL(.hex):
In the case of booting from SD Card:
In the case of Booting from QSPI:
If the hardware design(.sof) and the SPL(.hex) were created correctly, you should be able to see an output from the serial console. here you also need to double-check that in your devkit, the msel is set to QSPI so it can read the bitstream from the QSPI.
If you have problems generating the RootFS, you can get this directly from the Pre-Built binaries included in the correct paths provided above.
Thanks
Rolando
- BrianSune_Froum
Contributor
My questions are related to this ticket title SD Card Boot on latest version of 2025.01 or 2025.04.
If not wrongly understood the U-Boot had been changed since 2025
My original question : community.intel.com/t5/Intel-SoC-FPGA-Embedded/SD-Card-Boot/m-p/1714327#M3341
So unless Altera drop any support on C5,A5 I cannot see the default config can work proper on the 2024 or previous spl configurations. - BrianSune_Froum
Contributor
The last comment is wrongly written.
So unless Altera drop any support on C5,A5 I cannot see the default config can work proper on the 2025 same as previous 2024 or even older version of spl configurations.
- RolandoS_Altera
Occasional Contributor
Hi Brian
I don't think we had drop the support of these devices, but the embedded software (including U-Boot) evolves from release to release. Sometimes, there are dependencies on using the correct component versions to boot successfully ( SDM FW included on Quartus, ATF. U-Boot SPL, U-Boot, Linux). So in our releases pages (https://github.com/altera-fpga/gsrd-socfpga/releases) we include the combinations of components that we validate. For GSRD page or any other page with instructions to build binaries, we have a version of the page for each one of the releases with the component version combinations that we know they work. For this pages, we switched from Rocketboards to https://altera-fpga.github.io/ some time ago. For Agilex 5, I think most of the versions are already in the new site.
Thanks
Rolando
- BrianSune_Froum
Contributor
I am confused what actually you are asking or confirming?
For Das U-Boot 2025 01 and 04 had changed the SPL detection.While 2025 07 the stack is even changed which at this stage I can't make it boot on any Cyclone V device.
For both Altera Git U-Boot or Das U-Boot I had confirmed 2025 01 04 and older revision all aligned excluded dts file.
Aka modifications to boot properly on SD only platform.
I had not followed any altera boot document nor the rocket forum b.c. the follow is not telling any backward compatibility.
However it is actually allow on older "hps_isw_handoff" folder to reused on new Python script.
So I am not sure what you are asking for.
As far I can tell I have no idea why the 2025 07 cannot boot properly.
There are too many patches on SPL and the stack change include start.S.
- BrianSune_Froum
Contributor
On top of your responses.
I am not pointing on the stage after SPL aka U-Boot. Only focusing on SPL aka the HPS ARM ROM detecting the SPL etc.
I cannot see this is related to component variant. b.c. as long as the HEX data on the MBR sanity is good. Then it should at least provide message on serial port.
However on 2025 01 or 04 it is not able to do so on default cyclone_V defconfig file passed along version of U-Boot.
- RolandoS_Altera
Occasional Contributor
Hello Brian
Our documentation and HPS releases are based on the Altera repositories (https://github.com/altera-fpga). Please look at our Release Notes page that shows what versions of each component we released:
https://github.com/altera-fpga/gsrd-socfpga/releases/tag/QPDS25.1.1_REL_GSRD_PR
In the case of U-Boot, the latest release is based on 2025.04. The next release will be based in 2025.07.
We are working to push all the updates that we have in our repositories to the repositories that the community supports (i.e. https://github.com/u-boot/u-boot) but it's possible that the latest code in the Altera repos are not yet propagated to the community repos, so this is the reason why we direct our customers to use the Altera repos.
If you have any further questions about Cyclone V, it would be better to open a new case, so we can focus in this case to solve the issues related to Agilex 5.
Thanks
Rolando
- BrianSune_Froum
Contributor
I do see the github page info.
However, if you know better as internal stuff you should see Cyclone V only up to 2024.07.
The golden package links are all dead.
There are no confirmation nor test built on 2025.01 .04 etc.
There are no sanity check on SPL boot after this early year SPL boot RAW settings had changed.
I guess Altera would reduce massive support on C5 and market+support Ag5 for business purpose.
- tehjingy_Altera
Regular Contributor
Hi Brian
Is is not recommended to always grab the latest uboot branch, the latest branch has the latest updates and patch that was pushed for any on going issues.
Please refer to the last verified combination in the Altera GitHub page.
The last verified branch is :
Device Quartus Version U-Boot Branch Linux Branch Cyclone V SoC 24.1 Std socfpga_v2024.07 socfpga-6.6.51-lts Regards
Jingyang, Teh
- BrianSune_Froum
Contributor
Yes in other post you had reported 2024.07 is well tested.
However, 2025 01 04 is already released a while, not sure the definition of latest.
The most update now is 2025.10 so I am just thinking the resources are not put on C5 series not b.c. of the word of latest.
Thank you
- AlanCLTan
Occasional Contributor
Hi,
For Cyclone V, Quartus 24.1std is the latest release.
Quartus Pro releases in yearly cadence. Hence, the next release, 25.1std, will happen at the end of 2025.
Thanks,
Alan
- SueC_Altera
Contributor
Hi Brian,
This thread somehow got split. Malcolm's original question was about Cyclone V and Alan is addressing those questions.
Sue
- BrianSune_Froum
Contributor
You are also misread the topic.
What this original ticket is about SD Card U-Boot booting on Ag5.
I don't understand why you guys will consider U-Boot is device dependent.As for what the title mentioned is no device orientated.
As such I cannot understand at what points / posts / questions that are not U-Boot related question from first place.