Difference: FlashMemory (1 vs. 25)

1. 1. We want to program the Spartan chip! Right click on the name of the Spartan chip and select "Program Device"
      
   2. 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.
   3. Once you have done this, click Program.

1. 1. 1. Set the environment and start the program

1. 1. 1. Double click on the Boundary Scan icon in the "iMPACT Flows" sub-window
      2. Right click on the large sub-window and select initialize chain

1. 1. Download the following bit file to your computer (in a known, accessible location):

1. 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 here. Note that "pin 1" is in the upper left-hand corner of the connector
   2. Once your JTAG cable is connected, open the IMPACT software (see iMPACT Installation for installation instructions and Running iMPACT for startup instructions) on the computer which is connected to your JTAG cable
   3. The software will prompt you about loading past projects and creating new ones. Just say no/cancel to all of these opions.
   4. Once the main window for IMPACT is up, click on the Boundary Scan icon in the "iMPACT Flows" sub-window.
   5. Once you have done this, right click on the large sub-window and select initialize chain
   6. A window will then pop up asking you to assign configuration files. Cancel out of this.
   7. 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
   8. We want to program the Spartan chip! Right click on the graphic of the Spartan chip and select assign new configuration file
   9. This should open a file browser on your computer. Find and select the bit file that you downloaded at the start of this process.
   10. Once you have done this, click program and select ok
   11. The bit file is loaded very quickly, so don't be alarmed if it seems like nothing happened.
   12. Your Spartan chip should now be at firmware version 0x6. Do not cycle the power at this point.
   13. 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.

1. 1. Download the desired MCS file to your computer (in a known, accessible location)
   2. 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
   3. Once your JTAG cable is connected, open the IMPACT software (see iMPACT Installation for installation instructions and Running iMPACT for startup instructions) on the computer which is connected to your JTAG cable
   4. The software will prompt you about loading past projects and creating new ones. Just say no/cancel to all of these opions.
   5. Once the main window for IMPACT is up, click on the Boundary Scan icon in the "iMPACT Flows" sub-window.
   6. Once you have done this, right click on the large sub-window and select initialize chain
   7. Right click on the "SPI/BPI Device" dotted box and select "Add SPI/BPI Flash"
   8. In the file browser dialogue box, select the MCS file you want to program to FLASH
   9. 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
   10. Right click on the new FLASH box attached to your FPGA in the large sub-window's diagram and select "Program"
   11. 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

• Configure FPGA using Vivado (as an alternative to iMPACT)
  
  1. Download the following bit file to your computer (in a known, accessible location):
     • For AMC13 with serial number greater than 47: AMC13T2v0x0029_6slx45t.bit
     • For AMC13 with serial number less than 47: AMC13T2v0x001c_6slx25t.bit
  2. 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 here. Note that "pin 1" is in the upper left-hand corner of the connector
  3. Once your JTAG cable is connected, open the Vivado Lab Tools on the computer which is connected to your JTAG cable
  4. On the opening screen, click "Open Hardware Manager".
  5. 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.
  6. The device should appear on the left, with sub elements for both of the chips.
  7. We want to program the Spartan chip! Right click on the name of the Spartan chip and select "Program XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
     
  8. This should open a file browser on your computer. Find and select the bit file that you downloaded at the start of this process.
  9. Once you have done this, click program and select ok
  10. Your Spartan chip should now be at firmware version 0x6. Do not cycle the power at this point.
  11. Repeat steps 7-10 for the T1 Virtex Chip
  12. (If you're running a memory test for production testing, proceed with those steps now, before you program flash or power cycle the unit)
  13. 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.

• • • For AMC13 with serial number greater than 47: AMC13T2v0x0029_6slx45t.bit

1. 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 here. Note that "pin 1" is in the upper left-hand corner of the connector

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...

1. 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.

1. 1. Download the following bit file to your computer (in a known, accessible location):
      • For AMC13 with serial number greater than 47: AMC13T2v0x001d_6slx45t.bit
      • For AMC13 with serial number less than 47: AMC13T2v0x001c_6slx25t.bit

1. 1. Download the desired MCS file to your computer (in a known, accessible location)

1. 1. Download the following bit file to your computer (in a known, accessible location): amc13T2v0x17.bit.

1. 1. Download the following bit file to your computer (in a known, accessible location): http://physics.bu.edu/~wusx/download/AMC13/amc13T2v6.bit

• Prerequisites
  • You must have Xilinx "iMPACT" software installed on your computer. Instructions on how to install iMPACT on a SLC5 machine
  • You must have a Xilinx JTAG cable with an appropriate adapter (shown here) for connecting to the AMC13 front panel

• 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

                $ source <LabToolsInstallationDir>/14.4/LabTools/settings64.[c]sh
                $ export LD_LIBRARY_PATH=<libusbSharedLibDir>:$LD_LIBRARY_PATH
                $ impact
                

    2. Double click on the Boundary Scan icon in the "iMPACT Flows" sub-window
    3. 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.

• iMPACT Troubleshooting
  • If your device is not successfully identified per the above Running iMPACT instructions, see the following links for troubleshooting assistance
    • Test libusb Installation
    • Troubleshoot Locked USB Cable
    • Troubleshoot Cable Connection

• Configure FPGA using iMPACT
  1. Download the following bit file to your computer (in a known, accessible location): http://ohm.bu.edu/~hazen/test/firmware.cgi

1. 1. Once your JTAG cable is connected, open the IMPACT software (see iMPACT Installation for installation instructions and Running iMPACT for startup instructions) on the computer which is connected to your JTAG cable

1. 1. Once you have done this, right click on the large sub-window and select initialize chain

• Program FLASH using iMPACT
  1. Download the desired MCS file to your computer (in a known, accessible location)
  2. 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
  3. Once your JTAG cable is connected, open the IMPACT software (see iMPACT Installation for installation instructions and Running iMPACT for startup instructions) on the computer which is connected to your JTAG cable
  4. The software will prompt you about loading past projects and creating new ones. Just say no/cancel to all of these opions.
  5. Once the main window for IMPACT is up, click on the Boundary Scan icon in the "iMPACT Flows" sub-window.
  6. Once you have done this, right click on the large sub-window and select initialize chain
  7. Right click on the "SPI/BPI Device" dotted box and select "Add SPI/BPI Flash"
  8. In the file browser dialogue box, select the MCS file you want to program to FLASH
  9. 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
  10. Right click on the new FLASH box attached to your FPGA in the large sub-window's diagram and select "Program"
  11. 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

• • You have Xilinx "iMPACT" software installed on your computer. For instructions on how to install iMPACT on a SLC5 machine, go here

1. 1. The bit file is loaded very quickly, so don't be alarmed if it seems like nothing happened.
   2. Your Spartan chip should now be at firmware version 0x6. Do not cycle the power at this point.
   3. Use either AMC13Tool.exe in the C++ software or p_flash.py in the Python 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.

• • You have a Xilinx JTAG cable with an appropriate adapter (shown here) for connecting to the AMC13 front panel

• 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

1. 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. 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.
   2. Once you have done this, click program and select ok

1. 1. You should now be able to talk to your AMC13 via the software. Use either AMC13Tool.exe in the C++ software or p_flash.py in the Python software to update your Spartan and Virtex chips.

Flash Layout

Firmware Files

Flash Programming Instructions

2. Instructions on how to update your AMC13 firmware using the xDAQ C++ AMC13Tool executable are here

3. Instructions on how to program your AMC13 from a bit file using a Xilinx JTAG cable are below:

• Assumptions
  • You have Xilinx "Impact" software installed on your computer.
  • You have a Xilinx JTAG cable with an appropriate adapter for connecting to the AMC13 front panel

• NOTE: You generally should not have to do this 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 within the above links

• Instructions
  1. Download the following bit file to your computer (in a known, accessible location): http://physics.bu.edu/~wusx/download/AMC13/amc13T2v6.bit
  2. Connect your JTAG cable to the one of the two 10-pin, rectangular, male sockets on the front panel of your AMC13. The adapter to do this should have (in theory) come with your AMC13.
  3. Once your JTAG cable is connected, open the IMPACT software on the computer which is connected to the other end of your JTAG cable
  4. The software will prompt you about loading past projects and creating new ones. Just say no/cancel to all of these opions.
  5. Once the main window for IMPACT is up, click on the Boundary Scan icon in the "iMPACT Flows" sub-window.
  6. Once you have done this, right click on the large sub-window and select intialize chain
  7. A window will then pop up asking you to assign configuration files. Cancel out of this.
  8. 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
  9. We want to program the Spartan chip! Right click on the graphic of the Spartan chip and select assign new configuration file
  10. This should open a browser on your computer. Find and select the bit file that you downloaded at the start of this process.
  11. Once you have done this, right click on program and select ok
  12. The bit file is loaded very quickly, so don't be alarmed if it seems like nothing happened. After it has finished loading, cycle the power on your uTCA crate to reconfigure the Spartan chip from flash.
  13. Your Spartan chip should now be at firmware version 0x6.
  14. You should now be able to talk to your AMC13 via the software and program the Virtex chip using either AMC13Tool.exe in the C++ software or p_flash.py in the Python software.

Programming using Python Tools

First, please see the AMC13PythonSoftware page and be sure you have the latest version installed.

Be sure the MCS file for the version you want to program is in the directory amc13_python_2012-xx-xx/firmware_amc13. Note that the most recent firmware is included with each python software release, so you only have to worry about this if you have a special version.

Change to the directory amc13_python_2012-xx-xx/src_amc13.

Execute the command python p_flash.py and enter the serial number of your AMC13.

Use options 4 and 5 to program the Spartan and Virtex flash images.

Programming using HCAL xDAQ C++ Tool

The flash programming may be verified against the mcs files (which must be locally available) with !AMC13Tool.exe (C++ HCAL environment only) with the following commands:

The flash programming may be verified against the mcs files (which must be locally available) with AMC13Tool with the following commands:

• vfh (verify flash header)
• vbs (verify backup spartan)
• vs (verify spartan)
• vv (verify virtex)

The flash may be programmed (mcs files must be locally available) with AMC13Tool with the following commands:

• PFH (Program Flash Header)
• PBS (Program Backup Spartan)
• PS (Program Spartan)
• PV (Program Virtex)

The FPGAs (both Spartan and Virtex) may be configured from the flash contents by issuing the software command in AMC13Tool:

• L (Load)

• amc13.writeAddress(amc13.spartan,0x0, 0x100)

The firmware versions of the Spartand and Virtex may be read with AMC13Tool with the command:

• fv

• amc13.readAddress(amc13.spartan,0x0)
• amc13.readAddress(amc13.virtex,0x0)

-- JimRohlf - 26 May 2012