summaryrefslogtreecommitdiffstats
path: root/src/doc/src/devices/qtee-bd-sl-imx6.qdoc
blob: e94835b568d85f2675030df26683031f2c2c0ee5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
/****************************************************************************
**
** Copyright (C) 2014 Digia Plc
** All rights reserved.
** For any questions to Digia, please use the contact form at
** http://www.qt.io
**
** This file is part of Qt Enterprise Embedded.
**
** Licensees holding valid Qt Enterprise licenses may use this file in
** accordance with the Qt Enterprise License Agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.
**
** If you have questions regarding the use of this file, please use
** the contact form at http://www.qt.io
**
****************************************************************************/
/*!
    \page qtee-preparing-hardware-imx6.html
    \title Boundary Devices i.MX6 Boards
    \previouspage qtee-installation-guide.html

    Take the following steps when preparing these boards for \B2Q:

    \list
        \li \l{http://boundarydevices.com/products/sabre-lite-imx6-sbc/}
            {Boundary Devices BD-SL-i.MX6 (SABRE Lite)}
            (embedded Android and Linux)
        \li \l{http://boundarydevices.com/product/nitrogen6x-copy/}
            {Boundary Devices Nitrogen6X} (embedded Linux only)
        \li \l{http://boundarydevices.com/product/nitrogen6_lite/}
            {Boundary Devices Nitrogen6_Lite} (embedded Linux only)
        \li \l{http://boundarydevices.com/product/nitrogen6max/}
            {Boundary Devices Nitrogen6_MAX} (embedded Linux only)
        \li \l{http://boundarydevices.com/product/nitrogen6x-som/}
            {Boundary Devices Nitrogen6X_SOM} (embedded Linux only)
    \endlist

    \note It is important that you repeat the steps in this section after you
    update \SDK.

    The images containing the \B2Q stack for the device 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 4 GB capacity is needed. For \B2QL,
    a card of at least 1 GB 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}{Installing the Boot to Qt Image}.

    Download the package \e{imx6-jb-20130628.tar.gz} from
    \l{http://boundarydevices.com/android-jellybean-on-i-mx6-with-no-disclaimers/}{Boundary
    Devices Android Jellybean i.MX6 images} (registration required).

    Use the following commands to create an SD card containing the
    downloaded image:

    \list 1
        \li Extract the downloaded package:
        \badcode
        ~/$ mkdir bd-android
        ~/$ cd bd-android
        ~/bd-android$ tar zxvf ~/Downloads/imx6-jb-20130628.tar.gz
        \endcode
        \li Run device/boundary/mksdcard.sh:
        \badcode
        ~/bd-android$ sudo device/boundary/mksdcard.sh /dev/<device_name>
        ~/bd-android$ sync
        \endcode
    \endlist

    \section1 Installing the \B2Q Image

    \include common.qdocinc wizard

    Make sure you have the required tools installed in your development machine:

    \badcode
        sudo apt-get install u-boot-tools
    \endcode

    Then, upgrade the SD card with \B2Q. First, ensure that no partitions on the
    SD card are mounted:

    \include detect-sd-card-device-name.qdocinc unmount

    Then, use one of the commands below, depending on whether you are developing
    for embedded Android or Linux:

    \list
        \li \b{\B2QA}
        \badcode
            cd <INSTALL_DIR>
            ./Boot2Qt-4.x/generic-4.2-eAndroid/images/iMX6/deploy.sh /dev/<device_name>
        \endcode
        \li \b{\B2QL}
        \badcode
            cd <INSTALL_DIR>
            sudo ./Boot2Qt-4.x/iMX6-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 android linux

    You are now ready to start developing for your device. For more information,
    see \l{Building and Running an Example}.
*/