From 5be3cb521cdd67eeeac18e7f252fe89e2050e6b8 Mon Sep 17 00:00:00 2001
From: Topi Reinio <topi.reinio@digia.com>
Date: Fri, 31 Jan 2014 10:21:21 +0100
Subject: Doc: Add BeagleBone Black

Task-number: QTEE-302
Change-Id: I1c608ea0934a69244077a87de0f843993a3fc8d0
Reviewed-by: Samuli Piippo <samuli.piippo@digia.com>
---
 src/doc/src/b2qt.qdoc | 86 +++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 84 insertions(+), 2 deletions(-)

(limited to 'src')

diff --git a/src/doc/src/b2qt.qdoc b/src/doc/src/b2qt.qdoc
index e2322de..1b29b5a 100644
--- a/src/doc/src/b2qt.qdoc
+++ b/src/doc/src/b2qt.qdoc
@@ -45,6 +45,7 @@
         \list
             \li \l{Preparing Nexus 7}{Nexus 7 (2012) (embedded Android)}
             \li \l{Preparing Sabre Lite i.MX 6}{Sabre Lite i.MX 6 (embedded Android and Linux)}
+            \li \l{Preparing BeagleBone Black}{BeagleBone Black (embedded Android and Linux)}
             \li \l{Preparing BeagleBoard-xM}{BeagleBoard-xM (embedded Linux)}
             \li \l{Preparing Raspberry Pi}{Raspberry Pi Model B (embedded Linux)}
         \endlist
@@ -277,6 +278,7 @@
     \list
         \li \l{Nexus 7 (2012) (embedded Android)}
         \li \l{Sabre Lite i.MX 6 (embedded Android and Linux)}
+        \li \l{BeagleBone Black (embedded Android and Linux)}
         \li \l{BeagleBoard-xM (embedded Linux)}
         \li \l{Raspberry Pi Model B (embedded Linux)}
     \endlist
@@ -524,7 +526,7 @@
         \endcode
     \endlist
 
-    After the installation is complete, power on the device and check that
+    After the installation is complete, insert the SD card, power on the device and check that
     the \B2Q welcome screen and/or demo appear.
 
     \section1 Setting up USB Access
@@ -575,7 +577,7 @@
         sudo Boot2Qt-2.x/raspberrypi-eLinux/images/deploy.sh /dev/<device_name>
     \endcode
 
-    After the image has been deployed, power on the device and check that
+    After the image has been deployed, insert the SD card, power on the device and check that
     the \B2Q welcome screen and/or demo appear.
 
     \section1 Configuring a Device Kit in Qt Creator
@@ -586,6 +588,85 @@
     see \l{Building and Running an Example}.
 */
 
+/*!
+    \target BeagleBone Black (embedded Android and Linux)
+    \page qtee-preparing-hardware-beaglebone.html
+    \title Preparing BeagleBone Black
+    \previouspage qtee-installation-guide.html
+
+    Take the following steps to prepare a
+    \l{http://beagleboard.org/products/beaglebone%20black}{BeagleBone Black} for \B2Q.
+
+    \note It is important that you repeat the steps in this section after you
+    update \SDK.
+
+    The images containing the \B2Q stack for BeagleBone Black are included
+    in \SDK, ready to be copied to an SD card.
+
+    \section1 Preparing an SD Card
+
+    For \B2QA, an SD card of at least 2 GB capacity is needed. For \B2QL,
+    a card of at least 512 MB capacity is sufficient.
+
+    \include detect-sd-card-device-name.qdocinc instructions
+
+    \section1 Installing the Android image
+
+    \e{If installing} \B2QL, \e{you can skip this step and proceed to}
+    \l{Installing the Boot to Qt Image}.
+
+    Download the package \e{TI_Android_JB_4.2.2_DevKit_4.1.1_beagleboneblack.tar.gz} from
+    \l{http://downloads.ti.com/sitara_android/esd/TI_Android_DevKit/TI_Android_JB_4_2_2_DevKit_4_1_1/index_FDS.html}
+    {Texas Instruments} (search for \e {BeagleBone Black} in the list of download packages).
+
+    Use the following commands to create an SD card containing the
+    downloaded image:
+
+    \list 1
+        \li Extract the downloaded package:
+        \code
+        ~$ tar zxvf ~/Downloads/TI_Android_JB_4.2.2_DevKit_4.1.1_beagleboneblack.tar.gz
+        \endcode
+        \li Run beagleboneblack/mkmmc-android.sh:
+        \code
+        ~$ cd beagleboneblack
+        ~/beagleboneblack$ sudo ./mkmmc-android.sh /dev/<device_name>
+        \endcode
+    \endlist
+
+    \section1 Installing the \B2Q Image
+
+    Then, upgrade the SD card with \B2Q. Use one of the commands below,
+    depending on whether you are developing for embedded Android or Linux:
+
+    \list
+        \li \b{\B2QA}
+        \code
+            cd <INSTALL_DIR>
+            ./Boot2Qt-2.x/beaglebone-eAndroid/images/deploy.sh /dev/<device_name>
+        \endcode
+        \li \b{\B2QL}
+        \code
+            cd <INSTALL_DIR>
+            sudo ./Boot2Qt-2.x/beaglebone-eLinux/images/deploy.sh /dev/<device_name>
+        \endcode
+    \endlist
+
+    After the installation is complete, insert the SD card, power on the device and check that
+    the \B2Q welcome screen and/or demo appear.
+
+    \section1 Setting up USB Access
+
+    \include b2qt-post-install-setup.qdocinc setting up usb access
+
+    \section1 Configuring a Device Kit in Qt Creator
+
+    \include b2qt-post-install-setup.qdocinc configuring device kit
+
+    You are now ready to start developing for your device. For more information,
+    see \l{Building and Running an Example}.
+*/
+
 /*!
     \page qtee-building-and-running.html
     \title Building and Running an Example
@@ -756,6 +837,7 @@
     \list
         \li \l{http://www.google.com/nexus/7/specs/}{Google/Asus Nexus 7 (2012)}
         \li \l{http://beagleboard.org/hardware-xM}{BeagleBoard-xM}
+        \li \l{http://beagleboard.org/products/beaglebone%20black}{BeagleBone Black}
         \li \l{http://boundarydevices.com/products/sabre-lite-imx6-sbc/}{Freescale i.MX6 Sabre Lite board (Boundary Devices)}
         \li \l{http://www.raspberrypi.org/faqs}{Raspberry Pi Model B}
     \endlist
-- 
cgit v1.2.3