> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ethernet overview

Ethernet technology is designed to transmit data over a channel using wired technology at different link speeds. It uses cables to transmit data in network models, such as local area network (LAN) and wide area network (WAN) for a reliable, secure, and better network connectivity.

Ethernet connectivity is integrated into IoT devices and sensors, allowing them to transmit data to the network. It’s defined under IEEE 802.3 standards and provides a standardized interface for these devices to communicate with gateways.

Qualcomm<sup>®</sup> Linux<sup>®</sup> provides Ethernet features, architecture, and tools that can help you develop Ethernet applications on the following reference kits:

* Qualcomm Dragonwing<sup>TM</sup> RB3 Gen 2 Development Kit
* Qualcomm Dragonwing<sup>TM</sup> IQ-9075 Evaluation Kit (EVK)
* Qualcomm Dragonwing<sup>TM</sup> IQ-9075 EVK with Mezzanine card
* Qualcomm Dragonwing<sup>TM</sup> IQ-8275 EVK
* Qualcomm Dragonwing<sup>TM</sup> IQ-8275 EVK with Mezzanine card
* Qualcomm Dragonwing<sup>TM</sup> IQ-615 EVK

Additionally, Qualcomm Linux offers capabilities to bring up the Ethernet functionality, configure its features, and enable logging to debug issues.

<Note>
  See [Hardware SoCs](https://dragonwingdocs.qualcomm.com/Hardware-SoCs) that are supported on Qualcomm Linux.
</Note>

## **Ethernet interfaces**

The following table lists the reference kits and their supported Ethernet interfaces.

| **Reference kit**                                                                                                                         | **SoC** | **Ethernet interfaces**                                                                                                                  |
| :---------------------------------------------------------------------------------------------------------------------------------------- | :-----: | :--------------------------------------------------------------------------------------------------------------------------------------- |
| [Dragonwing RB3 Gen 2 Development Kit](https://docs.qualcomm.com/doc/80-80023-251/topic/rb3_hardware_overview.html#ethernet)              | QCS6490 | <ul><li>1 x RJ45 connector</li><li>1 x IX connector</li><li>1 x IX connector (optional)</li></ul>                                        |
| [Dragonwing IQ-9075 EVK](https://dragonwingdocs.qualcomm.com/Hardware-Docs/IQ9075-user-guide/hardware-overview#evk-ports-and-interfaces)  | IQ-9075 | 1 x RJ45 connector                                                                                                                       |
| Dragonwing IQ-9075 EVK with Mezzanine card                                                                                                | IQ-9075 | <ul><li>1 x RJ45 connector</li><li>1 x RJ45 connector for QPS615 + AQR PHY</li><li>1 x RJ45 connector for QPS615 + QEP8121 PHY</li></ul> |
| [Dragonwing IQ-8275 EVK](https://dragonwingdocs.qualcomm.com/Hardware-Docs/IQ8275-user-guide/hardware-overview.#evk-ports-and-interfaces) | IQ-8275 | 1 x RJ45 connector                                                                                                                       |
| Dragonwing IQ-8275 EVK with Mezzanine card                                                                                                | IQ-8275 | <ul><li>1 x RJ45 connector for QPS615 + AQR PHY</li><li>1 x RJ45 connector for QPS615 + QEP8121 PHY</li></ul>                            |
| Dragonwing IQ-615 EVK                                                                                                                     |  IQ-615 | 1 x RJ45 connector                                                                                                                       |

## **Ethernet features**

<Tabs>
  <Tab title="QCS6490">
    ### **Energy efficient Ethernet**

    Energy efficient Ethernet (EEE) is an optional operational mode that helps in reducing the consumption of power while transmitting and receiving data. When there is no data to transmit or receive, this feature allows the MAC sublayer and a family of physical layers (PHY) to operate in the low-power idle (LPI) mode.

    During link negotiation, the link partners learn about the capabilities and features, such as EEE, supported by the remote entity. Based on the supported capabilities, features, and data transfer state, the MAC determines whether the system should enter or exit the LPI mode and communicates this information to the PHY.

    The EEE feature specifies the capabilities and negotiation methods that the link partners can use to:

    * Determine whether EEE is supported.
    * Select the set of parameters that are common to both the devices.

    <Note>
      EEE feature is supported only on QEP8121 PHY.
    </Note>

    For configuration details, see [Configure EEE on QCS6490](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/configure-ethernet-features#configure-energy-efficient-ethernet).
  </Tab>

  <Tab title="IQ-9075">
    ### **Generalized Precision Time Protocol**

    The generalized Precision Time Protocol (gPTP) specifies a simplified and interoperable time synchronization architecture designed to operate across heterogeneous network media, including Ethernet, Wi-Fi, EPON, and coordinated shared networks.

    IEEE 802.1AS 2020 defines a precise timing and synchronization protocol for Time Sensitive Networking (TSN) across IEEE 802 LAN/MAN technologies. gPTP is a profile of the IEEE 1588 Precision Time Protocol (PTP), optimized for deterministic audio video (AV), industrial, and control oriented applications that require low latency and tightly synchronized network operation.

    For configuration details, see [Configure gPTP](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/configure-ethernet-features#configure-gptp).
  </Tab>

  <Tab title="IQ-9075 with Mezzanine">
    ### **Energy efficient Ethernet**

    Energy efficient Ethernet (EEE) is an optional operational mode that helps in reducing the consumption of power while transmitting and receiving data. When there is no data to transmit or receive, this feature allows the MAC sublayer and a family of physical layers (PHY) to operate in the low-power idle (LPI) mode.

    During link negotiation, the link partners learn about the capabilities and features, such as EEE, supported by the remote entity. Based on the supported capabilities, features, and data transfer state, the MAC determines whether the system should enter or exit the LPI mode and communicates this information to the PHY.

    The EEE feature specifies the capabilities and negotiation methods that the link partners can use to:

    * Determine whether EEE is supported.
    * Select the set of parameters that are common to both the devices.

    <Note>
      EEE feature is supported only on QEP8121 PHY.
    </Note>

    For configuration details, see [Configure EEE](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/configure-ethernet-features#configure-energy-efficient-ethernet-2).

    ### **Device tree source overlay (QPS615)**

    A Device tree source (DTS) overlay is a modular extension to a Linux device tree that allows hardware descriptions to be added, modified, or enabled on top of an existing base device tree.

    DTS overlays are typically applied at boot time and allow hardware configuration changes without modifying or recompiling the original device tree. This mechanism is commonly used to enable optional peripherals or board-specific features.

    <Note>
      EFI based overlay is required to enable Ethernet interfaces, which in turn enable XO shutdown and S2R functionality.
    </Note>

    For more information, see [Enable QPS615 Ethernet ports using DTS overlay](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/bring-up-ethernet#enable-qps615-ethernet-ports-using-dts-overlay).
  </Tab>

  <Tab title="IQ-8275">
    Basic Ethernet features such as interface enumeration and data path are supported on IQ-8275 EVK.
  </Tab>

  <Tab title="IQ-8275 with Mezzanine">
    ### **Energy efficient Ethernet**

    Energy efficient Ethernet (EEE) is an optional operational mode that helps in reducing the consumption of power while transmitting and receiving data. When there is no data to transmit or receive, this feature allows the MAC sublayer and a family of physical layers (PHY) to operate in the low-power idle (LPI) mode.

    During link negotiation, the link partners learn about the capabilities and features, such as EEE, supported by the remote entity. Based on the supported capabilities, features, and data transfer state, the MAC determines whether the system should enter or exit the LPI mode and communicates this information to the PHY.

    The EEE feature specifies the capabilities and negotiation methods that the link partners can use to:

    * Determine whether EEE is supported.
    * Select the set of parameters that are common to both the devices.

    <Note>
      EEE feature is supported only on QEP8121 PHY.
    </Note>

    For configuration details, see [Configure EEE](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/configure-ethernet-features#configure-energy-efficient-ethernet-3).

    ### **Device tree source overlay (QPS615)**

    A Device tree source (DTS) overlay is a modular extension to a Linux device tree that allows hardware descriptions to be added, modified, or enabled on top of an existing base device tree.

    DTS overlays are typically applied at boot time and allow hardware configuration changes without modifying or recompiling the original device tree. This mechanism is commonly used to enable optional peripherals or board-specific features.

    <Note>
      EFI based overlay is required to enable Ethernet interfaces, which in turn enable XO shutdown and S2R functionality.
    </Note>

    For more information, see [Enable QPS615 Ethernet ports using DTS overlay](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/bring-up-ethernet#enable-qps615-ethernet-ports-using-dts-overlay-2).
  </Tab>

  <Tab title="IQ-615">
    ### **Device tree source overlay (QPS615)**

    A Device tree source (DTS) overlay is a modular extension to a Linux device tree that allows hardware descriptions to be added, modified, or enabled on top of an existing base device tree.

    DTS overlays are typically applied at boot time and allow hardware configuration changes without modifying or recompiling the original device tree. This mechanism is commonly used to enable optional peripherals or board-specific features.

    <Note>
      EFI based overlay is required to enable Ethernet interfaces, which in turn enable XO shutdown and S2R functionality.
    </Note>

    For more information, see [Enable QPS615 Ethernet ports using DTS overlay](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/bring-up-ethernet#enable-qps615-ethernet-ports-using-dts-overlay-3).
  </Tab>
</Tabs>

## **Next steps**

> * [Get started with Ethernet](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/get-started-with-ethernet)
> * [Learn about Ethernet architecture](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/ethernet-architecture)
> * [Bring up Ethernet](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/bring-up-ethernet)
> * [Perform Ethernet operations](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/perform-ethernet-operations)
> * [Configure Ethernet features](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/configure-ethernet-features)
> * [Troubleshoot Ethernet issues](https://dragonwingdocs.qualcomm.com/Technologies/Ethernet/troubleshoot-ethernet-issues)
