diff options
author | Samuli Piippo <samuli.piippo@qt.io> | 2019-09-10 09:54:52 +0300 |
---|---|---|
committer | Samuli Piippo <samuli.piippo@qt.io> | 2019-09-27 13:37:37 +0300 |
commit | 258855105491b51e57cd1273710972c251fab7e0 (patch) | |
tree | d84db4a8f3f6fac28dce33e7529c0f41339ecdbb /meta-toradex-extras | |
parent | eeb890732e02978c1959c46bef7255b233624643 (diff) |
QBSP: include readme file in the QBSP image package
Add READMEs to be included in the QBSP image package,
machine specific instructions moved from the online docs.
Task-number: QTBUG-72815
Change-Id: I3af024aabb393eb32d866cd925e20d4f341f0d7d
Reviewed-by: Mikko Gronoff <mikko.gronoff@qt.io>
Reviewed-by: Tarja Sundqvist <tarja.sundqvist@qt.io>
Diffstat (limited to 'meta-toradex-extras')
3 files changed, 121 insertions, 0 deletions
diff --git a/meta-toradex-extras/recipes/qbsp-readme/qbsp-readme.bbappend b/meta-toradex-extras/recipes/qbsp-readme/qbsp-readme.bbappend new file mode 100644 index 00000000..64d9670e --- /dev/null +++ b/meta-toradex-extras/recipes/qbsp-readme/qbsp-readme.bbappend @@ -0,0 +1,30 @@ +############################################################################ +## +## Copyright (C) 2019 The Qt Company Ltd. +## Contact: https://www.qt.io/licensing/ +## +## This file is part of the Boot to Qt meta layer. +## +## $QT_BEGIN_LICENSE:GPL$ +## Commercial License Usage +## Licensees holding valid commercial Qt licenses may use this file in +## accordance with the commercial license agreement provided with the +## Software or, alternatively, in accordance with the terms contained in +## a written agreement between you and The Qt Company. For licensing terms +## and conditions see https://www.qt.io/terms-conditions. For further +## information use the contact form at https://www.qt.io/contact-us. +## +## GNU General Public License Usage +## Alternatively, this file may be used under the terms of the GNU +## General Public License version 3 or (at your option) any later version +## approved by the KDE Free Qt Foundation. The licenses are as published by +## the Free Software Foundation and appearing in the file LICENSE.GPL3 +## included in the packaging of this file. Please review the following +## information to ensure the GNU General Public License requirements will +## be met: https://www.gnu.org/licenses/gpl-3.0.html. +## +## $QT_END_LICENSE$ +## +############################################################################ + +FILESEXTRAPATHS_prepend := "${THISDIR}/${PN}:" diff --git a/meta-toradex-extras/recipes/qbsp-readme/qbsp-readme/README b/meta-toradex-extras/recipes/qbsp-readme/qbsp-readme/README new file mode 100644 index 00000000..f91fd080 --- /dev/null +++ b/meta-toradex-extras/recipes/qbsp-readme/qbsp-readme/README @@ -0,0 +1,66 @@ +To successfully set up the Boot to Qt software stack, +follow the instructions in https://doc.qt.io/QtForDeviceCreation/qtdc-qbsp-installation-guide.html#. + +In 2. Installing Boot to Qt on Target Device, see also the following device specific instructions: + + +2. Installing Boot to Qt on Target Device + +To flash the image, you can use either Toradex Easy Installer +(https://developer.toradex.com/software/toradex-easy-installer#) or Qt's Flashing Wizard. +With Toradex Easy Installer, the image is flashed to the device's internal eMMC +flash memory. + + +2.1 Flashing with Toradex Easy Installer: + +When Toradex Easy Installer is connected to the Internet, it automatically provides +the latest Boot to Qt image in its image list but that is not necessarily compatible +with your Boot to Qt installation. When you flash with Toradex Easy Installer, +you should always use the *.tezi.tar package that is included into the Boot to Qt +installation. + +Flash the Boot to Qt image with Toradex Easy Installer as follows: + +1. If your target device does not have the pre-installed Toradex Easy Installer, +follow instructions in https://developer.toradex.com/software/toradex-easy-installer#load-toradex-easy-installer# +to load Toradex Easy Installer. +2. Your Boot to Qt installation has the *.tezi.tar package under +<Qt installation directory>/<Qt version>/Boot2Qt/<target>/images. Extract the package +to an SD card or a USB flash drive. +3. Flash the image from the SD card or the USB flash drive with Toradex Easy Installer. +See https://developer.toradex.com/software/toradex-easy-installer#installing-the-images. + + +2.2 Flashing with Qt's Flashing Wizard + +Use Flashing Wizard to flash the image to your device: + +1. Connect your SD card reader to the development host. Make sure that the SD card size is at least 4 GB. +2. Launch Qt Creator. +3. Select Tools > Flash Boot to Qt Device, and follow the instructions in Flashing Wizard. + +In order to boot from the external SD card, U-Boot needs to be updated. + + +2.3 Booting from External SD Card + +Connect a serial cable to the device and enter into the U-Boot environment by +pressing any key before the autoboot. + +Enter following commands into U-Boot: + +run setupdate +run update + +Reset or power cycle the device to start the new U-Boot. +To reset the U-Boot environment to new default values, enter the following commands in the U-Boot command line: + +env default -a +saveenv + +New U-Boot commands are now stored into the device. + +For more information about the boot process on the Toradex Colibri devices, +see https://developer.toradex.com/knowledge-base/linux-booting. + diff --git a/meta-toradex-extras/recipes/qbsp-readme/qbsp-readme/mx8/README b/meta-toradex-extras/recipes/qbsp-readme/qbsp-readme/mx8/README new file mode 100644 index 00000000..d51a4847 --- /dev/null +++ b/meta-toradex-extras/recipes/qbsp-readme/qbsp-readme/mx8/README @@ -0,0 +1,25 @@ +To successfully set up the Boot to Qt software stack, +follow the instructions in https://doc.qt.io/QtForDeviceCreation/qtdc-qbsp-installation-guide.html#. + +In 2. Installing Boot to Qt on Target Device, see also the following device specific instructions. + + +2. Installing Boot to Qt on Target Device + +Use Flashing Wizard to flash the image to your Toradex board: + +1. Use the RS-232 cable to access the serial terminal on Toradex board. +2. Power on your device and press any key to stop the autoboot. +3. Run the following command in U-Boot: + +ums 0 mmc 0 + +4. Use Flashing Wizard to flash the image to the device: + 4.1 Launch Qt Creator. + 4.2 Select Tools > Flash Boot to Qt Device, and follow the instructions in Flashing Wizard. +5. Press Ctrl+C in the U-Boot console and run the reset command. + +For more information about flashing the Toradex devices, +see https://developer.toradex.com/software/linux/linux-software/build-apalis-imx8-yoctoopenembedded-bring-up-image#emmc-boot#. + +Note: The Boot to Qt software stack supports only the v1.0B silicon. |