Preparing the Linux Agent for Remote Connection - 2024.2 English - UG1209

The Vitis IDE needs a channel to download the application to the running target. When the target runs Linux, it uses TCF Agent running on Linux. TCF Agent is added to the Linux rootfs from the PetaLinux configuration by default. When Linux boots up, it launches TCF Agent automatically. The Vitis IDE talks to TCF Agent on the board using an Ethernet connection.

1. Prepare for running the Linux application on the ZCU102 board. Vitis can download the Linux application to the board, which runs Linux through a network connection. It is important to ensure that the connection between the host machine and the board works well.

   1. Make sure the USB UART cable is still connected with the ZCU102 board. Turn on your serial console and connect to the UART port.

   2. Connect an Ethernet cable between the host and the ZCU102 board.

      • It can be a direct connection from the host to the ZCU102 board.

      • You can also connect the host and the ZCU102 board using a router.

   3. Power on the board and let Linux run on ZCU102 (see Verifying the Image on the ZCU102 Board).

   4. Set up a networking software environment.

      1. If the host and the board are connected directly, run ifconfig end0 192.168.1.1 to setup an IP address on the board.

      2. Go to Control Panel → Network and Internet → Network and Sharing Center, and click Change Adapter Settings.

      3. Find your Ethernet adapter, then right-click and select Properties.

      4. Double-click Internet Protocol Version 4 (TCP/IPv4), and select Use the following IP address.

      5. Input the IP address 192.168.1.2 and click OK.

         • If the host and the board are connected through a router, they should be able to get an IP address from the router. If the Ethernet cable is plugged in after the board boots up, you can get the IP address manually by running the udhcpc eth0 command, which returns the board IP address.

         • Have the host and the ZCU102 board ping each other to make sure the network is set up correctly.

2. Set up the Linux agent in the Vitis IDE.

   1. Click Vitis → Target Connections icon on the toolbar.

      

      Fig. 14 Vitis Show View search for Target Connections

   2. In the Target Connections window, double-click Linux TCF Agent → Linux Agent[default].

   3. Input the IP address of your board.

   4. Click Test Connection.

      

      Fig. 15 Vitis test connection details

      Vitis should return a pop-up confirmation for success.

      

      Fig. 16 Vitis test connection success