Visible to Intel only — GUID: lro1432871074068
Ixiasoft
2.1. Starting the Flash Programmer GUI
2.2. Specifying your Flash Programmer Settings
2.3. Working with Flash Programmer Settings Files
2.4. Setting the Hardware Connection
2.5. Checking System ID and System Timestamp
2.6. Generating Flash Files and Programming Flash Memory
2.7. Document Revision History for Using the Flash Programmer GUI
B.1. Overview
B.2. Start Button Grayed Out in the Flash Programmer GUI
B.3. 'No Nios® II Processors Available' Error
B.4. 'No CFI Table Found' Error
B.5. 'No EPCS Registers Found' Error
B.6. 'System Does Not Have Any Flash Memory' Error
B.7. 'Reading System ID at Address 0x<address>: FAIL' Error
B.8. 'Base Address Not Aligned on Size of Device' Error
B.9. Document Revision History for Troubleshooting
Visible to Intel only — GUID: lro1432871074068
Ixiasoft
3.1.1.1. General Parameters
| Name | Required | Description |
|---|---|---|
| --cable=<cable name> | Required if there are multiple download cables connected to the host computer. | Specifies which download cable to use.6 |
| --device=<device index> | Required if there are multiple devices in the JTAG chain. | Specifies the FPGA's device number in the JTAG chain. The device index specifies the device where the flash programmer looks for the Nios® II JTAG debug module. JTAG devices are numbered relative to the JTAG chain, starting at 1.7 |
| --instance=<instance> | Required if there are multiple Nios® II processors with JTAG debug modules in the target design on the FPGA. | Specifies which Nios® II JTAG debug module to look at in the FPGA. The instance ID specifies the JTAG debug module that is used for programming flash memory.8 |
| --sidp=<address> | Optional; required for system ID validation. | Contains the base address of the System ID component in your system. This value is in hexadecimal format (for example, 0x01000000).9 |
| --id=<id> | Optional; required for system ID validation. | Contains the ID value programmed into the System ID component in your system. This value is randomly selected each time you regenerate your Platform Designer system. This value is in unsigned decimal format (for example, 2056847728u).10 |
| --timestamp=<time> | Optional; required for system timestamp validation. | Contains the timestamp value programmed into the System ID component in your system. Platform Designer sets this value based on the time of system generation. This value is in unsigned decimal format (for example, 1177105077u). Turning this parameter on is the same as turning off the Ignore mismatched system timestamp check box in the Nios® II Flash Programmer GUI Hardware Connections dialog box.11 |
| --accept-bad-sysid | Optional; defaults off. | Bypasses the system ID validation. Forces the flash programmer to download a flash image. Turning this parameter on is the same as turning on the Ignore mismatched system ID check box in the Nios® II Flash Programmer GUI Hardware Connections dialog box. |
| --erase=<start>,<size> | Optional; defaults off. | Erases a range of bytes in the flash memory. |
| --erase-all | Optional; defaults off. | Erases the entire flash memory. The erase operation occurs before programming, if an input file is provided for programming. |
| --program | Optional; defaults on if an input file is specified. | Programs flash memory from the input files. |
| --no-keep-nearby | Optional; defaults off. | Throws away partial sector data. If the data to program does not completely fill the first or last sector, the flash programmer normally preserves and reprograms the original data in those sectors. The --no-keep-nearby parameter disables this feature. This option speeds up the programming process, but is only appropriate if the existing flash memory contents are unimportant. |
| --verify | Optional; defaults off. | Verifies that contents of flash memory match input files. |
| { <file> } | Optional. | Specifies the name(s) of the input file(s) to program or verify. Separate multiple file names with spaces. |
| --read=<file> | Optional; defaults off. | Reads flash memory contents into the specified file. |
| --read-bytes=<start>,<size> | Optional if --read is specified; defaults off. | Specifies which address range to read (byte addresses). |
| --go | Optional; defaults off. | Runs the processor from its reset vector after flash memory programming is complete. |
6 The --cable parameter is only needed if there are multiple download cables connected to the host computer. To determine the cable names, run jtagconfig.
7 The --device parameter is only needed if there are two or more processors in different devices with the same instance ID. To determine the JTAG device index, run jtagconfig.
8 There are two ways to find the correct value of the instance ID for a processor. The easiest is to use the Nios® II Flash Programmer GUI to create a sample flash programmer script. For more information, refer to the "Using the Flash Programmer GUI" chapter. Alternatively, open < Intel® Quartus® Prime project name>.jdi, in the Intel® Quartus® Prime project directory. Locate the Nios® II processor node by finding a value of hpath containing "<processor module name>=". The instance ID is specified as instance_id.
9 In system.h and in your board support package (BSP), the system ID base address is specified by SYSID_BASE.
10 In system.h and in your BSP the system ID value is specified by SYSID_ID.