# Configure Ethernet features

Note

Ethernet supports a wide range of generic features that don’t require specific configuration. However, a few features that must be configured explicitly are described here.

Tab QCS6490
Tab IQ-9075
Tab IQ-8275
Tab IQ-615

- *class* tabincludedirective

    - ## Configure link speed

You can configure link speed from the supported link modes in the `ethtool` command output.

ethtool -s [device_name] autoneg [on/off] speed [10/100/1000/2500] duplex [full]
    Copy to clipboard

For example:

ethtool -s enP1p5s0f0 autoneg on speed 2500 duplex full
    Copy to clipboard

## Configure energy efficient Ethernet

Note

EEE feature is supported only on QEP8121 PHY.

You can control EEE by performing certain functions such as verify the
status of EEE and enabling or disabling EEE.

To configure EEE, do the following:

1. Verify the status of EEE.

ethtool --show-eee [interface]
        Copy to clipboard

    For example:

ethtool --show-eee enP1p5s0f1
        Copy to clipboard

    Sample output:

EEE settings for enP1p5s0f1:
        EEE status: disabled
        Tx LPI: disabled
        Supported EEE link modes:  1000baseT/Full
                                   10000baseT/Full
                                   1000baseKX/Full
                                   10000baseKX4/Full
                                   10000baseKR/Full
        Advertised EEE link modes:  Not reported
        Link partner advertised EEE link modes:  Not reported
        Copy to clipboard

2. Enable EEE.

ethtool --set-eee [interface] eee on
        Copy to clipboard

    For example:

ethtool --set-eee enP1p5s0f1 eee on
        Copy to clipboard

    Sample output:

EEE settings for enP1p5s0f1:
        EEE status: enabled - inactive
        Tx LPI: 17 (us)
        Supported EEE link modes:  100baseT/Full
                                   1000baseT/Full
        Advertised EEE link modes: 100baseT/Full
                                   1000baseT/Full
        Link partner advertised EEE link modes: Not reported
        Copy to clipboard

3. Disable EEE.

ethtool --set-eee [interface] eee off
        Copy to clipboard

    For example:

ethtool --set-eee enP1p5s0f1 eee off
        Copy to clipboard

    Sample output:

EEE settings for enP1p5s0f1:
        EEE status: disabled
        Tx LPI: 17 (us)
        Supported EEE link modes:  100baseT/Full
                                   1000baseT/Full
        Advertised EEE link modes: 100baseT/Full
                                   1000baseT/Full
        Link partner advertised EEE link modes: Not reported
        Copy to clipboard

## Verify preconfigured MAC address

QPS615 is a PCIe switch on RB3 Gen 2 Development Kit. It doesn’t have
an electrically erasable programmable read only memory (EEPROM) to store
the MAC address permanently. However, the MAC address is programmed and
stored at a persistent path on the device.

To verify the preconfigured MAC address, do the following:

1. Verify the configuration of the interface.

ifconfig
        Copy to clipboard

    Sample output:

enP1p5s0f0 Link encap:Ethernet  HWaddr XX:XX:XX:YY:YY:YY
                 inet addr:169.254.227.235  Bcast:169.254.255.255  Mask:255.255.0.0
                 inet6 addr: fe80::533c:8ed6:557:3860/64 Scope:Link
                 UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
                 RX packets:19 errors:0 dropped:0 overruns:0 frame:0
                 TX packets:36 errors:0 dropped:0 overruns:0 carrier:0
                 collisions:0 txqueuelen:1000
                 RX bytes:3416 (3.3 KiB)  TX bytes:5559 (5.4 KiB)
                 Interrupt:249
        Copy to clipboard

    The MAC address is stored in the `config.ini` file and is available at `/var/persist` of the device.
2. Verify whether the `config.ini` file is available on the device.

ls /var/persist/
        Copy to clipboard
3. Verify the content of the `config.ini` file.

cat /var/persist/config.ini
        Copy to clipboard

    Sample output:

#MAC ID configuration, For Test purpose only
        MDIOBUSID1: 1: MAC_ID01: XX:XX:XX:YY:YY:YY
        Copy to clipboard

## Retain and store MAC address

Whenever the device reboots, the MAC address configuration `config.ini`
file in the persistent path `/var/persist` is retained. However, while
upgrading the software build, if the **Erase all before download**
option is selected, then the configuration file is removed from the
device. In such cases, the software assigns a random MAC address.

To retain the `config.ini` file and store the MAC address in a location
other than `/var/persist`, do the following:

1. Back up the file to a local path.

scp  root@<device_ip_address>:/var/persist/config.ini .
        Copy to clipboard
2. Restore the backed-up file after upgrading the software build.

scp config.ini root@<device_ip_address>:/var/persit/
        Copy to clipboard

Note

When prompted for a password, enter `oelinux123` to authenticate the file transfer via the secure copy protocol (SCP).
3. To store the MAC address in a location other than `/var/persist`,
update the EMAC driver software with the new path in the following
source code.

sources/data-eth/drivers/qps615/src/tc956xmac_main.c
        ret = kernel_read_file_from_path("/var/persist/config.ini", &data, &size, 1000, READING_POLICY);
        Copy to clipboard

- *class* tabincludedirective

    - ## Configure link speed

You can configure link speed from the supported link modes in the
`ethtool` command output.

ethtool -s [device_name] autoneg [on/off] speed [10/100/1000] duplex [full]
    Copy to clipboard

For example:

ethtool -s eth0 autoneg on speed 1000 duplex full
    Copy to clipboard

- *class* tabincludedirective

    - ## Configure link speed

You can configure link speed from the supported link modes in the
`ethtool` command output.

ethtool -s [device_name] autoneg [on/off] speed [10/100/1000] duplex [full]
    Copy to clipboard

For example:

ethtool -s eth0 autoneg on speed 1000 duplex full
    Copy to clipboard

- *class* tabincludedirective

    - ## Configure link speed

You can configure link speed from the supported link modes in the
`ethtool` command output.

ethtool -s [device_name] autoneg [on/off] speed [10/100/1000] duplex [full]
    Copy to clipboard

For example:

ethtool -s eth0 autoneg on speed 1000 duplex full
    Copy to clipboard

## Configure PTP

You can configure PTP feature on IQ-615 EVK to synchronize clocks throughout a device.

To configure PTP, do the following:

1. Download the latest [linux PTP](https://www.linuxptp.org/) source code.
2. Compile the source code to generate ptp4l binary.
3. Download the ptp4l binary and `default.cfg` file to the `/data` directory in IQ-615 EVK.

    The `default.cfg` file is available in the `configs` directory of the linux PTP source code.

### PTP test setup

1. Connect two IQ-615 EVKs using a LAN cable, where one EVK works as a master and the other as a slave.
2. Run the PTP daemon as master on one IQ-615 EVK.

/data/ptp4l -i eth0 -A -m -l 7
        Copy to clipboard
3. Run the PTP daemon as slave on another IQ-615 EVK.

/data/ptp4l -i eth0 -A -m -l 7 -s
        Copy to clipboard

Note

For information about ptp4l arguments, see ptp4l linux man page.

## Configure TSO

You can enable TSO feature on IQ-615 EVK to reduce CPU overload, enhance system performance, and improve overall throughput.

To enable and verify TSO, do the following:

1. Disable TSO.

> 
> 
> ethtool -K [device_name] tso off
>         Copy to clipboard
> 
> 
> For example:
> 
> 
> ethtool -K eth0 tso off
>         Copy to clipboard
2. Enable TSO.

> 
> 
> ethtool -K [device_name] tso on
>         Copy to clipboard
> 
> 
> For example:
> 
> 
> ethtool -K eth0 tso on
>         Actual changes:
>         tx-tcp-segmentation: on
>         tx-tcp-ecn-segmentation: off [requested on]
>         tx-tcp-mangleid-segmentation: on
>         tx-tcp6-segmentation: on
>         Copy to clipboard
3. Verify TSO status.

> 
> 
> ethtool -k [device_name]
>         Copy to clipboard
> 
> 
> For example:
> 
> 
> ethtool -k eth0
>         Features for eth0:
>         tcp-segmentation-offload: on
>             tx-tcp-segmentation: on
>             tx-tcp-ecn-segmentation: off [fixed]
>             tx-tcp-mangleid-segmentation: on
>             tx-tcp6-segmentation: on
>         Copy to clipboard

Last Published: Nov 10, 2025

[Previous Topic
Perform Ethernet operations](https://docs.qualcomm.com/bundle/publicresource/80-70022-26/topics/perform-ethernet-operations.md) [Next Topic
Troubleshoot Ethernet issues](https://docs.qualcomm.com/bundle/publicresource/80-70022-26/topics/troubleshoot-ethernet-issues.md)