Debugging on a Remote Board - 2023.2 English

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

Document ID
Release Date
2023.2 English
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 your board is correctly connected.
    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 that is connected 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 Port on which the hardware server was launched, 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 AMD Vitis™ Unified IDE.
    10. Click OK.
    11. Two available connections are displayed. In this case, remote_zc702_1 is the remote connection.

    12. Click the debug button.
    Note: For target connection creation, refer to: Target Connections.