PCIe3 LP FPGA Accelerator Adapter (FC: EJ12, EJ13) ******* PLEASE READ THIS ENTIRE NOTICE ********* *DATE:* *Jul 7, 2014* *Table of Contents* _ _ *1.0 Microcode and Document Revision History: <#_Toc372636502>* *2.0 General information <#_Toc372636503>* *3.0 Installation time <#_Toc372636504>* *4.0 Machine's Affected: <#_Toc372636505>* *5.0 Linux Requirements: <#_Toc372636506>* *6.0 AIX Requirements: <#_Toc372636507>* *7.0 Determine the Current Microcode Level <#_Toc372636508>* *7.1 AIX Systems: <#_Toc372636509>* *7.2 Linux Systems: <#_Toc372636510>* *Linux is not supported for this adapter. <#_Toc372636511>* *8.0 Downloading and unpacking the Microcode Package <#_Toc372636512>* _9.0 Microcode Download Procedure for AIX: _ * * 1.0 Microcode and Document Revision History: *Firmware Level* *Description* zEDCv2_20140226 / 0000000330337220 Original Release _ _ *Document Revision History* *Description* 7/07/2014 Creating Readme file with latest microcode for this adapter _ _2.0 General information This Readme file is intended to give directions on how to update the microcode found on the PCIe3 LP FPGA Accelerator Adapter (FC: EJ12,EJ13). 3.0 Installation time Approximately 2 min 4.0 Machine's Affected: Feature Code EJ12, EJ13: 8284-22A 8286-41A 8286-42A 5.0 Linux Requirements: Linux is not supported for this adapter in June 2014. It will be supported in the 4Q 2014 GA 6.0 AIX Requirements: Basic card function is supported on: AIX Version 7.1 1412A_61A and 1412_71N BAI and greater AIX Version 7.1 with the 7100-02 Technology Level, or later AIX Version 7.1 with the 7100-01 Technology Level and Service Pack 6, or later AIX Version 7.1 with the 7100-00 Technology Level and Service Pack 8, or later If you are using another release of AIX, ensure that the adapter is supported on that release before you install the adapter. Contact service and support for assistance. 7.0 Determine the Current Microcode Level 7.1 AIX Systems: Use the following instructions to read the level stored in the Adapter. 1) List the Accelerator adapters installed in the system by typing: lscfg -l acc\* Note: All of the Accelerator adapters that are installed will be displayed. They will be listed as accelx, where x is 0, 1, etc. 2) To check the current microcode level for the adapter or controller enter the following command /usr/lpp/diagnostics/bin/flash_afu –d accel/x// –/T info Where “/x/” is the instance of the adapter. The command will produce output similar to: # /usr/lpp/diagnostics/bin/flash_afu -d accel0 -T info /The Application ID of the AFU Image on accel0 is 00000000475A4950./ /The Build Date of the AFU Image on accel0 is 0000000330337220/. ß This is the level of the fpga application (aka microcode) If the *ROM Level* is less than /0000000330337220/ you should update the microcode. 7.2 Linux Systems: Linux is not supported for this adapter. 8.0 Downloading and unpacking the Microcode Package 8.1 Downloading AIX Package Use this method to download to an AIX system: *NOTE:* The instructions that follow are specific AIX commands. AIX commands are CASE (lower and upper) SENSITIVE, and */must/* be entered exactly as shown, including filenames. 1) Once the zEDCv2_20140226.tgz file has been transfered to an AIX system or lpar, verify the checksum of the microcode file : # csum -h MD5 zEDCv2_20140226.tgz 6f81205e023b294d409147d3fd545959 zEDCv2_20140226.tgz Note : Verify that the checksum results matches with : 6f81205e023b294d409147d3fd545959 2) Unpack the zEDCv2_20140226.tgz file : # gunzip -c zEDCv2_20140226.tgz | tar -xvf - x ac_top_B_330342260.rbf, 33747356 bytes, 65913 media blocks. x ac_top_B_330342260.sof, 31733983 bytes, 61981 media blocks. Note: you only need the ac_top_B_330342260.rbf file for updating the FPGA image in AIX environment. 3) Make the following directory: # mkdir /etc/microcode/14104b0414104b04 4) Copy the ac_top_B_330342260.rbf file into the /microcode/14104b0414104b04 directory you created in step 3. # cp ac_top_B_330342260.rbf /microcode/14104b0414104b04/ac_top_B_330342260.rbf 8.2 Downloading Linux RPM Package Linux is not supported for this adapter. 9.0 Microcode Download Procedure for AIX: Microcode download must be performed separately for each Adapter under each Logical Partitions (LPAR's). 9.1 Setting up for Microcode download: 1) Stop all applications that use this interface/adapter 9.2 Downloading Microcode to the Adapter 1) Apply the microcode update # /usr/lpp/diagnostics/bin/flash_afu -d accel0 -T "load ac_top_B_330342260.rbf" 9.3 ) Check the microcode update 1) Verify the AFU build date # /usr/lpp/diagnostics/bin/flash_afu -d accel0 -T info The Application ID of the FPGA Image on accel0 is 00000002475A4950. The Build Date of the FPGA Image on accel0 is 00000B0330342260.