diff --git a/consumer/dragonboard/README.md b/consumer/dragonboard/README.md index eef719793..39c483799 100644 --- a/consumer/dragonboard/README.md +++ b/consumer/dragonboard/README.md @@ -16,6 +16,8 @@ Select your Consumer Edition DragonBoard 96Boards device to access all product s | 96Boards | About | Options | |:------------------------------------------------:|:------------------------------------------------------:|:--------------------------:| +|
**Qualcomm Robotics RB1** | Board based on Qualcomm® QRB2210 SoC | [Documentation](qualcomm-robotics-rb1/)
| +|
**Qualcomm Robotics RB2** | Board based on Qualcomm® QRB4210 SoC | [Documentation](qualcomm-robotics-rb2/)
| |
**Qualcomm Robotics RB5** | Board based on Qualcomm® QRB5165 SoC | [Documentation](qualcomm-robotics-rb5/)
| |
**Qualcomm RB3** | Board based on Qualcomm® Snapdragon™ 845 processor | [Documentation](dragonboard845c/)
| |
**DragonBoard 820c** | Board based on Qualcomm® APQ8016E processor | [Documentation](dragonboard820c/)
| diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/README.md b/consumer/dragonboard/qualcomm-robotics-rb1/README.md new file mode 100644 index 000000000..ab74f74a7 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb1/README.md @@ -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! + + diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/README.md b/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/README.md new file mode 100644 index 000000000..7f2318140 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/README.md @@ -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 + +*** diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/README.md b/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/README.md new file mode 100644 index 000000000..9f4296cbd --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/README.md @@ -0,0 +1 @@ +[Images_Board](images-board/) diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/images-board/README.md b/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/images-board/README.md new file mode 100644 index 000000000..826cde329 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/images-board/README.md @@ -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 diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/images-board/sd/rb1-back-sd.png b/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/images-board/sd/rb1-back-sd.png new file mode 100644 index 000000000..fc82c05b4 Binary files /dev/null and b/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/images-board/sd/rb1-back-sd.png differ diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/images-board/sd/rb1-front-sd.png b/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/images-board/sd/rb1-front-sd.png new file mode 100644 index 000000000..e6d521bba Binary files /dev/null and b/consumer/dragonboard/qualcomm-robotics-rb1/additional-docs/images/images-board/sd/rb1-front-sd.png differ diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/downloads/README.md b/consumer/dragonboard/qualcomm-robotics-rb1/downloads/README.md new file mode 100644 index 000000000..3a17efeac --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb1/downloads/README.md @@ -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/) + +*** diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/downloads/debian.md b/consumer/dragonboard/qualcomm-robotics-rb1/downloads/debian.md new file mode 100644 index 000000000..78639c078 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb1/downloads/debian.md @@ -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/) diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/downloads/files/README.md b/consumer/dragonboard/qualcomm-robotics-rb1/downloads/files/README.md new file mode 100644 index 000000000..8b1378917 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb1/downloads/files/README.md @@ -0,0 +1 @@ + diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/installation/README.md b/consumer/dragonboard/qualcomm-robotics-rb1/installation/README.md new file mode 100644 index 000000000..1dcd1a485 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb1/installation/README.md @@ -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) diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/installation/le.md b/consumer/dragonboard/qualcomm-robotics-rb1/installation/le.md new file mode 100644 index 000000000..b7f6804a6 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb1/installation/le.md @@ -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 here + - 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, click here 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!** + + + diff --git a/consumer/dragonboard/qualcomm-robotics-rb1/installation/linux-fastboot.md b/consumer/dragonboard/qualcomm-robotics-rb1/installation/linux-fastboot.md new file mode 100644 index 000000000..879b6e077 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb1/installation/linux-fastboot.md @@ -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 here + - 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, click here 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 + +# 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!** + + diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/README.md b/consumer/dragonboard/qualcomm-robotics-rb2/README.md new file mode 100644 index 000000000..34d1f8159 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb2/README.md @@ -0,0 +1,39 @@ +--- +title: Using the Qualcomm Robotics RB2 Development kit +permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb2/ +--- +# Using the Qualcomm® Robotics RB2 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 RB2 Development Kit](https://www.qualcomm.com/products/internet-of-things/industrial/industrial-automation/qualcomm-robotics-rb2-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-rb2-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 RB2 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! + + diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/README.md b/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/README.md new file mode 100644 index 000000000..32b9f52f0 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/README.md @@ -0,0 +1,19 @@ +--- +title: Additional Docs for Qualcomm® Robotics RB2 Platform +permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb2/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 + +*** diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/README.md b/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/README.md new file mode 100644 index 000000000..9f4296cbd --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/README.md @@ -0,0 +1 @@ +[Images_Board](images-board/) diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/images-board/README.md b/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/images-board/README.md new file mode 100644 index 000000000..826cde329 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/images-board/README.md @@ -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 diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/images-board/sd/rb2-back-sd.png b/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/images-board/sd/rb2-back-sd.png new file mode 100644 index 000000000..1fbd2b7d9 Binary files /dev/null and b/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/images-board/sd/rb2-back-sd.png differ diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/images-board/sd/rb2-front-sd.png b/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/images-board/sd/rb2-front-sd.png new file mode 100644 index 000000000..7099261af Binary files /dev/null and b/consumer/dragonboard/qualcomm-robotics-rb2/additional-docs/images/images-board/sd/rb2-front-sd.png differ diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/downloads/README.md b/consumer/dragonboard/qualcomm-robotics-rb2/downloads/README.md new file mode 100644 index 000000000..6011d2c05 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb2/downloads/README.md @@ -0,0 +1,26 @@ +--- +title: Downloads for Qualcomm Robotics RB2 development kit +permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb2/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 RB2 development kit, offered by partners. + +- [QTI Linux from Thundercomm for RB2 platform](https://www.thundercomm.com/product/qualcomm-robotics-rb2-platform/#sdk-manager) + - Download the SDK Manager tool from Thundercomm's website to build and flash the images on an RB2 development board. + +Continue to [Installation Page](../installation/) + +*** diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/downloads/debian.md b/consumer/dragonboard/qualcomm-robotics-rb2/downloads/debian.md new file mode 100644 index 000000000..2f16f8ba9 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb2/downloads/debian.md @@ -0,0 +1,25 @@ +--- +title: Debian Downloads for Qualcomm Robotics RB2 +permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb2/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 RB2 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_qrb4210-rb2-*.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/) diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/downloads/files/README.md b/consumer/dragonboard/qualcomm-robotics-rb2/downloads/files/README.md new file mode 100644 index 000000000..8b1378917 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb2/downloads/files/README.md @@ -0,0 +1 @@ + diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/installation/README.md b/consumer/dragonboard/qualcomm-robotics-rb2/installation/README.md new file mode 100644 index 000000000..f1bc4beab --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb2/installation/README.md @@ -0,0 +1,39 @@ +--- +title: Installation for Qualcomm Robotics RB2 development kit +permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb2/installation/ +--- +# Installation + +This guide will help you choose and install an operating system and installation method on your Qualcomm Robotics RB2 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 RB2 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) diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/installation/le.md b/consumer/dragonboard/qualcomm-robotics-rb2/installation/le.md new file mode 100644 index 000000000..c6877690a --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb2/installation/le.md @@ -0,0 +1,82 @@ +--- +title: Linux Host Installation for Qualcomm Robotics RB2 development kit +permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb2/installation/le.md.html +--- +## Linux Host + +This section show how to install a new operating system to your Qualcomm Robotics RB2 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 RB2 dev kit +- **Step 3**: Boot RB2 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 here + - 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, click here 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 RB2 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 RB2 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 RB2 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-rb2-platform/#sdk-manager). Follow the Thundercomm SDK Manager instructions to flash a full build for RB2 board recovery. + +#### **Step 5**: Reboot the Qualcomm Robotics RB2 development kit + +- ```fastboot reboot``` + +**Congratulations! You are now booting your newly installed OS directly +from UFS on the Qualcomm Robotics RB2 development kit!** + + + diff --git a/consumer/dragonboard/qualcomm-robotics-rb2/installation/linux-fastboot.md b/consumer/dragonboard/qualcomm-robotics-rb2/installation/linux-fastboot.md new file mode 100644 index 000000000..edc1ff809 --- /dev/null +++ b/consumer/dragonboard/qualcomm-robotics-rb2/installation/linux-fastboot.md @@ -0,0 +1,124 @@ +--- +title: Linux Host Installation for Qualcomm Robotics RB2 development kit +permalink: /documentation/consumer/dragonboard/qualcomm-robotics-rb2/installation/linux-fastboot.md.html +--- +## Linux Host + +This section show how to install a new operating system to your Qualcomm Robotics RB2 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 RB2 +- **Step 3**: Boot RB2 into fastboot mode +- **Step 4**: Recall location of all downloaded files +- **Step 5**: Unzip all files +- **Step 6**: Flash all files to the RB2 +- **Step 7**: Reboot RB2 + +*** + +#### **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 here + - 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, click here 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 RB2 + +- RB2 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 RB2 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_qrb4210-rb2-*.img.gz +$ gunzip linaro-sid-developer-arm64-*.img.gz +``` + +#### **Step 6**: Flash all images to the RB2 + +- 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 + +# Make sure you have properly unzipped the boot and rootfs downloads +$ sudo fastboot flash boot boot-linaro-sid-arm64-qcom_qrb4210-rb2-**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 RB2 + +- Unplug power to RB2 +- Ensure HDMI connection to a monitor +- Plug power back into RB2 +- 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 RB2!** + +