# Getting started

Source: [https://docs.qualcomm.com/doc/80-70015-26/topic/get_started.html](https://docs.qualcomm.com/doc/80-70015-26/topic/get_started.html)

<?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-70015-254)* for
                common infrastructure setup and build workflows.

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

## Set up SSH connection

Source: [https://docs.qualcomm.com/doc/80-70015-26/topic/get_started.html](https://docs.qualcomm.com/doc/80-70015-26/topic/get_started.html)

### About this task

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

### Procedure

1. To enable SSH, perform the steps mentioned in [Use SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-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.222Copy to clipboard
3. To connect to the SSH shell, enter the following password:
                
oelinux123Copy to clipboard

## Verify preconfigured MAC address

Source: [https://docs.qualcomm.com/doc/80-70015-26/topic/get_started.html](https://docs.qualcomm.com/doc/80-70015-26/topic/get_started.html)

### About this task

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:

### Procedure

1. To verify the configuration of the interface, run the following command.
                
ifconfigCopy to clipboard

A sample output is as follows:

        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

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.iniCopy to clipboard

A sample output is as follows:

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

## Retain and store MAC address

Source: [https://docs.qualcomm.com/doc/80-70015-26/topic/get_started.html](https://docs.qualcomm.com/doc/80-70015-26/topic/get_started.html)

### About this task

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:

### Procedure

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: Oct 14, 2024

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