MRD5165 Eagle Kit
Programming Guide
MRD5165 Eagle Kit Programming Guide
Revision History
Revision Date Description
0.1 Nov 28, 2023 Preliminary version
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 2 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
TABLE OF CONTENTS
Privacy Information...................................................................................................................... 5
1. Introduction ......................................................................................................................... 6
2. Eagle Kit Overview ................................................................................................................ 6
3. Getting Started ..................................................................................................................... 6
4. Eagle-Kit Programming Accessories ....................................................................................... 6
5. Eagle Kit Setup...................................................................................................................... 7
6. Setting up Eagle Kit in QDL/EDL Mode ................................................................................... 9
7. Windows HOST PC Setup .................................................................................................... 11
8. Windows Host PC QFIL Configuration and Programming ...................................................... 12
9. Ubuntu Host PC Programming ............................................................................................. 19
10. Eagle Kit Boot and Login Verify ............................................................................................ 22
11. Fastboot Programming........................................................................................................ 23
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 3 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
TABLE OF FIGURES
Figure 1 MRD5165 Eagle Kit .................................................................................................. 7
Figure 2 MRD5165 Eagle Kit connection to PC ........................................................... 8
Figure 3 MRD5165 Eagle Kit FORCE-USB SW5 Press .............................................. 9
Figure 4 MRD5165 Eagle Kit SW5 Hold, Type-C connected and Power Up
.............................................................................................................................................................. 10
Figure 5 Flatbuild Package unzip/extract ................................................................... 12
Figure 6 Flat build Package Folder Files....................................................................... 12
Figure 7 QFIL tool Select Port ............................................................................................ 13
Figure 8 Eagle Kit QDL COM port selection ................................................................. 13
Figure 9 Select Build Type to “Flat Build” ................................................................... 14
Figure 10 Select “FireHose Configuration” ............................................................... 14
Figure 11 Firehose programmer setting configuration ....................................... 15
Figure 12 RawProgram and Patch configuration .................................................... 16
Figure 13 Serial Console Programming logs.............................................................. 17
Figure 14 QFIL Flash Download In-Progress ............................................................ 18
Figure 15 QFIL Flash Download Succeed .................................................................... 18
Figure 16 Ubuntu Host PC Flatbuild Package zip file extraction ................... 19
Figure 17 Ubuntu Host PC Eagle Kit QDL mode check ......................................... 20
Figure 18 Ubuntu Host PC Serial Console Logs ........................................................ 20
Figure 19 Ubuntu Host PC Programming command execution ...................... 21
Figure 20 Ubuntu Host PC Program Successfully ................................................... 21
Figure 21 Ubuntu Host PC Eagle Kit Initial Boot Logs ......................................... 22
Figure 22 Ubuntu Host PC Eagle Kit Complete Boot and Login Prompt .... 22
Figure 23 Eagle-Kit fastboot mode set using adb commands ......................... 23
Figure 24 Eagle-Kit fastboot mode set using Vol- Key press .......................... 24
Figure 25 Eagle-Kit fastboot mode set using Vol- Key press and power
up ......................................................................................................................................................... 25
Figure 26 Eagle-Kit fastboot mode flash example ................................................. 26
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 4 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
Privacy Information
Mistral Solution Private Limited. and/or its affiliated companies – May Contain Trade Secrets and
information sensitive to restricted audience.
The content of this document is intended solely for the use of the individual or entity to whom it is
addressed and may contain privileged or confidential information. If you are not the intended
recipient, you are hereby notified that any dissemination, distribution, copying, or unauthorized use
of the information contained herein is strictly prohibited.
By accessing or reviewing this document, you agree to the following.
⚫ To treat its contents with the utmost confidentiality and to take all necessary precautions to
prevent unauthorized disclosure. Any unauthorized use, disclosure, or distribution of the
information in this document may result in legal action and may be subject to applicable laws.
⚫ Not to engage in or support any activities that are illegal or harmful. Any misuse of this document
for purposes contrary to the law or public safety is strictly prohibited.
Mistral Solutions disclaims any responsibility for the consequences of unauthorized access or
disclosure of the information contained in this document. Further to this, Mistral solutions disclaims
any responsibility for the misuse or illegal distribution of this document. Individuals or entities found
to be using or distributing this document for unlawful or harmful activities may be subject to legal
action.
If you have received this document in error, please notify the sender immediately and delete the
original message and all copies from your system.
Confidential Distribution: Use or distribution of this item, in whole or in part, is prohibited except as
expressly permitted by written agreement(s) and/or terms with Mistral Solutions and/or its
subsidiaries.
Not to be used, copied, reproduced, or modified in whole or in part, nor its contents revealed in any
manner to others without the express written permission of Mistral Solution Private Limited.
For any further information/clarifications please contact
Mistral Solutions Private Limited,
#60 Adarsh Regent, 100 Ft. Ring Road,
Domlur Extension, Bengaluru 560071
Karnataka, India
© 2023–2024 Mistral Solutions Private Limited. and/or its subsidiaries. All rights reserved.
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 5 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
1. Introduction
This document provides the instructions to setting up the Eagle-Kit and procedure to program the Eagle
Kit board both on Windows and Ubuntu Host PC.
This document is intended for all users of Eagle-Kit.
2. Eagle Kit Overview
The Mistral MRD5165 Eagle Kit is based on Qualcomm’s QRB5165 processor. The MRD5165 Eagle kit
provides high-performance compute platform for precise artificial intelligence (AI) and machine-
learning inferencing technology to facilitate the accelerated development of innovative, power-
efficient, high-computing robots and drones for enterprise, industrial, and professional service
applications. It offers readily deployable SDKs, Ubuntu Root-FS and tools for product development to
facilitate quick prototyping and proof-of-concept evaluations. Additionally, this kit includes high
performance connectivity interfaces making it an ideal platform for connected Eagle device in IOT,
Drones and Robotics.
3. Getting Started
The Mistral MRD5165 Eagle Kit offers a versatile platform for product developers to evaluate system
functionality, experiment with sample applications, migrate existing applications, create new features,
and integrate with a variety of peripheral devices. This kit provides a Linux software environment for
application development, with the option to customize and update the system software using a chosen
release of the QRB5165 system software.
The Eagle Kit Programming Guide provides an overall description of the hardware setup and Host PC
steps to flash the Eagle Kit
4. Eagle-Kit Programming Accessories
Basic Accessories required for Eagle-Kit Programming:
1. DC Adapter
2. Power Chord
3. Custom power cable
4. USB Type-C Cable
5. USB Micro-B Cable
Note: USB Micro-B cable is not part of the kit accessories.
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 6 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
5. Eagle Kit Setup
Figure 1 MRD5165 Eagle Kit
1. Connect the DC adapter using Power cable to J1
2. Connect a USB Type-C cable to J103 (adb connection)
3. Connect a Micro-B cable to J5 (Debug console)
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 7 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
Figure 2 MRD5165 Eagle Kit connection to PC
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 8 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
6. Setting up Eagle Kit in QDL/EDL Mode
1. Disconnect the Type-C cable and Power cable from the Eagle Kit
2. Press and hold the Eagle Kit Main Board SW5 (SDM_FORCE_USB_BOOT) switch.
3. Connect the Power cable and Power up the Eagle Kit
4. Connect the Type-C cable between Host PC and Eagle Kit
5. Observe the Eagle Kit device presence on the QFIL tool.
QFIL Tool Device Detection entry check: Qualcomm HS-USB QDLoader 9008 (COMxx)
6. Connect the Micro-B cable between Eagle kit and Host PC for programming logs.
Figure 3 MRD5165 Eagle Kit FORCE-USB SW5 Press
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 9 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
Figure 4 MRD5165 Eagle Kit SW5 Hold, Type-C connected and Power Up
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 10 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
7. Windows HOST PC Setup
1. After purchasing the Eagle Kit, please register at the Mistral website to download the most
recent flat build Package.
2. Acquire the newest iteration of QDART that includes QFIL tool for the Windows OS from
Qualcomm CreatePoint. The link for this is provided below:
https://createpoint.qti.qualcomm.com/search/#tools/searchArgs/q||QDART||rows||20||so
rtField||releaseDate||sortOrder||desc
Note: QDART/QFIL is required if Windows is used as host machine for programming.
3. Download the Qualcomm USB driver from Qualcomm CreatePoint. The link for this is provided
below:
https://createpoint.qti.qualcomm.com/search/#tools/searchArgs/q||USB%20driver||rows||
20||sortField||releaseDate||sortOrder||desc
4. Windows Host PC adb and fastbo ot installation
Download platform tools for Windows from the link provided below.
https://developer.android.com/tools/releases/platform-tools
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 11 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
8. Windows Host PC QFIL Configuration and Programming
1. Extract the downloaded flat build zip package.
Figure 5 Flatbuild Package unzip/extract
2. Observe the extracted files as below:
Figure 6 Flat build Package Folder Files
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 12 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
3. Observe and Select the Eagle Kit EDL COM port for programming.
Figure 7 QFIL tool Select Port
Figure 8 Eagle Kit QDL COM port selection
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 13 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
4. Select Build Type to “Flat Build” In QFIL
Figure 9 Select Build Type to “Flat Build”
5. Set the QFIL tool Configuration as below: Select Configuration -> FireHose Configuration
Figure 10 Select “FireHose Configuration”
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 14 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
6. Set the Firehose programmer settings as below:
a. Download Protocol: 0 - Sahara
b. Device Type: ufs
c. Ensure “Provision” is unchecked.
d. Check the “Erase All Before Download” checkbox and click “OK”
Figure 11 Firehose programmer setting configuration
7. Select QFIL Programmer file and Flat Build package files
a. Set the “Programmer Path” to file “prog_firehose_ddr.elf” from the
extracted flatbuild package folder.
b. Select all the rawprogram and patch and load from the extracted flatbuild
package folder.
rawprogram_unsparse0.xml
rawprogram1.xml
rawprogram2.xml
rawprogram3.xml
rawprogram4.xml
rawprogram5.xml
patch0.xml
patch1.xml
patch2.xml
patch3.xml
patch4.xml
patch5.xml
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 15 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
Figure 12 RawProgram and Patch configuration
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 16 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
8. Observe the Programming logs over debug console too. Open Tera Term with
Serial console COM port and set baudrate to 115200.
Expected logs after flash is completed.
Figure 13 Serial Console Programming logs
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 17 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
9. Start Programming
a. Once all the above steps are done click the QFIL “Download” button
b. Observe the Download progress bar and status logs
Figure 14 QFIL Flash Download In-Progress
c. Upon successful completion observe “Download Succeed” and “Finish
Download” on status logs.
Figure 15 QFIL Flash Download Succeed
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 18 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
9. Ubuntu Host PC Programming
1. Follow the procedure “Setting up Eagle Kit in QDL/EDL Mode” to set the Eagle Kit in EDL
mode.
2. Extract the downloaded Flatbuild zip file $ unzip “flatbuild_package.zip”
3. Ubuntu Host PC adb and fastboot installation
Use the commands below to install adb and fastboot.
$ sudo apt-get update
$ sudo apt-get install android-tools-adb android-tools-
fastboot
Figure 16 Ubuntu Host PC Flatbuild Package zip file extraction
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 19 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
4. Verify the Eagle Kit device is in EDL mode
$ lsusb
Observe Qualcomm device entry mentioned with “(QDL mode)”
Figure 17 Ubuntu Host PC Eagle Kit QDL mode check
5. Observe the Programming logs over debug console too. Run the minicom command with
Serial console device node and set baud rate to 115200.
$ sudo minicom -D /dev/ttyUSB0 -b 115200
Expected logs after flash is completed.
Figure 18 Ubuntu Host PC Serial Console Logs
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 20 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
6. Start Programming: Run the below command.
$ sudo chmod +x ./ubuntu_flash_flat.sh
$ sudo ./ubuntu_flash_flat.sh -x
rawprogram_unsparse0.xml,rawprogram1.xml,rawprogram2.xml,rawprogram3.
xml,rawprogram4.xml,rawprogram5.xml,patch0.xml,patch1.xml,patch2.xml,
patch3.xml,patch4.xml,patch5.xml -i ./ -f prog_firehose_ddr.elf -s
ufs
Figure 19 Ubuntu Host PC Programming command execution
7. Once the flashing is completed, “All Finished Successfully” logs will appear on the
screen as shown below.
Figure 20 Ubuntu Host PC Program Successfully
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 21 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
10. Eagle Kit Boot and Login Verify
1. Power up the Eagle Kit normally
2. Observe the Boot logs over Serial Console/Micro-B connection.
Figure 21 Ubuntu Host PC Eagle Kit Initial Boot Logs
Serial Console Login: Username: root Password: oelinux123
Figure 22 Ubuntu Host PC Eagle Kit Complete Boot and Login Prompt
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 22 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
11. Fastboot Programming
1. Host PC setup
a. Windows Host PC adb and fastboot installation
Download platform tools for Windows from the link provided below.
https://developer.android.com/tools/releases/platform-tools
b. Ubuntu Host PC adb and fastboo-t installation
Use the commands below to install adb and fastboot.
$ sudo apt-get update
$ sudo apt-get install android-tools-adb android-tools-
fastboot
2. Eagle Kit fastboot mode set
a. Fastboot mode set using adb commands
• Connect the device over adb, verify the device presence in adb mode
$ adb devices
• Enter as a root user
$ adb root
• Enter into fastboot mode
$ adb reboot bootloader
• After few seconds, check the device presence in fastboot mode
$ fastboot devices
Figure 23 Eagle-Kit fastboot mode set using adb commands
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 23 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
b. Fastboot mode set using VOL- key
• Disconnect the Type-C and Power cable
• Press Vol- Key/SW3 switch
Figure 24 Eagle-Kit fastboot mode set using Vol- Key press
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 24 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
• Hold the VOL- key
• Connect the type-c cable to host pc
• Power up the Eagle Kit
Figure 25 Eagle-Kit fastboot mode set using Vol- Key press and
power up
• After few seconds, check the device presence in fastboot mode
$ fastboot devices
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 25 Confidential Mistral Solutions Pvt Ltd
MRD5165 Eagle Kit Programming Guide
3. Fastboot mode programming
Once the device is present in fastboot mode, run the following command for fastboot
programming/flashing.
$ fastboot flash <partition_name> <file_name>
Example: Boot image flash
$ fastboot flash boot_a qti-ubuntu-robotics-image-qrb5165-ifb-
boot.img
$ fastboot flash boot_b qti-ubuntu-robotics-image-qrb5165-ifb-
boot.img
Once flash is completed, reboot the device to boot the flashed images
$ fastboot reboot
Figure 26 Eagle-Kit fastboot mode flash example
MRD5165 Eagle Kit Programming Guide Revision 0.1
Page Number 26 Confidential Mistral Solutions Pvt Ltd
