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>

1 files changed, 224 insertions, 0 deletions

diff --git a/src/plugins/generator/iarew/archs/arm/armassemblersettingsgroup_v8.cpp b/src/plugins/generator/iarew/archs/arm/armassemblersettingsgroup_v8.cpp
new file mode 100644
index 000000000..7c7f8e2bf
--- /dev/null
+++ b/src/plugins/generator/iarew/archs/arm/armassemblersettingsgroup_v8.cpp
@@ -0,0 +1,224 @@
+/****************************************************************************
+**
+** Copyright (C) 2019 Denis Shienkov <denis.shienkov@gmail.com>
+** Contact: http://www.qt.io/licensing
+**
+** This file is part of Qbs.
+**
+** 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 http://www.qt.io/terms-conditions. For further information
+** use the contact form at http://www.qt.io/contact-us.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 or version 3 as published by the Free
+** Software Foundation and appearing in the file LICENSE.LGPLv21 and
+** LICENSE.LGPLv3 included in the packaging of this file.  Please review the
+** following information to ensure the GNU Lesser General Public License
+** requirements will be met: https://www.gnu.org/licenses/lgpl.html and
+** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, The Qt Company gives you certain additional
+** rights.  These rights are described in The Qt Company LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+****************************************************************************/
+
+#include "armassemblersettingsgroup_v8.h"
+
+#include "../../iarewproperty.h"
+#include "../../iarewutils.h"
+
+namespace qbs {
+namespace v8 {
+
+constexpr int kAssemblerArchiveVersion = 2;
+constexpr int kAssemblerDataVersion = 10;
+
+namespace ArmAssembler {
+
+// Language page options.
+
+struct LanguagePageOptions final
+{
+    enum MacroQuoteCharacter { AngleBracketsQuote, RoundBracketsQuote,
+                               SquareBracketsQuote, FigureBracketsQuote };
+
+    explicit LanguagePageOptions(const ProductData &qbsProduct)
+    {
+        const auto &qbsProps = qbsProduct.moduleProperties();
+        const QStringList flags = IarewUtils::cppModuleAssemblerFlags(qbsProps);
+        enableSymbolsCaseSensitive = flags.contains(QLatin1String("-s+"));
+        allowAlternativeRegister = flags.contains(QLatin1String("-j"));
+        disableCodeMemoryDataReads = flags.contains(
+                    QLatin1String("--no_literal_pool"));
+        if (flags.contains(QLatin1String("-M<>")))
+            macroQuoteCharacter = LanguagePageOptions::AngleBracketsQuote;
+        else if (flags.contains(QLatin1String("-M()")))
+            macroQuoteCharacter = LanguagePageOptions::RoundBracketsQuote;
+        else if (flags.contains(QLatin1String("-M[]")))
+            macroQuoteCharacter = LanguagePageOptions::SquareBracketsQuote;
+        else if (flags.contains(QLatin1String("-M{}")))
+            macroQuoteCharacter = LanguagePageOptions::FigureBracketsQuote;
+    }
+
+    MacroQuoteCharacter macroQuoteCharacter = AngleBracketsQuote;
+    int enableSymbolsCaseSensitive = 0;
+    int allowAlternativeRegister = 0;
+    int disableCodeMemoryDataReads = 0;
+};
+
+// Output page options.
+
+struct OutputPageOptions final
+{
+    explicit OutputPageOptions(const ProductData &qbsProduct)
+    {
+        debugInfo = IarewUtils::debugInformation(qbsProduct);
+    }
+
+    int debugInfo = 0;
+};
+
+// Preprocessor page options.
+
+struct PreprocessorPageOptions final
+{
+    explicit PreprocessorPageOptions(const QString &baseDirectory,
+                                     const ProductData &qbsProduct)
+    {
+        const auto &qbsProps = qbsProduct.moduleProperties();
+        defineSymbols = IarewUtils::cppVariantModuleProperties(
+                    qbsProps, {QStringLiteral("defines")});
+
+        const QString toolkitPath = IarewUtils::toolkitRootPath(qbsProduct);
+        const QStringList fullIncludePaths = IarewUtils::cppStringModuleProperties(
+                    qbsProps, {QStringLiteral("includePaths"),
+                               QStringLiteral("systemIncludePaths")});
+        for (const QString &fullIncludePath : fullIncludePaths) {
+            const QFileInfo includeFileInfo(fullIncludePath);
+            const QString includeFilePath = includeFileInfo.absoluteFilePath();
+            if (includeFilePath.startsWith(toolkitPath, Qt::CaseInsensitive)) {
+                const QString path = IarewUtils::toolkitRelativeFilePath(
+                            toolkitPath, includeFilePath);
+                includePaths.push_back(path);
+            } else {
+                const QString path = IarewUtils::projectRelativeFilePath(
+                            baseDirectory, includeFilePath);
+                includePaths.push_back(path);
+            }
+        }
+    }
+
+    QVariantList defineSymbols;
+    QVariantList includePaths;
+};
+
+// Diagnostics page options.
+
+struct DiagnosticsPageOptions final
+{
+    explicit DiagnosticsPageOptions(const ProductData &qbsProduct)
+    {
+        const auto &qbsProps = qbsProduct.moduleProperties();
+        const QString warningLevel = IarewUtils::cppStringModuleProperty(
+                    qbsProps, QStringLiteral("warningLevel"));
+        if (warningLevel == QLatin1String("all")) {
+            enableWarnings = 0;
+            enableAllWarnings = 0;
+        } else if (warningLevel == QLatin1String("none")) {
+            enableWarnings = 1;
+            enableAllWarnings = 0;
+        } else {
+            enableWarnings = 0;
+            enableAllWarnings = 1;
+        }
+    }
+
+    int enableWarnings = 0;
+    int enableAllWarnings = 0;
+};
+
+} // namespace ArmAssembler
+
+// ArmAssemblerSettingsGroup
+
+ArmAssemblerSettingsGroup::ArmAssemblerSettingsGroup(
+        const Project &qbsProject,
+        const ProductData &qbsProduct,
+        const std::vector<ProductData> &qbsProductDeps)
+{
+    Q_UNUSED(qbsProductDeps)
+
+    setName(QByteArrayLiteral("AARM"));
+    setArchiveVersion(kAssemblerArchiveVersion);
+    setDataVersion(kAssemblerDataVersion);
+    setDataDebugInfo(IarewUtils::debugInformation(qbsProduct));
+
+    const QString buildRootDirectory = IarewUtils::buildRootPath(qbsProject);
+
+    buildLanguagePage(qbsProduct);
+    buildOutputPage(qbsProduct);
+    buildPreprocessorPage(buildRootDirectory, qbsProduct);
+    buildDiagnosticsPage(qbsProduct);
+}
+
+void ArmAssemblerSettingsGroup::buildLanguagePage(
+        const ProductData &qbsProduct)
+{
+    const ArmAssembler::LanguagePageOptions opts(qbsProduct);
+    // Add 'ACaseSensitivity' item (User symbols are case sensitive).
+    addOptionsGroup(QByteArrayLiteral("ACaseSensitivity"),
+                    {}, {opts.enableSymbolsCaseSensitive});
+    // Add 'AltRegisterNames' item (Allow alternative register names,
+    // mnemonics and operands).
+    addOptionsGroup(QByteArrayLiteral("AltRegisterNames"),
+                    {}, {opts.allowAlternativeRegister});
+    // Add 'AsmNoLiteralPool' item (No data reads in code memory).
+    addOptionsGroup(QByteArrayLiteral("AsmNoLiteralPool"),
+                    {}, {opts.disableCodeMemoryDataReads});
+    // Add 'MacroChars' item (Macro quote characters: ()/[]/{}/<>).
+    addOptionsGroup(QByteArrayLiteral("MacroChars"),
+                    {0}, {opts.macroQuoteCharacter});
+}
+void ArmAssemblerSettingsGroup::buildOutputPage(
+        const ProductData &qbsProduct)
+{
+    const ArmAssembler::OutputPageOptions opts(qbsProduct);
+    // Add 'ADebug' item (Generate debug information).
+    addOptionsGroup(QByteArrayLiteral("ADebug"),
+                    {}, {opts.debugInfo});
+}
+
+void ArmAssemblerSettingsGroup::buildPreprocessorPage(
+        const QString &baseDirectory,
+        const ProductData &qbsProduct)
+{
+    const ArmAssembler::PreprocessorPageOptions opts(baseDirectory,
+                                                     qbsProduct);
+    // Add 'ADefines' item (Defined symbols).
+    addOptionsGroup(QByteArrayLiteral("ADefines"),
+                    {}, opts.defineSymbols);
+    // Add 'AUserIncludes' item (Additional include directories).
+    addOptionsGroup(QByteArrayLiteral("AUserIncludes"),
+                    {}, opts.includePaths);
+}
+
+void ArmAssemblerSettingsGroup::buildDiagnosticsPage(
+        const ProductData &qbsProduct)
+{
+    const ArmAssembler::DiagnosticsPageOptions opts(qbsProduct);
+    // Add 'AWarnEnable' item (Enable/disable warnings).
+    addOptionsGroup(QByteArrayLiteral("AWarnEnable"),
+                    {}, {opts.enableWarnings});
+    // Add 'AWarnWhat' item (Enable/disable all warnings).
+    addOptionsGroup(QByteArrayLiteral("AWarnWhat"),
+                    {}, {opts.enableAllWarnings});
+}
+
+} // namespace v8
+} // namespace qbs