Setting Custom JTAG Frequency - 2025.2 English - UG1400

Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400)

Document ID
UG1400
Release Date
2025-11-20
Version
2025.2 English

You can operate at a different frequency supported by the JTAG cable by setting the JTAG frequency.

To set the JTAG frequency, execute the following steps.

  1. Right click the connection Hardware Server or Linux TCF Agent you want to add.
  2. Click the Add Target Connection button (+) on the toolbar.
  3. The Target Connection Details page opens.
  4. In the Target Name field, type a name for the new remote connection.
  5. Check the Set as default target check-box to set this target as default. The Vitis Unified IDE uses the default target for all the future interactions with the board.
  6. In the Host field, type the name or IP address of the remote host machine. This is the machine connecting to the target and the machine that hw_server is running on.
  7. In the Port field, type the port number on which the hw_server is running. By default, the hw_server runs on port 3121.
  8. Select Use Symbol Server, if the hardware server is running on a remote host.
  9. Click Advanced and select Automatically discover devices ON JTAG chain to view the JTAG device chain details.
  10. From the Set custom frequency drop-down list, select the frequency.
    Note: Current frequency can be the default frequency set by the server or the custom frequency set by a debug client.
  11. Click OK to save the configuration and create a new target connection. The Vitis tool saves the frequency in the workspace and uses the frequency when executing a connect command for the device.
  12. Note: If the server connects to only one client, the frequency of the cable resets to the default value whenever the connection closes. Do not perform simultaneous debug operations from different clients.