aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDenis Shienkov <denis.shienkov@gmail.com>2019-06-29 18:22:15 +0300
committerDenis Shienkov <denis.shienkov@gmail.com>2019-07-11 11:40:40 +0000
commit808d246607b768ea4dc02e3ef0b178e058d6575c (patch)
treeca19a3f75351ef7aad60241df81df82166451b72 /doc
parent9ee200a92808286a8c48253cf51ee7eecaa1a8a8 (diff)
baremetal: Long live the IAR EW project generator for ARM
Right now it is possible to generate a native projects for the IAR Embedded Workbench IDE, e.g. using the following command: qbs generate -g iarew8 -d <path/to/build/directory> -f <path/to/qbs/project> profile:<your/qbs/profile> We need in a valid IAR EW QBS profile, from which the generator take a desired target architecture and other stuff. The IAR EW generator has a semi-intelligent logic, it parses a source QBS project and converts a compiler flags and other stuff to an appropriate configurations of the native IAR EW project. Currently it is supported only one 'iarew8' generator which allow to generate a projects for the IAR EW for ARM for all versions of 8 series. Tested with the IAR EW for ARM v8.20, v8.32, v8.40, using as the QBS bare-metal examples, and as other projects. Change-Id: I2aa24d5a635f1f5a0e645bec8c30053e960d90a3 Reviewed-by: Ivan Komissarov <ABBAPOH@gmail.com> Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>
Diffstat (limited to 'doc')
-rw-r--r--doc/qbs.qdoc27
-rw-r--r--doc/reference/cli/cli-options.qdocinc1
2 files changed, 27 insertions, 1 deletions
diff --git a/doc/qbs.qdoc b/doc/qbs.qdoc
index d2c703491..d0129005b 100644
--- a/doc/qbs.qdoc
+++ b/doc/qbs.qdoc
@@ -1721,7 +1721,7 @@
integrate \QBS with popular IDEs, such as Microsoft Visual Studio, and to
generate Clang compilation databases.
- \section1 Generating Projects
+ \section1 Generating Microsoft Visual Studio Projects
To generate a project for another build system, such as Microsoft Visual
Studio, use the \l{generate}{qbs generate} command and specify a generator
@@ -1744,6 +1744,31 @@
\l{generate}{qbs generate} in order for the changes to be reflected in your
IDE.
+ \section1 Generating IAR Embedded Workbench Projects
+
+ To generate a project for an \l{https://www.iar.com/iar-embedded-workbench/}
+ {IAR Embedded Workbench}, use the \l{generate}{qbs generate} command and specify
+ a generator using the \l{generate-generator}{-g} option. For example:
+
+ \code
+ # For IAREW v8xxxx
+ qbs generate -g iarew8 profile:<your/qbs/profile>
+ qbs generate -g iarew8 -d <path/to/build/directory> -f <path/to/qbs/project> profile:<your/qbs/profile>
+ \endcode
+
+ \note You need to specify a specific QBS profile, which is required for a generator
+ to fetch a target architecture to generate the project.
+
+ \note An existing IAR EW generator creates a native target project for a specified
+ IAR Embedded Workbench.
+
+ Supported IAR EW generators are listed in a table below:
+
+ \table
+ \header \li Generator \li IAR EW Version \li Target Architecture
+ \row \li iarew8 \li All 8.x.y versions \li ARM
+ \endtable
+
\section1 Generating Clang Compilation Databases
To generate a \l{JSON Compilation Database Format Specification}
diff --git a/doc/reference/cli/cli-options.qdocinc b/doc/reference/cli/cli-options.qdocinc
index d4c3280a2..f609b1964 100644
--- a/doc/reference/cli/cli-options.qdocinc
+++ b/doc/reference/cli/cli-options.qdocinc
@@ -201,6 +201,7 @@
\list
\li \c clangdb
\li \c visualstudio2015
+ \li \c iarew8
\endlist
The available generators are listed if you run the \c {qbs generate} command