HAL Kernel Version Mismatch Error During FPGA Emulation with vector-add Sample

[Pavithran11]

Hello Intel FPGA team,

I'm currently working on the vector-add example from the official oneAPI-samples repository, specifically from:

DirectProgramming/DPC++/DenseLinearAlgebra/vector-add

I’m encountering the following runtime error when I attempt to run the emulation build:

Error output:

./vector-add-buffers.fpga_emu
HAL Kern: Version mismatch! Expected 0xa0c00001 but read 0x4130
Hardware version ID differs from version expected by software. Either:
a) Ensure your compiled design was generated by the same ACL build
currently in use, OR
b) The host can not communicate with the compiled kernel.

vector-add-buffers.fpga_emu: /nfs/sc/disks/swip_hld_1/ops/SC/hld/nightly/2022.1/96.2/l64/work/acl/acl/source/57c9d2bcb46afcf445b5da2406c0e6d85be93ef3/src/acl_kernel_if.cpp:733:
int acl_kernel_if_init(acl_kernel_if*, acl_bsp_io, acl_system_def_t*): Assertion `0' failed.
make: *** [Makefile.fpga:35: run_emu] Error 1

Environment details:

• Board: DE10-Agilex

• BSP Path: /opt/intel/oneapi/intelfpgadpcpp/2021.4.0/board/de10_agilex

• oneAPI version: Installed multiple versions. Active: 2022.0.2

• dpcpp path: /opt/intel/oneapi/compiler/2022.0.2/linux/bin/dpcpp

• OS: Ubuntu (detected as Rocky Linux during install attempts)

What I have tried:

• Verified the AOCL_BOARD_PACKAGE_ROOT is correctly set.

• Recompiled the design using make clean && make fpga_emu.

• Ran aoc -list-board-packages to confirm the installed board.

• Ensured Quartus, BSP, and compiler are aligned.

Despite that, I still encounter the HAL version mismatch.

Request:

Could someone guide me on how to:

• Resolve this version mismatch issue?

• Confirm the correct environment and runtime versions are in sync?

• Completely clean older/duplicate oneAPI installations if that’s the root cause?

@intel @OneAPI @fpga @agilex7 @de10 @intel6 

[BoonBengT_Altera]

Hi @Pavithran11,

Thank you for posting in Intel community forum, hope all is well and apologies for the delayed in response.

The HAL version mismatch may be cause by the runtime or emulation environment not matching with compiled kernel metadata. Which sometime multiple oneAPI version could cause the mismatched.

Would suggest the following below:

- Check for only source one version of oneapi: source /opt/intel/oneapi/setvars.sh

- Manually source the matching BSP with some command as followed: export AOCL_BOARD_PACKAGE_ROOT=/opt/intel/oneapi/intelfpgadpcpp/2022.0.2/board/de10_agilex

- Just to confirm there is no duplicates BSP when running the aoc -list-boards right?

- Are you seeing this issue only in emulation (fpga_emu)?

Hope to hear from you soon.

Best Wishes

BB

[BoonBengT_Altera]

Hi @Pavithran11,

Good day, just following up on the previous clarification.

By any chances did you managed to look into it?

Hope to hear from you soon.

Best Wishes

BB

[BoonBengT_Altera]

Hi @Pavithran11,

Greetings, as we do not receive any further clarification/updates on the matter, hence would assume challenge are overcome.

Please login to ‘ https://supporttickets.intel.com/s/?language=en_US’, 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. The community users will be able to help you on your follow-up questions. For new queries, please feel free to open a new thread and we will be right with you. Pleasure having you here.

Best Wishes

BB