clang-format implementation (#1740)

* Testing clang-format style check using github CI

* github/push: implement check-style for clang-format as a separate build step

* github/push: add missing packages for check-style/clang-format build step

* source/Makefile: check-style - reduce files of interest; update .clang-format to keep enums init

* source/Makefile: empty lines, spaces & tabs refactoring to unify style - part 1 out of N

* source/Makefile: fix formatting for multi-line variables

* source/Makefile: update formatting for multi-line variables

* source/Makefile: remove spaces on vars assignments to unify style

* source/Makefile: remove unused target style

* source/Makefile: implement exclude vars for clang-format related files

* source/Makefile: exclude configuration.h from clang-format check

* Dockerfile: add diffutils in a container to make check-style target using advanced version of diff to get more advanced output to parse & navigate log more easily

* source/Makefile: implement parser for clang-format inside check-style target to make output compatible with gcc-like error compilation format for compatibility with IDEs/editors for easy navigation over files to fix style errors

* source/Makefile: probably final touches on unifying style

* source/Makefile: implement check-style-list target to only list affected file names with wrong code style for debug purposes

* source/Makefile: fix missed spaces

* deploy.sh: add helper routine to deal with clang-format error output logging from makefile

* gitignore: add clang-format log explicitly

* Refactoring for clang-format compiance

* Dockerfile: add sed

* Dockerfile: false alarm - remove sed since busybox-sed seems fine

* source/Makefile: reduce calls of clang-format & make error log more clean, clear, and tidy

* deploy.sh:check_style() - add removal of DOS EOLs for generated log

* source/Makefile:check-style: add more empty lines between blocks with errors for readability when suggestion is too long & heavy

* source/Makefile: add STOP var to check-style for exit on first failed file

* source/Makefile: check-style: make log looks more like traditional diff/patch output

* source/Core/BSP/Pinecilv2/MemMang/heap_5.c: clang-format refactoring using reasonable advises ... and then disable it in Makefile from scanning by clang-format

* Return headers include order

* clang-format config: disable warnings about non-alphabetic include order

* clang-format refactoring

* clang-format refactoring, part 2

* clang-format refactoring, part 3

* settingsGUI.cpp: refactoring, part 1

* settingsGUI.cpp: refactoring, part 2

* settingsGUI.cpp: refactoring, part 3

* settingsGUI.cpp: refactoring, part 4

* clang-format should be happy now

* workflows/push: put readme check into separate build step & update style

* clang-format: giving SortIncludes option second chance by tweaking a couple of headers a bit

* source/Makefile: check-style: add homebrew parser to check for { } in conditional blocks

* homebrew-format: add { } for if/else, while, and for & unify some comments style; left two errors intentionally to debug & improve parser

* source/Makefile: homebrew-format: fix false negative trigger for multi-line condition in if-s

* Sleep.cpp: unify style & comments

* source/Makefile: remove unused debug target

source/Core/Src/QC3.cpp

@@ -11,29 +11,34 @@
 #include "cmsis_os.h"
 #include "configuration.h"
 #include "stdint.h"
+
 enum QCState {
   NOT_STARTED = 0, // Have not checked
   QC_3        = 1,
   QC_2        = 2,
   NO_QC       = 3,
-
 };
+
 void QC_Seek9V() {
   QC_DNegZero_Six();
   QC_DPlusThree_Three();
 }
+
 void QC_Seek12V() {
   QC_DNegZero_Six();
   QC_DPlusZero_Six();
 }
+
 void QC_Seek20V() {
   QC_DNegThree_Three();
   QC_DPlusThree_Three();
 }
+
 void QC_SeekContMode() {
   QC_DNegThree_Three();
   QC_DPlusZero_Six();
 }
+
 void QC_SeekContPlus() {
   QC_SeekContMode();
   osDelay(30);
@@ -41,6 +46,7 @@ void QC_SeekContPlus() {
   osDelay(10);
   QC_SeekContMode();
 }
+
 void QC_SeekContNeg() {
   QC_SeekContMode();
   osDelay(30);
@@ -48,17 +54,21 @@ void QC_SeekContNeg() {
   osDelay(10);
   QC_SeekContMode();
 }
+
 QCState QCMode  = QCState::NOT_STARTED;
 uint8_t QCTries = 0;
 void    seekQC(int16_t Vx10, uint16_t divisor) {
-  if (QCMode == QCState::NOT_STARTED)
+  if (QCMode == QCState::NOT_STARTED) {
     startQC(divisor);
+  }
 
-  if (Vx10 < 40) // Bail out if less than 4V
+  if (Vx10 < 40) { // Bail out if less than 4V
     return;
+  }
 
-  if (xTaskGetTickCount() < TICKS_SECOND)
+  if (xTaskGetTickCount() < TICKS_SECOND) {
     return;
+  }
 
   // Seek the QC to the Voltage given if this adapter supports continuous mode
   // try and step towards the wanted value
@@ -87,8 +97,9 @@ void    seekQC(int16_t Vx10, uint16_t divisor) {
   // Re-measure
   /* Disabled due to nothing to test and code space of around 1k*/
   steps = vStart - getInputVoltageX10(divisor, 0);
-  if (steps < 0)
+  if (steps < 0) {
     steps = -steps;
+  }
   if (steps > 4) {
     // No continuous mode, so QC2
     QCMode = QCState::QC_2;
@@ -104,8 +115,9 @@ void    seekQC(int16_t Vx10, uint16_t divisor) {
       QC_Seek9V();
     }
   }
-#endif
+#endif /* ENABLE_QC2 */
 }
+
 // Must be called after FreeRToS Starts
 void startQC(uint16_t divisor) {
   // Pre check that the input could be >5V already, and if so, dont both
@@ -143,7 +155,9 @@ void startQC(uint16_t divisor) {
       }
     }
   }
+
   QC_DM_No_PullDown();
+
   if (enteredQC) {
     // We have a QC capable charger
     QC_Seek9V();
@@ -161,7 +175,6 @@ void startQC(uint16_t divisor) {
     }
     QCMode = QCState::NOT_STARTED;
     QCTries++;
-
   } else {
     // no QC
     QCTries++;