Qualcomm Technologies, Inc.

DragonBoard™ 410c based on Qualcomm®

Snapdragon™ 410E processor
Setting Wi-Fi MAC Address on DragonBoardTM 410c
Application Note
LM80-P0436-44 Rev B
September 2016

© 2015-2016 Qualcomm Technologies, Inc. All rights reserved.

Qualcomm Snapdragon is a product of Qualcomm Technologies, Inc. Other Qualcomm products referenced herein are products of Qualcomm
Technologies, Inc. or its other subsidiaries.

DragonBoard, Qualcomm and Snapdragon are trademarks of Qualcomm Incorporated, registered in the United States and other countries.
Other product and brand names may be trademarks or registered trademarks of their respective owners.

This technical data may be subject to U.S. and international export, re-export, or transfer (“export”) laws. Diversion contrary to U.S. and
international law is strictly prohibited.

Use of this document is subject to the license set forth in Exhibit 1.

Questions or comments: https://www.96boards.org/DragonBoard410c/forum

Qualcomm Technologies, Inc.

5775 Morehouse Drive
San Diego, CA 92121
U.S.A.

LM80-P0436-44 RevB
 Revision history
Revision Date Description
B September 2016 Update to ‘E’ part
A November 13, 2015 Initial release

LM80-P0436-44 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 2
 Contents

1 Introduction ........................................................................................................................... 4
1.1 Purpose .....................................................................................................................................................4
1.2 Acronyms, abbreviations, and terms ..........................................................................................................4
1.3 Additional information ................................................................................................................................ 4

2 Wi-Fi MAC Address Programming ....................................................................................... 5

2.1 Setting the Wi-Fi MAC address on DragonBoard 410c ..............................................................................5
2.1.1 Android ..................................................................................................................................... 5
2.1.2 Linux ......................................................................................................................................... 6

EXHIBIT 1.................................................................................................................................. 8

Tables
Table 1-1 Acronyms, abbreviations, and terms ..............................................................................................................4

LM80-P0436-44 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 3
 1 Introduction

1.1 Purpose
All internet connected devices have a globally unique address used for Media Access Control.
This “MAC” address, sometimes referred to as the physical address, serves as your device’s
unique identity when accessing a network. The MAC address can be used for internet packet
routing, this allows messages to be moved through the network to a specific device. If multiple
devices share the same MAC address, packets may be directed to the wrong device.
Just like a serial number, DragonBoard™ 410c devices are also given a unique MAC address
during production. This 12-digit address is printed on a sticker, and can be found below the
analog expansion header on the reverse side of your board.
This document shows users how to program a unique MAC address into a DragonBoard 410c
board. If at any point the board’s flash memory is rewritten (changing between operating systems,
etc.) the MAC address will once again need to be reprogrammed.

1.2 Acronyms, abbreviations, and terms

Table 1-1 provides definitions for the acronyms, abbreviations, and terms used in this document.

Table 1-1 Acronyms, abbreviations, and terms

Term Definition
MAC Media Access Control
OTA Over The Air
WLAN Wireless Local Area Network

1.3 Additional information

For additional information, go to http://www.96boards.org/db410c-getting-started/.

LM80-P0436-44 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 4
 2 Wi-Fi MAC Address Programming

This Wi-Fi MAC address programming section describes how to write the MAC address to the
DragonBoard 410c device manually in order to have a unique MAC address.

2.1 Setting the Wi-Fi MAC address on DragonBoard 410c

2.1.1 Android
Each board needs a unique MAC address so the network can talk to a specific board. You need to
set the MAC address for your board. You can find the MAC address on a sticker on the back of
the board. The MAC address will be 12 characters long, where the characters are from 0-9 and A-
F. There may be colon ':' characters between pairs of characters.
To set the Wi-Fi MAC address:
1. On the board, turn off Wi-Fi.
2. Connect the host computer to the DragonBoard 410c board and run the following commands:
adb devices
adb root
adb remount
adb pull /data/misc/wifi/WCNSS_qcom_cfg.ini

3. With a local editor, edit the file WCNSS_qcom_cfg.ini and change the MAC address:
# Each byte of MAC address is represented in Hex format as XX
Intf0MacAddress=8CFDF00123EA
Intf1MacAddress=8CFDF00123E9
Intf2MacAddress=8CFDF00123E8
Intf3MacAddress=8CFDF00123E7

NOTE: The Intf0MacAddress should match the address printed on your board (all uppercase letters,
with the colons removed). The last character of the remaining addresses should each be one letter
or digit smaller that the preceding one.

4. Write the MAC address back to the board and reboot:

adb push WCNSS_qcom_cfg.ini /data/misc/wifi/
adb reboot
5. Use one of the following methods to confirm the MAC address has been changed (you have
the option to check via the DragonBoard 410c connected display or through your host
computer command line).

LM80-P0436-44 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 5
Setting Wi-Fi MAC Address on DragonBoardTM 410c Application Note Wi-Fi MAC Address Programming

 Option 1. On the board, look at the Wi-Fi advanced settings and ensure that your MAC
address is correct (as seen on the sticker).

 Option 2. This method allows you to continue working in the shell (through the host
computer) without needing to hook up a display or mouse to confirm the changed MAC
address.
i Ensure the DragonBoard 410c device Wi-Fi is connected.
ii From Android shell run: netcfg.
netcfg provides information on the current status of a specific WLAN/Ethernet
interface. The output will include information such as:
$ wlan0 UP [IP] [NETMASK] [MAC], etc.

NOTE: If you are unable to follow this procedure, re-image your DragonBoard 410c device and repeat
this section.

2.1.2 Linux
If you are running Linux based Ubuntu release 15.07 or newer, your board should already be
equipped with a unique MAC address. Therefore, you should not experience a random MAC
address issue, as with prior releases. Instructions below are only relevant for those who wish to
use the DragonBoard 410c assigned MAC address. You can find the DragonBoard 410c MAC
address on a sticker on the back of your board. The MAC address will be 12 characters long,

LM80-P0436-44 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 6
Setting Wi-Fi MAC Address on DragonBoardTM 410c Application Note Wi-Fi MAC Address Programming

where the characters are from 0-9 and A-F. There may be colon ':' characters between pairs of
characters.
To set the Wi-Fi MAC address:
1. From a command prompt, run the following command (MAC address is in lowercase):
sudo su
echo "8d:fd:f0:01:22:d7" > /lib/firmware/wlan/macaddr0
Run the ‘echo’ command once, using the MAC address from the sticker on the DragonBoard
410c device.
2. Reboot the device.
3. Validate the MAC address across reboots by entering the following command:
root@linaro-developer:~$ ifconfig wlan0
Observe the print out and confirm the MAC address.
wlan0 Link encap:Ethernet WHaddr 8d:fd:f0:01:22:d7
inet addr:A:B:C:D Bcast:E:F:G:H Mask:I:J:K:H
inet6 addr: fe00::8efd:f0ff:fe01:7a5b/64 Scope:Link
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:22 errors:0 dropped:0 overruns:0 frame:0
TX packets:22 errors:0 dropped:0 overruns:0 carrier:0
Collisions:0 txqueuelen:1000
RX bytes:8264 (8.2 KB) TX bytes:8145 (8.1 KB)

NOTE: If you are unable to follow this procedure, re-image your DragonBoard 410c device and repeat
this section.

For Linux based Ubuntu 15.07 and newer, if this procedure is not followed, onboard software
will generate a MAC address for you. This MAC address is expected to be unique and should not
cause any issues.
For Linux based Ubuntu older than 15.07, if this procedure is not followed, onboard software
will recognize that the MAC address has not yet been set. A temporary MAC address will be
generated, which is not guaranteed to be globally unique. The use of this address may cause
unexpected behaviors when accessing a network

LM80-P0436-44 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 7
 EXHIBIT 1

PLEASE READ THIS LICENSE AGREEMENT (“AGREEMENT”) CAREFULLY. THIS AGREEMENT IS A BINDING LEGAL
AGREEMENT ENTERED INTO BY AND BETWEEN YOU (OR IF YOU ARE ENTERING INTO THIS AGREEMENT ON BEHALF
OF AN ENTITY, THEN THE ENTITY THAT YOU REPRESENT) AND QUALCOMM TECHNOLOGIES, INC. (“QTI” “WE”
“OUR” OR “US”). THIS IS THE AGREEMENT THAT APPLIES TO YOUR USE OF THE DESIGNATED AND/OR ATTACHED
DOCUMENTATION AND ANY UPDATES OR IMPROVEMENTS THEREOF (COLLECTIVELY, “MATERIALS”). BY USING OR
COMPLETING THE INSTALLATION OF THE MATERIALS, YOU ARE ACCEPTING THIS AGREEMENT AND YOU AGREE
TO BE BOUND BY ITS TERMS AND CONDITIONS. IF YOU DO NOT AGREE TO THESE TERMS, QTI IS UNWILLING TO
AND DOES NOT LICENSE THE MATERIALS TO YOU. IF YOU DO NOT AGREE TO THESE TERMS YOU MUST
DISCONTINUE AND YOU MAY NOT USE THE MATERIALS OR RETAIN ANY COPIES OF THE MATERIALS. ANY USE OR
POSSESSION OF THE MATERIALS BY YOU IS SUBJECT TO THE TERMS AND CONDITIONS SET FORTH IN THIS
AGREEMENT.
1.1 License. Subject to the terms and conditions of this Agreement, including, without limitation, the restrictions, conditions,
limitations and exclusions set forth in this Agreement, Qualcomm Technologies, Inc. (“QTI”) hereby grants to you a nonexclusive, limited
license under QTI’s copyrights to use the attached Materials; and to reproduce and redistribute a reasonable number of copies of the Materials.
You may not use Qualcomm Technologies or its affiliates or subsidiaries name, logo or trademarks; and copyright, trademark, patent and any
other notices that appear on the Materials may not be removed or obscured. QTI shall be free to use suggestions, feedback or other information
received from You, without obligation of any kind to You. QTI may immediately terminate this Agreement upon your breach. Upon termination
of this Agreement, Sections 1.2-4 shall survive.
1.2 Indemnification. You agree to indemnify and hold harmless QTI and its officers, directors, employees and successors and
assigns against any and all third party claims, demands, causes of action, losses, liabilities, damages, costs and expenses, incurred by QTI
(including but not limited to costs of defense, investigation and reasonable attorney’s fees) arising out of, resulting from or related to: (i) any
breach of this Agreement by You; and (ii) your acts, omissions, products and services. If requested by QTI, You agree to defend QTI in
connection with any third party claims, demands, or causes of action resulting from, arising out of or in connection with any of the foregoing.
1.3 Ownership. QTI (or its licensors) shall retain title and all ownership rights in and to the Materials and all copies thereof, and
nothing herein shall be deemed to grant any right to You under any of QTI's or its affiliates’ patents. You shall not subject the Materials to any
third party license terms (e.g., open source license terms). You shall not use the Materials for the purpose of identifying or providing evidence to
support any potential patent infringement claim against QTI, its affiliates, or any of QTI’s or QTI’s affiliates’ suppliers and/or direct or indirect
customers. QTI hereby reserves all rights not expressly granted herein.
1.4 WARRANTY DISCLAIMER. YOU EXPRESSLY ACKNOWLEDGE AND AGREE THAT THE USE OF THE
MATERIALS IS AT YOUR SOLE RISK. THE MATERIALS AND TECHNICAL SUPPORT, IF ANY, ARE PROVIDED "AS IS" AND
WITHOUT WARRANTY OF ANY KIND, WHETHER EXPRESS OR IMPLIED. QTI ITS LICENSORS AND AFFILIATES MAKE NO
WARRANTIES, EXPRESS OR IMPLIED, WITH RESPECT TO THE MATERIALS OR ANY OTHER INFORMATION OR
DOCUMENTATION PROVIDED UNDER THIS AGREEMENT, INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE OR AGAINST INFRINGEMENT, OR ANY EXPRESS OR
IMPLIED WARRANTY ARISING OUT OF TRADE USAGE OR OUT OF A COURSE OF DEALING OR COURSE OF PERFORMANCE.
NOTHING CONTAINED IN THIS AGREEMENT SHALL BE CONSTRUED AS (I) A WARRANTY OR REPRESENTATION BY QTI, ITS
LICENSORS OR AFFILIATES AS TO THE VALIDITY OR SCOPE OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL
PROPERTY RIGHT OR (II) A WARRANTY OR REPRESENTATION BY QTI THAT ANY MANUFACTURE OR USE WILL BE FREE
FROM INFRINGEMENT OF PATENTS, COPYRIGHTS OR OTHER INTELLECTUAL PROPERTY RIGHTS OF OTHERS, AND IT
SHALL BE THE SOLE RESPONSIBILITY OF YOU TO MAKE SUCH DETERMINATION AS IS NECESSARY WITH RESPECT TO THE
ACQUISITION OF LICENSES UNDER PATENTS AND OTHER INTELLECTUAL PROPERTY OF THIRD PARTIES.
1.5 LIMITATION OF LIABILITY. IN NO EVENT SHALL QTI, QTI’S AFFILIATES OR ITS LICENSORS BE LIABLE TO
YOU FOR ANY INCIDENTAL, CONSEQUENTIAL OR SPECIAL DAMAGES, INCLUDING BUT NOT LIMITED TO ANY LOST
PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL DAMAGES, ARISING OUT OF THE USE OR INABILITY TO USE, OR THE
DELIVERY OR FAILURE TO DELIVER, ANY OF THE MATERIALS, OR ANY BREACH OF ANY OBLIGATION UNDER THIS
AGREEMENT, EVEN IF QTI HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE FOREGOING LIMITATION OF
LIABILITY SHALL REMAIN IN FULL FORCE AND EFFECT REGARDLESS OF WHETHER YOUR REMEDIES HEREUNDER ARE
DETERMINED TO HAVE FAILED OF THEIR ESSENTIAL PURPOSE. THE ENTIRE LIABILITY OF QTI, QTI’s AFFILIATES AND ITS
LICENSORS, AND THE SOLE AND EXCLUSIVE REMEDY OF YOU, FOR ANY CLAIM OR CAUSE OF ACTION ARISING
HEREUNDER (WHETHER IN CONTRACT, TORT, OR OTHERWISE) SHALL NOT EXCEED US$10.
2. COMPLIANCE WITH LAWS; APPLICABLE LAW. You agree to comply with all applicable local, international and national laws
and regulations and with U.S. Export Administration Regulations, as they apply to the subject matter of this Agreement. This Agreement is
governed by the laws of the State of California, excluding California’s choice of law rules.
3. CONTRACTING PARTIES. If the Materials are downloaded on any computer owned by a corporation or other legal entity, then this
Agreement is formed by and between QTI and such entity. The individual accepting the terms of this Agreement represents and warrants to QTI
that they have the authority to bind such entity to the terms and conditions of this Agreement.
4. MISCELLANEOUS PROVISIONS. This Agreement, together with all exhibits attached hereto, which are incorporated herein by this
reference, constitutes the entire agreement between QTI and You and supersedes all prior negotiations, representations and agreements between
the parties with respect to the subject matter hereof. No addition or modification of this Agreement shall be effective unless made in writing and
signed by the respective representatives of QTI and You. The restrictions, limitations, exclusions and conditions set forth in this Agreement shall
apply even if QTI or any of its affiliates becomes aware of or fails to act in a manner to address any violation or failure to comply therewith. You
hereby acknowledge and agree that the restrictions, limitations, conditions and exclusions imposed in this Agreement on the rights granted in this
Agreement are not a derogation of the benefits of such rights. You further acknowledges that, in the absence of such restrictions, limitations,
conditions and exclusions, QTI would not have entered into this Agreement with You. Each party shall be responsible for and shall bear its own
expenses in connection with this Agreement. If any of the provisions of this Agreement are determined to be invalid, illegal, or otherwise
unenforceable, the remaining provisions shall remain in full force and effect. This Agreement is entered into solely in the English language, and
if for any reason any other language version is prepared by any party, it shall be solely for convenience and the English version shall govern and
control all aspects. If You are located in the province of Quebec, Canada, the following applies: The Parties hereby confirm they have requested
this Agreement and all related documents be prepared in English.

LM80-P0436-44 Rev B MAY CONTAIN U.S. AND INTERNATIONAL EXPORT CONTROLLED INFORMATION 8