bare-metal: Add IAR EWARM toolchain support on Windows

This commit adds a basic support of the IAR Embedded Workbench
toolchain for the ARM processors on Windows host.

To use it with Qt Creator, it is enough to add there a desired Kit
with a custom IAR C/C++ compiler, and then set the following in the
Kit's Qbs profile settings:

* Key: qbs.toolchainType
* Value: iar

To specify the target CPU/FPU you need to set the cpp.driverFlags
property, like this:

    cpp.driverFlags: [
        "--cpu", "Cortex-M4",
        "--fpu", "VFPv4_sp"
    ]

Then these flags will be automatically passed to both compiler
and assembler.

To specify the linker flags you need to set the cpp.driverLinkerFlags
property instead of cpp.linkerFlags property, like this:

    cpp.driverLinkerFlags: ["--vfe"]

To add the linker script files you need to set the 'linkerscript'
tag, e.g. in the following way:

    Group {
        name: "Linker scripts"
        fileTags: ["linkerscript"]
        files: ["stm32f407xx_flash.icf"]
    }

Other properties can be used as usual, according to the EWARM
compiler documentation.

Tested with EWARM v8.20.2, v6.50.3 on Windows using:

* STM NUCLEO-F767ZI
* STM 32F4DISCOVERY

target boards.

Change-Id: I3c42eb94051352cb3b7eb5b0768a1dc8bdacabce
Reviewed-by: Richard Weickelt <richard@weickelt.de>
Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>

1 files changed, 195 insertions, 0 deletions

diff --git a/share/qbs/modules/cpp/iar.qbs b/share/qbs/modules/cpp/iar.qbs
new file mode 100644
index 000000000..69a0a0377
--- /dev/null
+++ b/share/qbs/modules/cpp/iar.qbs
@@ -0,0 +1,195 @@
+/****************************************************************************
+**
+** Copyright (C) 2019 Denis Shienkov <denis.shienkov@gmail.com>
+** Contact: http://www.qt.io/licensing
+**
+** This file is part of the Qt Build Suite.
+**
+** 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.
+**
+****************************************************************************/
+
+import qbs 1.0
+import qbs.File
+import qbs.FileInfo
+import qbs.ModUtils
+import qbs.PathTools
+import qbs.Probes
+import qbs.Utilities
+import "iar.js" as IAR
+
+CppModule {
+    condition: qbs.toolchain && qbs.toolchain.contains("iar")
+
+    Probes.BinaryProbe {
+        id: compilerPathProbe
+        condition: !toolchainInstallPath && !_skipAllChecks
+        names: ["iccarm"]
+    }
+
+    Probes.IarProbe {
+        id: iarProbe
+        condition: !_skipAllChecks
+        compilerFilePath: compilerPath
+    }
+
+    qbs.architecture: iarProbe.found ? iarProbe.architecture : original
+
+    compilerVersionMajor: iarProbe.versionMajor
+    compilerVersionMinor: iarProbe.versionMinor
+    compilerVersionPatch: iarProbe.versionPatch
+    endianness: iarProbe.endianness
+
+    compilerDefinesByLanguage: []
+
+    property string toolchainInstallPath: compilerPathProbe.found
+        ? compilerPathProbe.path : undefined
+
+    property string compilerExtension: qbs.hostOS.contains("windows") ? ".exe" : ""
+
+    property bool generateMapFile: true
+    PropertyOptions {
+        name: "generateMapFile"
+        description: "produce a linker list file (enabled by default)"
+    }
+
+    /* Work-around for QtCreator which expects these properties to exist. */
+    property string cCompilerName: compilerName
+    property string cxxCompilerName: compilerName
+
+    compilerName: {
+        switch (qbs.architecture) {
+        case "arm":
+            return "iccarm" + compilerExtension;
+        }
+    }
+    compilerPath: FileInfo.joinPaths(toolchainInstallPath, compilerName)
+
+    assemblerName: {
+        switch (qbs.architecture) {
+        case "arm":
+            return "iasmarm" + compilerExtension;
+        }
+    }
+    assemblerPath: FileInfo.joinPaths(toolchainInstallPath, assemblerName)
+
+    linkerName: {
+        switch (qbs.architecture) {
+        case "arm":
+            return "ilinkarm" + compilerExtension;
+        }
+    }
+    linkerPath: FileInfo.joinPaths(toolchainInstallPath, linkerName)
+
+    property string archiverName: {
+        switch (qbs.architecture) {
+        case "arm":
+            return "iarchive" + compilerExtension;
+        }
+    }
+    property string archiverPath: FileInfo.joinPaths(toolchainInstallPath, archiverName)
+
+    runtimeLibrary: "static"
+    staticLibrarySuffix: ".a"
+    executableSuffix: ".out"
+    imageFormat: "elf"
+    enableExceptions: false
+    enableRtti: false
+
+    Rule {
+        id: assembler
+        inputs: ["asm"]
+
+        Artifact {
+            fileTags: ["obj"]
+            filePath: Utilities.getHash(input.baseDir) + "/" + input.fileName + ".o"
+        }
+
+        prepare: IAR.prepareAssembler.apply(IAR, arguments);
+    }
+
+    FileTagger {
+        patterns: "*.s"
+        fileTags: ["asm"]
+    }
+
+    Rule {
+        id: compiler
+        inputs: ["cpp", "c"]
+        auxiliaryInputs: ["hpp"]
+
+        Artifact {
+            fileTags: ["obj"]
+            filePath: Utilities.getHash(input.baseDir) + "/" + input.fileName + ".o"
+        }
+
+        prepare: IAR.prepareCompiler.apply(IAR, arguments);
+    }
+
+    Rule {
+        id: applicationLinker
+        multiplex: true
+        inputs: ["obj", "linkerscript"]
+
+        outputFileTags: {
+            var tags = ["application"];
+            if (product.moduleProperty("cpp", "generateMapFile"))
+                tags.push("map_file");
+            return tags;
+        }
+        outputArtifacts: {
+            var app = {
+                fileTags: ["application"],
+                filePath: FileInfo.joinPaths(
+                              product.destinationDirectory,
+                              PathTools.applicationFilePath(product))
+            };
+            var artifacts = [app];
+            if (product.cpp.generateMapFile) {
+                artifacts.push({
+                    fileTags: ["map_file"],
+                filePath: FileInfo.joinPaths(
+                              product.destinationDirectory,
+                              product.targetName + ".map")
+                });
+            }
+            return artifacts;
+        }
+
+        prepare:IAR.prepareLinker.apply(IAR, arguments);
+    }
+
+    Rule {
+        id: staticLibraryLinker
+        multiplex: true
+        inputs: ["obj"]
+
+        Artifact {
+            fileTags: ["staticlibrary"]
+            filePath: FileInfo.joinPaths(
+                            product.destinationDirectory,
+                            PathTools.staticLibraryFilePath(product))
+        }
+
+        prepare: IAR.prepareArchiver.apply(IAR, arguments);
+    }
+}