Skip to main content

ETH-PCIE

PCIe Ethernet Card​

This section describes how to use the PCIe Ethernet expansion function on the Raspberry Pi, laying the foundation for subsequent project development.

Note: The PCIe interface must be enabled before using this function.
PCIe Version Restriction

The product supports only PCIe Gen 2.

Working with Official Raspberry Pi OS​

Enabling the PCIe Interface​

  • Enabling the PCIe interface (PCIe Gen 2 is enabled by default)

    • Edit the config.txt file

      sudo nano /boot/firmware/config.txt

    • PCIe defaults to gen2. If PCIe is not already enabled, add the following to config.txt:

      dtparam=pciex1

    • After modification, reboot the Raspberry Pi to recognize the device

      sudo reboot

    • After reboot, check the PCIe recognition status (the output may vary depending on the module)

      lspci

PCIe Ethernet Card Operations​

  • If the PCIe interface is not enabled, enable the PCIe interface first

  • The Raspberry Pi has the relevant drivers installed by default; the expansion Ethernet port can be used once PCIe is enabled

  • Power is supplied through the PCIe interface by default; no additional power is required

  • After reboot, check the existing Ethernet interfaces

    ifconfig

  • Test by using the ping command with a specific interface

    ping baidu.com -I eth1  # Replace eth1 with the actual interface name

Using on Other Systems​

System Compatibility

If you are not using Raspberry Pi OS but another Raspberry Pi‑compatible system, the PCIe device may be detected but the Ethernet card may not be recognized.

  • The kernel needs to be recompiled

    Device Drivers
    > Network device support
      > Ethernet driver support
        > Realtek devices
          > Realtek 8169/8168/8101/8125 ethernet support

  • The driver installation method depends on the system and kernel version in use. Please refer to the system documentation for configuration.