# Configure Ethernet features

Ethernet supports a wide range of generic features that don’t require specific configuration. However, a few features that must be configured explicitly for each reference kit 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 verifying the
status of EEE and enabling or disabling EEE. Sample commands and their outputs for each function are provided here for your reference.

- Verify EEE status

> 
> 
> 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

- 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

- 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/2500] duplex [full]
    Copy to clipboard

For example:

ethtool -s eth0 autoneg on speed 2500 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/2500] duplex [full]
    Copy to clipboard

For example:

ethtool -s eth0 autoneg on speed 2500 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

## Next steps

> 
> 
> - [Troubleshoot Ethernet issues](https://docs.qualcomm.com/doc/80-80020-26/topic/troubleshoot-ethernet-issues.html#troubleshoot-ethernet-issues)

Last Published: Feb 19, 2026

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