Update descriptions and dont call unneeded functions

6 years ago · eb91f08725
94 changed files with 385 additions and 117 deletions
--- a/Marlin/Configuration.h
+++ b/Marlin/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/Marlin/src/feature/bltouch.cpp
+++ b/Marlin/src/feature/bltouch.cpp
@ -70,19 +70,23 @@ bool BLTouch::set_deployed(const bool in_deploy) {
    }
  }

-  #if ENABLED(BLTOUCH_FORCE_5V_MODE)
-    set_5V_mode();
-  #elif ENABLED(BLTOUCH_FORCE_OPEN_DRAIN_MODE)
-    set_OD_mode();
-  #elif ENABLED(ENDSTOPPULLUPS) || ALL(Z_MIN_PROBE_USES_Z_MIN_ENDSTOP_PIN, ENDSTOPPULLUP_ZMIN) || (USES_Z_MIN_PROBE_ENDSTOP && ENABLED(ENDSTOPPULLUP_ZMIN_PROBE))
-    set_5V_mode();                  // Assume 5V DC logic level if endstop pullup resistors are enabled
-  #else
-    set_OD_mode();
+  #if ENABLED(BLTOUCH_V3)
+    #if ENABLED(BLTOUCH_FORCE_5V_MODE)
+      set_5V_mode();
+    #elif ENABLED(BLTOUCH_FORCE_OPEN_DRAIN_MODE)
+      set_OD_mode();
+    #elif ENABLED(ENDSTOPPULLUPS) || ALL(Z_MIN_PROBE_USES_Z_MIN_ENDSTOP_PIN, ENDSTOPPULLUP_ZMIN) || (USES_Z_MIN_PROBE_ENDSTOP && ENABLED(ENDSTOPPULLUP_ZMIN_PROBE))
+      set_5V_mode();                  // Assume 5V DC logic level if endstop pullup resistors are enabled
+    #else
+      set_OD_mode();
+    #endif
  #endif
-
  if (in_deploy) {
    _deploy();
-    set_SW_mode();                  // Ensure Switch mode is activated for BLTouch V3. Ignored on V2.
+    
+    #if ENABLED(BLTOUCH_V3)
+      set_SW_mode();
+    #endif
  }
  else _stow();

--- a/Marlin/src/feature/bltouch.h
+++ b/Marlin/src/feature/bltouch.h
@ -43,21 +43,9 @@ public:
  FORCE_INLINE static void reset()       { command(BLTOUCH_RESET); }
  FORCE_INLINE static void selftest()    { command(BLTOUCH_SELFTEST); }

-  FORCE_INLINE static void set_5V_mode() { 
-    #if ENABLED(BLTOUCH_V3)
-      command(BLTOUCH_5V_MODE);
-    #endif
-  }
-  FORCE_INLINE static void set_OD_mode() {
-    #if ENABLED(BLTOUCH_V3)
-      command(BLTOUCH_OD_MODE);
-    #endif
-  }
-  FORCE_INLINE static void set_SW_mode() {
-    #if ENABLED(BLTOUCH_V3)
-      command(BLTOUCH_SW_MODE);
-    #endif
-  }
+  FORCE_INLINE static void set_5V_mode() { command(BLTOUCH_5V_MODE); }
+  FORCE_INLINE static void set_OD_mode() { command(BLTOUCH_OD_MODE); }
+  FORCE_INLINE static void set_SW_mode() { command(BLTOUCH_SW_MODE); }

  FORCE_INLINE static bool deploy()      { return set_deployed(true); }
  FORCE_INLINE static bool stow()        { return set_deployed(false); }
--- a/config/default/Configuration.h
+++ b/config/default/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/3DFabXYZ/Migbot/Configuration.h
+++ b/config/examples/3DFabXYZ/Migbot/Configuration.h
@ -824,7 +824,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/AlephObjects/TAZ4/Configuration.h
+++ b/config/examples/AlephObjects/TAZ4/Configuration.h
@ -838,7 +838,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/AliExpress/CL-260/Configuration.h
+++ b/config/examples/AliExpress/CL-260/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/AliExpress/UM2pExt/Configuration.h
+++ b/config/examples/AliExpress/UM2pExt/Configuration.h
@ -829,7 +829,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Anet/A2/Configuration.h
+++ b/config/examples/Anet/A2/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Anet/A2plus/Configuration.h
+++ b/config/examples/Anet/A2plus/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Anet/A6/Configuration.h
+++ b/config/examples/Anet/A6/Configuration.h
@ -865,7 +865,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Anet/A8/Configuration.h
+++ b/config/examples/Anet/A8/Configuration.h
@ -831,7 +831,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/AnyCubic/i3/Configuration.h
+++ b/config/examples/AnyCubic/i3/Configuration.h
@ -828,7 +828,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/ArmEd/Configuration.h
+++ b/config/examples/ArmEd/Configuration.h
@ -819,7 +819,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Azteeg/X5GT/Configuration.h
+++ b/config/examples/Azteeg/X5GT/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/BIBO/TouchX/cyclops/Configuration.h
+++ b/config/examples/BIBO/TouchX/cyclops/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/BIBO/TouchX/default/Configuration.h
+++ b/config/examples/BIBO/TouchX/default/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/BQ/Hephestos/Configuration.h
+++ b/config/examples/BQ/Hephestos/Configuration.h
@ -806,7 +806,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/BQ/Hephestos_2/Configuration.h
+++ b/config/examples/BQ/Hephestos_2/Configuration.h
@ -819,7 +819,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/BQ/WITBOX/Configuration.h
+++ b/config/examples/BQ/WITBOX/Configuration.h
@ -806,7 +806,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Cartesio/Configuration.h
+++ b/config/examples/Cartesio/Configuration.h
@ -817,7 +817,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Creality/CR-10/Configuration.h
+++ b/config/examples/Creality/CR-10/Configuration.h
@ -828,7 +828,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Creality/CR-10S/Configuration.h
+++ b/config/examples/Creality/CR-10S/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Creality/CR-10_5S/Configuration.h
+++ b/config/examples/Creality/CR-10_5S/Configuration.h
@ -819,7 +819,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Creality/CR-10mini/Configuration.h
+++ b/config/examples/Creality/CR-10mini/Configuration.h
@ -837,7 +837,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Creality/CR-8/Configuration.h
+++ b/config/examples/Creality/CR-8/Configuration.h
@ -828,7 +828,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Creality/Ender-2/Configuration.h
+++ b/config/examples/Creality/Ender-2/Configuration.h
@ -822,7 +822,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Creality/Ender-3/Configuration.h
+++ b/config/examples/Creality/Ender-3/Configuration.h
@ -822,7 +822,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Creality/Ender-4/Configuration.h
+++ b/config/examples/Creality/Ender-4/Configuration.h
@ -828,7 +828,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Einstart-S/Configuration.h
+++ b/config/examples/Einstart-S/Configuration.h
@ -829,7 +829,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Felix/Configuration.h
+++ b/config/examples/Felix/Configuration.h
@ -800,7 +800,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Felix/DUAL/Configuration.h
+++ b/config/examples/Felix/DUAL/Configuration.h
@ -800,7 +800,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/FlashForge/CreatorPro/Configuration.h
+++ b/config/examples/FlashForge/CreatorPro/Configuration.h
@ -810,7 +810,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/FolgerTech/i3-2020/Configuration.h
+++ b/config/examples/FolgerTech/i3-2020/Configuration.h
@ -824,7 +824,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Formbot/Raptor/Configuration.h
+++ b/config/examples/Formbot/Raptor/Configuration.h
@ -901,7 +901,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Formbot/T_Rex_2+/Configuration.h
+++ b/config/examples/Formbot/T_Rex_2+/Configuration.h
@ -847,7 +847,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Formbot/T_Rex_3/Configuration.h
+++ b/config/examples/Formbot/T_Rex_3/Configuration.h
@ -834,7 +834,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Geeetech/A10M/Configuration.h
+++ b/config/examples/Geeetech/A10M/Configuration.h
@ -801,7 +801,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Geeetech/A20M/Configuration.h
+++ b/config/examples/Geeetech/A20M/Configuration.h
@ -801,7 +801,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Geeetech/GT2560/Configuration.h
+++ b/config/examples/Geeetech/GT2560/Configuration.h
@ -833,7 +833,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Geeetech/MeCreator2/Configuration.h
+++ b/config/examples/Geeetech/MeCreator2/Configuration.h
@ -825,7 +825,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Geeetech/Prusa
+++ b/config/examples/Geeetech/Prusa
@ -834,7 +834,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Geeetech/Prusa
+++ b/config/examples/Geeetech/Prusa
@ -833,7 +833,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Geeetech/Prusa
+++ b/config/examples/Geeetech/Prusa
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Geeetech/Prusa
+++ b/config/examples/Geeetech/Prusa
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Infitary/i3-M508/Configuration.h
+++ b/config/examples/Infitary/i3-M508/Configuration.h
@ -822,7 +822,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/JGAurora/A5/Configuration.h
+++ b/config/examples/JGAurora/A5/Configuration.h
@ -830,7 +830,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/MakerParts/Configuration.h
+++ b/config/examples/MakerParts/Configuration.h
@ -838,7 +838,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Malyan/M150/Configuration.h
+++ b/config/examples/Malyan/M150/Configuration.h
@ -838,7 +838,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Malyan/M200/Configuration.h
+++ b/config/examples/Malyan/M200/Configuration.h
@ -817,7 +817,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Micromake/C1/basic/Configuration.h
+++ b/config/examples/Micromake/C1/basic/Configuration.h
@ -822,7 +822,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Micromake/C1/enhanced/Configuration.h
+++ b/config/examples/Micromake/C1/enhanced/Configuration.h
@ -822,7 +822,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Mks/Robin/Configuration.h
+++ b/config/examples/Mks/Robin/Configuration.h
@ -819,7 +819,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Mks/Sbase/Configuration.h
+++ b/config/examples/Mks/Sbase/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Printrbot/PrintrboardG2/Configuration.h
+++ b/config/examples/Printrbot/PrintrboardG2/Configuration.h
@ -826,7 +826,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/RapideLite/RL200/Configuration.h
+++ b/config/examples/RapideLite/RL200/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/RepRapPro/Huxley/Configuration.h
+++ b/config/examples/RepRapPro/Huxley/Configuration.h
@ -858,7 +858,10 @@ Black rubber belt(MXL), 18 - tooth aluminium pulley : 87.489 step per mm (Huxley
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/RepRapWorld/Megatronics/Configuration.h
+++ b/config/examples/RepRapWorld/Megatronics/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/RigidBot/Configuration.h
+++ b/config/examples/RigidBot/Configuration.h
@ -816,7 +816,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/SCARA/Configuration.h
+++ b/config/examples/SCARA/Configuration.h
@ -831,7 +831,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/STM32F10/Configuration.h
+++ b/config/examples/STM32F10/Configuration.h
@ -820,7 +820,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/STM32F4/Configuration.h
+++ b/config/examples/STM32F4/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Sanguinololu/Configuration.h
+++ b/config/examples/Sanguinololu/Configuration.h
@ -849,7 +849,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/TheBorg/Configuration.h
+++ b/config/examples/TheBorg/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/TinyBoy2/Configuration.h
+++ b/config/examples/TinyBoy2/Configuration.h
@ -869,7 +869,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Tronxy/X1/Configuration.h
+++ b/config/examples/Tronxy/X1/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Tronxy/X3A/Configuration.h
+++ b/config/examples/Tronxy/X3A/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Tronxy/X5S-2E/Configuration.h
+++ b/config/examples/Tronxy/X5S-2E/Configuration.h
@ -839,7 +839,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Tronxy/X5S/Configuration.h
+++ b/config/examples/Tronxy/X5S/Configuration.h
@ -817,7 +817,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Tronxy/XY100/Configuration.h
+++ b/config/examples/Tronxy/XY100/Configuration.h
@ -829,7 +829,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/UltiMachine/Archim1/Configuration.h
+++ b/config/examples/UltiMachine/Archim1/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/UltiMachine/Archim2/Configuration.h
+++ b/config/examples/UltiMachine/Archim2/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/VORONDesign/Configuration.h
+++ b/config/examples/VORONDesign/Configuration.h
@ -827,7 +827,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Velleman/K8200/Configuration.h
+++ b/config/examples/Velleman/K8200/Configuration.h
@ -847,7 +847,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Velleman/K8400/Configuration.h
+++ b/config/examples/Velleman/K8400/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Velleman/K8400/Dual-head/Configuration.h
+++ b/config/examples/Velleman/K8400/Dual-head/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/WASP/PowerWASP/Configuration.h
+++ b/config/examples/WASP/PowerWASP/Configuration.h
@ -837,7 +837,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/Wanhao/Duplicator
+++ b/config/examples/Wanhao/Duplicator
@ -828,7 +828,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/adafruit/ST7565/Configuration.h
+++ b/config/examples/adafruit/ST7565/Configuration.h
@ -818,7 +818,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/delta/Anycubic/Kossel/Configuration.h
+++ b/config/examples/delta/Anycubic/Kossel/Configuration.h
@ -954,7 +954,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/delta/FLSUN/auto_calibrate/Configuration.h
+++ b/config/examples/delta/FLSUN/auto_calibrate/Configuration.h
@ -900,7 +900,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/delta/FLSUN/kossel/Configuration.h
+++ b/config/examples/delta/FLSUN/kossel/Configuration.h
@ -900,7 +900,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/delta/FLSUN/kossel_mini/Configuration.h
+++ b/config/examples/delta/FLSUN/kossel_mini/Configuration.h
@ -900,7 +900,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/delta/Geeetech/Rostock
+++ b/config/examples/delta/Geeetech/Rostock
@ -890,7 +890,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/delta/Hatchbox_Alpha/Configuration.h
+++ b/config/examples/delta/Hatchbox_Alpha/Configuration.h
@ -905,7 +905,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/delta/MKS/SBASE/Configuration.h
+++ b/config/examples/delta/MKS/SBASE/Configuration.h
@ -890,7 +890,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/delta/generic/Configuration.h
+++ b/config/examples/delta/generic/Configuration.h
@ -890,7 +890,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/delta/kossel_mini/Configuration.h
+++ b/config/examples/delta/kossel_mini/Configuration.h
@ -890,7 +890,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/delta/kossel_pro/Configuration.h
+++ b/config/examples/delta/kossel_pro/Configuration.h
@ -883,7 +883,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/delta/kossel_xl/Configuration.h
+++ b/config/examples/delta/kossel_xl/Configuration.h
@ -893,7 +893,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/makibox/Configuration.h
+++ b/config/examples/makibox/Configuration.h
@ -821,7 +821,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/stm32f103ret6/Configuration.h
+++ b/config/examples/stm32f103ret6/Configuration.h
@ -820,7 +820,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/tvrrug/Round2/Configuration.h
+++ b/config/examples/tvrrug/Round2/Configuration.h
@ -813,7 +813,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE
--- a/config/examples/wt150/Configuration.h
+++ b/config/examples/wt150/Configuration.h
@ -823,7 +823,10 @@
 #if ENABLED(BLTOUCH)
  //#define BLTOUCH_DELAY 375   // (ms) Enable and increase if needed

-  // BLTouch V3.0 and newer smart series
+  /** BLTouch V3.0 and newer smart series
+   *  Functions with most genuine sensors, however clones have been reporting issues with the new code.
+   *  If the pin trigger is not detected, first try swapping black and white wires then toggle this.
+   */
  //#define BLTOUCH_V3
  #if ENABLED(BLTOUCH_V3)
    //#define BLTOUCH_FORCE_5V_MODE