# Getting started

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

### Developer workflow

<?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: 0.75 }
.svg-1 .st7 { fill: #000000; fill-opacity: 1; stroke: #000000; stroke-opacity: 1; stroke-width: 0.22935779816514 }
.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="-8.72" orient="auto" markerunits="strokeWidth" overflow="visible">		<use xlink:href="#lend4" transform="scale(-4.36,-4.36) "></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" rx="9" ry="9" 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" rx="9" ry="9" 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" rx="9" ry="9" 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.5 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 L185.46 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" rx="9" ry="9" 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" rx="9" ry="9" 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" rx="9" ry="9" 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" rx="9" ry="9" 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 L30.46 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 L29.46 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 L21.3 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.56 228.06" class="st6"></path>	</g></g>
</svg>

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

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

## Set up SSH connection

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

### About this task

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

### Procedure

1. Enable SSH in Permissive mode by performing the steps mentioned in [How to SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70014-254/how_to.html#how-to-ssh-).
2. Connect to the device by running 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, run the
                        following command:

        ssh root@10.92.160.222Copy to clipboard
3. Connect to the SSH shell by entering the following password:
                
oelinux123Copy to clipboard

## Verify preconfigured MAC address

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

### About this task

QPS615 is a PCIe switch on RB3 Gen 2 device. 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. Verify the preconfigured MAC address by running the following command:
                
ifconfigCopy to clipboard

Sample output is as follows:

        ifconfig
        enP1p5s0f0 Link encap:Ethernet  HWaddr EC:21:E5:10:4F:EA
                  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 file is available on the device by running the following
                    command:
                
ls /var/persist/Copy to clipboard
3. Verify the content of the config.ini file by running the
                    following command:
                
cat /var/persist/config.iniCopy to clipboard

Sample output is as follows:

        #MAC ID configuration, For Test purpose only
        MDIOBUSID1: 1: MAC_ID01: EC:21:E5:10:4F:EACopy to clipboard

## Retain and store MAC address

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

### About this task

The MAC address configuration file in the persistent path
                    /var/persist/config.ini is retained whenever the device
                reboots. 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.

### Procedure

1. To retain the config.ini file, do the following:
    1. Back up the file to a local path by running the following
                            command:
                        
scp  root@<device_ip_address>:/var/persist/config.ini .Copy to clipboard
    2. After upgrading the software build, restore the backed-up file by
                            running 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 Secure
                        Copy Protocol (SCP).
2. 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: Jul 11, 2024

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