Forum Discussion

Feng-Y-28's avatar
Feng-Y-28
Icon for New Contributor rankNew Contributor
2 years ago
Solved

Questions: Intel oneAPI 24.2 with DE10-Agilex and Related Environment setup

Regarding version compatibility issues with Intel FPGA development environment, I have the following questions:
I'm using the Terasic DE10-Agilex Kit, initially with oneAPI version 22.1. When attempting to upgrade to the latest oneAPI 24.2, I encountered compatibility issues - the generated binary files are not working correctly. This contradicts Intel's official documentation----Intel® oneAPI FPGA Acceleration Card Support, which indicates oneAPI support for this development board.
Regarding the FPGA development workflow, I understand that BSP and Quartus must work together to convert System Verilog IP to RTL circuits. However, Intel recently announced the discontinuation of support for specific older Quartus versions (such as 21.2/21.4). Does this mean that development kits using these Quartus versions will not be compatible with the new oneAPI 24.2?
I've also noticed that Intel's cloud development platform has migrated to Triber AI Cloud, but I cannot find FPGA-related development resources in its hardware directory.
My core questions are:
Is there a definitive version compatibility matrix detailing how new versions of oneAPI support various FPGA development boards (such as DE10-Agilex, Bittware 520N-MX, etc.)?
Does the new version of oneAPI have backward compatibility? Will it support previous FPGA development boards if the configuration is correct?

High-level Design Tools
  • whitepau_altera's avatar
    whitepau_altera
    2 years ago

    Hello Feng,

    I'm sorry for the trouble you've been having. We test the compiler against a reference BSP on devkit hardware, but it is ultimately up to board vendors to validate that their hardware and firmware work with the latest oneAPI compiler release. If Terasic only validates 2022.1, then that is the only version that is officially known to work with that card.

    Having said that, my colleague was able to successfully compile your design using

    • Ubuntu 20.04.6 LTS
    • oneAPI 2024.1
    • Quartus® Prime Pro 21.2
    • the Terasic BSP

    He saw the same license issue with oneAPI 2024.2.

    I suggest as a last resort that you remove other versions of the Quartus® Prime and oneAPI software, leaving only oneAPI 2024.1 and Quartus® Prime Pro 21.2.

    I have personally experienced issues with license files that were not configured correctly. For example, a Quartus fixed license only works for a machine whose ethernet MAC address matches the ID embedded in the license file. This means that a license file for my workstation will not work for your workstation. From your Terasic email chain that you shared, it sounds like you may be using a liceense0046.dat from a different machine, rather than one that they specifically made for you:

    How did you get the license0046.dat before? There are not any previous emails communication with you that we send you this license file.



22 Replies

  • BoonBengT_Altera's avatar
    BoonBengT_Altera
    Icon for Moderator rankModerator
    2 years ago

    Hi @Feng-Y-28,


    Great! Good to know that it is working now, with no further clarification on this thread, it will be transitioned to community support for further help on doubts in this thread. Please login to ‘https://supporttickets.intel.com’, view details of the desire request, and post a feed/response within the next 15 days to allow me to continue to support you. After 15 days, this thread will be transitioned to community support.

    Thank you for the questions and as always pleasure having you here.


    Best Wishes

    BB



  • whitepau_altera's avatar
    whitepau_altera
    Icon for Contributor rankContributor
    2 years ago

    Thanks for checking with Terasic. We don't normally test with the Terasic DE10-Agilex cards.

    I see that we observe the same issue with oneAPI 2024.2 and the Terasic BSP, however oneAPI 2024.1 appears to compile successfully (as noted in https://community.intel.com/t5/Intel-High-Level-Design/Error-while-linking-host-code-device-code-in-sycl-with-icpx/m-p/1641487). You can download the 2024.1 basekit from linux package repositories the same way you downloaded 2024.2, except you don't need to install a separate FPGA support package.

    • Feng-Y-28's avatar
      Feng-Y-28
      Icon for New Contributor rankNew Contributor
      2 years ago

      I read the linked attached discussion, but I do not see a successful reply.

      I get the same error as before with 24.2; I cut from the quartus_sh_compile.log file:


      Error (292014): Can't find valid feature line for core adjust_plls_ag_pxx (535C_0046) (Vendor: Terasic) in current license.
      Internal Error: Sub-system: QEXE, File: /quartus/comp/qexe/qexe_framework.cpp, Line: 1964
      Input TCL is not properly encrypted by altcrypt


      Error (23035): Tcl error:
      while executing
      "qexec "quartus_cdb -t scripts/adjust_plls_ag_pxx.tcl""
      (file "scripts/post_flow_pr.tcl" line 59)
      Error (23031): Evaluation of Tcl script scripts/post_flow_pr.tcl unsuccessful
      Error: Quartus Prime Compiler Database Interface was unsuccessful. 2 errors, 0 warnings
      Error: Peak virtual memory: 797 megabytes
      Error: Processing ended: Sat Nov 9 13:43:01 2024
      Error: Elapsed time: 00:04:46
      Error: System process ID: 214522


      Error (23035): Tcl error:
      while executing
      "qexec "quartus_cdb -t scripts/post_flow_pr.tcl \"$top_path\"""
      invoked from within
      "if {$revision_name eq "top"} {

      post_message "Compiling top revision..."

      # Load OpenCL BSP utility functions
      source "$sdk_root/ip/board/bsp/ope..."
      (file "compile_script.tcl" line 39)
      Error (23031): Evaluation of Tcl script compile_script.tcl unsuccessful
      Error: Quartus Prime Compiler Database Interface was unsuccessful. 2 errors, 0 warnings
      Error: Peak virtual memory: 797 megabytes
      Error: Processing ended: Sat Nov 9 13:43:01 2024
      Error: Elapsed time: 01:20:26
      Error: System process ID: 203816

      I also check the $LM_LICENSE_FILE before my test.

      I suffered from these processes in the past year trying and testing. And now back to my initial confusion:

      What is the work environment for OneAPI: 24.2/24.1 on DE10-Agilex?
      Or does the DE10_Agilex only work with OneAPI22.1?

      Regards

      Feng

      • whitepau_altera's avatar
        whitepau_altera
        Icon for Contributor rankContributor
        2 years ago

        Hello Feng,

        I'm sorry for the trouble you've been having. We test the compiler against a reference BSP on devkit hardware, but it is ultimately up to board vendors to validate that their hardware and firmware work with the latest oneAPI compiler release. If Terasic only validates 2022.1, then that is the only version that is officially known to work with that card.

        Having said that, my colleague was able to successfully compile your design using

        • Ubuntu 20.04.6 LTS
        • oneAPI 2024.1
        • Quartus® Prime Pro 21.2
        • the Terasic BSP

        He saw the same license issue with oneAPI 2024.2.

        I suggest as a last resort that you remove other versions of the Quartus® Prime and oneAPI software, leaving only oneAPI 2024.1 and Quartus® Prime Pro 21.2.

        I have personally experienced issues with license files that were not configured correctly. For example, a Quartus fixed license only works for a machine whose ethernet MAC address matches the ID embedded in the license file. This means that a license file for my workstation will not work for your workstation. From your Terasic email chain that you shared, it sounds like you may be using a liceense0046.dat from a different machine, rather than one that they specifically made for you:

        How did you get the license0046.dat before? There are not any previous emails communication with you that we send you this license file.



    • Feng-Y-28's avatar
      Feng-Y-28
      Icon for New Contributor rankNew Contributor
      2 years ago

      ~$ apt-cache policy intel-oneapi-base-toolkit
      intel-oneapi-base-toolkit:
      Installed: (none)
      Candidate: 2025.0.0-884
      Version table:
      2025.0.0-884 500
      500 https://apt.repos.intel.com/oneapi all/main amd64 Packages

      When I tried installing it with apt, it seemed only to have the 2025.0 version.

      I use the online installation for 2024.2 because the Get the Intel® oneAPI Base Toolkit web only provides these two versions.

      Could you please offer the link for 2024.1 downloads, online installer, offline installer, and apt download link both OK?

    • Feng-Y-28's avatar
      Feng-Y-28
      Icon for New Contributor rankNew Contributor
      2 years ago

      Subject: RE: DE10-Agilex BSP License Issue - Additional Testing Information

      I would like to share additional testing information regarding the DE10-Agilex BSP license issue:

      1. Environment Setup Status:
      - As per Teras ic's manual, $LM_LICENSE_FILE has been properly configured
      - QUARTUS_ROOTDIR_OVERRIDE is correctly set to point to the Quartus installation, same as the 2022.1 environment pointed file.

      2. Current Testing Results:
      - I have a fully functional environment with oneAPI 22.1 on the same system
      - With oneAPI 24.2, I can successfully:
      * Run 'aocl diagnose'
      * Generate emulation files
      * Generate report files
      - However, FPGA binary generation fails consistently with this error:


      Error (292014): Can't find valid feature line for core adjust_plls_ag_pxx (535C_0046) (Vendor: Terasic) in current license.
      Error (23035): Tcl error:
      Error (23031): Evaluation of Tcl script scripts/post_flow_pr.tcl unsuccessful
      Error: Quartus Prime Compiler Database Interface was unsuccessful. 2 errors, 0 warnings
      3. Test Cases:
      - Using samples from oneAPI 2024.2 GitHub repository
      - Tested both 'fpga_compile' project and 'printf' project from features directory
      - Both tests produce identical errors

      Best regards,
      Feng

      ---------- Forwarded message ---------
      From: support02 <support@terasic.com.cn>
      Date: Wed, 6 Nov 2024 at 21:06
      Subject: Re: Subject: DE10-Agilex BSP License Issue - Error 292014
      To: Feng Yan <fyan691@aucklanduni.ac.nz>
      Cc: <support@terasic.com>, <sales@terasic.com>


      Hi Feng,

      To be honest we don't test to verify if license0046.dat is still working in new version Quartus and new oneAPI toolkit 2024, it's just a unverified suggestion for you to use new version Quartus.

      Thanks.


      在 2024/11/6 15:16, Feng Yan 写道:
      Hi Ice
      The license was in the lab workstation, which our lab technician provided. I am doing PhD at the University of Auckland in Parallel and Reconfigurable Computing Lab.
      I want to check if the new version of Quartus(like 2022.3) uses the same license file( license0046.dat) before my test.
      Regards
      Feng

      On Wed, 6 Nov 2024 at 19:24, support02 <support@terasic.com.cn> wrote:

      Hi Feng,

      How did you get the license0046.dat before? There are not any previous emails communication with you that we send you this license file.

      We also advise you to use a newer version of Quartus to test, check if you will get the same error.

      Thanks.


      在 2024/11/6 10:41, Feng Yan 写道:
      Hi Ice
      Here is the screenshot, the same as the bottom of the attachment in the first email.

      Previously, the license0046.dat was loaded into the local lab's workstation. I have also used the 2022.2 Oneapi successfully previously with this set.
      I encountered this error when I tried to upgrade the oneapi to 2024.2. According to my discussion with Intel support, DE10_Agilex should also support with this version oneapi.
      Regards
      Feng



      On Wed, 6 Nov 2024 at 15:23, support02 <support@terasic.com.cn> wrote:

      Hi Feng,

      We think your license file isn't set correctly, how did you get the license0046.dat before? Please provide screenshot for the result of echo $LM_LICENSE_FILE.

      By the way, did you test our oneAPI BSP v21.2 with oneAPI toolkit 2022 and the same license0046.dat setting successfully?

      Thanks.


      在 2024/11/6 9:42, Feng Yan 写道:

      Hi Ice,

      Thank you for your prompt response. I would like to clarify a few points regarding my license issue:

      1. I have already set up the LM_LICENSE_FILE variable as per the manual's Section 3.3, and I can confirm the variable is pointing to the correct license0046.dat file location (verified through echo $LM_LICENSE_FILE).
      2. However, I'm still encountering this specific error: Error (292014): Can't find valid feature line for core adjust_plls_ag_pxx (535C_0046) (Vendor: Terasic)

      Given that I have properly set up the Terasic license file, I would like to understand:

      • Is this particular error still within Terasic's scope, or should it be handled by Intel support since it relates to PLL IP core functionality?

      Your guidance on whether this is a Terasic license issue or an Intel Quartus compatibility matter..

      Best regards

      Feng


      On Wed, 6 Nov 2024 at 14:10, support02 <support@terasic.com.cn> wrote:

      Dear Feng,

      Thanks for using DE10-Agilex board.

      An additional license is required when customer use our oneAPI BSP v21.2, please see the attached license file. You can refer to section 3.3 Setup License for BSP of our DE10-Agilex OneAPI User Manual to set it. However we aren't sure if it will solve your issue as you are using oneAPI 24.2 base toolkit.

      Best Regards,

      Ice


      在 2024/11/6 6:24, Feng Yan 写道:
      Dear Terasic Technical Support,

      I am using the DE10-Agilex development board with the following setup:
      - Ubuntu 20.04
      - Intel oneAPI 24.2 base toolkit
      - Quartus Prime Pro 21.2
      - BSP version: B2E2_8GBx4

      While attempting to generate binaries, I'm encountering the following error despite having set up $LM_LICENSE_FILE according to the manual:

      Error (292014): Can't find valid feature line for core adjust_plls_ag_pxx (535C_0046) (Vendor: Terasic)

      Could you please:
      1. Confirm if there are additional license requirements for this specific IP core?
      2. Provide guidance on resolving this license-related error?

      Thank you for your assistance. Other details can be find through this link, my discussion with Intel support:
      https://community.intel.com/t5/Intel-Quartus-Prime-Software/Questions-Intel-oneAPI-24-2-with-DE10-Agilex-and-Related/m-p/1641427/emcs_t/S2h8ZW1haWx8dG9waWNfc3Vic2NyaXB0aW9ufE0zNFNaUzRYUkJEMzcwfDE2NDE0Mjd8U1VCU0NSSVBUSU9OU3xoSw#M84590

      Best regards,
      Feng
    • Feng-Y-28's avatar
      Feng-Y-28
      Icon for New Contributor rankNew Contributor
      2 years ago

      This is the detail that confused me about whether the oneapi 24.2 supported DE10_Agilex. I tried this for half a year, from time to time.

      >>>>>>The $LM_LICENSE_FILE is set to the correct location.
      I set it according to the manual, as I said before.

      Once I got the error message, the first step I took was to check the licence setup.


      I can use the oneapi 22.1 successfully with the set-up guide provided by the manual but always failed with 24.2.

      I searched the Error (292014) online and found some other conditions that the Quartus needs to be set(I'm not sure).

    • Feng-Y-28's avatar
      Feng-Y-28
      Icon for New Contributor rankNew Contributor
      2 years ago

      I installed the intel-oneapi-compiler-fpga and intel-oneapi-base-toolkit, both 24.2

      I can successfully passed aocl diagnosed

      When I try the binary generation, get the following errors:

      Error (292014): Can't find valid feature line for core adjust_plls_ag_pxx (535C_0046) (Vendor: Terasic) in current license.
      Internal Error: Sub-system: QEXE, File: /quartus/comp/qexe/qexe_framework.cpp, Line: 1964
      Error (23035): Tcl error:
      Error (23031): Evaluation of Tcl script scripts/post_flow_pr.tcl unsuccessful
      Error: Quartus Prime Compiler Database Interface was unsuccessful. 2 errors, 0 warnings
      Error: Peak virtual memory: 797 megabytes
      Error: Processing ended: Tue Nov 5 17:56:00 2024
      Error: Elapsed time: 00:04:45
      Error: System process ID: 25198
      Error (23035): Tcl error:
      Error (23031): Evaluation of Tcl script compile_script.tcl unsuccessful
      Error: Quartus Prime Compiler Database Interface was unsuccessful. 2 errors, 0 warnings
      Error: Peak virtual memory: 797 megabytes
      Error: Processing ended: Tue Nov 5 17:56:00 2024
      Error: Elapsed time: 01:20:45
      Error: System process ID: 4863


      The $LM_LICENSE_FILE is set to the correct location.

      Ubuntu:20.04
      The Quartus version is pro 21.2.
      BSP: B2E2_8GBx4

  • whitepau_altera's avatar
    whitepau_altera
    Icon for Contributor rankContributor
    2 years ago

    please make sure you install the FPGA support package for 2024.2 and beyond


    According to Terasic's documentation, you should use Quartus® Prime 21.2 with their BSP.

    The work enviro for OneAPI: 24.2 on DE10-Agilex is should be as follows:

    22.04 20.04 Ubuntu

    Quartus® Prime Pro 22.3-24.2 21.2

    BSP version: B2E2_8GBx4
    OneAPI 2024.2 base toolkit
    FPGA Support Package version 2024.2

    • Feng-Y-28's avatar
      Feng-Y-28
      Icon for New Contributor rankNew Contributor
      2 years ago

      I searched for the FPGA support package 2024.2 but could not find it on the Intel website today, which may have been provided one week ago.

      The download link is only for 25.0. However, the oneAPI base toolkit provided the different versions, 24.2/25.0, for download.

      Regards

      Feng

  • whitepau_altera's avatar
    whitepau_altera
    Icon for Contributor rankContributor
    2 years ago

    Hello, thanks for the question; sorry for the slow reply!

    > The generated binary files are not working correctly

    Can you please elaborate some more on this? What OS are you using? What driver/BSP do you have? What version of Quartus® Prime are you using? When you say 'oneAPI 24.2', should I assume you mean oneAPI 2024.2 base toolkit + FPGA Support Package version 2024.2?

    > Intel recently announced the discontinuation of support for specific older Quartus versions (such as 21.2/21.4). Does this mean that development kits using these Quartus versions will not be compatible with the new oneAPI 24.2?

    That is correct. Boards whose BSPs are not kept up to date and compatible with a version of Quartus® Prime from the past 2 years will not be supported by the FPGA Acceleration flow.

    > Is there a definitive version compatibility matrix detailing how new versions of oneAPI support various FPGA development boards (such as DE10-Agilex, Bittware 520N-MX, etc.)?

    Yes, it is on our homepage:

    Additional Cards Available from Partner Vendors

    • Feng-Y-28's avatar
      Feng-Y-28
      Icon for New Contributor rankNew Contributor
      2 years ago

      Hi whitepau

      Thanks for your kind reply.

      >System details:

      Here are my enviro details:

      20.04 Ubuntu

      Quartus® Prime Pro 21.2

      BSP version: B2E2_8GBx4
      OneAPI 2024.2 base toolkit
      FPGA Support Package version 2024.2， this seems not installed;

      I will upgrade the OS to 22.04 Ubuntu and install the FPGA Support Package.       Before my test, I want to check the oneAPI 24.2 is compatible with DE10-Agilex. My issue is about the system environments.

      >That is correct. Boards whose BSPs are not kept up to date and compatible with a version of Quartus® Prime from the past 2 years will not be supported by the FPGA Acceleration flow.

      I find that Quartus 24.2 can support the DE10-Agilex bitstreams file; I am unsure whether this Quartus can, together with BSP version B2E2_8GBx4, in the FPGA Acceleration flow. Or can the B2E2_8GBx4 only support Quartus 21.2?

      In conclusion, the work enviro for OneAPI: 24.2 on DE10-Agilex is as follows:

      22.04 Ubuntu

      Quartus® Prime Pro 22.3-24.2

      BSP version: B2E2_8GBx4
      OneAPI 2024.2 base toolkit
      FPGA Support Package version 2024.2

      One more thing:
      So far, does only the PAC D5005 board support USM functions in OneAPI?


      Regards

      Feng