# Bring up Ethernet

The following figure shows the workflow to bring up Ethernet on the reference kits.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<!-- Generated by Microsoft Visio, SVG Export bringup-workflow.svg Page-1 -->
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ev="http://www.w3.org/2001/xml-events" width="8.01042in" height="1.38542in" viewbox="0 0 576.75 99.75" xml:space="preserve" color-interpolation-filters="sRGB" class="st8" aria-label="Figure : Ethernet bringup workflow"><style>.svg-1 .st1 { fill: #ffffff; stroke: none; stroke-linecap: round; stroke-linejoin: round; stroke-width: 0.75 }
.svg-1 .st2 { fill: #fafafa; stroke: #d2d7e1; stroke-linecap: round; stroke-linejoin: round; stroke-width: 0.75 }
.svg-1 .st3 { fill: #6280cc; stroke: #6280cc; stroke-linecap: round; stroke-linejoin: round; stroke-width: 0.75 }
.svg-1 .st4 { fill: #ffffff; font-family: Arial; font-size: 1.00001em }
.svg-1 .st5 { fill: #6280cc; stroke: #6280cc; stroke-width: 0.75 }
.svg-1 .st6 { marker-end: url("#mrkr4-19"); stroke: #000000; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1 }
.svg-1 .st7 { fill: #000000; fill-opacity: 1; stroke: #000000; stroke-opacity: 1; stroke-width: 0.28409090909091 }
.svg-1 .st8 { fill: none; fill-rule: evenodd; font-size: 12px; overflow: visible; stroke-linecap: square; stroke-miterlimit: 3 }</style>
<defs id="Markers">	<g id="lend4">		<path d="M 2 1 L 0 0 L 2 -1 L 2 1 " style="stroke:none"></path>	</g>	<marker id="mrkr4-19" class="st7" refx="-7.04" orient="auto" markerunits="strokeWidth" overflow="visible">		<use xlink:href="#lend4" transform="scale(-3.52,-3.52) "></use>	</marker></defs><g>	<title>VBackground-1</title>	<g id="shape1000-1">		<title>Solid.1000</title>		<rect x="0" y="0" width="576.75" height="99.75" class="st1"></rect>	</g></g><g>	<title>Page-1</title>	<g id="shape1034-3" transform="translate(18.375,-18.375)">		<title>Sheet.1034</title>		<rect x="0" y="36.75" width="540" height="63" rx="4.5" ry="4.5" class="st2"></rect>	</g>	<g id="shape4-5" transform="translate(28.5,-27.8437)">		<title>Sheet.4</title>		<desc>Assign MAC address</desc>		<rect x="0" y="56.55" width="144" height="43.2" rx="4.5" ry="4.5" class="st3"></rect>		<text x="15.98" y="81.75" class="st4">Assign MAC address</text>		</g>	<g id="shape20-8" transform="translate(404.625,-27.8437)">		<title>Sheet.20</title>		<desc>Configure MTU size</desc>		<rect x="0" y="56.55" width="144" height="43.2" rx="4.5" ry="4.5" class="st3"></rect>		<text x="18.98" y="81.75" class="st4">Configure MTU size</text>		</g>	<g id="shape1000-11" transform="translate(216.375,-27.8437)">		<title>Sheet.1000</title>		<desc>Assign IP address</desc>		<rect x="0" y="56.55" width="144" height="43.2" rx="4.5" ry="4.5" class="st5"></rect>		<text x="23.64" y="81.75" class="st4">Assign IP address</text>		</g>	<g id="shape1032-14" transform="translate(172.975,-49.9187)">		<title>Sheet.1032</title>		<path d="M0 99.75 L36.16 99.75" class="st6"></path>	</g>	<g id="shape1033-20" transform="translate(361.125,-49.6687)">		<title>Sheet.1033</title>		<path d="M0 99.75 L36.16 99.75" class="st6"></path>	</g></g>
</svg>

Ethernet bringup workflow

Tab QCS6490
Tab QCS9075
Tab QCS8275

- *class* tabincludedirective

    - Note

- Flash the corresponding [CDT](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250403001134/ReleaseNote.html#release-specific-information) on the device to ensure that the correct configuration is used for Ethernet bringup.
- The QPS615 MAC driver and kernel configuration are enabled by default in the source code.
- To bring up hardware configurations other than the configuration provided by Qualcomm, see [Bring up alternate hardware enablement](https://docs.qualcomm.com/doc/80-70018-26/topic/bring_up-ethernet.html#bring-up-alt-hardware-enablement).

To bring up Ethernet functionality on RB3 Gen 2 Development Kit, do the following:

> 
> 
> 1. The RB3 Gen 2 Development Kit comes with a [preconfigured MAC address](https://docs.qualcomm.com/doc/80-70018-26/topic/configure-ethernet-features.html#verify-preconfigured-mac). Skip this step if you choose to use the same MAC address.
> 
> 
> 
> > 
> > 
> > Alternatively, to modify the preconfigured MAC address on the device, perform the following steps:
> > 
> >     1. Bring down the interface.
> > 
> > 
> > 
> > > 
> > > 
> > > ifconfig <Interface_name> down
> > >             Copy to clipboard
> > > 
> > > 
> > > For example:
> > > 
> > > 
> > > ifconfig enP1p5s0f0 down
> > >             Copy to clipboard
> >     2. Assign the MAC address.
> > 
> > 
> > 
> > > 
> > > 
> > > ifconfig <Interface_name> hw ether <MAC Address>
> > >             Copy to clipboard
> > > 
> > > 
> > > For example:
> > > 
> > > 
> > > ifconfig enP15s0f0 hw ether XX:XX:XX:YY:YY:YY
> > >             Copy to clipboard
> >     3. Bring up the interface.
> > 
> > 
> > 
> > > 
> > > 
> > > ifconfig <Interface_name> <ip address> up
> > >             Copy to clipboard
> > > 
> > > 
> > > For example:
> > > 
> > > 
> > > ifconfig enP1p5s0f0 169.254.227.235 up
> > >             Copy to clipboard
> > 
> > 
> > 
> > Sample output:
> > 
> > 
> > ifconfig
> >         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
> > 
> > 
> > 
> > 
> > 
> > Note
> > 
> > 
> > This MAC address is valid only for the current boot cycle. On rebooting the device, the MAC address is updated with the address from persistent storage as described in Verify preconfigured MAC address.
> 2. When the device is connected to a public network, the DHCP server connected to the network assigns the IP address automatically. No specific configuration is required.
> 
> 
> 
> > 
> > 
> > Alternatively, you can assign a static IP address.
> > 
> > 
> > ifconfig <Interface_name> <ip address>
> >         Copy to clipboard
> > 
> > 
> > For example:
> > 
> > 
> > ifconfig enP1p5s0f0 169.254.227.235
> >         Copy to clipboard
> > 
> > 
> > Sample output:
> > 
> > 
> > ifconfig
> >         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
> > 
> > 
> > 
> > 
> > 
> > Note
> > 
> > 
> > This IP address is valid only for the current boot cycle. On rebooting the device, the IP address isn’t retained.
> 3. Configure the MTU size for the data packets over the Ethernet interface.
> 
> 
> 
> > 
> > 
> > ifconfig <Interface_name> down
> >         
> >         ifconfig <Interface_name> mtu <mtu_size>
> >         
> >         ifconfig <Interface_name> up
> >         Copy to clipboard
> > 
> > 
> > For example:
> > 
> > 
> > ifconfig enP1p5s0f0 down
> >         
> >         ifconfig enP1p5s0f0 mtu 1500
> >         
> >         ifconfig enP1p5s0f0 up
> >         Copy to clipboard
> > 
> > 
> > Sample output:
> > 
> > 
> > ifconfig
> >         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

## Bring up alternate hardware enablement

You can attach MAC/PHY components other than the hardware configuration provided by Qualcomm and bring them up. To replace QPS615 with other PCIe based MAC/PHY, see [PCIe software support for QPS615 switch](https://docs.qualcomm.com/bundle/publicresource/topics/80-70018-8/pcie.html#sub$pcie-software-support-feature-for-qps615).

Note

You must obtain the MAC/PHY driver and firmware from the respective vendor. Qualcomm isn’t responsible for these configuration changes.

### Retain QPS615 PCIe and replace QEP8121/AQR113C

To retain QPS615 PCIe and replace QEP8121/AQR113C with other PHY
components, do the following:

1. Based on the attached PHY recommendations, update all the parameters
in the `arch/arm64/boot/dts/qcom/qcs6490-addons-rb3gen2.dtsi` file.
2. Compile the software.

    Sample code for QEP PHY:

qep_vreg: qep_vreg {
              compatible = "regulator-fixed";
              regulator-name = "qep_vreg";
              gpio = <&pm7325_gpios 8 0>;
              regulator-min-microvolt = <1800000>;
              regulator-max-microvolt = <1800000>;
              enable-active-high;
              };

        qps615_eth1,qps615_eth1@pcie1_rp {
                 reg = <0x100 0x0 0x0 0x0 0x0>;
                 pinctrl-names = "default";
                 pinctrl-0 = <&napa_intn_wol_sig>;
                 qcom,phy-rst-gpio = <1>;
                 interrupts-extended = <&tlmm 101 IRQ_TYPE_EDGE_FALLING>;
                 interrupt-names = "wol_irq";
                 phy-supply = <&qep_vreg>;
                 qcom,phy-rst-delay-us = <20000>;
                 #address-cells = <1>;
                 #size-cells = <1>;
              };
        Copy to clipboard

    After flashing the modified software, the QPS615 driver scans the
physical devices connected to it and matches the device tree
information in the `qcs6490-addons-rb3gen2.dtsi` file.

Note

A PHY may fail to load due to mismatch between the
configuration in the `.dtsi` file and actual recommendations for the
PHY. In such cases, you must update the configuration in the `.dtsi`
file accordingly.

## AQR PHY enablement

Though AQR PHY for 10 GbE is optional, it’s validated on reference RB3
Gen 2 Development Kit. You must flash the PHY firmware to the hardware
only once. However, when the AQR PHY is detected, the PHY driver is enabled by default.

Qualcomm verified the following AQR PHY firmware on RB3 Gen 2
Development Kit:

- Marvell firmware: `AQR-G4_v5.6.1-QR_Marvell_NoSwap_XFI_ID44874_VER1836.cld`
- Marvell proprietary flashburn tool is recommended for flashing Marvell AQR113 PHY.
- Contact Marvell Technology, Inc. to obtain the AQR PHY firmware.

### Detect the PHY

To detect the PHY, do the following:

1. Update the AQR PHY parameters in the
`arch/arm64/boot/dts/qcom/qcs6490-addons-rb3gen2.dtsi` file.
2. Compile the software.

    Sample code for AQR PHY:

aqr_vreg: aqr_vreg {
                 compatible = "regulator-fixed";
                 regulator-name = "aqr_vreg";
                 gpio = <&pm7250b_gpios 4 0>;
                 regulator-min-microvolt = <1800000>;
                 regulator-max-microvolt = <1800000>;
                 enable-active-high;
              };
        
        qps615_eth0,qps615_eth0@pcie1_rp {
                 reg = <0x0 0x0 0x0 0x0 0x0>;
                 pinctrl-names = "default";
                 pinctrl-0 = <&aqr_intn_wol_sig>;
                 qcom,phy-rst-gpio = <0>;
                 interrupts-extended = <&tlmm 141 IRQ_TYPE_EDGE_FALLING>;
                 interrupt-names = "wol_irq";
                 phy-supply = <&aqr_vreg>;
                 qcom,phy-rst-delay-us = <221000>;
                 #address-cells = <1>;
                 #size-cells = <1>;
              };
        Copy to clipboard

- *class* tabincludedirective

    - Note

Flash the corresponding [CDT](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250403001134/ReleaseNote.html#release-specific-information) on the device to ensure that the correct configuration is used for Ethernet bringup.

To bring up Ethernet functionality on IQ-9075 EVK, do the following:

> 
> 
> 1. The IQ-9075 EVK comes with a MAC address. Skip this step if you choose to use the same MAC address.
> 
> 
> 
> > 
> > 
> > Alternatively, you can change the MAC address on the device.
> > 
> > 
> > ifconfig <Interface_name> hw ether <MAC Address>
> >         Copy to clipboard
> > 
> > 
> > For example:
> > 
> > 
> > ifconfig eth0 hw ether XX:XX:XX:YY:YY:YY
> >         Copy to clipboard
> > 
> > 
> > Sample output:
> > 
> > 
> > eth0    Link encap:Ethernet  **HWaddr XX:XX:XX:YY:YY:YY**
> >                 inet6 addr: fe80::34c9:27f8:b0b0:b036/64 Scope:Link
> >                 UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
> >                 RX packets:34 errors:0 dropped:0 overruns:0 frame:0
> >                 TX packets:453 errors:0 dropped:0 overruns:0 carrier:0
> >                 collisions:0 txqueuelen:1000
> >                 RX bytes:10176 (9.9 KiB)  TX bytes:74668 (72.9 KiB)
> >                 Interrupt:36
> >         Copy to clipboard
> 
> 
> 
> 
> 
> 2. When the device is connected to a public network, the DHCP server connected to the network assigns the IP address automatically. Skip this step if you choose to use the IP address assigned by the network.
> 
> 
> 
> > 
> > 
> > Alternatively, you can assign a static IP address.
> > 
> > 
> > ifconfig <Interface_name> <ip address>
> >         Copy to clipboard
> > 
> > 
> > For example:
> > 
> > 
> > ifconfig eth0 192.168.1.1
> >         Copy to clipboard
> > 
> > 
> > Sample output:
> > 
> > 
> > eth0    Link encap:Ethernet  HWaddr XX:XX:XX:YY:YY:YY
> >                 inet6 addr: fe80::34c9:27f8:b0b0:b036/64 Scope:Link
> >                 UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
> >                 RX packets:34 errors:0 dropped:0 overruns:0 frame:0
> >                 TX packets:453 errors:0 dropped:0 overruns:0 carrier:0
> >                 collisions:0 txqueuelen:1000
> >                 RX bytes:10176 (9.9 KiB)  TX bytes:74668 (72.9 KiB)
> >                 Interrupt:36
> >         Copy to clipboard
> 
> 
> 
> 
> 
> 3. Configure the MTU size for the data packets over the Ethernet interface.
> 
> 
> 
> > 
> > 
> > ifconfig <Interface_name> down
> >         
> >         ifconfig <Interface_name> mtu <mtu_size>
> >         
> >         ifconfig <Interface_name> up
> >         Copy to clipboard
> > 
> > 
> > For example:
> > 
> > 
> > ifconfig eth0 down
> >         
> >         ifconfig eth0 mtu 1500
> >         
> >         ifconfig eth0 up
> >         Copy to clipboard
> > 
> > 
> > Sample output:
> > 
> > 
> > eth0    Link encap:Ethernet  HWaddr XX:XX:XX:YY:YY:YY
> >                 inet6 addr: fe80::34c9:27f8:b0b0:b036/64 Scope:Link
> >                 UP BROADCAST RUNNING MULTICAST  **MTU:1500**  Metric:1
> >                 RX packets:34 errors:0 dropped:0 overruns:0 frame:0
> >                 TX packets:453 errors:0 dropped:0 overruns:0 carrier:0
> >                 collisions:0 txqueuelen:1000
> >                 RX bytes:10176 (9.9 KiB)  TX bytes:74668 (72.9 KiB)
> >                 Interrupt:36
> >         Copy to clipboard

- *class* tabincludedirective

    - Note

Flash the corresponding [CDT](https://docs.qualcomm.com/bundle/publicresource/topics/RNO-250403001134/ReleaseNote.html#release-specific-information) on the device to ensure that the correct configuration is used for Ethernet bringup.

To bring up Ethernet functionality on IQ-8 Beta EVK, do the following:

> 
> 
> 1. The IQ-8 Beta EVK comes with a MAC address. Skip this step if you choose to use the same MAC address.
> 
> 
> 
> > 
> > 
> > Alternatively, you can modify the MAC address on the device.
> > 
> > 
> > ifconfig <Interface_name> hw ether <MAC Address>
> >         Copy to clipboard
> > 
> > 
> > For example:
> > 
> > 
> > ifconfig eth0 hw ether XX:XX:XX:YY:YY:YY
> >         Copy to clipboard
> > 
> > 
> > Sample output:
> > 
> > 
> > eth0    Link encap:Ethernet  **HWaddr XX:XX:XX:YY:YY:YY**
> >                 inet addr:192.168.1.1  Bcast:192.168.1.255  Mask:255.255.255.0
> >                 UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
> >                 RX packets:57 errors:0 dropped:0 overruns:0 frame:0
> >                 TX packets:192 errors:0 dropped:0 overruns:0 carrier:0
> >                 collisions:0 txqueuelen:1000
> >                 RX bytes:11403 (11.1 KiB)  TX bytes:31620 (30.8 KiB)
> >                 Interrupt:61
> >         Copy to clipboard
> 
> 
> 
> 
> 
> 2. When the device is connected to a public network, the DHCP server connected to the network assigns the IP address automatically. Skip this step if you choose to use the IP address assigned by the network.
> 
> 
> 
> > 
> > 
> > Alternatively, you can assign a static IP address.
> > 
> > 
> > ifconfig <Interface_name> <ip address>
> >         Copy to clipboard
> > 
> > 
> > For example:
> > 
> > 
> > ifconfig eth0 192.168.1.1
> >         Copy to clipboard
> > 
> > 
> > Sample output:
> > 
> > 
> > eth0    Link encap:Ethernet  HWaddr XX:XX:XX:YY:YY:YY
> >                 **inet addr:192.168.1.1**  Bcast:192.168.1.255  Mask:255.255.255.0
> >                 UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
> >                 RX packets:57 errors:0 dropped:0 overruns:0 frame:0
> >                 TX packets:192 errors:0 dropped:0 overruns:0 carrier:0
> >                 collisions:0 txqueuelen:1000
> >                 RX bytes:11403 (11.1 KiB)  TX bytes:31620 (30.8 KiB)
> >                 Interrupt:61
> >         Copy to clipboard
> 
> 
> 
> 
> 
> 3. Configure the MTU size for the data packets over the Ethernet interface.
> 
> 
> 
> > 
> > 
> > ifconfig <Interface_name> down
> >         
> >         ifconfig <Interface_name> mtu <mtu_size>
> >         
> >         ifconfig <Interface_name> up
> >         Copy to clipboard
> > 
> > 
> > For example:
> > 
> > 
> > ifconfig eth0 down
> >         
> >         ifconfig eth0 mtu 1500
> >         
> >         ifconfig eth0 up
> >         Copy to clipboard
> > 
> > 
> > Sample output:
> > 
> > 
> > eth0    Link encap:Ethernet  HWaddr XX:XX:XX:YY:YY:YY
> >                 inet addr:192.168.1.1  Bcast:192.168.1.255  Mask:255.255.255.0
> >                 UP BROADCAST RUNNING MULTICAST  **MTU:1500**  Metric:1
> >                 RX packets:57 errors:0 dropped:0 overruns:0 frame:0
> >                 TX packets:192 errors:0 dropped:0 overruns:0 carrier:0
> >                 collisions:0 txqueuelen:1000
> >                 RX bytes:11403 (11.1 KiB)  TX bytes:31620 (30.8 KiB)
> >                 Interrupt:61
> >         Copy to clipboard

Last Published: Apr 10, 2025

[Previous Topic
Tools for Ethernet operations](https://docs.qualcomm.com/bundle/publicresource/80-70018-26/topics/tools-for-ethernet-operations.md) [Next Topic
Configure Ethernet features](https://docs.qualcomm.com/bundle/publicresource/80-70018-26/topics/configure-ethernet-features.md)