Doc: Update the setup instructions

Dropped/moved links to the Qt for MCUs documentation
at some places. This should improve the reading
experience and avoid confusion.

Fixes: UL-2324
Change-Id: Ied18323355884092d9b02a2228bdf8a9e1c4235c
Reviewed-by: Rainer Keller <Rainer.Keller@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
This commit is contained in:
Venugopal Shivashankar
2020-06-29 10:58:04 +02:00
parent 33a91ab099
commit 3a2f09c1bb

View File

@@ -49,9 +49,6 @@
For a list of Qt for MCU reference implementations, see the For a list of Qt for MCU reference implementations, see the
\l{Qt for MCUs - Supported Target Platforms}{Qt for MCUs} documentation. \l{Qt for MCUs - Supported Target Platforms}{Qt for MCUs} documentation.
You use the \l{Connecting Bare Metal Devices}{Bare metal plugin} to connect
to a debug server provider for debugging on MCUs.
\section1 Requirements \section1 Requirements
To use \QC to develop QML applications for MCUs, you need the following: To use \QC to develop QML applications for MCUs, you need the following:
@@ -61,33 +58,40 @@
\li The Bare Metal plugin \li The Bare Metal plugin
\li \l{https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm} \li \l{https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm}
{GNU ARM Embedded Toolchain} {GNU ARM Embedded Toolchain}
\li The hardware-specific requirements vary depending on the hardware platform you are developing for. \endlist
The hardware-specific requirements vary depending on the hardware platform you are developing for.
For more information see: For more information see:
\list \list
\li \l{Getting Started on NXP} \li \l{Getting Started on NXP}
\li \l{Getting Started on STM} \li \l{Getting Started on STM}
\li \l{Getting Started on Renesas} \li \l{Getting Started on Renesas}
\endlist \endlist
\endlist
\section1 Setting Up the Development Environment \section1 Setting Up the Development Environment
You must download and install the required software and create connections You must download and install the required software and create connections
between \QC and MCUs. For more information, see \l{Getting Started on Windows}. between \QC and MCUs. The following subsections guide you through the
setup process.
\section2 Enabling Bare Metal and MCU Plugins \section2 MCU and Bare Metal Plugins
To be able to develop for MCUs, you must enable the Bare Metal and MCU To be able to develop applications for MCUs, you need the MCU plugin at least.
plugins: This plugin is enabled automatically by the installer when you install the
Qt for MCUs SDK.
The Bare Metal plugin is optional unless you want to configure the
debug server provider settings explicitly. For more information
see \l{Connecting Bare Metal Devices}.
To explicitly disable or enable any of these plugins, follow these
instructions:
\list 1 \list 1
\li Select \uicontrol Help > \uicontrol {About Plugins} > \li Select \uicontrol Help > \uicontrol {About Plugins} >
\uicontrol {Device Support} > \uicontrol {Bare Metal} and \uicontrol {Device Support} > \uicontrol {Bare Metal} and
\uicontrol {MCU Support} to enable the Bare Metal and MCU \uicontrol {MCU Support} to enable the Bare Metal and MCU
plugins. plugins.
\li Select \uicontrol {Restart Now} to restart \QC and load the plugins. \li Select \uicontrol {Restart Now} to restart \QC and load the plugins.
\li Create connections for debugging on the MCU board, as described in
\l{Connecting Bare Metal Devices}.
\endlist \endlist
\section2 Specifying MCU Settings \section2 Specifying MCU Settings
@@ -103,30 +107,30 @@
to the directory where you installed Qt for MCUs SDK. to the directory where you installed Qt for MCUs SDK.
\li In the \uicontrol {Targets supported by the Qt for MCUs SDK} \li In the \uicontrol {Targets supported by the Qt for MCUs SDK}
field, select your MCU board. field, select your MCU board.
\li In the \uicontrol {GNU ARM Embedded Toolchain} field, \li In the \uicontrol Requirements section, ensure that the
specify the path to the directory where you installed the platform-specific requirements are met. This varies depending
tool chain. on the target chosen:
\li For STM32 boards:
\list \list
\li In the \uicontrol {STM32Cube SDK} field, specify the \li For STM32 targets:
path to the directory where you installed the SDK. \list
\li In the \uicontrol {STM32Cube Programmer} field, \li The \uicontrol {GNU ARM Embedded Toolchain} path.
specify the path to the directory where you \li The \uicontrol {STM32CubeProgrammer} install path.
installed the tool.
\endlist \endlist
\li For NXP boards: \li For NXP targets:
\list \list
\li In the \uicontrol {NXP EVKB-IMXRT 1050 SDK} field, \li The \uicontrol {GNU ARM Embedded Toolchain} path.
specify the path to the directory where you \li The \uicontrol {MCUXpresso IDE} install path.
installed the SDK. \endlist
\li In the \uicontrol {SEGGER JLink} field, specify the \li For Renesas targets:
path to the directory where you installed the tool. \list
\li The \uicontrol {Green Hills Compiler} path.
\li The \uicontrol {Renesas Graphics Library} path.
\endlist
\endlist \endlist
\li Select \uicontrol{Create Kit} to create a kit. If you have \li Select \uicontrol{Create Kit} to create a kit. If you have
an older kit for the selected SDK, remove it first using an older kit for the selected target, remove it first using
\uicontrol{Remove Kit}. \uicontrol{Remove Kit}.
\li Select \uicontrol Apply to save the settings and to generate \li Select \uicontrol Apply to save the settings.
a MCU device and kit.
\endlist \endlist
\section2 Adding MCU Devices \section2 Adding MCU Devices