# Getting started

<?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 eth-dev-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="9.67187in" height="3.16753in" viewbox="0 0 696.375 228.062" xml:space="preserve" color-interpolation-filters="sRGB" class="st12"><style>.svg-1 .st1 { fill: #ffffff; stroke: none; stroke-linecap: round; stroke-linejoin: round; stroke-width: 0.75 }
.svg-1 .st2 { stroke: #000000; stroke-dasharray: 7, 5; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1 }
.svg-1 .st3 { fill: #3253dc; stroke: #3253dc; 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 { font-size: 1em }
.svg-1 .st6 { marker-end: url("#mrkr4-22"); 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: #82cbd7; stroke: #82cbd7; stroke-linecap: round; stroke-linejoin: round; stroke-width: 0.75 }
.svg-1 .st9 { fill: #000000; font-family: Arial; font-size: 1.00001em }
.svg-1 .st10 { fill: none; stroke: none; stroke-linecap: round; stroke-linejoin: round; stroke-width: 0.75 }
.svg-1 .st11 { fill: #000000; font-family: Arial; font-size: 1.33333em }
.svg-1 .st12 { 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-22" 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>Page-1</title>	<g id="shape1009-1" transform="translate(-0.4375,0)">		<title>Sheet.1009</title>		<rect x="0" y="-1.43752" width="697.5" height="229.5" class="st1"></rect>	</g>	<g id="shape1-3" transform="translate(25.875,-148.875)">		<title>Sheet.1</title>		<path d="M0 228.06 L640.12 228.06" class="st2"></path>	</g>	<g id="shape2-6" transform="translate(131.33,-167.813)">		<title>Sheet.2</title>		<desc>Set up SSH connection</desc>		<rect x="0" y="186.188" width="92.25" height="41.875" class="st3"></rect>		<text x="14.77" y="203.53" class="st4">Set up SSH <tspan x="17.1" dy="1.2em" class="st5">connection</tspan></text>		</g>	<g id="shape3-10" transform="translate(268.375,-167.813)">		<title>Sheet.3</title>		<desc>Verify MAC address</desc>		<rect x="0" y="186.188" width="92.25" height="41.875" class="st3"></rect>		<text x="15.79" y="203.53" class="st4">Verify MAC <tspan x="24.78" dy="1.2em" class="st5">address</tspan></text>		</g>	<g id="shape4-14" transform="translate(552.625,-166.875)">		<title>Sheet.4</title>		<desc>Bring up Ethernet</desc>		<rect x="0" y="186.188" width="108" height="41.875" class="st3"></rect>		<text x="7.3" y="210.73" class="st4">Bring up Ethernet</text>		</g>	<g id="shape5-17" transform="translate(224.775,-189.039) rotate(0.111778)">		<title>Sheet.5</title>		<path d="M0 228.06 L37 228.06" class="st6"></path>	</g>	<g id="shape6-23" transform="translate(360.625,-189.375)">		<title>Sheet.6</title>		<path d="M0 228.06 L184.96 228.06" class="st6"></path>	</g>	<g id="shape7-28" transform="translate(389.875,-88.75)">		<title>Sheet.7</title>		<desc>Bring up alternate hardware enablement</desc>		<rect x="0" y="186.188" width="133.5" height="41.875" class="st8"></rect>		<text x="19.39" y="203.53" class="st9">Bring up alternate <tspan x="8.71" dy="1.2em" class="st5">hardware enablement</tspan></text>		</g>	<g id="shape8-32" transform="translate(263.875,-88.9375)">		<title>Sheet.8</title>		<desc>Retain and store MAC address</desc>		<rect x="0" y="186.188" width="99" height="41.875" class="st8"></rect>		<text x="5.47" y="203.53" class="st9">Retain and store <tspan x="13.15" dy="1.2em" class="st5">MAC address</tspan></text>		</g>	<g id="shape10-36" transform="translate(552.475,-88.75)">		<title>Sheet.10</title>		<desc>Configure Ethernet features</desc>		<rect x="0" y="186.188" width="108" height="41.875" class="st8"></rect>		<text x="27.98" y="203.53" class="st9">Configure <tspan x="7.97" dy="1.2em" class="st5">Ethernet features</tspan></text>		</g>	<g id="shape18-40" transform="translate(18.375,-109.813)">		<title>Sheet.18</title>		<desc>Explore more</desc>		<rect x="0" y="196.562" width="108" height="31.5" class="st10"></rect>		<text x="6.43" y="217.11" class="st11">Explore more</text>		</g>	<g id="shape20-43" transform="translate(18.625,-155.25)">		<title>Sheet.20</title>		<desc>Get started</desc>		<rect x="0" y="196.562" width="92.25" height="31.5" class="st10"></rect>		<text x="6.55" y="217.11" class="st11">Get started</text>		</g>	<g id="shape1000-46" transform="translate(552.475,-18.375)">		<title>Sheet.1000</title>		<desc>Log and debug issues</desc>		<rect x="0" y="186.188" width="108" height="41.875" class="st8"></rect>		<text x="13.96" y="203.53" class="st9">Log and debug <tspan x="36.99" dy="1.2em" class="st5">issues</tspan></text>		</g>	<g id="shape1005-50" transform="translate(541.437,60.6352) rotate(90.0968)">		<title>Sheet.1005</title>		<path d="M0 228.06 L29.96 228.06" class="st6"></path>	</g>	<g id="shape1006-55" transform="translate(834.437,61.6855) rotate(90.0498)">		<title>Sheet.1006</title>		<path d="M0 228.06 L28.96 228.06" class="st6"></path>	</g>	<g id="shape1007-60" transform="translate(834.537,140) rotate(90)">		<title>Sheet.1007</title>		<path d="M0 228.06 L20.8 228.06" class="st6"></path>	</g>	<g id="shape1008-65" transform="translate(523.375,-110.125)">		<title>Sheet.1008</title>		<path d="M0 228.06 L22.06 228.06" class="st6"></path>	</g></g>
</svg>

Before you begin, see [*Qualcomm Linux Build Guide*](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254)
for common infrastructure setup and build workflows.

For more information on Ethernet interfaces on QCS6490/QCS5430, see
[Ethernet on RB3 Gen 2 Development Kit](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-251/rb3_gen2_ethernet.html).

## Set up SSH connection

To enable SSH and connect to the device, do the following:

1. To enable SSH, perform the steps mentioned in [Log in using SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70017-254/how_to.html#use-ssh).
2. To connect to the device, run the following command.

ssh root@<device_IP_address>
        Copy to clipboard

    For example, if the IP address of the device is `10.92.160.222`, then
run the following command.

ssh root@10.92.160.222
        Copy to clipboard
3. To connect to the SSH shell, enter the following password.

oelinux123
        Copy to clipboard

## Verify preconfigured MAC address

Note

Persistent storage of MAC address is supported on QCS6490/QCS5430 but not supported on QCS9075.

QPS615 is a PCIe switch on RB3 Gen 2 Development Kit. It does not 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. To verify the configuration of the interface, run the following
command.

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

    The MAC address is stored in the `config.ini` file and is available at
`/var/persist` of the device.
2. To verify whether the `config.ini` file is available on the device, run
the following command.

ls /var/persist/
        Copy to clipboard
3. To verify the content of the `config.ini` file, run the following
command.

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

## Retain and store MAC address

Note

Retaining and storing MAC address is supported on QCS6490/QCS5430 but not supported on QCS9075.

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. To back up the file to a local path, run the following command.

scp  root@<device_ip_address>:/var/persist/config.ini .
        Copy to clipboard
2. To restore the backed-up file after upgrading the software build, run
the following command.

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

Last Published: Dec 24, 2024

[Previous Topic
Overview](https://docs.qualcomm.com/bundle/publicresource/80-70017-26/topics/overview.md) [Next Topic
Features](https://docs.qualcomm.com/bundle/publicresource/80-70017-26/topics/features.md)