Embedded Design Handbook

ID 683689
Date 8/28/2023
Public
Document Table of Contents

4.1.1.1.1. jtagconfig Usage Example

To use the jtagconfig command, perform the following steps:

  1. Open a Nios® II command shell.
  2. In the command shell, type the following command:
    jtagconfig -n

jtagconfig Example Response

$ jtagconfig -n
1) 
               Intel® FPGA Download Cable [USB-0]
020050DD EP1S40/_HARDCOPY_FPGA_PROTOTYPE
Node 11104600
Node 0C006E00

The information in the response varies, depending on the particular FPGA, its configuration, and the JTAG connection cable type. The table below describes the information that appears in the response in the example.

Table 14.  Interpretation of jtagconfig Command Response
Value Description
Intel® FPGA Download Cable [USB-0] The type of cable. You can have multiple cables connected to your workstation.
EP1S40/_HARDCOPY_FPGA_PROTOTYPE The device name, as identified by silicon identification number.
Node 11104600 The node number of a JTAG node inside the FPGA. The appearance of a node number between 11104600 and 11046FF, inclusive, in this system’s response confirms that you have a Nios® II processor with a JTAG debug module.
Note 0C006E00 The node number of a JTAG node inside the FPGA. The appearance of a node number between 0C006E00 and 0C006EFF, inclusive, in this system’s response confirms that you have a JTAG UART component.

The device name is read from the text file pgm_parts.txt in your Quartus® Prime installation. In the example above, the name is EP1S40/_HARDCOPY_FPGA_PROTOTYPE because the silicon identification number on the JTAG chain for the FPGA device is 020050DD, which maps to the names EP1S40<device-specific name>, a couple of which end in the string _HARDCOPY_FPGA_PROTOTYPE. The internal nodes are nodes on the system-level debug (SLD) hub. All JTAG communication to an Intel FPGA passes through this hub, including advanced debugging capabilities such as the Signal Tap II embedded logic analyzer and the debugging capabilities in the Nios® II EDS.

The example above illustrates a single cable connected to a single-device JTAG chain. However, your computer can have multiple JTAG cables, connected to different systems. Each of these systems can have multiple devices in its JTAG chain. Each device can have multiple JTAG debug modules, JTAG UART modules, and other kinds of JTAG nodes. Use the jtagconfig -n command to help you understand the devices with JTAG connections to your host PC and how you can access them.