1.9.1. Custom Platform Automigration for Forward Compatibility
The following information applies to a Custom Platform that is version 14.0 and beyond:
- To update a Custom Platform for use with the current version of the Intel® Quartus® Prime Design Suite, which includes the Intel® FPGA SDK for OpenCL™ , do not modify your Custom Platform. The automigration capability detects the version of your Custom Platform based on certain characteristics and updates it automatically.
- If you have modified a Custom Platform and you want to update it for use with the current version of the Intel® Quartus® Prime Design Suite, implement all mandatory features for the current version of the Custom Platform. After you modify a Custom Platform, automigration can no longer correctly detect its characteristics. Therefore, you must upgrade your Custom Platform manually.
A successfully-migrated Custom Platform will preserve its original functionality. In most cases, new features in a new version of the Intel® Quartus® Prime Design Suite will not interfere with Custom Platform functionality.
When the Intel® FPGA SDK for OpenCL™ Offline Compiler compiles a kernel, it probes the board_spec.xml file for the following information:
- The version of the Custom Platform, as specified by the version attribute of the board XML element.
- The platform type, as specified by the platform_type parameter of the auto_migrate attribute within the compile XML element.
Based on the information, the SDK names a set of fixes it must apply during Custom Platform migration. It applies the fixes to the Quartus Prime project that the Intel® FPGA SDK for OpenCL™ Offline Compiler uses to compile the OpenCL kernel. It also generates an automigration.rpt report file in the SDK user's current working directory describing the applied fixes.
The automigration process does not modify the installed Custom Platform.