bare-metal: Add KEIL 8051 toolchain support for Windows

This commit adds a basic support of the KEIL toolchain for the
8051 processors family.

The KEIL toolchain support only the Windows environment:
* http://www.keil.com/support/docs/1456.htm

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

* Key: qbs.toolchainType
* Value: keil

Tested with the KEIL uVision v5.23 on Windows using the Cypress FX2
development kit examples.

Change-Id: I2cf59b307762ab95c69bc22eb8989af9b68cd555
Reviewed-by: Christian Kandeler <christian.kandeler@qt.io>

1 files changed, 227 insertions, 0 deletions

diff --git a/share/qbs/modules/cpp/keil.qbs b/share/qbs/modules/cpp/keil.qbs
new file mode 100644
index 000000000..371d0535d
--- /dev/null
+++ b/share/qbs/modules/cpp/keil.qbs
@@ -0,0 +1,227 @@
+/****************************************************************************
+**
+** 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.
+**
+****************************************************************************/
+
+import qbs 1.0
+import qbs.File
+import qbs.FileInfo
+import qbs.ModUtils
+import qbs.PathTools
+import qbs.Probes
+import qbs.Utilities
+import "keil.js" as KEIL
+
+CppModule {
+    condition: qbs.hostOS.contains("windows") && qbs.toolchain && qbs.toolchain.contains("keil")
+
+    Probes.BinaryProbe {
+        id: compilerPathProbe
+        condition: !toolchainInstallPath && !_skipAllChecks
+        names: ["c51"]
+    }
+
+    Probes.KeilProbe {
+        id: keilProbe
+        condition: !_skipAllChecks
+        compilerFilePath: compilerPath
+    }
+
+    qbs.architecture: keilProbe.found ? keilProbe.architecture : original
+
+    compilerVersionMajor: keilProbe.versionMajor
+    compilerVersionMinor: keilProbe.versionMinor
+    compilerVersionPatch: keilProbe.versionPatch
+    endianness: keilProbe.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 "mcs51":
+            return "c51" + compilerExtension;
+        }
+    }
+    compilerPath: FileInfo.joinPaths(toolchainInstallPath, compilerName)
+
+    assemblerName: {
+        switch (qbs.architecture) {
+        case "mcs51":
+            return "a51" + compilerExtension;
+        }
+    }
+    assemblerPath: FileInfo.joinPaths(toolchainInstallPath, assemblerName)
+
+    linkerName: {
+        switch (qbs.architecture) {
+        case "mcs51":
+            return "bl51" + compilerExtension;
+        }
+    }
+    linkerPath: FileInfo.joinPaths(toolchainInstallPath, linkerName)
+
+    property string archiverName: {
+        switch (qbs.architecture) {
+        case "mcs51":
+            return "lib51" + compilerExtension;
+        }
+    }
+    property string archiverPath: FileInfo.joinPaths(toolchainInstallPath, archiverName)
+
+    runtimeLibrary: "static"
+
+    staticLibrarySuffix: {
+        switch (qbs.architecture) {
+        case "mcs51":
+            return ".lib";
+        }
+    }
+
+    executableSuffix: {
+        switch (qbs.architecture) {
+        case "mcs51":
+            return ".abs";
+        }
+    }
+
+    property string objectSuffix: {
+        switch (qbs.architecture) {
+        case "mcs51":
+            return ".obj";
+        }
+    }
+
+    imageFormat: {
+        switch (qbs.architecture) {
+        case "mcs51":
+            // Keil OMF51 or OMF2 Object Module Format (which is an
+            // extension of the original Intel OMF51).
+            return "omf";
+        }
+    }
+
+    enableExceptions: false
+    enableRtti: false
+
+    Rule {
+        id: assembler
+        inputs: ["asm"]
+
+        Artifact {
+            fileTags: ["obj"]
+            filePath: Utilities.getHash(input.baseDir) + "/"
+                      + input.fileName + input.cpp.objectSuffix
+        }
+
+        prepare: KEIL.prepareAssembler.apply(KEIL, arguments);
+    }
+
+    FileTagger {
+        condition: qbs.architecture === "mcs51";
+        patterns: ["*.a51", "*.A51"]
+        fileTags: ["asm"]
+    }
+
+    Rule {
+        id: compiler
+        inputs: ["cpp", "c"]
+        auxiliaryInputs: ["hpp"]
+
+        Artifact {
+            fileTags: ["obj"]
+            filePath: Utilities.getHash(input.baseDir) + "/"
+                      + input.fileName + input.cpp.objectSuffix
+        }
+
+        prepare: KEIL.prepareCompiler.apply(KEIL, 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:KEIL.prepareLinker.apply(KEIL, arguments);
+    }
+
+    Rule {
+        id: staticLibraryLinker
+        multiplex: true
+        inputs: ["obj"]
+        inputsFromDependencies: ["staticlibrary"]
+
+        Artifact {
+            fileTags: ["staticlibrary"]
+            filePath: FileInfo.joinPaths(
+                            product.destinationDirectory,
+                            PathTools.staticLibraryFilePath(product))
+        }
+
+        prepare: KEIL.prepareArchiver.apply(KEIL, arguments);
+    }
+}