FlashMemory < BUCMSPublic

Tags: view all tags
| *Useful Links* |
| [[AMC13Firmware][Firmware Files]] |
| [[impactInstallation][iMPACT Installation]] |
| [[#RunningImpact][Running iMPACT]] |
| [[#ImpactTroubleshooting][iMPACT Troubleshooting]] |
| [[http://physics.bu.edu/~wusx/download/AMC13/amc13T2v0x19.bit][amc13T2v0x19.bit]] (LX25T only) |
#FlashLayout
---++ Flash Layout

*All Flash memory programming is done with the Spartan (T2). From T2 firmware version 0x6 onward, the flash memory is organized as follows:*
| *Address* | *Flash Sector* |
| 0x000000 | header |
| 0x80000  | Spartan "golden" backup for lx45t chips |
| 0x100000 | Spartan "golden" backup for lx25t chips |
| 0x200000 | Spartan |
| 0x400000 | Virtex/Kintex |
#FirmwareFiles
---++ Firmware Files

See AMC13Firmware page for current firmware releases.

#FlashProgramming
---++ Flash Programming Instructions

The best procedure to follow depends on why you are trying to program the flash on your AMC13.
If you just want to update to the latest version, follow these instructions:  [[AMC13Tool2Recipes#UpdateFirmware][UpdateFirmware]]

If you suspect that the flash memory has somehow been corrupted and the board doesn't respond, there are
a couple of possible causes and various solutions.  If you can ping the T2 address at least
(see IPaddressAssignment) then try using AMC13ToolFlash.

If both of those fail, maybe you don't actually know the IP address of your module?  It can be set in various ways,
including a RARP daemon and via the EEPROM on the MMC.  This was mandated by CMS and can result in
a difficult recovery situation.  

Anyway, if you can't talk to your module and want to attempt recovery using JTAG, read on...

   * *NOTE:* You generally should not have to program via JTAG unless your firmware has become corrupted and the AMC13 software can no longer talk to your module. If this is not the case and you can in fact communicate with your AMC13, please use the Python/C++ tools and follow the directions at the above links

   * *Prerequisites*
      * You must have Xilinx "iMPACT" software installed on your computer. [[impactInstallation][Instructions on how to install iMPACT on a SLC5 machine]]
      * You must have a Xilinx JTAG cable with an appropriate adapter (shown [[http://ohm.bu.edu/~chill90/pics/20121005_125912.jpg][here]]) for connecting to the AMC13 front panel

#RunningImpact
   * *Running iMPACT*
      * If you have successfully installed iMPACT as well as "libusb" and "fxload" (see installation instructions above if not!), try and run the !LabTools software.
         1 Set the environment and start the program
         <verbatim>
         $ source <LabToolsInstallationDir>/14.4/LabTools/settings64.[c]sh
         $ export LD_LIBRARY_PATH=<libusbSharedLibDir>:$LD_LIBRARY_PATH
         $ impact
         </verbatim>
         1 Double click on the *Boundary Scan* icon in the "iMPACT Flows" sub-window
         1 Right click on the large sub-window and select *initialize chain*
         If your device is successfully identified, then you are ready to follow the instructions below and program your AMC13's flash memory from JTAG.
         *NOTE* Newer versions of iMPACT may not have a iMPACT Flows window with Boundary Scan opened by default. Another way to start in this case is to start a new project (File -&gt; New Project) and doing a boundary scan through there

#ImpactTroubleshooting
   * *iMPACT Troubleshooting*
      * If your device is _not_ successfully identified per the above *Running iMPACT* instructions, see the following links for troubleshooting assistance
         * [[http://www.xilinx.com/support/answers/42728.htm][Test libusb Installation]]
         * [[http://forums.xilinx.com/t5/Design-Tools-Others/Cable-connection-times-out-w-iMPACT-XMD-and-cannot-clean-cable/td-p/60647][Troubleshoot Locked USB Cable]]
         * [[CableConnect][Troubleshoot Cable Connection]]

   * *Configure FPGA using iMPACT*
      1 Download the following bit file to your computer (in a known, accessible location):
         * For AMC13 with serial number greater than 47: [[http://physics.bu.edu/~wusx/download/AMC13/AMC13T2v0x0029_6slx45t.bit][AMC13T2v0x0029_6slx45t.bit]]
         * For AMC13 with serial number less than 47: [[http://physics.bu.edu/~wusx/download/AMC13/AMC13T2v0x001c_6slx25t.bit][AMC13T2v0x001c_6slx25t.bit]]
      1 Connect your JTAG cable to the bottom-most of the two 10-pin, rectangular, male sockets on the front panel of your AMC13 as show [[http://physics.bu.edu/~djarcaro/Pictures/IMG_20160512_172932.jpg][here]]. Note that "pin 1" is in the upper left-hand corner of the connector
      1 Once your JTAG cable is connected, open the IMPACT software (see [[impactInstallation][iMPACT Installation]] for installation instructions and [[#RunningImpact][Running iMPACT]] for startup instructions) on the computer which is connected to your JTAG cable
      1 The software will prompt you about loading past projects and creating new ones. Just say no/cancel to all of these opions.
      1 Once the main window for IMPACT is up, click on the *Boundary Scan* icon in the "iMPACT Flows" sub-window.
      1 Once you have done this, *right click* on the large sub-window and select *initialize chain*
      1 A window will then pop up asking you to assign configuration files. Cancel out of this.
      1 Make sure that at the bottom of your large sub-window, there is a blue rectangle which reads "Identify Succeeded". Also, you should now see a graphic (in this same sub-window) of both the Virtex and Spartan chips in your AMC13
      1 We want to program the *Spartan* chip! Right click on the graphic of the Spartan chip and select *assign new configuration file*
      1 This should open a file browser on your computer. Find and select the bit file that you downloaded at the start of this process.
      1 Once you have done this, click *program* and select *ok*
      1 The bit file is loaded very quickly, so don't be alarmed if it seems like nothing happened.
      1 Your Spartan chip should now be at firmware version 0x6. *Do not cycle the power at this point*.
      1 Use either *AMC13Tool.exe* in the C++ software or *AMC13ToolFlash* in the AMC13 software to update the flash for your Spartan and Virtex chips. You should program all 4 flash images (=AMC13T2Header=, =AMC13T2Golden=, =AMC13T2Vxxxxx.mcs= and =AMC13T2Vxxxxx.mcs=). After this last step is complete you should cycle the power and check that your versions are now the latest ones.

#ProgramFlashImpact
   * *Program FLASH using iMPACT*
      1 Download the [[http://ohm.bu.edu/~dzou/firmware.cgi][desired MCS file]] to your computer (in a known, accessible location)
      1 Connect your JTAG cable to the bottom-most of the two 10-pin, rectangular, male sockets on the front panel of your AMC13. Note that "pin 1" is in the upper left-hand corner of the connector
      1 Once your JTAG cable is connected, open the IMPACT software (see [[impactInstallation][iMPACT Installation]] for installation instructions and [[#RunningImpact][Running iMPACT]] for startup instructions) on the computer which is connected to your JTAG cable
      1 The software will prompt you about loading past projects and creating new ones. Just say no/cancel to all of these opions.
      1 Once the main window for IMPACT is up, click on the *Boundary Scan* icon in the "iMPACT Flows" sub-window.
      1 Once you have done this, *right click* on the large sub-window and select *initialize chain*
      1 Right click on the "SPI/BPI Device" dotted box and select "Add SPI/BPI Flash"
      1 In the file browser dialogue box, select the MCS file you want to program to FLASH
      1 In the "Select Attached SPI/BPI" dialogue box, select "SPI PROM" in the first pull down box and !M25P128 in the second dialogue box (use !M25P32 for TTT board!), then hit OK
      1 Right click on the new FLASH box attached to your FPGA in the large sub-window's diagram and select "Program"
      1 This process may take quite a long time, so be patient. The large sub-window will let you know whether the FLASH program was successfull or problematic

#ConfirgureFPGAVivado
   * <b>Configure FPGA using Vivado (as an alternative to iMPACT)<br /></b>
      1 Download the following bit file to your computer (in a known, accessible location):
         * For AMC13 with serial number greater than 47: [[http://physics.bu.edu/~wusx/download/AMC13/AMC13T2v0x0029_6slx45t.bit][AMC13T2v0x0029_6slx45t.bit]]
         * For AMC13 with serial number less than 47: [[http://physics.bu.edu/~wusx/download/AMC13/AMC13T2v0x001c_6slx25t.bit][AMC13T2v0x001c_6slx25t.bit]]
      1 Connect your JTAG cable to the bottom-most of the two 10-pin, rectangular, male sockets on the front panel of your AMC13 as show [[http://physics.bu.edu/~djarcaro/Pictures/IMG_20160512_172932.jpg][here]]. Note that "pin 1" is in the upper left-hand corner of the connector
      1 Once your JTAG cable is connected, open the Vivado Lab Tools on the computer which is connected to your JTAG cable
      1 On the opening screen, click "Open Hardware Manager".
      1 At the top of the screen a bar will appear with the text "No hardware target is open." Click on "Open target" and select "Auto Connect" from the drop down menu.
      1 The device should appear on the left, with sub elements for both of the chips.
      1 We want to program the *Spartan* chip! Right click on the name of the Spartan chip and select "Program Device"<b><br /></b>
      1 Click on the "..." next to "Bitsteam file". Find and select the bit file that you downloaded at the start of this process. Leave "Debug probes file" black.
      1 Once you have done this, click *Program.*
      1 Your Spartan chip should now be at firmware version 0x6. *Do not cycle the power at this point*.
      1 Repeat steps 7-10 for the T1 Virtex Chip
      1 Use either *AMC13Tool.exe* in the C++ software or *AMC13ToolFlash* in the AMC13 software to update the flash for your Spartan and Virtex chips. You should program all 4 flash images (AMC13T2Header, AMC13T2Golden, AMC13T2Vxxxxx.mcs and AMC13T2Vxxxxx.mcs). After this last step is complete you should cycle the power and check that your versions are now the latest ones.

-- Main.JimRohlf - 26 May 2012
Topic revision: r25 - 23 Sep 2020 - ChristopherCosby