Differences

This shows you the differences between two versions of the page.

Link to this comparison view

reference:software:adept:qspi-flash [2018/06/26 18:31]
Thomas Kappenman created
reference:software:adept:qspi-flash [2018/06/26 18:36] (current)
Thomas Kappenman
Line 11: Line 11:
 ===== COMMANDS ===== ===== COMMANDS =====
  
 +| enum        | Enumerate the device table and discover any connected Digilent devices. This command prints out a list of Digilent devices. The list includes both devices in the device table and devices that were discovered. The product name, user name, and serial number are displayed for all devices that are currently connected to the system. If a device is in the device table, then its alias is also displayed. ​                                                                                                                                                                                                 |
 +| write       | Write a .bin file to the target FPGA’s flash memory. The "​-d"​ option must be used to specify the user name or alias of the device whose scan chain you wish to initialize. The “-f” or “-file” option must be used to specify the bin file to write to flash. The “-verify” option can be used to verify that the flash was written correctly.\\ read Read the target’s flash memory to a file. The "​-d"​ option must be used to specify the user name or alias of the device you wish to use for programming. The "​-f"​ or "​-file"​ option must be used to specify the pathname of the file used for programming. ​ |
 +| erase       | Erase the specified device’s configuration. The "​-d"​ option must be used to specify the user name or alias of the device you wish to use for erasing. ​                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
 +| verify ​     | Verify the contents of the target’s flash memory. The "​-d"​ option must be used to specify the user name or alias of the device you wish to use. The "​-f"​ or "​-file"​ option must be used to specify the pathname of the bin file you wish to verify with.                                                                                                                                                                                                                                                                                                                                                         |
 +| blankcheck ​ | Verify that the contents of the target’s flash memory are blank. The "​-d"​ option must be used to specify the user name or alias of the device you wish to use.                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
  
-enum Enumerate the device table and discover any connected Digilent devices. This command prints out a list of Digilent devices. The list includes both devices in the device table and devices that were discovered. The product name, user name, and serial number are displayed for all devices that are currently connected to the system. If a device is in the device table, then its alias is also displayed. 
-write Write a .bin file to the target FPGA’s flash memory. The "​-d"​ option must be used to specify the user name or alias of the device whose scan chain you wish to initialize. The “-f” or “-file” option must be used to specify the bin file to write to flash. The “-verify” option can be used to verify that the flash was written correctly. 
-read Read the target’s flash memory to a file. The "​-d"​ option must be used to specify the user name or alias of the device you wish to use for programming. The "​-f"​ or "​-file"​ option must be used to specify the pathname of the file used for programming. 
-erase Erase the specified device’s configuration. The "​-d"​ option must be used to specify the user name or alias of the device you wish to use for erasing. 
-verify Verify the contents of the target’s flash memory. The "​-d"​ option must be used to specify the user name or alias of the device you wish to use. The "​-f"​ or "​-file"​ option must be used to specify the pathname of the bin file you wish to verify with. 
-blankcheckVerify that the contents of the target’s flash memory are blank. The "​-d"​ option must be used to specify the user name or alias of the device you wish to use. 
  
-OPTIONS+===== OPTIONS ​===== 
 + 
 + 
 +| -d            | Specify the user name or alias of the device you wish to communicate with.                         | 
 +| -f, -file     | Specify the name of the file used to program (configure) the target device. ​                       | 
 +| -t            | Time the operation. ​                                                                               | 
 +| -?, -help     | Display typical application usage, a list of supported commands, and a list of supported options. ​ | 
 +| -v, -version ​ | Display information about the program version. ​                                                    | 
 +| -verify ​      | Verify that the flash wrote correctly. ​                                                            | 
 +| -verbose ​     | Display more detailed error messages. ​                                                             | 
 + 
 +===== EXAMPLES ===== 
  
--d Specify the user name or alias of the device you wish to communicate with. 
--f, -file Specify the name of the file used to program (configure) the target device. 
--t Time the operation. 
-DFlashConfig 
-(1) 
-DFlashConfig 
-(1) 
-06/20/2018 2 
--?, -help 
-Display typical application usage, a list of supported commands, and a list of supported options. 
--v, -version 
-Display information about the program version. 
--verify 
-Verify that the flash wrote correctly. 
--verbose Display more detailed error messages. 
-EXAMPLES 
 $ DFlashConfig enum $ DFlashConfig enum
 +
 Enumerate all devices in the device table and all devices connected to the system. Enumerate all devices in the device table and all devices connected to the system.
 +
 $ DFlashConfig write -d Nexys4DDR -f “C:\My Files\myProject.bin” -verify $ DFlashConfig write -d Nexys4DDR -f “C:\My Files\myProject.bin” -verify
 +
 Writes myProject.bin to the connected Nexys4DDR and verifies that it was written correctly. Writes myProject.bin to the connected Nexys4DDR and verifies that it was written correctly.
 +
 $ DFlashConfig read -d SN:​210292645370 -f .\file.bin $ DFlashConfig read -d SN:​210292645370 -f .\file.bin
 +
 Read the contents of the flash on the FPGA with the serial number 210292645370 and write it to file.bin. Read the contents of the flash on the FPGA with the serial number 210292645370 and write it to file.bin.
 +
 $ DFlashConfig erase -d ArtyA7 $ DFlashConfig erase -d ArtyA7
 +
 Erase the flash on the connected Arty A7. Erase the flash on the connected Arty A7.
 +
 $ DFlashConfig verify -d CmodA7 -f .\myProject.bin $ DFlashConfig verify -d CmodA7 -f .\myProject.bin
 +
 Verify that the connected Cmod A7’s flash contains myProject.bin. Verify that the connected Cmod A7’s flash contains myProject.bin.
-AUTHOR 
-Digilent, Inc. <​support@digilentinc.com>​