Vendor version override (#14189)

Co-Authored-By: InsanityAutomation <insanityautomation@users.noreply.github.com>

buildroot/bin/generate_version

@@ -2,10 +2,10 @@
 #
 # generate_version
 #
-# Make a _Version.h file
+# Make a Version.h file to accompany CUSTOM_VERSION_FILE
 #
 
-DIR=${1:-"Marlin/src/inc"}
+DIR=${1:-"Marlin"}
 
 # MRCC3=$( git merge-base HEAD upstream/bugfix-2.0.x 2>/dev/null )
 # MRCC2=$( git merge-base HEAD upstream/bugfix-1.1.x 2>/dev/null )
@@ -44,7 +44,30 @@ SOURCE_CODE_URL=$(awk -F'"' \
 WEBSITE_URL=$(awk -F'"' \
   '/#define WEBSITE_URL/{ print $2 }' < "${DIR}/Version.h")
 
-cat > "${DIR}/_Version.h" <<EOF
+cat > "${DIR}/Version.h" <<EOF
+/**
+ * Marlin 3D Printer Firmware
+ * Copyright (c) 2019 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
+ *
+ * Based on Sprinter and grbl.
+ * Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+#pragma once
+
 /**
  * THIS FILE IS AUTOMATICALLY GENERATED DO NOT MANUALLY EDIT IT.
  * IT DOES NOT GET COMMITTED TO THE REPOSITORY.
@@ -53,15 +76,69 @@ cat > "${DIR}/_Version.h" <<EOF
  * Version: ${VERSION}
  */
 
-#define BUILD_UNIX_DATETIME "${BUILDATE}"
-#define STRING_DISTRIBUTION_DATE "${DISTDATE}"
+/**
+  * Marlin release version identifier
+  */
+#ifndef SHORT_BUILD_VERSION
+  #define SHORT_BUILD_VERSION "${SHORT_BUILD_VERSION}"
+#endif
 
-#define SHORT_BUILD_VERSION "${SHORT_BUILD_VERSION}"
-#define DETAILED_BUILD_VERSION "${DETAILED_BUILD_VERSION}"
+/**
+  * Verbose version identifier which should contain a reference to the location
+  * from where the binary was downloaded or the source code was compiled.
+  */
+#ifndef DETAILED_BUILD_VERSION
+  #define DETAILED_BUILD_VERSION "${DETAILED_BUILD_VERSION}"
+#endif
+
+/**
+  * The STRING_DISTRIBUTION_DATE represents when the binary file was built,
+  * here we define this default string as the date where the latest release
+  * version was tagged.
+  */
+#ifndef STRING_DISTRIBUTION_DATE
+  #define STRING_DISTRIBUTION_DATE "${DISTDATE}"
+#endif
+
+/**
+  * The protocol for communication to the host. Protocol indicates communication
+  * standards such as the use of ASCII, "echo:" and "error:" line prefixes, etc.
+  * (Other behaviors are given by the firmware version and capabilities report.)
+  */
+#ifndef PROTOCOL_VERSION
+  #define PROTOCOL_VERSION "${PROTOCOL_VERSION}"
+#endif
+
+/**
+  * Defines a generic printer name to be output to the LCD after booting Marlin.
+  */
+#ifndef MACHINE_NAME
+  #define MACHINE_NAME "${MACHINE_NAME}"
+#endif
+
+/**
+  * The SOURCE_CODE_URL is the location where users will find the Marlin Source
+  * Code which is installed on the device. In most cases —unless the manufacturer
+  * has a distinct Github fork— the Source Code URL should just be the main
+  * Marlin repository.
+  */
+#ifndef SOURCE_CODE_URL
+  #define SOURCE_CODE_URL "${SOURCE_CODE_URL}"
+#endif
+
+/**
+  * Default generic printer UUID.
+  */
+#ifndef DEFAULT_MACHINE_UUID
+  #define DEFAULT_MACHINE_UUID "${DEFAULT_MACHINE_UUID}"
+#endif
+
+/**
+  * The WEBSITE_URL is the location where users can get more information such as
+  * documentation about a specific Marlin release.
+  */
+#ifndef WEBSITE_URL
+  #define WEBSITE_URL "${WEBSITE_URL}"
+#endif
 
-#define PROTOCOL_VERSION "${PROTOCOL_VERSION}"
-#define MACHINE_NAME "${MACHINE_NAME}"
-#define SOURCE_CODE_URL "${SOURCE_CODE_URL}"
-#define DEFAULT_MACHINE_UUID "${DEFAULT_MACHINE_UUID}"
-#define WEBSITE_URL "${WEBSITE_URL}"
 EOF