feat(autobackup): Automatically backup FC parameters before the first usage of the AMC software

Only backs up the parameters if a backup file does not exist and
only if AMC has not yet been used to write parameters to the FC

Author: amilcarlucas

ARCHITECTURE.md

@@ -106,6 +106,8 @@ the following system design requirements were derived:
   - Non-default, read-only *reason changed* annotated parameters in, `non-default_read-only.param` file
   - Non-default, writable calibrations *reason changed* annotated parameters in `non-default_writable_calibrations.param` file
   - Non-default, writable non-calibrations *reason changed* annotated parameters in `non-default_writable_non-calibrations.param` file
+- automatically create a parameter backup before the first usage of the software to change parameters [PR #173](https://github.com/ArduPilot/MethodicConfigurator/pull/173)
+  - Only backs up the parameters if a backup file does not exist and only if AMC has not yet been used to write parameters to the FC
 
 #### 7. Customization and Extensibility
 

ardupilot_methodic_configurator/__main__.py

@@ -191,6 +191,14 @@ def main() -> None:
     imu_tcal_available = "INS_TCAL1_ENABLE" in flight_controller.fc_parameters or not flight_controller.fc_parameters
     start_file = local_filesystem.get_start_file(args.n, imu_tcal_available)
 
+    if flight_controller.fc_parameters:
+        local_filesystem.backup_fc_parameters_to_file(
+            flight_controller.fc_parameters,
+            "autobackup_00_before_ardupilot_methodic_configurator.param",
+            overwrite_existing_file=False,
+            even_if_last_uploaded_filename_exists=False,
+        )
+
     # Call the GUI function with the starting intermediate parameter file
     ParameterEditorWindow(start_file, flight_controller, local_filesystem)
 

ardupilot_methodic_configurator/backend_filesystem.py

@@ -575,6 +575,21 @@ def get_start_file(self, explicit_index: int, tcal_available: bool) -> str:
             start_file_index = len(files) - 1
         return files[start_file_index]
 
+    def backup_fc_parameters_to_file(
+        self,
+        param_dict: dict[str, float],
+        filename: str,
+        overwrite_existing_file: bool = False,
+        even_if_last_uploaded_filename_exists: bool = True,
+    ) -> None:
+        if (even_if_last_uploaded_filename_exists or not self.__read_last_uploaded_filename()) and (
+            overwrite_existing_file or not self.vehicle_configuration_file_exists(filename)
+        ):
+            Par.export_to_param(
+                Par.format_params({param: Par(float(value), "") for param, value in param_dict.items()}),
+                os_path.join(self.vehicle_dir, filename),
+            )
+
     def get_eval_variables(self) -> dict[str, dict[str, Any]]:
         variables = {}
         if hasattr(self, "vehicle_components") and self.vehicle_components and "Components" in self.vehicle_components: