This repository has been archived by the owner on Jul 31, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 285
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
dragonboard: add description of RB1 and RB2 platform kits
Signed-off-by: Vladimir Zapolskiy <[email protected]> Signed-off-by: Vladimir Zapolskiy <[email protected]>
- Loading branch information
Vladimir Zapolskiy
committed
Oct 3, 2023
1 parent
213198c
commit b8e66bc
Showing
25 changed files
with
740 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,39 @@ | ||
| --- | ||
| title: Using the Qualcomm Robotics RB1 Development kit | ||
| permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb1/ | ||
| --- | ||
| # Using the Qualcomm® Robotics RB1 Development Kit | ||
|
|
||
| ## Documentation | ||
|
|
||
| - [Quick Start Guide](https://developer.qualcomm.com/hardware/qualcomm-robotics-rb1-rb2-kits/quick-start-guides) | ||
| - Learn about your development board, how to prepare and set up for basic use | ||
| - [Hardware Documentation](https://developer.qualcomm.com/hardware/qualcomm-robotics-rb1-rb2-kits/hardware-reference-guide) | ||
| - Explore what makes your development board unique, technical specifications, schematics, hardware notes and more... | ||
|
|
||
| ## Software | ||
|
|
||
| ### With upstream Linux versions by Linaro | ||
|
|
||
| A comprehensive guide to using the [Qualcomm® Robotics RB1 Development Kit](https://www.qualcomm.com/products/internet-of-things/industrial/industrial-automation/qualcomm-robotics-rb1-platform) . This guide is written by the [96Boards](https://www.96boards.org) team at [Linaro](http://www.linaro.org) with community contributions and links to third-party content. | ||
|
|
||
| - [Downloads](downloads/) | ||
| - Already familiar with your 96Boards? Skip the board bring up sections and go straight to your download! | ||
| - [Installation](installation/) | ||
| - Choose and install an operating system on your development kit | ||
|
|
||
| ### With downstream version from Thundercomm | ||
|
|
||
| Developers can use the downstream version from Thundercomm to get started. Software and tools to download, build and flash the boot images and rootfs images can be found on Thundercomm's website. | ||
|
|
||
| - [Downloads from Thundercomm](https://www.thundercomm.com/product/qualcomm-robotics-rb1-platform/#sdk-manager) | ||
| - Download the SDK Manager tool from Thundercomm's website to build and flash the images on the development board. | ||
| - [Software Tools and Drivers from Qualcomm](https://developer.qualcomm.com/hardware/qualcomm-robotics-rb1-rb2-kits/quick-start-guide/software) | ||
| - Tools and software to support the development platform. | ||
|
|
||
| ## Support | ||
| - [Thundercomm Support](https://www.thundercomm.com/help/) | ||
| - [96boards Forums](https://discuss.96boards.org/c/products/qualcomm-rb1-rb2) | ||
| - The Qualcomm RB1 has its own 96Boards forum. If you can't find a pre-existing thread that addresses your issue, start your own and let the community help out! | ||
|
|
||
|
|
19 changes: 19 additions & 0 deletions
19
consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/README.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,19 @@ | ||
| --- | ||
| title: Additional Docs for Qualcomm® Robotics RB1 Platform | ||
| permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/ | ||
| --- | ||
| # Board Images | ||
|
|
||
| Each 96Boards development board must provide six images, 3 x High Definition and 3 x Standard Definition. These images should be sized and named accordingly. These images should be uploaded to this folder and made available to community for viewing and/or download. | ||
|
|
||
| #### 1500x974 - 300dpi | ||
| - BoardName_Front_HD | ||
| - BoardName_Back_HD | ||
| - BoardName_Angle_HD | ||
|
|
||
| #### 770x500 - 72dpi | ||
| - BoardName_Front_SD | ||
| - BoardName_Back_SD | ||
| - BoardName_Angle_SD | ||
|
|
||
| *** |
1 change: 1 addition & 0 deletions
1
consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/README.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
| [Images_Board](images-board/) |
13 changes: 13 additions & 0 deletions
13
...dragonboard/qualcomm-robotics-rb1/additional-docs/images/images-board/README.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,13 @@ | ||
| # Board Images | ||
|
|
||
| Each 96Boards development board must provide six images, 3 x High Definition and 3 x Standard Definition. These images should be sized and named accordingly. These images should be uploaded to this folder and made available to community for viewing and/or download. | ||
|
|
||
| #### 1500x974 - 300dpi | ||
| - BoardName_Front_HD | ||
| - BoardName_Back_HD | ||
| - BoardName_Angle_HD | ||
|
|
||
| #### 770x500 - 72dpi | ||
| - BoardName_Front_SD | ||
| - BoardName_Back_SD | ||
| - BoardName_Angle_SD |
Binary file added
BIN
+478 KB
...rd/qualcomm-robotics-rb1/additional-docs/images/images-board/sd/rb1-back-sd.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+455 KB
...d/qualcomm-robotics-rb1/additional-docs/images/images-board/sd/rb1-front-sd.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
26 changes: 26 additions & 0 deletions
26
consumer/dragonboard/qualcomm-robotics-rb1/downloads/README.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,26 @@ | ||
| --- | ||
| title: Downloads for Qualcomm Robotics RB1 development kit | ||
| permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb1/downloads/ | ||
| --- | ||
| ## Downloads | ||
|
|
||
| This page provides links to the latest software downloads to switch the Operating System, update the existing software images on your board, or unbrick your board. | ||
|
|
||
| *** | ||
|
|
||
| ### Linaro supported operating systems | ||
|
|
||
| - [Debian](debian.md) | ||
|
|
||
| *** | ||
|
|
||
| ### Third Party Operating Systems | ||
|
|
||
| Other operating systems supported on Qualcomm Robotics RB1 development kit, offered by partners. | ||
|
|
||
| - [QTI Linux from Thundercomm for RB1 platform](https://www.thundercomm.com/product/qualcomm-robotics-rb1-platform/#sdk-manager) | ||
| - Download the SDK Manager tool from Thundercomm's website to build and flash the images on an RB1 development board. | ||
|
|
||
| Continue to [Installation Page](../installation/) | ||
|
|
||
| *** |
25 changes: 25 additions & 0 deletions
25
consumer/dragonboard/qualcomm-robotics-rb1/downloads/debian.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,25 @@ | ||
| --- | ||
| title: Debian Downloads for Qualcomm Robotics RB1 | ||
| permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb1/downloads/debian.md.html | ||
| --- | ||
| # Debian | ||
|
|
||
| **Debian Linux** is a desktop/window or console (command line) based development environment comprised of some basic programs and utilities. Development can happen directly on the board, and within the OS. While applications and programs can be built directly on the board, they can also be built remotely and cross-compiled for the particular system. | ||
|
|
||
| *Note*: Debian images for the Qualcomm Robotics RB1 platform are currently under development, and can be tested using the links to daily builds below. | ||
|
|
||
| *** | ||
|
|
||
| ## Fastboot files | ||
|
|
||
| | Boot image | | ||
| |:---------------------------------------------------------------------------------------------------------------------------------------| | ||
| | [Download](https://snapshots.linaro.org/member-builds/qcomlt/debian/arm64/latest/boot-linaro-sid-arm64-qcom_qrb2210-rb1-*.img.gz) | | ||
| | [Release Notes](https://snapshots.linaro.org/member-builds/qcomlt/debian/arm64/latest/) | | ||
|
|
||
| | Rootfs image | | ||
| |:---------------------------------------------------------------------------------------------------------------------------------------| | ||
| | [Developer](https://snapshots.linaro.org/member-builds/qcomlt/debian/arm64/latest/linaro-sid-developer-arm64-*.img.gz) | | ||
| | [Release Notes](https://snapshots.linaro.org/member-builds/qcomlt/debian/arm64/latest/) | | ||
|
|
||
| #### Continue to [Installation page](../installation/) |
1 change: 1 addition & 0 deletions
1
consumer/dragonboard/qualcomm-robotics-rb1/downloads/files/README.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1 @@ | ||
|
|
39 changes: 39 additions & 0 deletions
39
consumer/dragonboard/qualcomm-robotics-rb1/installation/README.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,39 @@ | ||
| --- | ||
| title: Installation for Qualcomm Robotics RB1 development kit | ||
| permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb1/installation/ | ||
| --- | ||
| # Installation | ||
|
|
||
| This guide will help you choose and install an operating system and installation method on your Qualcomm Robotics RB1 development kit. | ||
|
|
||
| To appropriately follow this installation guide you will need to: | ||
|
|
||
| - Download necessary files | ||
| - Choose host machine | ||
| - Follow flashing instructions | ||
|
|
||
| *** | ||
|
|
||
| ### Fastboot Method | ||
|
|
||
| Fastboot is supported by the board and can be used for installs. | ||
|
|
||
| This method requires the following hardware: | ||
|
|
||
| - Qualcomm Robotics RB1 development kit with power supply | ||
| - Host machine (Linux, Mac OS X, or Windows) | ||
| - USB to USB Type C cable | ||
| - USB Mouse and/or keyboard (not required to perform flash) | ||
| - HDMI Monitor with full size HDMI cable (not required to perform flash) | ||
|
|
||
| Go to the [Downloads page](../downloads/) to get your boot image and root file system image (rootfs). | ||
|
|
||
| Choose host machine | ||
|
|
||
| - [Linux](linux-fastboot.md) | ||
|
|
||
| *** | ||
|
|
||
| ### Third Party OS | ||
|
|
||
| - [LE OS Installation](le.md) |
82 changes: 82 additions & 0 deletions
82
consumer/dragonboard/qualcomm-robotics-rb1/installation/le.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,82 @@ | ||
| --- | ||
| title: Linux Host Installation for Qualcomm Robotics RB1 development kit | ||
| permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb1/installation/le.md.html | ||
| --- | ||
| ## Linux Host | ||
|
|
||
| This section show how to install a new operating system to your Qualcomm Robotics RB1 development kit using the fastboot method on a Linux host computer. | ||
|
|
||
| *** | ||
|
|
||
| - **Step 1**: Make sure fastboot is set up on host computer | ||
| - **Step 2**: Connect host computer to Qualcomm Robotics RB1 dev kit | ||
| - **Step 3**: Boot RB1 into fastboot mode | ||
| - **Step 4**: Flash Images | ||
| - **Step 5**: Reboot the development kit | ||
|
|
||
| *** | ||
|
|
||
| #### **Step 1**: Make sure fastboot is set up on host computer. | ||
| ##### You can install fastboot from source or using your distro package manager. | ||
|
|
||
| - **From source:** | ||
| - Android SDK “Tools only” for Linux can be downloaded <a href="https://developer.android.com/studio/releases/platform-tools.html" target="_blank">here</a> | ||
| - The Linux “Tools Only” SDK download does not come with fastboot, you will need to use the Android SDK Manager to install platform-tools. | ||
| - To do this follow the “SDK Readme.txt” instructions included in your SDK “Tools Only” download. | ||
|
|
||
| If you are still having trouble setting up fastboot, <a href="https://youtu.be/W_zlydVBftA" target="_blank">click here</a> for a short tutorial video | ||
|
|
||
| - **Or using a distro package manager:** | ||
| ``` | ||
| # Red Hat flavour (Fedora, CentOS) | ||
| $ sudo yum install android-tools | ||
| # Debian (Ubuntu) | ||
| $ sudo apt-get install fastboot | ||
| ``` | ||
|
|
||
| #### **Step 2**: Connect host computer to Qualcomm Robotics RB1 development kit | ||
|
|
||
| - Development kit must be powered off (unplugged from power) | ||
| - Make sure microSD card slot on the development kit is empty | ||
| - Please check the Quick start guide to set the correct dip switches on the development kit. | ||
| - Connect USB to microUSB cable from host computer to the development kit. | ||
|
|
||
| #### **Step 3**: Boot Qualcomm Robotics RB1 dev kit into fastboot mode | ||
|
|
||
| **Please read all bullet points before attempting** | ||
|
|
||
| - Press and hold the Vol (-) button on the dev kit, this is the S4 button. Dev kit should still NOT be powered on | ||
| - While holding the Vol (-) button, power on the development kit by plugging it in | ||
| - Once the development kit is plugged into power, release your hold on the Vol (-) button. | ||
| - Wait for about 20 seconds. | ||
| - Board should boot into fastboot mode. | ||
|
|
||
| From the connected host machine terminal window, run the following commands: | ||
|
|
||
| ```shell | ||
| # Check to make sure device is connected and in fastboot mode | ||
|
|
||
| $ sudo fastboot devices | ||
| ``` | ||
|
|
||
| Typically it will show as below | ||
| ```shell | ||
| de82318 fastboot | ||
| ``` | ||
|
|
||
| **At this point you should be connected to your Qualcomm Robotics RB1 development kit with a USB to TypeC cable. Your development kit should be booted into fastboot mode and ready to be flashed with the appropriate images.** | ||
|
|
||
| #### **Step 4**: Flash Images | ||
|
|
||
| The LE build and recovery files can be downloaded by running [Thundercomm SDK Manager](https://www.thundercomm.com/product/qualcomm-robotics-rb1-platform/#sdk-manager). Follow the Thundercomm SDK Manager instructions to flash a full build for RB1 board recovery. | ||
|
|
||
| #### **Step 5**: Reboot the Qualcomm Robotics RB1 development kit | ||
|
|
||
| - ```fastboot reboot``` | ||
|
|
||
| **Congratulations! You are now booting your newly installed OS directly | ||
| from UFS on the Qualcomm Robotics RB1 development kit!** | ||
|
|
||
|
|
||
|
|
124 changes: 124 additions & 0 deletions
124
consumer/dragonboard/qualcomm-robotics-rb1/installation/linux-fastboot.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,124 @@ | ||
| --- | ||
| title: Linux Host Installation for Qualcomm Robotics RB1 development kit | ||
| permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb1/installation/linux-fastboot.md.html | ||
| --- | ||
| ## Linux Host | ||
|
|
||
| This section show how to install a new operating system to your Qualcomm Robotics RB1 development kit using the fastboot method on a Linux host computer. | ||
|
|
||
| *** | ||
|
|
||
| - **Step 1**: Make sure fastboot is set up on host computer | ||
| - **Step 2**: Connect host computer to RB1 | ||
| - **Step 3**: Boot RB1 into fastboot mode | ||
| - **Step 4**: Recall location of all downloaded files | ||
| - **Step 5**: Unzip all files | ||
| - **Step 6**: Flash all files to the RB1 | ||
| - **Step 7**: Reboot RB1 | ||
|
|
||
| *** | ||
|
|
||
| #### **Step 1**: Make sure fastboot is set up on host computer. | ||
| ##### You can install fastboot from source or using your distro package manager. | ||
|
|
||
| - ###### From source: | ||
| - Android SDK “Tools only” for Linux can be downloaded <a href="https://developer.android.com/studio/releases/platform-tools.html" target="_blank">here</a> | ||
| - The Linux “Tools Only” SDK download does not come with fastboot, you will need to use the Android SDK Manager to install platform-tools. | ||
| - To do this follow the “SDK Readme.txt” instructions included in your SDK “Tools Only” download. | ||
|
|
||
| If you are still having trouble setting up fastboot, <a href="https://youtu.be/W_zlydVBftA" target="_blank">click here</a> for a short tutorial video | ||
|
|
||
| - ###### Or using a distro package manager: | ||
| ``` | ||
| # Red Hat flavour (Fedora, CentOS) | ||
| $ sudo yum install android-tools | ||
| # Debian (Ubuntu) | ||
| $ sudo apt-get install google-android-platform-tools-installer | ||
| # Ubuntu 16.04 (Xenial) and beyond | ||
| $ sudo apt-get install android-tools-fastboot | ||
| ``` | ||
|
|
||
| #### **Step 2**: Connect host computer to RB1 | ||
|
|
||
| - RB1 must be powered off (unplugged from power) | ||
| - please check the Quick start guide to set the dip switches on the development kit | ||
|
|
||
| #### **Step 3**: Boot RB1 into fastboot mode | ||
|
|
||
| **Please read all bullet points before attempting** | ||
|
|
||
| - Disconnect the power cable from the board and make sure no USB cable is plugged into the board | ||
| - Hold down the "VOL-" button while reconnecting the power supply. | ||
| - Tap the "ON/OFF" button while continuing to hold the "VOL-" button for ~5 seconds after the green LED lights up. | ||
| - Release "VOL-" button | ||
| - Connect the USB3 Type C between the Linux PC and the board | ||
| - Board should boot into fastboot mode. | ||
|
|
||
| From the connected host machine terminal window, run the following commands: | ||
|
|
||
| ```shell | ||
| # Check to make sure device is connected and in fastboot mode | ||
|
|
||
| $ sudo fastboot devices | ||
| ``` | ||
|
|
||
| Typically it will show as below | ||
| ```shell | ||
| de82318 fastboot | ||
| ``` | ||
|
|
||
| #### **Step 4**: Recall location of all downloaded files | ||
|
|
||
| Recall location of all downloaded files from the downloads page: | ||
|
|
||
| ###### **Linaro/Debian**: Recall location of `boot` and `rootfs` downloaded from the downloads page | ||
| - You should have downloaded the `boot` file | ||
| - You should have downloaded the `rootfs` file | ||
|
|
||
| #### **Step 5**: Unzip required files | ||
|
|
||
| ##### For Debian | ||
| ```shell | ||
| $ gunzip boot-linaro-sid-arm64-qcom_qrb2210-rb1-*.img.gz | ||
| $ gunzip linaro-sid-developer-arm64-*.img.gz | ||
| ``` | ||
|
|
||
| #### **Step 6**: Flash all images to the RB1 | ||
|
|
||
| - Use host computer | ||
| - Use "Terminal" application | ||
| - Recall location of extracted(unzipped) files | ||
| - `cd` to the directory with your unzipped files | ||
| - From within extraction directory, execute the following commands: | ||
|
|
||
| ###### **Linaro/Debian**: | ||
| ```shell | ||
| # (Once again) Check to make sure fastboot device connected | ||
| $ sudo fastboot devices | ||
| # It will show similar to below if the device is connected successfully | ||
| de82318 fastboot | ||
|
|
||
| # cd to the directory the boot image and were extracted | ||
| $ cd <extraction directory> | ||
|
|
||
| # Make sure you have properly unzipped the boot and rootfs downloads | ||
| $ sudo fastboot flash boot boot-linaro-sid-arm64-qcom_qrb2210-rb1-**BUILD#**.img | ||
| $ sudo fastboot flash userdata linaro-sid-developer-arm64-**BUILD#**.img | ||
| ``` | ||
| **Note**: Replace **BUILD#** in the above commands with the file-specific date/build stamp. | ||
|
|
||
| #### **Step 7**: Reboot RB1 | ||
|
|
||
| - Unplug power to RB1 | ||
| - Ensure HDMI connection to a monitor | ||
| - Plug power back into RB1 | ||
| - Wait for board to boot up | ||
| - Board will boot into command line | ||
|
|
||
| **Note:** For Linaro/Debian the **username** and **password** are both **“linaro”** when the login information is requested. | ||
|
|
||
| **Congratulations! You are now booting your newly installed OS directly from eMMC on the RB1!** | ||
|
|
||
|
|
Oops, something went wrong.