Debugging on a Remote Board - 2025.2 English - UG1400

The following describes the steps for debugging on a remote board.

1. Setting up the remote system environment:
   1. Run hw_server with a non-default port (for example: 3122) to enable remote connections. Use the following command to launch the hw_server on port 3122:

      the hw_server -s TCP::3122

   2. Make sure connections to your board are correct.
   3. In a cmd window on the host machine, check the IP address:
      
      
2. Setup the Local System for Remote Debug:
   1. Launch the Vitis Unified IDE.
   2. Select the application component to debug.
   3. Go to the Flow Navigator and click Open Launch configuration. See Launch Configurations for details.
   4. For the Target Connection filed, click New to create a new target connection.
      
      
   5. In the New Target Connection wizard, add the required details for the remote host connecting to the target.
   6. In the Target Name, type a name for the target.
   7. In the Host field, enter the IP address or name of the host machine.
   8. In the Port field, enter the hardware server's launching Port, for example 3122.
   9. Select Use Symbol Server to ensure that the source code view is available, during debugging the application remotely. Symbol server acts as a mediator between hardware server and the Vitis Unified IDE.
   10. Click OK.
   11. In the following screenshot, there are two available connections. remote_zc702_1 is the remote connection.
       
       
   12. Click the debug button.
   Note: For target connection creation, refer to: Target Connections.