Skip to main content

Static IP Configuration

Wired Ethernet Port Direct Connection to PC

Starting from FlyOS-Fast v1.3.9, the wired Ethernet port supports automatic detection of direct PC connections or routers. If the device's Ethernet port is directly connected to a PC, wait approximately 15 seconds and access the device via 10.10.10.1 or local.klipper.cn; manual static IP configuration is generally not required for direct connection scenarios.

Purpose and Advantages of Static IP​

Static IP configuration ensures the device has a fixed address on the network, providing stable and reliable network connectivity for various application scenarios.

Main Application Scenarios​

  1. Ensuring Stable Device Accessibility

    • The device consistently maintains the same IP address, facilitating remote access and control
    • Suitable for scenarios requiring fixed addresses such as web servers, MQTT communication, and PLC control

  2. Simplifying Network Management

    • In LAN or industrial networks, devices such as cameras, sensors, and controllers require fixed IPs
    • Facilitates stable connections for other systems and services

  3. Adapting to Special Network Environments

    • Static IPs are mandatory in environments without DHCP services (e.g., industrial control, edge computing)
    • Avoids reliance on dynamic address allocation

  4. Enhancing Development and Debugging Efficiency

    • Fixed IPs enable quick device identification and connection
    • Simplifies repetitive testing procedures

  5. Supporting Device Discovery Mechanisms

    • When accessing devices via preset IP ranges, static IPs ensure the device responds as expected

Comparison of Static IP Advantages​

AdvantageDescription
Stable and ReliableFixed IP addresses ensure stable communication for long-running devices
Headless Environment FriendlySuitable for embedded devices and other environments without graphical interfaces
Convenient Remote MaintenanceMore efficient when connecting via SSH, Web, API, etc.
Closed Network AdaptationStatic IPs are required in industrial or private networks without DHCP
Automation SupportDeployment, monitoring, and update scripts rely on consistent IPs to function properly

System-Side Configuration​

IP Address Selection Recommendations
  • Avoid using IP addresses near boundary values such as 0, 1, 254, and 255
  • Addresses like 192.168.1.254 may be occupied by other applications, leading to unstable connections
  • It is recommended to use IP addresses in the middle range, such as 192.168.1.100 - 192.168.1.200

Configuration Steps​

  1. Connect to the System Terminal

    • Use SSH to connect to the device system

  2. View Network Interfaces

    • Execute the command: ip link show
    • Note the network interface name, such as eth0 or end0
    Loading...

  3. Edit the Network Configuration File

    • Execute the command: nano /etc/systemd/network/end0.network
    • Note: The end0 in the filename must be replaced with the actual network interface name
    Loading...

  4. Configure Static IP Parameters

    • Modify the file content as follows (adjust according to the actual network environment):
    [Match]
    # Match the network interface name; modify according to the actual situation
    Name=end0

    [Network]
    # Set the static IP address and subnet mask
    # /24 indicates a subnet mask of 255.255.255.0
    Address=192.168.1.100/24
    # Set the default gateway address
    Gateway=192.168.1.1
    # Set DNS servers
    DNS=8.8.8.8
    DNS=114.114.114.114
    Loading...

  5. Save and Apply the Configuration

    • Press Ctrl + S to save the file
    • Press Ctrl + X to exit the editor
    • Execute the command to restart the network service: systemctl restart systemd-networkd

  6. Verify the Configuration Result

    • Execute the command: ip a
    • Confirm that the displayed IP address matches the configuration
    Loading...

PC-Side Configuration​

To ensure proper communication between the PC and the device configured with a static IP, corresponding network configuration is required on the PC side.

Network Parameter Settings​

ParameterConfiguration RequirementDescription
Local IP192.168.1.xxxMust be on the same subnet as the device IP
Gateway192.168.1.1Must match the gateway configured on the device
Subnet Mask255.255.255.0Corresponds to the device IP's /24 configuration
DNS Server8.8.8.8, 114.114.114.114Use common public DNS services

Configuration Methods​

Windows System​

  1. Open "Network and Sharing Center"
  2. Click "Change adapter settings"
  3. Right-click the active network connection and select "Properties"
  4. Double-click "Internet Protocol Version 4 (TCP/IPv4)"
  5. Select "Use the following IP address" and fill in the corresponding parameters

macOS System​

  1. Open "System Preferences" → "Network"
  2. Select the active network connection
  3. Click "Advanced" → "TCP/IP"
  4. Configure "IPv4" as "Manual"
  5. Fill in the corresponding IP address, subnet mask, and router address

Connectivity Test​

After configuration, it is recommended to perform a connectivity test:

# Execute the ping command on the PC to test connectivity
ping 192.168.1.100

# If replies are received, the network configuration was successful
Troubleshooting

If the device cannot be pinged, check:

  • Whether the Ethernet cable connection is normal
  • Whether firewall settings are blocking communication
  • Whether the IP addresses are on the same subnet
  • Whether the subnet mask and gateway configurations are correct
Loading...