[stm32variant] Add generic_clock.c generation

Signed-off-by: Frederic Pillon <frederic.pillon@st.com>

Author: fpistm

.gitignore

@@ -4,6 +4,7 @@ boards.local.txt
 platform.local.txt
 path_config.json
 update_config.json
+variant_config.json
 
 # Backup
 *.bak
@@ -34,4 +35,4 @@ __pycache__/
 !.vscode/tasks.json
 !.vscode/launch.json
 !.vscode/extensions.json
-*.code-workspace
+*.code-workspace

CI/utils/stm32variant.py

@@ -1393,6 +1393,16 @@ def print_boards_entry():
     return generic_list
 
 
+def print_general_clock(generic_list):
+    generic_clock_template = j2_env.get_template(generic_clock_filename)
+    generic_clock_file.write(
+        generic_clock_template.render(
+            year=datetime.datetime.now().year,
+            generic_list=generic_list,
+        )
+    )
+
+
 # List management
 tokenize = re.compile(r"(\d+)|(\D+)").findall
 
@@ -1721,6 +1731,7 @@ def manage_repo():
 variant_h_filename = "variant.h"
 variant_cpp_filename = "variant.cpp"
 boards_entry_filename = "boards_entry.txt"
+generic_clock_filename = "generic_clock.c"
 repo_local_path = cur_dir / "repo"
 cubemxdir = ""
 gh_url = "https://github.com/STMicroelectronics/STM32_open_pin_data"
@@ -1734,7 +1745,13 @@ def manage_repo():
 parser = argparse.ArgumentParser(
     description=textwrap.dedent(
         """\
-By default, generate {}, {}, {}, {} and {}
+By default, generates:
+ - {},
+ - {},
+ - {},
+ - {},
+ - {}
+ - {}
 for all xml files description available in STM32CubeMX internal database.
 Internal database path must be defined in {}.
 It can be the one from STM32CubeMX directory if defined:
@@ -1748,6 +1765,7 @@ def manage_repo():
             variant_cpp_filename,
             variant_h_filename,
             boards_entry_filename,
+            generic_clock_filename,
             config_filename,
             cubemxdir,
             gh_url,
@@ -1774,15 +1792,10 @@ def manage_repo():
     metavar="xml",
     help=textwrap.dedent(
         """\
-Generate {}, {}, {} and {}
-for specified mcu xml file description in database.
+Generate all files for specified mcu xml file description in database.
 This xml file can contain non alpha characters in its name,
-you should call it with double quotes""".format(
-            periph_c_filename,
-            pinvar_h_filename,
-            variant_cpp_filename,
-            variant_h_filename,
-        )
+you should call it with double quotes.
+"""
     ),
 )
 
@@ -1902,6 +1915,7 @@ def manage_repo():
     variant_cpp_filepath = out_temp_path / variant_cpp_filename
     variant_h_filepath = out_temp_path / variant_h_filename
     boards_entry_filepath = out_temp_path / boards_entry_filename
+    generic_clock_filepath = out_temp_path / generic_clock_filename
     out_temp_path.mkdir(parents=True, exist_ok=True)
 
     # open output file
@@ -1910,12 +1924,13 @@ def manage_repo():
     variant_cpp_file = open(variant_cpp_filepath, "w", newline="\n")
     variant_h_file = open(variant_h_filepath, "w", newline="\n")
     boards_entry_file = open(boards_entry_filepath, "w", newline="\n")
-
+    generic_clock_file = open(generic_clock_filepath, "w", newline="\n")
     parse_pins()
     sort_my_lists()
     manage_alternate()
 
     generic_list = print_boards_entry()
+    print_general_clock(generic_list)
     print_peripheral()
     print_pinamevar()
     print_variant(generic_list)
@@ -1942,6 +1957,7 @@ def manage_repo():
     variant_h_file.close()
     variant_cpp_file.close()
     boards_entry_file.close()
+    generic_clock_file.close()
     xml_mcu.unlink()
     xml_gpio.unlink()
 
@@ -2089,7 +2105,7 @@ def manage_repo():
                     new_line_c += " || {}".format(pre)
                     new_line_h += " && !{}".format(pre)
             update_file(mcu_dir / variant_cpp_filename, update_regex, new_line_c)
-
+            update_file(mcu_dir / generic_clock_filename, update_regex, new_line_c)
             update_file(mcu_dir / variant_h_filename, update_regex, new_line_h)
 
             # Appending to board_entry file
@@ -2104,8 +2120,12 @@ def manage_repo():
 
         # Move to variants/ folder
         out_path = out_family_path / mcu_dir.stem
+        generic_clock_filepath = out_path / generic_clock_filename
         out_path.mkdir(parents=True, exist_ok=True)
         for fname in mcu_dir.glob("*.*"):
-            fname.replace(out_path / fname.name)
+            if fname.name == generic_clock_filename and generic_clock_filepath.exists():
+                fname.unlink()
+            else:
+                fname.replace(out_path / fname.name)
 # Clean temporary dir
 rm_tree(tmp_dir)

CI/utils/templates/generic_clock.c

@@ -0,0 +1,29 @@
+/*
+ *******************************************************************************
+ * Copyright (c) 2020-{{year}}, STMicroelectronics
+ * All rights reserved.
+ *
+ * This software component is licensed by ST under BSD 3-Clause license,
+ * the "License"; You may not use this file except in compliance with the
+ * License. You may obtain a copy of the License at:
+ *                        opensource.org/licenses/BSD-3-Clause
+ *
+ *******************************************************************************
+ */
+#if defined(ARDUINO_GENERIC_{{generic_list[0].board}}){% for name in generic_list[1:] %} || defined(ARDUINO_GENERIC_{{name.board}}){% endfor %}
+
+#include "pins_arduino.h"
+
+/**
+  * @brief  System Clock Configuration
+  * @param  None
+  * @retval None
+  */
+WEAK void SystemClock_Config(void)
+{
+  /* SystemClock_Config can be generated by STM32CubeMX */
+#warning "SystemClock_Config() is empty. Default clock at reset is used."
+}
+
+#endif /* ARDUINO_GENERIC_* */
+