FAQs, Known Limitations, Support¶
Intel® Edge Software Support Forum¶
Expand your knowledge of Intel® Edge Software through participating in the Intel® Edge Software Support Forum community.
Submit Intel® Edge Controls for Industrial questions to Intel® Technical Support and find answers to your support issues: Intel® Edge Software Hub - Intel Communities.
Frequently Asked Questions¶
- I used my personal email address while requesting for access, and it has been more than two working days. I have not yet received the product key. What should I do?
It is recommended to use an official email address instead of your personal email address.
- I used my official email address while requesting for access. It has been more than two working days, and I have not yet received the product key. What should I do?
Downloading of Intel® Edge Controls for Industrial involves a manual approval process. Make sure your company has a CNDA before submitting the request for access. If you have any questions regarding the CNDA with Intel®, contact the Intel® Sales Representatives.
- I received the email with the product key. What should I do next?
After receiving the product key, you can download the ECI Release Package.
- My colleague had requested for access and received the email with the product key. However, I am unable to download. Do I need to request for access again?
Yes. The access is granted for the email address and not the company. So, if you want to download using a different email address, you need to request for access for that email address.
- What is the minimum free space required to build Intel® ECI?
A minimum of 150 GB free space is required to build Intel® ECI. For more details, refer to system requirements.
- Building packages is time consuming. How can I speed up the compilation?
To speed up the compilation, create a local cache.
Known Limitations¶
This section lists the known limitations with ECI. Fixes to these limitations are expected in the future releases of ECI. Refer to your ECI distribution channel to learn more about updates on ECI.
For other issues, go to https://premiersupport.intel.com/ (Login with your Intel® account) and create a new Intel Edge Software Recipes Case under the Software/Driver/OS category and the Industrial Edge Control Software sub-category.
Limitation #1 - ECI Build errors¶
When building ECI, the build process may fail due to do_fetch errors. These errors occur when the build engine is unable to reach external dependencies via the network. Most often, these errors occur due to network instability, broken mirrors, or proxy server instability.
Mitigation Actions
It is recommended to avoid environments with network proxies and heavy network congestion.
Often, repeating the build process will eventually result in a complete build.
Outages and offline mirrors tend to be intermittent. Attempt the build again after waiting a few hours for the issues to subside.
Limitation #2 - ACRN Service VM monitor output¶
On some hardware platforms, the ACRN Service VM may not output anything to the attached monitor. Only the GRUB warning “WARNING: no console will be available to OS” will be visible upon booting.
Limitation #3 - ACRN VM filesystem read-only¶
When intensive storage I/O is sustained within a virtual machine (VM) running on the ACRN hypervisor, some I/O requests may be dropped. Linux kernels will interpret this behavior as faulty storage hardware and automatically remount the affected storage partition as read-only. This situation may occur if storage benchmarks are performed within the VM.
Mitigation Actions
Avoid sustained intensive storage I/O within the VM.
Assign more virtual CPUs to the VM to increase the effective I/O bandwidth.
Limit the number of VMs running simultaneously.
Avoid sharing physical CPUs between VMs.
Limitation #4 - No results from msi-jitter benchmark¶
Benchmark msi-jitter /opt/benchmarking/msi-jitter does not provide results on certain devices. Known, affected devices are Karbon 700 and Karbon 300.
************ RESULTS (ns) ************ [79774.994363] * Max: 0 [79774.994363] * Avg: 0 [79774.994364] * Min: 0 [79774.994364] *********** *********** ***********
This behavior is currently observed only for i210 Ethernet NICs connected to cascading PCI bridges. The following is an lspci -t example from a Karbon 700 device:
lspci -t -[0000:00]-+-00.0 +-02.0 +-08.0 +-12.0 +-14.0 +-14.2 +-15.0 +-15.1 +-16.0 +-16.3 +-17.0 +-1b.0-[01]----00.0 +-1b.6-[02-08]----00.0-[03-08]--+-01.0-[04]----00.0 | +-02.0-[05]----00.0 | +-03.0-[06]----00.0 | +-04.0-[07]----00.0 | \-05.0-[08]-- +-1c.0-[09]----00.0 +-1c.6-[0a]----00.0 +-1c.7-[0b]----00.0 +-1e.0 +-1f.0 +-1f.3 +-1f.4 +-1f.5 \-1f.6 lscpi 00:00.0 Host bridge: Intel Corporation 8th Gen Core 8-core Desktop Processor Host Bridge/DRAM Registers [Coffee Lake S] (rev 0d) ... 00:1b.6 PCI bridge: Intel Corporation Cannon Lake PCH PCI Express Root Port #23 (rev f0) 00:1c.0 PCI bridge: Intel Corporation Cannon Lake PCH PCI Express Root Port #3 (rev f0) 00:1c.6 PCI bridge: Intel Corporation Cannon Lake PCH PCI Express Root Port #7 (rev f0) 00:1c.7 PCI bridge: Intel Corporation Cannon Lake PCH PCI Express Root Port #8 (rev f0) ... 02:00.0 PCI bridge: Pericom Semiconductor PI7C9X2G608GP PCIe2 6-Port/8-Lane Packet Switch 03:01.0 PCI bridge: Pericom Semiconductor PI7C9X2G608GP PCIe2 6-Port/8-Lane Packet Switch 03:02.0 PCI bridge: Pericom Semiconductor PI7C9X2G608GP PCIe2 6-Port/8-Lane Packet Switch 03:03.0 PCI bridge: Pericom Semiconductor PI7C9X2G608GP PCIe2 6-Port/8-Lane Packet Switch 03:04.0 PCI bridge: Pericom Semiconductor PI7C9X2G608GP PCIe2 6-Port/8-Lane Packet Switch 03:05.0 PCI bridge: Pericom Semiconductor PI7C9X2G608GP PCIe2 6-Port/8-Lane Packet Switch 04:00.0 Ethernet controller: Intel Corporation I210 Gigabit Network Connection (rev 03) 05:00.0 Ethernet controller: Intel Corporation I210 Gigabit Network Connection (rev 03) 06:00.0 Ethernet controller: Intel Corporation I210 Gigabit Network Connection (rev 03) 07:00.0 Ethernet controller: Intel Corporation I210 Gigabit Network Connection (rev 03) 09:00.0 Non-Volatile memory controller: Silicon Motion, Inc. Device 2263 (rev 03) 0a:00.0 Ethernet controller: Intel Corporation I210 Gigabit Network Connection (rev 03) 0b:00.0 Ethernet controller: Intel Corporation I210 Gigabit Network Connection (rev 03)
In the above example, Ethernet controller 04:00.0, 05:00.0, 06:00.0, 07:00.0 would be affected as they connect
to 00:1c.6 PCI bridge: Intel Corporation Cannon Lake PCH PCI Express Root Port #7 (rev f0)
and PCI bridge: Pericom Semiconductor PI7C9X2G608GP PCIe2 6-Port/8-Lane Packet Switch.
Mitigation Actions
Run msi-jitter benchmark on non-cascading PCI bridged Ethernet controllers. E.g.
./run_msijitter.sh "0000:0a:00.0" 1 10 10, for Karbon 700. This behavior is unique to the msi-jitter benchmark and does not affect regular operation of the Ethernet controller. The msi-jitter benchmark kernel driver has to be fixed with upcoming releases.
Limitation #5 - Cannot start CODESYS Linux runtime¶
The CODESYS Linux Runtime may not start correctly on +12th Generation Intel® CPUs. This behavior seems to be related to the split “efficiency” and “performance” cores on newer processors.
Mitigation Actions
Try restarting the CODESYS Linux runtime:
$ sudo systemctl restart codesyscontrolVerify that the CODESYS Linux runtime is active (running):
$ sudo systemctl status codesyscontrolUse the kernel boot parameter
isolcpusto isolate the “efficiency” cores.Enable
Intel(R) TCC Modein the BIOS to affect Linux task CPU affinity:
Setting Name
Option
Setting Menu
Intel(R) TCC Mode
Enabled
Intel Advanced Menu ⟶ Intel Time Coordinated Computing
Limitation #6 - Fail when calling Intel Level0 API¶
Enable Intel® Level Zero and OpenCL™ Graphics Compute Runtime may not start correctly on Intel® Atom™ x3000 Series [Apollo Lake] Gen9 Graphics and Intel® Atom™ x6000 Series [Elkhart Lake] Gen11 Graphics that do NOT support Intel oneAPI Level-Zero.
$ ze_info
When Intel® oneAPI Level-Zero is NOT supported by Intel® HD Graphics user gets the following error message:
ze_info: ./samples/ze_info/main.cc:382: int main(int, char**): Assertion `status == ZE_RESULT_SUCCESS' failed.
Mitigation Actions
Use ONLY Intel® OpenCL HD Graphics APIs to optimize application using Intel® Atom™ x3000 Series [Apollo Lake] Gen9 Graphics and Intel® Atom™ x6000 Series [Elkhart Lake] Gen11 Graphics
Check to find all details:
$ sudo apt install clinfo $ clinfoWhen Intel® OpenCL API is supported by Intel® HD Graphics:
Click to view
clinfooutput on Intel® Atom™ x6000 Series [Elkhart Lake] Gen11 GraphicsNumber of platforms 1 Platform Name Intel(R) OpenCL HD Graphics Platform Vendor Intel(R) Corporation Platform Version OpenCL 3.0 Platform Profile FULL_PROFILE Platform Extensions cl_khr_byte_addressable_store cl_khr_device_uuid cl_khr_fp16 cl_khr_global_int32_base_atomics cl_khr_global_int32_extended_atomics cl_khr_icd cl_khr_local_int32_base_atomics cl_khr_local_int32_extended_atomics cl_intel_command_queue_families cl_intel_subgroups cl_intel_required_subgroup_size cl_intel_subgroups_short cl_khr_spir cl_intel_accelerator cl_intel_driver_diagnostics cl_khr_priority_hints cl_khr_throttle_hints cl_khr_create_command_queue cl_intel_subgroups_char cl_intel_subgroups_long cl_khr_il_program cl_intel_mem_force_host_memory cl_khr_subgroup_extended_types cl_khr_subgroup_non_uniform_vote cl_khr_subgroup_ballot cl_khr_subgroup_non_uniform_arithmetic cl_khr_subgroup_shuffle cl_khr_subgroup_shuffle_relative cl_khr_subgroup_clustered_reduce cl_intel_device_attribute_query cl_khr_suggested_local_work_size cl_intel_split_work_group_barrier cl_ext_float_atomics cl_intel_planar_yuv cl_intel_packed_yuv cl_khr_image2d_from_buffer cl_khr_depth_images cl_khr_3d_image_writes cl_intel_media_block_io cl_intel_subgroup_local_block_io cl_khr_gl_sharing cl_khr_gl_depth_images cl_khr_gl_event cl_khr_gl_msaa_sharing cl_intel_sharing_format_query cl_khr_pci_bus_info Platform Extensions with Version cl_khr_byte_addressable_store 0x400000 (1.0.0) cl_khr_device_uuid 0x400000 (1.0.0) cl_khr_fp16 0x400000 (1.0.0) cl_khr_global_int32_base_atomics 0x400000 (1.0.0) cl_khr_global_int32_extended_atomics 0x400000 (1.0.0) cl_khr_icd 0x400000 (1.0.0) cl_khr_local_int32_base_atomics 0x400000 (1.0.0) cl_khr_local_int32_extended_atomics 0x400000 (1.0.0) cl_intel_command_queue_families 0x400000 (1.0.0) cl_intel_subgroups 0x400000 (1.0.0) cl_intel_required_subgroup_size 0x400000 (1.0.0) cl_intel_subgroups_short 0x400000 (1.0.0) cl_khr_spir 0x400000 (1.0.0) cl_intel_accelerator 0x400000 (1.0.0) cl_intel_driver_diagnostics 0x400000 (1.0.0) cl_khr_priority_hints 0x400000 (1.0.0) cl_khr_throttle_hints 0x400000 (1.0.0) cl_khr_create_command_queue 0x400000 (1.0.0) cl_intel_subgroups_char 0x400000 (1.0.0) cl_intel_subgroups_long 0x400000 (1.0.0) cl_khr_il_program 0x400000 (1.0.0) cl_intel_mem_force_host_memory 0x400000 (1.0.0) cl_khr_subgroup_extended_types 0x400000 (1.0.0) cl_khr_subgroup_non_uniform_vote 0x400000 (1.0.0) cl_khr_subgroup_ballot 0x400000 (1.0.0) cl_khr_subgroup_non_uniform_arithmetic 0x400000 (1.0.0) cl_khr_subgroup_shuffle 0x400000 (1.0.0) cl_khr_subgroup_shuffle_relative 0x400000 (1.0.0) cl_khr_subgroup_clustered_reduce 0x400000 (1.0.0) cl_intel_device_attribute_query 0x400000 (1.0.0) cl_khr_suggested_local_work_size 0x400000 (1.0.0) cl_intel_split_work_group_barrier 0x400000 (1.0.0) cl_ext_float_atomics 0x400000 (1.0.0) cl_intel_planar_yuv 0x400000 (1.0.0) cl_intel_packed_yuv 0x400000 (1.0.0) cl_khr_image2d_from_buffer 0x400000 (1.0.0) cl_khr_depth_images 0x400000 (1.0.0) cl_khr_3d_image_writes 0x400000 (1.0.0) cl_intel_media_block_io 0x400000 (1.0.0) cl_intel_subgroup_local_block_io 0x400000 (1.0.0) cl_khr_gl_sharing 0x400000 (1.0.0) cl_khr_gl_depth_images 0x400000 (1.0.0) cl_khr_gl_event 0x400000 (1.0.0) cl_khr_gl_msaa_sharing 0x400000 (1.0.0) cl_intel_sharing_format_query 0x400000 (1.0.0) cl_khr_pci_bus_info 0x400000 (1.0.0) Platform Numeric Version 0xc00000 (3.0.0) Platform Extensions function suffix INTEL Platform Host timer resolution 1ns Platform Name Intel(R) OpenCL HD Graphics Number of devices 1 Device Name Intel(R) UHD Graphics Device Vendor Intel(R) Corporation Device Vendor ID 0x8086 Device Version OpenCL 3.0 NEO Device UUID 86807145-0100-0000-0002-000000000000 Driver UUID 32332e31-332e-3032-3630-333200000000 Valid Device LUID No Device LUID a04e-2573fe7f0000 Device Node Mask 0 Device Numeric Version 0xc00000 (3.0.0) Driver Version 23.13.026032 Device OpenCL C Version OpenCL C 1.2 Device OpenCL C all versions OpenCL C 0x400000 (1.0.0) OpenCL C 0x401000 (1.1.0) OpenCL C 0x402000 (1.2.0) OpenCL C 0xc00000 (3.0.0) Device OpenCL C features __opencl_c_int64 0xc00000 (3.0.0) __opencl_c_3d_image_writes 0xc00000 (3.0.0) __opencl_c_images 0xc00000 (3.0.0) __opencl_c_read_write_images 0xc00000 (3.0.0) Latest comfornace test passed v2022-04-22-00 Device Type GPU Device Profile FULL_PROFILE Device Available Yes Compiler Available Yes Linker Available Yes Max compute units 32 Max clock frequency 400MHz Device Partition (core) Max number of sub-devices 0 Supported partition types None Supported affinity domains (n/a) Max work item dimensions 3 Max work item sizes 256x256x256 Max work group size 256 Preferred work group size multiple (device) 32 Preferred work group size multiple (kernel) 32 Max sub-groups per work group 0 Sub-group sizes (Intel) 8, 16, 32 Preferred / native vector sizes char 16 / 16 short 8 / 8 int 4 / 4 long 1 / 1 half 8 / 8 (cl_khr_fp16) float 1 / 1 double 0 / 0 (n/a) Half-precision Floating-point support (cl_khr_fp16) Denormals Yes Infinity and NANs Yes Round to nearest Yes Round to zero Yes Round to infinity Yes IEEE754-2008 fused multiply-add Yes Support is emulated in software No Single-precision Floating-point support (core) Denormals Yes Infinity and NANs Yes Round to nearest Yes Round to zero Yes Round to infinity Yes IEEE754-2008 fused multiply-add Yes Support is emulated in software No Correctly-rounded divide and sqrt operations No Double-precision Floating-point support (n/a) Address bits 32, Little-Endian Global memory size 3435970560 (3.2GiB) Error Correction support No Max memory allocation 1717985280 (1.6GiB) Unified memory for Host and Device Yes Shared Virtual Memory (SVM) capabilities (core) Coarse-grained buffer sharing No Fine-grained buffer sharing No Fine-grained system sharing No Atomics No Minimum alignment for any data type 128 bytes Alignment of base address 1024 bits (128 bytes) Preferred alignment for atomics SVM 64 bytes Global 64 bytes Local 64 bytes Atomic memory capabilities relaxed, work-group scope Atomic fence capabilities relaxed, acquire/release, work-group scope Max size for global variable 0 Preferred total size of global vars 0 Global Memory cache type Read/Write Global Memory cache size 1310720 (1.25MiB) Global Memory cache line size 64 bytes Image support Yes Max number of samplers per kernel 16 Max size for 1D images from buffer 107374080 pixels Max 1D or 2D image array size 2048 images Base address alignment for 2D image buffers 4 bytes Pitch alignment for 2D image buffers 4 pixels Max 2D image size 16384x16384 pixels Max planar YUV image size 16384x16352 pixels Max 3D image size 16384x16384x2048 pixels Max number of read image args 128 Max number of write image args 128 Max number of read/write image args 128 Pipe support No Max number of pipe args 0 Max active pipe reservations 0 Max pipe packet size 0 Local memory type Local Local memory size 65536 (64KiB) Max number of constant args 8 Max constant buffer size 1717985280 (1.6GiB) Generic address space support No Max size of kernel argument 2048 (2KiB) Queue properties (on host) Out-of-order execution Yes Profiling Yes Device enqueue capabilities (n/a) Queue properties (on device) Out-of-order execution No Profiling No Preferred size 0 Max size 0 Max queues on device 0 Max events on device 0 Prefer user sync for interop Yes Profiling timer resolution 52ns Execution capabilities Run OpenCL kernels Yes Run native kernels No Non-uniform work-groups Yes Work-group collective functions No Sub-group independent forward progress No IL version SPIR-V_1.2 ILs with version SPIR-V 0x402000 (1.2.0) SPIR versions 1.2 printf() buffer size 4194304 (4MiB) Built-in kernels (n/a) Built-in kernels with version (n/a) Device Extensions cl_khr_byte_addressable_store cl_khr_device_uuid cl_khr_fp16 cl_khr_global_int32_base_atomics cl_khr_global_int32_extended_atomics cl_khr_icd cl_khr_local_int32_base_atomics cl_khr_local_int32_extended_atomics cl_intel_command_queue_families cl_intel_subgroups cl_intel_required_subgroup_size cl_intel_subgroups_short cl_khr_spir cl_intel_accelerator cl_intel_driver_diagnostics cl_khr_priority_hints cl_khr_throttle_hints cl_khr_create_command_queue cl_intel_subgroups_char cl_intel_subgroups_long cl_khr_il_program cl_intel_mem_force_host_memory cl_khr_subgroup_extended_types cl_khr_subgroup_non_uniform_vote cl_khr_subgroup_ballot cl_khr_subgroup_non_uniform_arithmetic cl_khr_subgroup_shuffle cl_khr_subgroup_shuffle_relative cl_khr_subgroup_clustered_reduce cl_intel_device_attribute_query cl_khr_suggested_local_work_size cl_intel_split_work_group_barrier cl_ext_float_atomics cl_intel_planar_yuv cl_intel_packed_yuv cl_khr_image2d_from_buffer cl_khr_depth_images cl_khr_3d_image_writes cl_intel_media_block_io cl_intel_subgroup_local_block_io cl_khr_gl_sharing cl_khr_gl_depth_images cl_khr_gl_event cl_khr_gl_msaa_sharing cl_intel_sharing_format_query cl_khr_pci_bus_info Device Extensions with Version cl_khr_byte_addressable_store 0x400000 (1.0.0) cl_khr_device_uuid 0x400000 (1.0.0) cl_khr_fp16 0x400000 (1.0.0) cl_khr_global_int32_base_atomics 0x400000 (1.0.0) cl_khr_global_int32_extended_atomics 0x400000 (1.0.0) cl_khr_icd 0x400000 (1.0.0) cl_khr_local_int32_base_atomics 0x400000 (1.0.0) cl_khr_local_int32_extended_atomics 0x400000 (1.0.0) cl_intel_command_queue_families 0x400000 (1.0.0) cl_intel_subgroups 0x400000 (1.0.0) cl_intel_required_subgroup_size 0x400000 (1.0.0) cl_intel_subgroups_short 0x400000 (1.0.0) cl_khr_spir 0x400000 (1.0.0) cl_intel_accelerator 0x400000 (1.0.0) cl_intel_driver_diagnostics 0x400000 (1.0.0) cl_khr_priority_hints 0x400000 (1.0.0) cl_khr_throttle_hints 0x400000 (1.0.0) cl_khr_create_command_queue 0x400000 (1.0.0) cl_intel_subgroups_char 0x400000 (1.0.0) cl_intel_subgroups_long 0x400000 (1.0.0) cl_khr_il_program 0x400000 (1.0.0) cl_intel_mem_force_host_memory 0x400000 (1.0.0) cl_khr_subgroup_extended_types 0x400000 (1.0.0) cl_khr_subgroup_non_uniform_vote 0x400000 (1.0.0) cl_khr_subgroup_ballot 0x400000 (1.0.0) cl_khr_subgroup_non_uniform_arithmetic 0x400000 (1.0.0) cl_khr_subgroup_shuffle 0x400000 (1.0.0) cl_khr_subgroup_shuffle_relative 0x400000 (1.0.0) cl_khr_subgroup_clustered_reduce 0x400000 (1.0.0) cl_intel_device_attribute_query 0x400000 (1.0.0) cl_khr_suggested_local_work_size 0x400000 (1.0.0) cl_intel_split_work_group_barrier 0x400000 (1.0.0) cl_ext_float_atomics 0x400000 (1.0.0) cl_intel_planar_yuv 0x400000 (1.0.0) cl_intel_packed_yuv 0x400000 (1.0.0) cl_khr_image2d_from_buffer 0x400000 (1.0.0) cl_khr_depth_images 0x400000 (1.0.0) cl_khr_3d_image_writes 0x400000 (1.0.0) cl_intel_media_block_io 0x400000 (1.0.0) cl_intel_subgroup_local_block_io 0x400000 (1.0.0) cl_khr_gl_sharing 0x400000 (1.0.0) cl_khr_gl_depth_images 0x400000 (1.0.0) cl_khr_gl_event 0x400000 (1.0.0) cl_khr_gl_msaa_sharing 0x400000 (1.0.0) cl_intel_sharing_format_query 0x400000 (1.0.0) cl_khr_pci_bus_info 0x400000 (1.0.0) NULL platform behavior clGetPlatformInfo(NULL, CL_PLATFORM_NAME, ...) Intel(R) OpenCL HD Graphics clGetDeviceIDs(NULL, CL_DEVICE_TYPE_ALL, ...) Success [INTEL] clCreateContext(NULL, ...) [default] Success [INTEL] clCreateContextFromType(NULL, CL_DEVICE_TYPE_DEFAULT) Success (1) Platform Name Intel(R) OpenCL HD Graphics Device Name Intel(R) UHD Graphics clCreateContextFromType(NULL, CL_DEVICE_TYPE_CPU) No devices found in platform clCreateContextFromType(NULL, CL_DEVICE_TYPE_GPU) Success (1) Platform Name Intel(R) OpenCL HD Graphics Device Name Intel(R) UHD Graphics clCreateContextFromType(NULL, CL_DEVICE_TYPE_ACCELERATOR) No devices found in platform clCreateContextFromType(NULL, CL_DEVICE_TYPE_CUSTOM) No devices found in platform clCreateContextFromType(NULL, CL_DEVICE_TYPE_ALL) Success (1) Platform Name Intel(R) OpenCL HD Graphics Device Name Intel(R) UHD Graphics ICD loader properties ICD loader Name OpenCL ICD Loader ICD loader Vendor OCL Icd free software ICD loader Version 2.2.14 ICD loader Profile OpenCL 3.0