summaryrefslogtreecommitdiffstats
path: root/src/doc/src/devices/qtee-bd-sl-imx6.qdoc
blob: 8ef2e8aa58f7a49e73b87be1e857030835c9256d (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
124
125
126
127
128
/****************************************************************************
**
** 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)}
        \li \l{http://boundarydevices.com/product/nitrogen6x-copy/}
            {Boundary Devices Nitrogen6X}
        \li \l{http://boundarydevices.com/product/nitrogen6_lite/}
            {Boundary Devices Nitrogen6_Lite}
        \li \l{http://boundarydevices.com/product/nitrogen6max/}
            {Boundary Devices Nitrogen6_MAX}
        \li \l{http://boundarydevices.com/product/nitrogen6x-som/}
            {Boundary Devices Nitrogen6X_SOM}
    \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 \B2QL, an SD card of at least 1 GB capacity is needed.

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

    \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 the following command to install the embedded Linux image:

    \badcode
        cd <INSTALL_DIR>
        sudo dd bs=4k if=5.6/Boot2Qt/nitrogen6x/images/b2qt-embedded-qt5-image-nitrogen6x.img of=/dev/<device_name>
    \endcode

    After the installation is complete, insert the SD card, power on the device and check that
    the \B2Q welcome screen and/or demo appear.

    \b {Updating U-Boot}

    If you are updating from an older image, you may also need to update the version of U-Boot on the device.
    The prebuilt image already contains U-Boot versions for most of the device variants from Boundary Devices,
    but the update needs to be done manually when first starting the device. Correct device type is selected by
    setting the \c uboot_defconfig U-Boot environment variable. More information available from
    \l{https://boundarydevices.com/compiling-latest-u-boot-for-i-mx6-2015-edition/}{Boundary Devices}.

    Access the device's console and run the following commands on the U-Boot prompt:

    \badcode
        setenv uboot_defconfig <device type>
        run upgradeu
    \endcode

    \b {Setup for Nitrogen6_Lite Device}

    The boot script requires the environment variables, \c dtbname and \c gpumem, to identify
    the device as Nitrogen6_Lite. Otherwise, the device is booted with the default GPU
    memory setting of 512MiB, which is more than what is available on the Nitrogen_Lite devices
    (128MibB).

    Use one of the two following options to enable the scripts boot the device
    with correct GPU memory setting:

    \list
     \li Write a \c uEnv.txt file on to the boot partition of SD card with the following
         content:

         \badcode
             gpumem=67108864
             dtbname=imx6dl-nit6xlite.dtb
         \endcode

     \li Access the device's console and run the following commands on the U-Boot prompt:
         \badcode
             U-Boot > setenv gpumem 67108864
             U-Boot > setenv dtbname imx6dl-nit6xlite.dtb
             U-Boot > saveenv
         \endcode
    \endlist

    \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 linux

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