Homepage    Static IP Configuration Guide for Z19 Board

Static IP Configuration Guide for Z19 Board

Created on:2026-08-27 09:31

 

1 Overview

This guide describes how to configure a fixed static IP address (e.g. 192.168.1.238) when the ZU19EG board is directly connected to a host PC via an Ethernet cable. For direct cable connection without a router or DHCP server, a manual static‑IP setup is required for network communication.

Note: If the board connects through a switch or router, IP address is assigned automatically, this procedure is not required.

2 Hardware Preparation and Connection

Verify all hardware connections before software configuration.

  • ZU19EG Board: Target development board.
  • ZU19EG Power Adapter: Power supply for the board.
  • USB‑to‑UART Cable: Connect host PC to PS UART port on ZU19EG.
  • Ethernet Cable: Direct connection between ZU19EG PS Ethernet port and host PC network port.

Connection Steps: Connect one end of USB‑to‑UART cable to the board PS UART port, and the other end to host USB port. Plug one end of Ethernet cable into the PS Ethernet port of ZU19EG, connect the other end directly to PC network adapter.

3 Serial‑port Connection and System Login

A serial terminal is required to view boot log and perform network configuration.

Serial terminal tool recommendation: MobaXterm (integrated serial port & SSH client).

Power‑on the board and log in:

Username: root
Password: root

4 Network Configuration Procedure

After login, create startup script to persist static‑IP settings.

Enter the following command in terminal to create script file:

vi /etc/init.d/network-static

Press i to enter edit mode, copy and paste the script content below:

case "$1" in
    start)
        echo "Configuring static IP on eth0..."
        # Wait for eth0 ready (max 5 seconds)
        count=0
        while [ ! -e /sys/class/net/eth0 ] && [ $count -lt 50 ]; do
            sleep 0.1
            count=$((count + 1))
        done
        if [ ! -e /sys/class/net/eth0 ]; then
            echo "ERROR: eth0 device not found!"
            exit 1
        fi
        # Clear old ip settings
        ip addr flush dev eth0 2>/dev/null
        # Assign static IP (broadcast auto‑calculated)
        ip addr add 192.168.1.238/24 dev eth0
        # Bring up ethernet interface
        ip link set eth0 up
        # Default gateway (optional for internet access)
        ip route add default via 192.168.1.1 2>/dev/null
        # Configure DNS servers
        echo "nameserver 8.8.8.8" > /etc/resolv.conf
        echo "nameserver 114.114.114.114" >> /etc/resolv.conf
        echo "Static IP configured successfully."
        ;;
    stop)
        echo "Stopping network-static..."
        ip addr flush dev eth0
        ip link set eth0 down
        ;;
    restart|reload)
        $0 stop
        $0 start
        ;;
    *)
        echo "Usage: $0 {start|stop|restart}"
        exit 1
        ;;
esac

exit 0

Press Esc, input :wq to save and exit vi editor.

Grant execute permission:

chmod +x /etc/init.d/network-static

Enable auto‑run on system boot:

ln -s /etc/init.d/network-static /etc/rcS.d/S99network-static

Disable DHCP client:

mv /sbin/udhcpc /sbin/udhcpc.bak

5 Test and Verification

Verify configuration after completing all steps.

Manually start the network script:

/etc/init.d/network-static start

Check ethernet IP address:

ifconfig

Reboot for boot‑time validation:

reboot

6 Host PC Configuration

Set PC Ethernet IPv4 address within same subnet as board, example: 192.168.1.100, subnet mask 255.255.255.0.

Launch imggrab tool and confirm the board can be discovered on network.

Hello‑FPGA‑ZU19EG | Zynq UltraScale+ MPSoC Development Board