Browse Source

BLTouch V3.1 changes (#14104)

InsanityAutomation 5 years ago
parent
commit
49e83dd7c8
100 changed files with 5802 additions and 589 deletions
  1. 62
    6
      Marlin/Configuration.h
  2. 1
    1
      Marlin/src/Marlin.cpp
  3. 63
    9
      Marlin/src/feature/bltouch.cpp
  4. 7
    2
      Marlin/src/feature/bltouch.h
  5. 2
    2
      Marlin/src/inc/SanityCheck.h
  6. 18
    9
      Marlin/src/lcd/language/language_en.h
  7. 0
    14
      Marlin/src/lcd/menu/menu_advanced.cpp
  8. 26
    3
      Marlin/src/lcd/menu/menu_configuration.cpp
  9. 43
    1
      Marlin/src/module/configuration_store.cpp
  10. 62
    6
      config/default/Configuration.h
  11. 62
    6
      config/examples/3DFabXYZ/Migbot/Configuration.h
  12. 62
    6
      config/examples/AlephObjects/TAZ4/Configuration.h
  13. 62
    6
      config/examples/AliExpress/CL-260/Configuration.h
  14. 62
    6
      config/examples/AliExpress/UM2pExt/Configuration.h
  15. 62
    6
      config/examples/Anet/A2/Configuration.h
  16. 62
    6
      config/examples/Anet/A2plus/Configuration.h
  17. 62
    6
      config/examples/Anet/A6/Configuration.h
  18. 62
    6
      config/examples/Anet/A8/Configuration.h
  19. 62
    6
      config/examples/Anet/A8plus/Configuration.h
  20. 62
    6
      config/examples/Anet/E16/Configuration.h
  21. 62
    6
      config/examples/AnyCubic/i3/Configuration.h
  22. 62
    6
      config/examples/ArmEd/Configuration.h
  23. 62
    6
      config/examples/Azteeg/X5GT/Configuration.h
  24. 62
    6
      config/examples/BIBO/TouchX/cyclops/Configuration.h
  25. 62
    6
      config/examples/BIBO/TouchX/default/Configuration.h
  26. 62
    6
      config/examples/BQ/Hephestos/Configuration.h
  27. 62
    6
      config/examples/BQ/Hephestos_2/Configuration.h
  28. 62
    6
      config/examples/BQ/WITBOX/Configuration.h
  29. 62
    6
      config/examples/Cartesio/Configuration.h
  30. 62
    6
      config/examples/Creality/CR-10/Configuration.h
  31. 62
    6
      config/examples/Creality/CR-10S/Configuration.h
  32. 62
    6
      config/examples/Creality/CR-10_5S/Configuration.h
  33. 62
    6
      config/examples/Creality/CR-10mini/Configuration.h
  34. 62
    6
      config/examples/Creality/CR-8/Configuration.h
  35. 62
    6
      config/examples/Creality/Ender-2/Configuration.h
  36. 62
    6
      config/examples/Creality/Ender-3/Configuration.h
  37. 62
    6
      config/examples/Creality/Ender-4/Configuration.h
  38. 62
    6
      config/examples/Einstart-S/Configuration.h
  39. 62
    6
      config/examples/Felix/Configuration.h
  40. 62
    6
      config/examples/Felix/DUAL/Configuration.h
  41. 62
    6
      config/examples/FlashForge/CreatorPro/Configuration.h
  42. 62
    6
      config/examples/FolgerTech/i3-2020/Configuration.h
  43. 62
    6
      config/examples/Formbot/Raptor/Configuration.h
  44. 62
    6
      config/examples/Formbot/T_Rex_2+/Configuration.h
  45. 62
    6
      config/examples/Formbot/T_Rex_3/Configuration.h
  46. 62
    7
      config/examples/Geeetech/A10M/Configuration.h
  47. 62
    7
      config/examples/Geeetech/A20M/Configuration.h
  48. 62
    6
      config/examples/Geeetech/GT2560/Configuration.h
  49. 62
    6
      config/examples/Geeetech/MeCreator2/Configuration.h
  50. 62
    6
      config/examples/Geeetech/Prusa i3 Pro B/bltouch/Configuration.h
  51. 62
    6
      config/examples/Geeetech/Prusa i3 Pro B/noprobe/Configuration.h
  52. 62
    6
      config/examples/Geeetech/Prusa i3 Pro C/Configuration.h
  53. 62
    6
      config/examples/Geeetech/Prusa i3 Pro W/Configuration.h
  54. 62
    6
      config/examples/Infitary/i3-M508/Configuration.h
  55. 62
    6
      config/examples/JGAurora/A5/Configuration.h
  56. 62
    6
      config/examples/MakerParts/Configuration.h
  57. 62
    6
      config/examples/Malyan/M150/Configuration.h
  58. 62
    6
      config/examples/Malyan/M200/Configuration.h
  59. 62
    6
      config/examples/Micromake/C1/basic/Configuration.h
  60. 62
    6
      config/examples/Micromake/C1/enhanced/Configuration.h
  61. 62
    6
      config/examples/Mks/Robin/Configuration.h
  62. 62
    6
      config/examples/Mks/Sbase/Configuration.h
  63. 62
    6
      config/examples/Printrbot/PrintrboardG2/Configuration.h
  64. 62
    6
      config/examples/RapideLite/RL200/Configuration.h
  65. 62
    6
      config/examples/RepRapPro/Huxley/Configuration.h
  66. 62
    6
      config/examples/RepRapWorld/Megatronics/Configuration.h
  67. 62
    6
      config/examples/RigidBot/Configuration.h
  68. 62
    6
      config/examples/SCARA/Configuration.h
  69. 62
    6
      config/examples/STM32/Black_STM32F407VET6/Configuration.h
  70. 62
    6
      config/examples/STM32/STM32F10/Configuration.h
  71. 62
    6
      config/examples/STM32/STM32F4/Configuration.h
  72. 62
    6
      config/examples/STM32/stm32f103ret6/Configuration.h
  73. 62
    6
      config/examples/Sanguinololu/Configuration.h
  74. 62
    6
      config/examples/TheBorg/Configuration.h
  75. 62
    6
      config/examples/TinyBoy2/Configuration.h
  76. 62
    6
      config/examples/Tronxy/X1/Configuration.h
  77. 62
    6
      config/examples/Tronxy/X3A/Configuration.h
  78. 62
    6
      config/examples/Tronxy/X5S-2E/Configuration.h
  79. 62
    6
      config/examples/Tronxy/X5S/Configuration.h
  80. 62
    6
      config/examples/Tronxy/XY100/Configuration.h
  81. 62
    6
      config/examples/UltiMachine/Archim1/Configuration.h
  82. 62
    6
      config/examples/UltiMachine/Archim2/Configuration.h
  83. 62
    6
      config/examples/VORONDesign/Configuration.h
  84. 62
    6
      config/examples/Velleman/K8200/Configuration.h
  85. 62
    6
      config/examples/Velleman/K8400/Configuration.h
  86. 62
    6
      config/examples/Velleman/K8400/Dual-head/Configuration.h
  87. 62
    6
      config/examples/WASP/PowerWASP/Configuration.h
  88. 62
    6
      config/examples/Wanhao/Duplicator 6/Configuration.h
  89. 62
    6
      config/examples/adafruit/ST7565/Configuration.h
  90. 62
    6
      config/examples/delta/Anycubic/Kossel/Configuration.h
  91. 62
    6
      config/examples/delta/FLSUN/auto_calibrate/Configuration.h
  92. 62
    6
      config/examples/delta/FLSUN/kossel/Configuration.h
  93. 62
    6
      config/examples/delta/FLSUN/kossel_mini/Configuration.h
  94. 62
    6
      config/examples/delta/Geeetech/Rostock 301/Configuration.h
  95. 62
    6
      config/examples/delta/Hatchbox_Alpha/Configuration.h
  96. 62
    6
      config/examples/delta/MKS/SBASE/Configuration.h
  97. 62
    6
      config/examples/delta/generic/Configuration.h
  98. 62
    6
      config/examples/delta/kossel_mini/Configuration.h
  99. 62
    6
      config/examples/delta/kossel_pro/Configuration.h
  100. 0
    0
      config/examples/delta/kossel_xl/Configuration.h

+ 62
- 6
Marlin/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 1
- 1
Marlin/src/Marlin.cpp View File

@@ -1058,7 +1058,7 @@ void setup() {
1058 1058
   #endif
1059 1059
 
1060 1060
   #if ENABLED(BLTOUCH)
1061
-    bltouch.init();
1061
+    bltouch.init(/*set_voltage=*/true);
1062 1062
   #endif
1063 1063
 
1064 1064
   #if ENABLED(I2C_POSITION_ENCODERS)

+ 63
- 9
Marlin/src/feature/bltouch.cpp View File

@@ -28,6 +28,8 @@
28 28
 
29 29
 BLTouch bltouch;
30 30
 
31
+bool BLTouch::last_written_mode; // Initialized by settings.load, 0 = Open Drain; 1 = 5V Drain
32
+
31 33
 #include "../module/servo.h"
32 34
 
33 35
 void stop();
@@ -38,21 +40,53 @@ void stop();
38 40
 bool BLTouch::command(const BLTCommand cmd, const millis_t &ms) {
39 41
   if (DEBUGGING(LEVELING)) SERIAL_ECHOLNPAIR("BLTouch Command :", cmd);
40 42
   MOVE_SERVO(Z_PROBE_SERVO_NR, cmd);
41
-  safe_delay(MAX(ms, BLTOUCH_DELAY)); // BLTOUCH_DELAY is also the *minimum* delay
43
+  safe_delay(MAX(ms, (uint32_t)BLTOUCH_DELAY)); // BLTOUCH_DELAY is also the *minimum* delay
42 44
   return triggered();
43 45
 }
44 46
 
45
-void BLTouch::init() {
46
-  // This is called by marlin.cpp on initialization
47
-  // SET_5V_MODE (if enabled). OD_MODE is the default on power on.
48
-  // This mode will stay active until manual SET_OD_MODE or power cycle
49
-  #if ENABLED(BLTOUCH_FORCE_5V_MODE)
50
-    _set_5V_mode();                          // Set 5V mode if explicitely demanded (V3 upwards)
47
+// Init the class and device. Call from setup().
48
+void BLTouch::init(const bool set_voltage/*=false*/) {
49
+  // Voltage Setting (if enabled). At every Marlin initialization:
50
+  // BLTOUCH < V3.0 and clones: This will be ignored by the probe
51
+  // BLTOUCH V3.0: SET_5V_MODE or SET_OD_MODE (if enabled).
52
+  //               OD_MODE is the default on power on, but setting it does not hurt
53
+  //               This mode will stay active until manual SET_OD_MODE or power cycle
54
+  // BLTOUCH V3.1: SET_5V_MODE or SET_OD_MODE (if enabled).
55
+  //               At power on, the probe will default to the eeprom settings configured by the user
56
+  #if ENABLED(BLTOUCH_FORCE_MODE_SET)
57
+
58
+    constexpr bool should_set = true;
59
+
60
+  #else
61
+
62
+    if (DEBUGGING(LEVELING)) {
63
+      DEBUG_ECHOLNPAIR("last_written_mode - ", (int)last_written_mode);
64
+      DEBUG_ECHOLNPGM("config mode - "
65
+        #if ENABLED(BLTOUCH_SET_5V_MODE)
66
+          "BLTOUCH_SET_5V_MODE"
67
+        #else
68
+          "OD"
69
+        #endif
70
+      );
71
+    }
72
+
73
+    const bool should_set = last_written_mode != (false
74
+      #if ENABLED(BLTOUCH_SET_5V_MODE)
75
+        || true
76
+      #endif
77
+    );
78
+
51 79
   #endif
80
+
81
+  if (should_set && set_voltage)
82
+    mode_conv_proc((false
83
+      #if ENABLED(BLTOUCH_SET_5V_MODE)
84
+        || true
85
+      #endif
86
+    ));
87
+
52 88
   _reset();
53 89
   _stow();
54
-  // There really should be no alarm outstanding now, and no triggered condition. But if there is,
55
-  // there is no need to worry people here on init right at the start of the printer.
56 90
 }
57 91
 
58 92
 void BLTouch::clear() {
@@ -97,6 +131,11 @@ bool BLTouch::deploy_proc() {
97 131
     }
98 132
   }
99 133
 
134
+  // One of the recommended ANTClabs ways to probe, using SW MODE
135
+  #if ENABLED(BLTOUCH_FORCE_SW_MODE)
136
+   _set_SW_mode();
137
+  #endif
138
+
100 139
   // Now the probe is ready to issue a 10ms pulse when the pin goes up.
101 140
   // The trigger STOW (see motion.cpp for example) will pull up the probes pin as soon as the pulse
102 141
   // is registered.
@@ -159,4 +198,19 @@ bool BLTouch::status_proc() {
159 198
   return !tr;
160 199
 }
161 200
 
201
+void BLTouch::mode_conv_proc(const bool M5V) {
202
+  /**
203
+   * BLTOUCH pre V3.0 and clones: No reaction at all to this sequence apart from a DEPLOY -> STOW
204
+   * BLTOUCH V3.0: This will set the mode (twice) and sadly, a STOW is needed at the end, because of the deploy
205
+   * BLTOUCH V3.1: This will set the mode and store it in the eeprom. The STOW is not needed but does not hurt
206
+   */
207
+  if (DEBUGGING(LEVELING)) DEBUG_ECHOLNPAIR("BLTouch Set Mode - ", (int)M5V);
208
+  _deploy();
209
+  if (M5V) _set_5V_mode(); else _set_OD_mode();
210
+  _mode_store();
211
+  if (M5V) _set_5V_mode(); else _set_OD_mode();
212
+  _stow();
213
+  last_written_mode = M5V;
214
+}
215
+
162 216
 #endif // BLTOUCH

+ 7
- 2
Marlin/src/feature/bltouch.h View File

@@ -67,8 +67,8 @@ typedef unsigned char BLTCommand;
67 67
 
68 68
 class BLTouch {
69 69
 public:
70
-  static bool triggered();         // used by menu_advanced.cpp
71
-  static void init();              // used by main.cpp
70
+  static void init(const bool set_voltage=false);
71
+  static bool last_written_mode; // Initialized by settings.load, 0 = Open Drain; 1 = 5V Drain
72 72
 
73 73
   // DEPLOY and STOW are wrapped for error handling - these are used by homing and by probing
74 74
   FORCE_INLINE static bool deploy()              { return deploy_proc(); }
@@ -90,15 +90,20 @@ public:
90 90
   FORCE_INLINE static void _deploy()             { command(BLTOUCH_DEPLOY, BLTOUCH_DEPLOY_DELAY); }
91 91
   FORCE_INLINE static void _stow()               { command(BLTOUCH_STOW, BLTOUCH_STOW_DELAY); }
92 92
 
93
+  FORCE_INLINE static void mode_conv_5V()        { mode_conv_proc(true); }
94
+  FORCE_INLINE static void mode_conv_OD()        { mode_conv_proc(false); }
95
+
93 96
 private:
94 97
   FORCE_INLINE static bool _deploy_query_alarm() { return command(BLTOUCH_DEPLOY, BLTOUCH_DEPLOY_DELAY); }
95 98
   FORCE_INLINE static bool _stow_query_alarm()   { return command(BLTOUCH_STOW, BLTOUCH_STOW_DELAY); }
96 99
 
97 100
   static void clear();
98 101
   static bool command(const BLTCommand cmd, const millis_t &ms);
102
+  static bool triggered();
99 103
   static bool deploy_proc();
100 104
   static bool stow_proc();
101 105
   static bool status_proc();
106
+  static void mode_conv_proc(const bool M5V);
102 107
 };
103 108
 
104 109
 // Deploy/stow angles for use by servo.cpp / servo.h

+ 2
- 2
Marlin/src/inc/SanityCheck.h View File

@@ -1028,8 +1028,8 @@ static_assert(Y_MAX_LENGTH >= Y_BED_SIZE, "Movement bounds (Y_MIN_POS, Y_MAX_POS
1028 1028
   #if ENABLED(BLTOUCH)
1029 1029
     #if BLTOUCH_DELAY < 200
1030 1030
       #error "BLTOUCH_DELAY less than 200 is unsafe and is not supported."
1031
-    #elif DISABLED(BLTOUCH_FORCE_5V_MODE) && NONE(ENDSTOPPULLUPS, ENDSTOPPULLUP_ZMIN, ENDSTOPPULLUP_ZMIN_PROBE)
1032
-      #error "BLTOUCH without BLTOUCH_FORCE_5V_MODE requires ENDSTOPPULLUPS, ENDSTOPPULLUP_ZMIN or ENDSTOPPULLUP_ZMIN_PROBE."
1031
+    #elif DISABLED(BLTOUCH_SET_5V_MODE) && NONE(ENDSTOPPULLUPS, ENDSTOPPULLUP_ZMIN, ENDSTOPPULLUP_ZMIN_PROBE)
1032
+      #error "BLTOUCH without BLTOUCH_SET_5V_MODE requires ENDSTOPPULLUPS, ENDSTOPPULLUP_ZMIN or ENDSTOPPULLUP_ZMIN_PROBE."
1033 1033
     #endif
1034 1034
   #endif
1035 1035
 

+ 18
- 9
Marlin/src/lcd/language/language_en.h View File

@@ -901,28 +901,37 @@
901 901
   #define MSG_BLTOUCH                         _UxGT("BLTouch")
902 902
 #endif
903 903
 #ifndef MSG_BLTOUCH_SELFTEST
904
-  #define MSG_BLTOUCH_SELFTEST                _UxGT("BLTouch Self-Test")
904
+  #define MSG_BLTOUCH_SELFTEST                _UxGT("Cmd: Self-Test")
905 905
 #endif
906 906
 #ifndef MSG_BLTOUCH_RESET
907
-  #define MSG_BLTOUCH_RESET                   _UxGT("Reset BLTouch")
907
+  #define MSG_BLTOUCH_RESET                   _UxGT("Cmd: Reset")
908
+#endif
909
+#ifndef MSG_BLTOUCH_STOW
910
+  #define MSG_BLTOUCH_STOW                    _UxGT("Cmd: Stow")
908 911
 #endif
909 912
 #ifndef MSG_BLTOUCH_DEPLOY
910
-  #define MSG_BLTOUCH_DEPLOY                  _UxGT("Deploy BLTouch")
913
+  #define MSG_BLTOUCH_DEPLOY                  _UxGT("Cmd: Deploy")
911 914
 #endif
912 915
 #ifndef MSG_BLTOUCH_SW_MODE
913
-  #define MSG_BLTOUCH_SW_MODE                 _UxGT("BLTouch SW Mode")
916
+  #define MSG_BLTOUCH_SW_MODE                 _UxGT("Cmd: SW-Mode")
914 917
 #endif
915 918
 #ifndef MSG_BLTOUCH_5V_MODE
916
-  #define MSG_BLTOUCH_5V_MODE                 _UxGT("BLTouch 5V Mode")
919
+  #define MSG_BLTOUCH_5V_MODE                 _UxGT("Cmd: 5V-Mode")
917 920
 #endif
918 921
 #ifndef MSG_BLTOUCH_OD_MODE
919
-  #define MSG_BLTOUCH_OD_MODE                 _UxGT("BLTouch OD Mode")
922
+  #define MSG_BLTOUCH_OD_MODE                 _UxGT("Cmd: OD-Mode")
920 923
 #endif
921 924
 #ifndef MSG_BLTOUCH_MODE_STORE
922
-  #define MSG_BLTOUCH_MODE_STORE              _UxGT("BLTouch Mode Store")
925
+  #define MSG_BLTOUCH_MODE_STORE              _UxGT("Cmd: Mode-Store")
923 926
 #endif
924
-#ifndef MSG_BLTOUCH_STOW
925
-  #define MSG_BLTOUCH_STOW                    _UxGT("Stow BLTouch")
927
+#ifndef MSG_BLTOUCH_MODE_STORE_5V
928
+  #define MSG_BLTOUCH_MODE_STORE_5V           _UxGT("Set BLTouch to 5V")
929
+#endif
930
+#ifndef MSG_BLTOUCH_MODE_STORE_OD
931
+  #define MSG_BLTOUCH_MODE_STORE_OD           _UxGT("Set BLTouch to OD")
932
+#endif
933
+#ifndef MSG_BLTOUCH_MODE_ECHO
934
+  #define MSG_BLTOUCH_MODE_ECHO               _UxGT("Report Drain")
926 935
 #endif
927 936
 #ifndef MSG_MANUAL_DEPLOY
928 937
   #define MSG_MANUAL_DEPLOY                   _UxGT("Deploy Z-Probe")

+ 0
- 14
Marlin/src/lcd/menu/menu_advanced.cpp View File

@@ -39,11 +39,6 @@
39 39
   #include "../../module/probe.h"
40 40
 #endif
41 41
 
42
-#if ENABLED(BLTOUCH)
43
-  #include "../../module/endstops.h"
44
-  #include "../../feature/bltouch.h"
45
-#endif
46
-
47 42
 #if ENABLED(PIDTEMP)
48 43
   #include "../../module/temperature.h"
49 44
 #endif
@@ -683,15 +678,6 @@ void menu_advanced_settings() {
683 678
     MENU_ITEM_EDIT(bool, MSG_ENDSTOP_ABORT, &planner.abort_on_endstop_hit);
684 679
   #endif
685 680
 
686
-  //
687
-  // BLTouch Self-Test and Reset
688
-  //
689
-  #if ENABLED(BLTOUCH)
690
-    MENU_ITEM(function, MSG_BLTOUCH_SELFTEST, []{ bltouch._selftest(); ui.refresh(); });
691
-    if (!endstops.z_probe_enabled && bltouch.triggered())
692
-      MENU_ITEM(function, MSG_BLTOUCH_RESET, []{ bltouch._reset(); ui.refresh(); });
693
-  #endif
694
-
695 681
   #if ENABLED(SD_FIRMWARE_UPDATE)
696 682
     bool sd_update_state = settings.sd_update_status();
697 683
     MENU_ITEM_EDIT_CALLBACK(bool, MSG_SD_UPDATE, &sd_update_state, []{

+ 26
- 3
Marlin/src/lcd/menu/menu_configuration.cpp View File

@@ -172,6 +172,24 @@ static void lcd_factory_settings() {
172 172
 
173 173
 #if ENABLED(BLTOUCH)
174 174
 
175
+  #if ENABLED(BLTOUCH_LCD_VOLTAGE_MENU)
176
+    void bltouch_report() {
177
+      SERIAL_ECHOLNPAIR("EEPROM Last BLTouch Mode - ", (int)bltouch.last_written_mode);
178
+      SERIAL_ECHOLNPGM("Configuration BLTouch Mode - "
179
+        #if ENABLED(BLTOUCH_SET_5V_MODE)
180
+          "5V"
181
+        #else
182
+          "OD"
183
+        #endif
184
+      );
185
+      char mess[21];
186
+      strcpy_P(mess, PSTR("BLTouch Mode - "));
187
+      sprintf_P(&mess[15], bltouch.last_written_mode ? PSTR("5V") : PSTR("OD"));
188
+      ui.set_status(mess);
189
+      ui.return_to_status();
190
+    }
191
+  #endif
192
+
175 193
   void menu_bltouch() {
176 194
     START_MENU();
177 195
     MENU_BACK(MSG_CONFIGURATION);
@@ -180,9 +198,14 @@ static void lcd_factory_settings() {
180 198
     MENU_ITEM(function, MSG_BLTOUCH_DEPLOY, bltouch._deploy);
181 199
     MENU_ITEM(function, MSG_BLTOUCH_STOW, bltouch._stow);
182 200
     MENU_ITEM(function, MSG_BLTOUCH_SW_MODE, bltouch._set_SW_mode);
183
-    MENU_ITEM(function, MSG_BLTOUCH_5V_MODE, bltouch._set_5V_mode);
184
-    MENU_ITEM(function, MSG_BLTOUCH_OD_MODE, bltouch._set_OD_mode);
185
-    MENU_ITEM(function, MSG_BLTOUCH_MODE_STORE, bltouch._mode_store);
201
+    #if ENABLED(BLTOUCH_LCD_VOLTAGE_MENU)
202
+      MENU_ITEM(function, MSG_BLTOUCH_5V_MODE, bltouch._set_5V_mode);
203
+      MENU_ITEM(function, MSG_BLTOUCH_OD_MODE, bltouch._set_OD_mode);
204
+      MENU_ITEM(function, MSG_BLTOUCH_MODE_STORE, bltouch._mode_store);
205
+      MENU_ITEM(function, MSG_BLTOUCH_MODE_STORE_5V, bltouch.mode_conv_5V);
206
+      MENU_ITEM(function, MSG_BLTOUCH_MODE_STORE_OD, bltouch.mode_conv_OD);
207
+      MENU_ITEM(function, MSG_BLTOUCH_MODE_ECHO, bltouch_report);
208
+    #endif
186 209
     END_MENU();
187 210
   }
188 211
 

+ 43
- 1
Marlin/src/module/configuration_store.cpp View File

@@ -37,7 +37,7 @@
37 37
  */
38 38
 
39 39
 // Change EEPROM version if the structure changes
40
-#define EEPROM_VERSION "V66"
40
+#define EEPROM_VERSION "V67"
41 41
 #define EEPROM_OFFSET 100
42 42
 
43 43
 // Check the integrity of data offsets.
@@ -109,6 +109,10 @@ extern float saved_extruder_advance_K[EXTRUDERS];
109 109
   void M217_report(const bool eeprom);
110 110
 #endif
111 111
 
112
+#if ENABLED(BLTOUCH)
113
+  #include "../feature/bltouch.h"
114
+#endif
115
+
112 116
 #if HAS_TRINAMIC
113 117
   #include "stepper_indirection.h"
114 118
   #include "../feature/tmc_util.h"
@@ -207,6 +211,11 @@ typedef struct SettingsDataStruct {
207 211
   uint16_t servo_angles[EEPROM_NUM_SERVOS][2];          // M281 P L U
208 212
 
209 213
   //
214
+  // BLTOUCH
215
+  //
216
+  bool bltouch_last_written_mode;
217
+
218
+  //
210 219
   // DELTA / [XYZ]_DUAL_ENDSTOPS
211 220
   //
212 221
   #if ENABLED(DELTA)
@@ -701,6 +710,19 @@ void MarlinSettings::postprocess() {
701 710
     }
702 711
 
703 712
     //
713
+    // BLTOUCH
714
+    //
715
+    {
716
+      _FIELD_TEST(bltouch_last_written_mode);
717
+      #if ENABLED(BLTOUCH)
718
+        const bool &bltouch_last_written_mode = bltouch.last_written_mode;
719
+      #else
720
+        constexpr bool bltouch_last_written_mode = false;
721
+      #endif
722
+      EEPROM_WRITE(bltouch_last_written_mode);
723
+    }
724
+
725
+    //
704 726
     // DELTA Geometry or Dual Endstops offsets
705 727
     //
706 728
     {
@@ -1489,6 +1511,19 @@ void MarlinSettings::postprocess() {
1489 1511
       }
1490 1512
 
1491 1513
       //
1514
+      // BLTOUCH
1515
+      //
1516
+      {
1517
+        _FIELD_TEST(bltouch_last_written_mode);
1518
+        #if ENABLED(BLTOUCH)
1519
+          bool &bltouch_last_written_mode = bltouch.last_written_mode;
1520
+        #else
1521
+          bool bltouch_last_written_mode;
1522
+        #endif
1523
+        EEPROM_READ(bltouch_last_written_mode);
1524
+      }
1525
+
1526
+      //
1492 1527
       // DELTA Geometry or Dual Endstops offsets
1493 1528
       //
1494 1529
       {
@@ -2314,6 +2349,13 @@ void MarlinSettings::reset() {
2314 2349
   #endif
2315 2350
 
2316 2351
   //
2352
+  // BLTOUCH
2353
+  //
2354
+  //#if ENABLED(BLTOUCH)
2355
+  //  bltouch.last_written_mode;
2356
+  //#endif
2357
+
2358
+  //
2317 2359
   // Endstop Adjustments
2318 2360
   //
2319 2361
 

+ 62
- 6
config/default/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/3DFabXYZ/Migbot/Configuration.h View File

@@ -834,15 +834,71 @@
834 834
  */
835 835
 //#define BLTOUCH
836 836
 #if ENABLED(BLTOUCH)
837
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
837
+  /**
838
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
839
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
840
+   * advanced commands.
841
+   *
842
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
843
+   *       check the wiring of the BROWN, RED and ORANGE wires.
844
+   *
845
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
846
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
847
+   *       like they would be with a real switch. So please check the wiring first.
848
+   *
849
+   * Settings for all BLTouch and clone probes:
850
+   */
851
+
852
+  // Safety: The probe needs time to recognize the command.
853
+  //         Minimum command delay (ms). Enable and increase if needed.
854
+  //#define BLTOUCH_DELAY 500
838 855
 
839 856
   /**
840
-   * BLTouch V3.0 and newer smart series
841
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
842
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
857
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
843 858
    */
844
-  //#define BLTOUCH_FORCE_5V_MODE
845
-#endif
859
+
860
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
861
+  //          in special cases, like noisy or filtered input configurations.
862
+  //#define BLTOUCH_FORCE_SW_MODE
863
+
864
+  /**
865
+   * Settings for BLTouch Smart 3.0 and 3.1
866
+   * Summary:
867
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
868
+   *   - High-Speed mode
869
+   *   - Disable LCD voltage options
870
+   */
871
+
872
+  /**
873
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
874
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
875
+   * If disabled, OD mode is the hard-coded default on 3.0
876
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
877
+   * differs, a mode set eeprom write will be completed at initialization.
878
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
879
+   */
880
+  //#define BLTOUCH_SET_5V_MODE
881
+
882
+  /**
883
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
884
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
885
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
886
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
887
+   */
888
+  //#define BLTOUCH_FORCE_MODE_SET
889
+
890
+  /**
891
+   * Use "HIGH SPEED" mode for probing.
892
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
893
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
894
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
895
+   */
896
+  //#define BLTOUCH_HS_MODE
897
+
898
+  // Safety: Enable voltage mode settings in the LCD menu.
899
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
900
+
901
+#endif // BLTOUCH
846 902
 
847 903
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
848 904
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/AlephObjects/TAZ4/Configuration.h View File

@@ -848,15 +848,71 @@
848 848
  */
849 849
 //#define BLTOUCH
850 850
 #if ENABLED(BLTOUCH)
851
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
851
+  /**
852
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
853
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
854
+   * advanced commands.
855
+   *
856
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
857
+   *       check the wiring of the BROWN, RED and ORANGE wires.
858
+   *
859
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
860
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
861
+   *       like they would be with a real switch. So please check the wiring first.
862
+   *
863
+   * Settings for all BLTouch and clone probes:
864
+   */
865
+
866
+  // Safety: The probe needs time to recognize the command.
867
+  //         Minimum command delay (ms). Enable and increase if needed.
868
+  //#define BLTOUCH_DELAY 500
852 869
 
853 870
   /**
854
-   * BLTouch V3.0 and newer smart series
855
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
856
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
871
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
857 872
    */
858
-  //#define BLTOUCH_FORCE_5V_MODE
859
-#endif
873
+
874
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
875
+  //          in special cases, like noisy or filtered input configurations.
876
+  //#define BLTOUCH_FORCE_SW_MODE
877
+
878
+  /**
879
+   * Settings for BLTouch Smart 3.0 and 3.1
880
+   * Summary:
881
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
882
+   *   - High-Speed mode
883
+   *   - Disable LCD voltage options
884
+   */
885
+
886
+  /**
887
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
888
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
889
+   * If disabled, OD mode is the hard-coded default on 3.0
890
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
891
+   * differs, a mode set eeprom write will be completed at initialization.
892
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
893
+   */
894
+  //#define BLTOUCH_SET_5V_MODE
895
+
896
+  /**
897
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
898
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
899
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
900
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
901
+   */
902
+  //#define BLTOUCH_FORCE_MODE_SET
903
+
904
+  /**
905
+   * Use "HIGH SPEED" mode for probing.
906
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
907
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
908
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
909
+   */
910
+  //#define BLTOUCH_HS_MODE
911
+
912
+  // Safety: Enable voltage mode settings in the LCD menu.
913
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
914
+
915
+#endif // BLTOUCH
860 916
 
861 917
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
862 918
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/AliExpress/CL-260/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/AliExpress/UM2pExt/Configuration.h View File

@@ -839,15 +839,71 @@
839 839
  */
840 840
 //#define BLTOUCH
841 841
 #if ENABLED(BLTOUCH)
842
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
842
+  /**
843
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
844
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
845
+   * advanced commands.
846
+   *
847
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
848
+   *       check the wiring of the BROWN, RED and ORANGE wires.
849
+   *
850
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
851
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
852
+   *       like they would be with a real switch. So please check the wiring first.
853
+   *
854
+   * Settings for all BLTouch and clone probes:
855
+   */
856
+
857
+  // Safety: The probe needs time to recognize the command.
858
+  //         Minimum command delay (ms). Enable and increase if needed.
859
+  //#define BLTOUCH_DELAY 500
843 860
 
844 861
   /**
845
-   * BLTouch V3.0 and newer smart series
846
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
847
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
862
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
848 863
    */
849
-  //#define BLTOUCH_FORCE_5V_MODE
850
-#endif
864
+
865
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
866
+  //          in special cases, like noisy or filtered input configurations.
867
+  //#define BLTOUCH_FORCE_SW_MODE
868
+
869
+  /**
870
+   * Settings for BLTouch Smart 3.0 and 3.1
871
+   * Summary:
872
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
873
+   *   - High-Speed mode
874
+   *   - Disable LCD voltage options
875
+   */
876
+
877
+  /**
878
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
879
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
880
+   * If disabled, OD mode is the hard-coded default on 3.0
881
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
882
+   * differs, a mode set eeprom write will be completed at initialization.
883
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
884
+   */
885
+  //#define BLTOUCH_SET_5V_MODE
886
+
887
+  /**
888
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
889
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
890
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
891
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
892
+   */
893
+  //#define BLTOUCH_FORCE_MODE_SET
894
+
895
+  /**
896
+   * Use "HIGH SPEED" mode for probing.
897
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
898
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
899
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
900
+   */
901
+  //#define BLTOUCH_HS_MODE
902
+
903
+  // Safety: Enable voltage mode settings in the LCD menu.
904
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
905
+
906
+#endif // BLTOUCH
851 907
 
852 908
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
853 909
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Anet/A2/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Anet/A2plus/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Anet/A6/Configuration.h View File

@@ -875,15 +875,71 @@
875 875
  */
876 876
 //#define BLTOUCH
877 877
 #if ENABLED(BLTOUCH)
878
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
878
+  /**
879
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
880
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
881
+   * advanced commands.
882
+   *
883
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
884
+   *       check the wiring of the BROWN, RED and ORANGE wires.
885
+   *
886
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
887
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
888
+   *       like they would be with a real switch. So please check the wiring first.
889
+   *
890
+   * Settings for all BLTouch and clone probes:
891
+   */
892
+
893
+  // Safety: The probe needs time to recognize the command.
894
+  //         Minimum command delay (ms). Enable and increase if needed.
895
+  //#define BLTOUCH_DELAY 500
879 896
 
880 897
   /**
881
-   * BLTouch V3.0 and newer smart series
882
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
883
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
898
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
884 899
    */
885
-  //#define BLTOUCH_FORCE_5V_MODE
886
-#endif
900
+
901
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
902
+  //          in special cases, like noisy or filtered input configurations.
903
+  //#define BLTOUCH_FORCE_SW_MODE
904
+
905
+  /**
906
+   * Settings for BLTouch Smart 3.0 and 3.1
907
+   * Summary:
908
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
909
+   *   - High-Speed mode
910
+   *   - Disable LCD voltage options
911
+   */
912
+
913
+  /**
914
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
915
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
916
+   * If disabled, OD mode is the hard-coded default on 3.0
917
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
918
+   * differs, a mode set eeprom write will be completed at initialization.
919
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
920
+   */
921
+  //#define BLTOUCH_SET_5V_MODE
922
+
923
+  /**
924
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
925
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
926
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
927
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
928
+   */
929
+  //#define BLTOUCH_FORCE_MODE_SET
930
+
931
+  /**
932
+   * Use "HIGH SPEED" mode for probing.
933
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
934
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
935
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
936
+   */
937
+  //#define BLTOUCH_HS_MODE
938
+
939
+  // Safety: Enable voltage mode settings in the LCD menu.
940
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
941
+
942
+#endif // BLTOUCH
887 943
 
888 944
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
889 945
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Anet/A8/Configuration.h View File

@@ -841,15 +841,71 @@
841 841
  */
842 842
 //#define BLTOUCH
843 843
 #if ENABLED(BLTOUCH)
844
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
844
+  /**
845
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
846
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
847
+   * advanced commands.
848
+   *
849
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
850
+   *       check the wiring of the BROWN, RED and ORANGE wires.
851
+   *
852
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
853
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
854
+   *       like they would be with a real switch. So please check the wiring first.
855
+   *
856
+   * Settings for all BLTouch and clone probes:
857
+   */
858
+
859
+  // Safety: The probe needs time to recognize the command.
860
+  //         Minimum command delay (ms). Enable and increase if needed.
861
+  //#define BLTOUCH_DELAY 500
845 862
 
846 863
   /**
847
-   * BLTouch V3.0 and newer smart series
848
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
849
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
864
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
850 865
    */
851
-  //#define BLTOUCH_FORCE_5V_MODE
852
-#endif
866
+
867
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
868
+  //          in special cases, like noisy or filtered input configurations.
869
+  //#define BLTOUCH_FORCE_SW_MODE
870
+
871
+  /**
872
+   * Settings for BLTouch Smart 3.0 and 3.1
873
+   * Summary:
874
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
875
+   *   - High-Speed mode
876
+   *   - Disable LCD voltage options
877
+   */
878
+
879
+  /**
880
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
881
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
882
+   * If disabled, OD mode is the hard-coded default on 3.0
883
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
884
+   * differs, a mode set eeprom write will be completed at initialization.
885
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
886
+   */
887
+  //#define BLTOUCH_SET_5V_MODE
888
+
889
+  /**
890
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
891
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
892
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
893
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
894
+   */
895
+  //#define BLTOUCH_FORCE_MODE_SET
896
+
897
+  /**
898
+   * Use "HIGH SPEED" mode for probing.
899
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
900
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
901
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
902
+   */
903
+  //#define BLTOUCH_HS_MODE
904
+
905
+  // Safety: Enable voltage mode settings in the LCD menu.
906
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
907
+
908
+#endif // BLTOUCH
853 909
 
854 910
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
855 911
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Anet/A8plus/Configuration.h View File

@@ -839,15 +839,71 @@
839 839
  */
840 840
 //#define BLTOUCH
841 841
 #if ENABLED(BLTOUCH)
842
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
842
+  /**
843
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
844
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
845
+   * advanced commands.
846
+   *
847
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
848
+   *       check the wiring of the BROWN, RED and ORANGE wires.
849
+   *
850
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
851
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
852
+   *       like they would be with a real switch. So please check the wiring first.
853
+   *
854
+   * Settings for all BLTouch and clone probes:
855
+   */
856
+
857
+  // Safety: The probe needs time to recognize the command.
858
+  //         Minimum command delay (ms). Enable and increase if needed.
859
+  //#define BLTOUCH_DELAY 500
843 860
 
844 861
   /**
845
-   * BLTouch V3.0 and newer smart series
846
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
847
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
862
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
848 863
    */
849
-  //#define BLTOUCH_FORCE_5V_MODE
850
-#endif
864
+
865
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
866
+  //          in special cases, like noisy or filtered input configurations.
867
+  //#define BLTOUCH_FORCE_SW_MODE
868
+
869
+  /**
870
+   * Settings for BLTouch Smart 3.0 and 3.1
871
+   * Summary:
872
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
873
+   *   - High-Speed mode
874
+   *   - Disable LCD voltage options
875
+   */
876
+
877
+  /**
878
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
879
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
880
+   * If disabled, OD mode is the hard-coded default on 3.0
881
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
882
+   * differs, a mode set eeprom write will be completed at initialization.
883
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
884
+   */
885
+  //#define BLTOUCH_SET_5V_MODE
886
+
887
+  /**
888
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
889
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
890
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
891
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
892
+   */
893
+  //#define BLTOUCH_FORCE_MODE_SET
894
+
895
+  /**
896
+   * Use "HIGH SPEED" mode for probing.
897
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
898
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
899
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
900
+   */
901
+  //#define BLTOUCH_HS_MODE
902
+
903
+  // Safety: Enable voltage mode settings in the LCD menu.
904
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
905
+
906
+#endif // BLTOUCH
851 907
 
852 908
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
853 909
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Anet/E16/Configuration.h View File

@@ -840,15 +840,71 @@
840 840
  */
841 841
 //#define BLTOUCH
842 842
 #if ENABLED(BLTOUCH)
843
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
843
+  /**
844
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
845
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
846
+   * advanced commands.
847
+   *
848
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
849
+   *       check the wiring of the BROWN, RED and ORANGE wires.
850
+   *
851
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
852
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
853
+   *       like they would be with a real switch. So please check the wiring first.
854
+   *
855
+   * Settings for all BLTouch and clone probes:
856
+   */
857
+
858
+  // Safety: The probe needs time to recognize the command.
859
+  //         Minimum command delay (ms). Enable and increase if needed.
860
+  //#define BLTOUCH_DELAY 500
844 861
 
845 862
   /**
846
-   * BLTouch V3.0 and newer smart series
847
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
848
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
863
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
849 864
    */
850
-  #define BLTOUCH_FORCE_5V_MODE
851
-#endif
865
+
866
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
867
+  //          in special cases, like noisy or filtered input configurations.
868
+  //#define BLTOUCH_FORCE_SW_MODE
869
+
870
+  /**
871
+   * Settings for BLTouch Smart 3.0 and 3.1
872
+   * Summary:
873
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
874
+   *   - High-Speed mode
875
+   *   - Disable LCD voltage options
876
+   */
877
+
878
+  /**
879
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
880
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
881
+   * If disabled, OD mode is the hard-coded default on 3.0
882
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
883
+   * differs, a mode set eeprom write will be completed at initialization.
884
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
885
+   */
886
+  #define BLTOUCH_SET_5V_MODE
887
+
888
+  /**
889
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
890
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
891
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
892
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
893
+   */
894
+  //#define BLTOUCH_FORCE_MODE_SET
895
+
896
+  /**
897
+   * Use "HIGH SPEED" mode for probing.
898
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
899
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
900
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
901
+   */
902
+  //#define BLTOUCH_HS_MODE
903
+
904
+  // Safety: Enable voltage mode settings in the LCD menu.
905
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
906
+
907
+#endif // BLTOUCH
852 908
 
853 909
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
854 910
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/AnyCubic/i3/Configuration.h View File

@@ -838,15 +838,71 @@
838 838
  */
839 839
 #define BLTOUCH
840 840
 #if ENABLED(BLTOUCH)
841
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
841
+  /**
842
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
843
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
844
+   * advanced commands.
845
+   *
846
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
847
+   *       check the wiring of the BROWN, RED and ORANGE wires.
848
+   *
849
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
850
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
851
+   *       like they would be with a real switch. So please check the wiring first.
852
+   *
853
+   * Settings for all BLTouch and clone probes:
854
+   */
855
+
856
+  // Safety: The probe needs time to recognize the command.
857
+  //         Minimum command delay (ms). Enable and increase if needed.
858
+  //#define BLTOUCH_DELAY 500
842 859
 
843 860
   /**
844
-   * BLTouch V3.0 and newer smart series
845
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
846
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
861
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
847 862
    */
848
-  //#define BLTOUCH_FORCE_5V_MODE
849
-#endif
863
+
864
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
865
+  //          in special cases, like noisy or filtered input configurations.
866
+  //#define BLTOUCH_FORCE_SW_MODE
867
+
868
+  /**
869
+   * Settings for BLTouch Smart 3.0 and 3.1
870
+   * Summary:
871
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
872
+   *   - High-Speed mode
873
+   *   - Disable LCD voltage options
874
+   */
875
+
876
+  /**
877
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
878
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
879
+   * If disabled, OD mode is the hard-coded default on 3.0
880
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
881
+   * differs, a mode set eeprom write will be completed at initialization.
882
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
883
+   */
884
+  //#define BLTOUCH_SET_5V_MODE
885
+
886
+  /**
887
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
888
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
889
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
890
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
891
+   */
892
+  //#define BLTOUCH_FORCE_MODE_SET
893
+
894
+  /**
895
+   * Use "HIGH SPEED" mode for probing.
896
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
897
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
898
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
899
+   */
900
+  //#define BLTOUCH_HS_MODE
901
+
902
+  // Safety: Enable voltage mode settings in the LCD menu.
903
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
904
+
905
+#endif // BLTOUCH
850 906
 
851 907
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
852 908
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/ArmEd/Configuration.h View File

@@ -829,15 +829,71 @@
829 829
  */
830 830
 //#define BLTOUCH
831 831
 #if ENABLED(BLTOUCH)
832
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
832
+  /**
833
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
834
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
835
+   * advanced commands.
836
+   *
837
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
838
+   *       check the wiring of the BROWN, RED and ORANGE wires.
839
+   *
840
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
841
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
842
+   *       like they would be with a real switch. So please check the wiring first.
843
+   *
844
+   * Settings for all BLTouch and clone probes:
845
+   */
846
+
847
+  // Safety: The probe needs time to recognize the command.
848
+  //         Minimum command delay (ms). Enable and increase if needed.
849
+  //#define BLTOUCH_DELAY 500
833 850
 
834 851
   /**
835
-   * BLTouch V3.0 and newer smart series
836
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
837
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
852
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
838 853
    */
839
-  //#define BLTOUCH_FORCE_5V_MODE
840
-#endif
854
+
855
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
856
+  //          in special cases, like noisy or filtered input configurations.
857
+  //#define BLTOUCH_FORCE_SW_MODE
858
+
859
+  /**
860
+   * Settings for BLTouch Smart 3.0 and 3.1
861
+   * Summary:
862
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
863
+   *   - High-Speed mode
864
+   *   - Disable LCD voltage options
865
+   */
866
+
867
+  /**
868
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
869
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
870
+   * If disabled, OD mode is the hard-coded default on 3.0
871
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
872
+   * differs, a mode set eeprom write will be completed at initialization.
873
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
874
+   */
875
+  //#define BLTOUCH_SET_5V_MODE
876
+
877
+  /**
878
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
879
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
880
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
881
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
882
+   */
883
+  //#define BLTOUCH_FORCE_MODE_SET
884
+
885
+  /**
886
+   * Use "HIGH SPEED" mode for probing.
887
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
888
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
889
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
890
+   */
891
+  //#define BLTOUCH_HS_MODE
892
+
893
+  // Safety: Enable voltage mode settings in the LCD menu.
894
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
895
+
896
+#endif // BLTOUCH
841 897
 
842 898
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
843 899
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Azteeg/X5GT/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/BIBO/TouchX/cyclops/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/BIBO/TouchX/default/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/BQ/Hephestos/Configuration.h View File

@@ -816,15 +816,71 @@
816 816
  */
817 817
 //#define BLTOUCH
818 818
 #if ENABLED(BLTOUCH)
819
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
819
+  /**
820
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
821
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
822
+   * advanced commands.
823
+   *
824
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
825
+   *       check the wiring of the BROWN, RED and ORANGE wires.
826
+   *
827
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
828
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
829
+   *       like they would be with a real switch. So please check the wiring first.
830
+   *
831
+   * Settings for all BLTouch and clone probes:
832
+   */
833
+
834
+  // Safety: The probe needs time to recognize the command.
835
+  //         Minimum command delay (ms). Enable and increase if needed.
836
+  //#define BLTOUCH_DELAY 500
820 837
 
821 838
   /**
822
-   * BLTouch V3.0 and newer smart series
823
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
824
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
839
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
825 840
    */
826
-  //#define BLTOUCH_FORCE_5V_MODE
827
-#endif
841
+
842
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
843
+  //          in special cases, like noisy or filtered input configurations.
844
+  //#define BLTOUCH_FORCE_SW_MODE
845
+
846
+  /**
847
+   * Settings for BLTouch Smart 3.0 and 3.1
848
+   * Summary:
849
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
850
+   *   - High-Speed mode
851
+   *   - Disable LCD voltage options
852
+   */
853
+
854
+  /**
855
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
856
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
857
+   * If disabled, OD mode is the hard-coded default on 3.0
858
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
859
+   * differs, a mode set eeprom write will be completed at initialization.
860
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
861
+   */
862
+  //#define BLTOUCH_SET_5V_MODE
863
+
864
+  /**
865
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
866
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
867
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
868
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
869
+   */
870
+  //#define BLTOUCH_FORCE_MODE_SET
871
+
872
+  /**
873
+   * Use "HIGH SPEED" mode for probing.
874
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
875
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
876
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
877
+   */
878
+  //#define BLTOUCH_HS_MODE
879
+
880
+  // Safety: Enable voltage mode settings in the LCD menu.
881
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
882
+
883
+#endif // BLTOUCH
828 884
 
829 885
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
830 886
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/BQ/Hephestos_2/Configuration.h View File

@@ -829,15 +829,71 @@
829 829
  */
830 830
 //#define BLTOUCH
831 831
 #if ENABLED(BLTOUCH)
832
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
832
+  /**
833
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
834
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
835
+   * advanced commands.
836
+   *
837
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
838
+   *       check the wiring of the BROWN, RED and ORANGE wires.
839
+   *
840
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
841
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
842
+   *       like they would be with a real switch. So please check the wiring first.
843
+   *
844
+   * Settings for all BLTouch and clone probes:
845
+   */
846
+
847
+  // Safety: The probe needs time to recognize the command.
848
+  //         Minimum command delay (ms). Enable and increase if needed.
849
+  //#define BLTOUCH_DELAY 500
833 850
 
834 851
   /**
835
-   * BLTouch V3.0 and newer smart series
836
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
837
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
852
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
838 853
    */
839
-  //#define BLTOUCH_FORCE_5V_MODE
840
-#endif
854
+
855
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
856
+  //          in special cases, like noisy or filtered input configurations.
857
+  //#define BLTOUCH_FORCE_SW_MODE
858
+
859
+  /**
860
+   * Settings for BLTouch Smart 3.0 and 3.1
861
+   * Summary:
862
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
863
+   *   - High-Speed mode
864
+   *   - Disable LCD voltage options
865
+   */
866
+
867
+  /**
868
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
869
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
870
+   * If disabled, OD mode is the hard-coded default on 3.0
871
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
872
+   * differs, a mode set eeprom write will be completed at initialization.
873
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
874
+   */
875
+  //#define BLTOUCH_SET_5V_MODE
876
+
877
+  /**
878
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
879
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
880
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
881
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
882
+   */
883
+  //#define BLTOUCH_FORCE_MODE_SET
884
+
885
+  /**
886
+   * Use "HIGH SPEED" mode for probing.
887
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
888
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
889
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
890
+   */
891
+  //#define BLTOUCH_HS_MODE
892
+
893
+  // Safety: Enable voltage mode settings in the LCD menu.
894
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
895
+
896
+#endif // BLTOUCH
841 897
 
842 898
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
843 899
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/BQ/WITBOX/Configuration.h View File

@@ -816,15 +816,71 @@
816 816
  */
817 817
 //#define BLTOUCH
818 818
 #if ENABLED(BLTOUCH)
819
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
819
+  /**
820
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
821
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
822
+   * advanced commands.
823
+   *
824
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
825
+   *       check the wiring of the BROWN, RED and ORANGE wires.
826
+   *
827
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
828
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
829
+   *       like they would be with a real switch. So please check the wiring first.
830
+   *
831
+   * Settings for all BLTouch and clone probes:
832
+   */
833
+
834
+  // Safety: The probe needs time to recognize the command.
835
+  //         Minimum command delay (ms). Enable and increase if needed.
836
+  //#define BLTOUCH_DELAY 500
820 837
 
821 838
   /**
822
-   * BLTouch V3.0 and newer smart series
823
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
824
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
839
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
825 840
    */
826
-  //#define BLTOUCH_FORCE_5V_MODE
827
-#endif
841
+
842
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
843
+  //          in special cases, like noisy or filtered input configurations.
844
+  //#define BLTOUCH_FORCE_SW_MODE
845
+
846
+  /**
847
+   * Settings for BLTouch Smart 3.0 and 3.1
848
+   * Summary:
849
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
850
+   *   - High-Speed mode
851
+   *   - Disable LCD voltage options
852
+   */
853
+
854
+  /**
855
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
856
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
857
+   * If disabled, OD mode is the hard-coded default on 3.0
858
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
859
+   * differs, a mode set eeprom write will be completed at initialization.
860
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
861
+   */
862
+  //#define BLTOUCH_SET_5V_MODE
863
+
864
+  /**
865
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
866
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
867
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
868
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
869
+   */
870
+  //#define BLTOUCH_FORCE_MODE_SET
871
+
872
+  /**
873
+   * Use "HIGH SPEED" mode for probing.
874
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
875
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
876
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
877
+   */
878
+  //#define BLTOUCH_HS_MODE
879
+
880
+  // Safety: Enable voltage mode settings in the LCD menu.
881
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
882
+
883
+#endif // BLTOUCH
828 884
 
829 885
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
830 886
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Cartesio/Configuration.h View File

@@ -827,15 +827,71 @@
827 827
  */
828 828
 //#define BLTOUCH
829 829
 #if ENABLED(BLTOUCH)
830
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
830
+  /**
831
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
832
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
833
+   * advanced commands.
834
+   *
835
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
836
+   *       check the wiring of the BROWN, RED and ORANGE wires.
837
+   *
838
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
839
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
840
+   *       like they would be with a real switch. So please check the wiring first.
841
+   *
842
+   * Settings for all BLTouch and clone probes:
843
+   */
844
+
845
+  // Safety: The probe needs time to recognize the command.
846
+  //         Minimum command delay (ms). Enable and increase if needed.
847
+  //#define BLTOUCH_DELAY 500
831 848
 
832 849
   /**
833
-   * BLTouch V3.0 and newer smart series
834
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
835
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
850
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
836 851
    */
837
-  //#define BLTOUCH_FORCE_5V_MODE
838
-#endif
852
+
853
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
854
+  //          in special cases, like noisy or filtered input configurations.
855
+  //#define BLTOUCH_FORCE_SW_MODE
856
+
857
+  /**
858
+   * Settings for BLTouch Smart 3.0 and 3.1
859
+   * Summary:
860
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
861
+   *   - High-Speed mode
862
+   *   - Disable LCD voltage options
863
+   */
864
+
865
+  /**
866
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
867
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
868
+   * If disabled, OD mode is the hard-coded default on 3.0
869
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
870
+   * differs, a mode set eeprom write will be completed at initialization.
871
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
872
+   */
873
+  //#define BLTOUCH_SET_5V_MODE
874
+
875
+  /**
876
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
877
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
878
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
879
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
880
+   */
881
+  //#define BLTOUCH_FORCE_MODE_SET
882
+
883
+  /**
884
+   * Use "HIGH SPEED" mode for probing.
885
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
886
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
887
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
888
+   */
889
+  //#define BLTOUCH_HS_MODE
890
+
891
+  // Safety: Enable voltage mode settings in the LCD menu.
892
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
893
+
894
+#endif // BLTOUCH
839 895
 
840 896
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
841 897
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Creality/CR-10/Configuration.h View File

@@ -838,15 +838,71 @@
838 838
  */
839 839
 //#define BLTOUCH
840 840
 #if ENABLED(BLTOUCH)
841
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
841
+  /**
842
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
843
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
844
+   * advanced commands.
845
+   *
846
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
847
+   *       check the wiring of the BROWN, RED and ORANGE wires.
848
+   *
849
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
850
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
851
+   *       like they would be with a real switch. So please check the wiring first.
852
+   *
853
+   * Settings for all BLTouch and clone probes:
854
+   */
855
+
856
+  // Safety: The probe needs time to recognize the command.
857
+  //         Minimum command delay (ms). Enable and increase if needed.
858
+  //#define BLTOUCH_DELAY 500
842 859
 
843 860
   /**
844
-   * BLTouch V3.0 and newer smart series
845
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
846
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
861
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
847 862
    */
848
-  #define BLTOUCH_FORCE_5V_MODE
849
-#endif
863
+
864
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
865
+  //          in special cases, like noisy or filtered input configurations.
866
+  //#define BLTOUCH_FORCE_SW_MODE
867
+
868
+  /**
869
+   * Settings for BLTouch Smart 3.0 and 3.1
870
+   * Summary:
871
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
872
+   *   - High-Speed mode
873
+   *   - Disable LCD voltage options
874
+   */
875
+
876
+  /**
877
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
878
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
879
+   * If disabled, OD mode is the hard-coded default on 3.0
880
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
881
+   * differs, a mode set eeprom write will be completed at initialization.
882
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
883
+   */
884
+  #define BLTOUCH_SET_5V_MODE
885
+
886
+  /**
887
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
888
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
889
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
890
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
891
+   */
892
+  //#define BLTOUCH_FORCE_MODE_SET
893
+
894
+  /**
895
+   * Use "HIGH SPEED" mode for probing.
896
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
897
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
898
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
899
+   */
900
+  //#define BLTOUCH_HS_MODE
901
+
902
+  // Safety: Enable voltage mode settings in the LCD menu.
903
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
904
+
905
+#endif // BLTOUCH
850 906
 
851 907
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
852 908
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Creality/CR-10S/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  #define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  #define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Creality/CR-10_5S/Configuration.h View File

@@ -829,15 +829,71 @@
829 829
  */
830 830
 //#define BLTOUCH
831 831
 #if ENABLED(BLTOUCH)
832
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
832
+  /**
833
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
834
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
835
+   * advanced commands.
836
+   *
837
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
838
+   *       check the wiring of the BROWN, RED and ORANGE wires.
839
+   *
840
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
841
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
842
+   *       like they would be with a real switch. So please check the wiring first.
843
+   *
844
+   * Settings for all BLTouch and clone probes:
845
+   */
846
+
847
+  // Safety: The probe needs time to recognize the command.
848
+  //         Minimum command delay (ms). Enable and increase if needed.
849
+  //#define BLTOUCH_DELAY 500
833 850
 
834 851
   /**
835
-   * BLTouch V3.0 and newer smart series
836
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
837
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
852
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
838 853
    */
839
-  #define BLTOUCH_FORCE_5V_MODE
840
-#endif
854
+
855
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
856
+  //          in special cases, like noisy or filtered input configurations.
857
+  //#define BLTOUCH_FORCE_SW_MODE
858
+
859
+  /**
860
+   * Settings for BLTouch Smart 3.0 and 3.1
861
+   * Summary:
862
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
863
+   *   - High-Speed mode
864
+   *   - Disable LCD voltage options
865
+   */
866
+
867
+  /**
868
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
869
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
870
+   * If disabled, OD mode is the hard-coded default on 3.0
871
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
872
+   * differs, a mode set eeprom write will be completed at initialization.
873
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
874
+   */
875
+  #define BLTOUCH_SET_5V_MODE
876
+
877
+  /**
878
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
879
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
880
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
881
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
882
+   */
883
+  //#define BLTOUCH_FORCE_MODE_SET
884
+
885
+  /**
886
+   * Use "HIGH SPEED" mode for probing.
887
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
888
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
889
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
890
+   */
891
+  //#define BLTOUCH_HS_MODE
892
+
893
+  // Safety: Enable voltage mode settings in the LCD menu.
894
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
895
+
896
+#endif // BLTOUCH
841 897
 
842 898
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
843 899
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Creality/CR-10mini/Configuration.h View File

@@ -847,15 +847,71 @@
847 847
  */
848 848
 //#define BLTOUCH
849 849
 #if ENABLED(BLTOUCH)
850
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
850
+  /**
851
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
852
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
853
+   * advanced commands.
854
+   *
855
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
856
+   *       check the wiring of the BROWN, RED and ORANGE wires.
857
+   *
858
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
859
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
860
+   *       like they would be with a real switch. So please check the wiring first.
861
+   *
862
+   * Settings for all BLTouch and clone probes:
863
+   */
864
+
865
+  // Safety: The probe needs time to recognize the command.
866
+  //         Minimum command delay (ms). Enable and increase if needed.
867
+  //#define BLTOUCH_DELAY 500
851 868
 
852 869
   /**
853
-   * BLTouch V3.0 and newer smart series
854
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
855
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
870
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
856 871
    */
857
-  #define BLTOUCH_FORCE_5V_MODE
858
-#endif
872
+
873
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
874
+  //          in special cases, like noisy or filtered input configurations.
875
+  //#define BLTOUCH_FORCE_SW_MODE
876
+
877
+  /**
878
+   * Settings for BLTouch Smart 3.0 and 3.1
879
+   * Summary:
880
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
881
+   *   - High-Speed mode
882
+   *   - Disable LCD voltage options
883
+   */
884
+
885
+  /**
886
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
887
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
888
+   * If disabled, OD mode is the hard-coded default on 3.0
889
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
890
+   * differs, a mode set eeprom write will be completed at initialization.
891
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
892
+   */
893
+  #define BLTOUCH_SET_5V_MODE
894
+
895
+  /**
896
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
897
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
898
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
899
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
900
+   */
901
+  //#define BLTOUCH_FORCE_MODE_SET
902
+
903
+  /**
904
+   * Use "HIGH SPEED" mode for probing.
905
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
906
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
907
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
908
+   */
909
+  //#define BLTOUCH_HS_MODE
910
+
911
+  // Safety: Enable voltage mode settings in the LCD menu.
912
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
913
+
914
+#endif // BLTOUCH
859 915
 
860 916
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
861 917
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Creality/CR-8/Configuration.h View File

@@ -838,15 +838,71 @@
838 838
  */
839 839
 //#define BLTOUCH
840 840
 #if ENABLED(BLTOUCH)
841
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
841
+  /**
842
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
843
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
844
+   * advanced commands.
845
+   *
846
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
847
+   *       check the wiring of the BROWN, RED and ORANGE wires.
848
+   *
849
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
850
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
851
+   *       like they would be with a real switch. So please check the wiring first.
852
+   *
853
+   * Settings for all BLTouch and clone probes:
854
+   */
855
+
856
+  // Safety: The probe needs time to recognize the command.
857
+  //         Minimum command delay (ms). Enable and increase if needed.
858
+  //#define BLTOUCH_DELAY 500
842 859
 
843 860
   /**
844
-   * BLTouch V3.0 and newer smart series
845
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
846
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
861
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
847 862
    */
848
-  #define BLTOUCH_FORCE_5V_MODE
849
-#endif
863
+
864
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
865
+  //          in special cases, like noisy or filtered input configurations.
866
+  //#define BLTOUCH_FORCE_SW_MODE
867
+
868
+  /**
869
+   * Settings for BLTouch Smart 3.0 and 3.1
870
+   * Summary:
871
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
872
+   *   - High-Speed mode
873
+   *   - Disable LCD voltage options
874
+   */
875
+
876
+  /**
877
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
878
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
879
+   * If disabled, OD mode is the hard-coded default on 3.0
880
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
881
+   * differs, a mode set eeprom write will be completed at initialization.
882
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
883
+   */
884
+  #define BLTOUCH_SET_5V_MODE
885
+
886
+  /**
887
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
888
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
889
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
890
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
891
+   */
892
+  //#define BLTOUCH_FORCE_MODE_SET
893
+
894
+  /**
895
+   * Use "HIGH SPEED" mode for probing.
896
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
897
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
898
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
899
+   */
900
+  //#define BLTOUCH_HS_MODE
901
+
902
+  // Safety: Enable voltage mode settings in the LCD menu.
903
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
904
+
905
+#endif // BLTOUCH
850 906
 
851 907
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
852 908
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Creality/Ender-2/Configuration.h View File

@@ -832,15 +832,71 @@
832 832
  */
833 833
 //#define BLTOUCH
834 834
 #if ENABLED(BLTOUCH)
835
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
835
+  /**
836
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
837
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
838
+   * advanced commands.
839
+   *
840
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
841
+   *       check the wiring of the BROWN, RED and ORANGE wires.
842
+   *
843
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
844
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
845
+   *       like they would be with a real switch. So please check the wiring first.
846
+   *
847
+   * Settings for all BLTouch and clone probes:
848
+   */
849
+
850
+  // Safety: The probe needs time to recognize the command.
851
+  //         Minimum command delay (ms). Enable and increase if needed.
852
+  //#define BLTOUCH_DELAY 500
836 853
 
837 854
   /**
838
-   * BLTouch V3.0 and newer smart series
839
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
840
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
855
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
841 856
    */
842
-  #define BLTOUCH_FORCE_5V_MODE
843
-#endif
857
+
858
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
859
+  //          in special cases, like noisy or filtered input configurations.
860
+  //#define BLTOUCH_FORCE_SW_MODE
861
+
862
+  /**
863
+   * Settings for BLTouch Smart 3.0 and 3.1
864
+   * Summary:
865
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
866
+   *   - High-Speed mode
867
+   *   - Disable LCD voltage options
868
+   */
869
+
870
+  /**
871
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
872
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
873
+   * If disabled, OD mode is the hard-coded default on 3.0
874
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
875
+   * differs, a mode set eeprom write will be completed at initialization.
876
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
877
+   */
878
+  #define BLTOUCH_SET_5V_MODE
879
+
880
+  /**
881
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
882
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
883
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
884
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
885
+   */
886
+  //#define BLTOUCH_FORCE_MODE_SET
887
+
888
+  /**
889
+   * Use "HIGH SPEED" mode for probing.
890
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
891
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
892
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
893
+   */
894
+  //#define BLTOUCH_HS_MODE
895
+
896
+  // Safety: Enable voltage mode settings in the LCD menu.
897
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
898
+
899
+#endif // BLTOUCH
844 900
 
845 901
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
846 902
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Creality/Ender-3/Configuration.h View File

@@ -832,15 +832,71 @@
832 832
  */
833 833
 //#define BLTOUCH
834 834
 #if ENABLED(BLTOUCH)
835
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
835
+  /**
836
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
837
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
838
+   * advanced commands.
839
+   *
840
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
841
+   *       check the wiring of the BROWN, RED and ORANGE wires.
842
+   *
843
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
844
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
845
+   *       like they would be with a real switch. So please check the wiring first.
846
+   *
847
+   * Settings for all BLTouch and clone probes:
848
+   */
849
+
850
+  // Safety: The probe needs time to recognize the command.
851
+  //         Minimum command delay (ms). Enable and increase if needed.
852
+  //#define BLTOUCH_DELAY 500
836 853
 
837 854
   /**
838
-   * BLTouch V3.0 and newer smart series
839
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
840
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
855
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
841 856
    */
842
-  #define BLTOUCH_FORCE_5V_MODE
843
-#endif
857
+
858
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
859
+  //          in special cases, like noisy or filtered input configurations.
860
+  //#define BLTOUCH_FORCE_SW_MODE
861
+
862
+  /**
863
+   * Settings for BLTouch Smart 3.0 and 3.1
864
+   * Summary:
865
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
866
+   *   - High-Speed mode
867
+   *   - Disable LCD voltage options
868
+   */
869
+
870
+  /**
871
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
872
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
873
+   * If disabled, OD mode is the hard-coded default on 3.0
874
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
875
+   * differs, a mode set eeprom write will be completed at initialization.
876
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
877
+   */
878
+  #define BLTOUCH_SET_5V_MODE
879
+
880
+  /**
881
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
882
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
883
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
884
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
885
+   */
886
+  //#define BLTOUCH_FORCE_MODE_SET
887
+
888
+  /**
889
+   * Use "HIGH SPEED" mode for probing.
890
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
891
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
892
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
893
+   */
894
+  //#define BLTOUCH_HS_MODE
895
+
896
+  // Safety: Enable voltage mode settings in the LCD menu.
897
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
898
+
899
+#endif // BLTOUCH
844 900
 
845 901
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
846 902
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Creality/Ender-4/Configuration.h View File

@@ -838,15 +838,71 @@
838 838
  */
839 839
 //#define BLTOUCH
840 840
 #if ENABLED(BLTOUCH)
841
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
841
+  /**
842
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
843
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
844
+   * advanced commands.
845
+   *
846
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
847
+   *       check the wiring of the BROWN, RED and ORANGE wires.
848
+   *
849
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
850
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
851
+   *       like they would be with a real switch. So please check the wiring first.
852
+   *
853
+   * Settings for all BLTouch and clone probes:
854
+   */
855
+
856
+  // Safety: The probe needs time to recognize the command.
857
+  //         Minimum command delay (ms). Enable and increase if needed.
858
+  //#define BLTOUCH_DELAY 500
842 859
 
843 860
   /**
844
-   * BLTouch V3.0 and newer smart series
845
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
846
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
861
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
847 862
    */
848
-  #define BLTOUCH_FORCE_5V_MODE
849
-#endif
863
+
864
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
865
+  //          in special cases, like noisy or filtered input configurations.
866
+  //#define BLTOUCH_FORCE_SW_MODE
867
+
868
+  /**
869
+   * Settings for BLTouch Smart 3.0 and 3.1
870
+   * Summary:
871
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
872
+   *   - High-Speed mode
873
+   *   - Disable LCD voltage options
874
+   */
875
+
876
+  /**
877
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
878
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
879
+   * If disabled, OD mode is the hard-coded default on 3.0
880
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
881
+   * differs, a mode set eeprom write will be completed at initialization.
882
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
883
+   */
884
+  #define BLTOUCH_SET_5V_MODE
885
+
886
+  /**
887
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
888
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
889
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
890
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
891
+   */
892
+  //#define BLTOUCH_FORCE_MODE_SET
893
+
894
+  /**
895
+   * Use "HIGH SPEED" mode for probing.
896
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
897
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
898
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
899
+   */
900
+  //#define BLTOUCH_HS_MODE
901
+
902
+  // Safety: Enable voltage mode settings in the LCD menu.
903
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
904
+
905
+#endif // BLTOUCH
850 906
 
851 907
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
852 908
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Einstart-S/Configuration.h View File

@@ -837,15 +837,71 @@
837 837
  */
838 838
 //#define BLTOUCH
839 839
 #if ENABLED(BLTOUCH)
840
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
840
+  /**
841
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
842
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
843
+   * advanced commands.
844
+   *
845
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
846
+   *       check the wiring of the BROWN, RED and ORANGE wires.
847
+   *
848
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
849
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
850
+   *       like they would be with a real switch. So please check the wiring first.
851
+   *
852
+   * Settings for all BLTouch and clone probes:
853
+   */
854
+
855
+  // Safety: The probe needs time to recognize the command.
856
+  //         Minimum command delay (ms). Enable and increase if needed.
857
+  //#define BLTOUCH_DELAY 500
841 858
 
842 859
   /**
843
-   * BLTouch V3.0 and newer smart series
844
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
845
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
860
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
846 861
    */
847
-  //#define BLTOUCH_FORCE_5V_MODE
848
-#endif
862
+
863
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
864
+  //          in special cases, like noisy or filtered input configurations.
865
+  //#define BLTOUCH_FORCE_SW_MODE
866
+
867
+  /**
868
+   * Settings for BLTouch Smart 3.0 and 3.1
869
+   * Summary:
870
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
871
+   *   - High-Speed mode
872
+   *   - Disable LCD voltage options
873
+   */
874
+
875
+  /**
876
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
877
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
878
+   * If disabled, OD mode is the hard-coded default on 3.0
879
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
880
+   * differs, a mode set eeprom write will be completed at initialization.
881
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
882
+   */
883
+  //#define BLTOUCH_SET_5V_MODE
884
+
885
+  /**
886
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
887
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
888
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
889
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
890
+   */
891
+  //#define BLTOUCH_FORCE_MODE_SET
892
+
893
+  /**
894
+   * Use "HIGH SPEED" mode for probing.
895
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
896
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
897
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
898
+   */
899
+  //#define BLTOUCH_HS_MODE
900
+
901
+  // Safety: Enable voltage mode settings in the LCD menu.
902
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
903
+
904
+#endif // BLTOUCH
849 905
 
850 906
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
851 907
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Felix/Configuration.h View File

@@ -810,15 +810,71 @@
810 810
  */
811 811
 //#define BLTOUCH
812 812
 #if ENABLED(BLTOUCH)
813
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
813
+  /**
814
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
815
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
816
+   * advanced commands.
817
+   *
818
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
819
+   *       check the wiring of the BROWN, RED and ORANGE wires.
820
+   *
821
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
822
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
823
+   *       like they would be with a real switch. So please check the wiring first.
824
+   *
825
+   * Settings for all BLTouch and clone probes:
826
+   */
827
+
828
+  // Safety: The probe needs time to recognize the command.
829
+  //         Minimum command delay (ms). Enable and increase if needed.
830
+  //#define BLTOUCH_DELAY 500
814 831
 
815 832
   /**
816
-   * BLTouch V3.0 and newer smart series
817
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
818
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
833
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
819 834
    */
820
-  //#define BLTOUCH_FORCE_5V_MODE
821
-#endif
835
+
836
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
837
+  //          in special cases, like noisy or filtered input configurations.
838
+  //#define BLTOUCH_FORCE_SW_MODE
839
+
840
+  /**
841
+   * Settings for BLTouch Smart 3.0 and 3.1
842
+   * Summary:
843
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
844
+   *   - High-Speed mode
845
+   *   - Disable LCD voltage options
846
+   */
847
+
848
+  /**
849
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
850
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
851
+   * If disabled, OD mode is the hard-coded default on 3.0
852
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
853
+   * differs, a mode set eeprom write will be completed at initialization.
854
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
855
+   */
856
+  //#define BLTOUCH_SET_5V_MODE
857
+
858
+  /**
859
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
860
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
861
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
862
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
863
+   */
864
+  //#define BLTOUCH_FORCE_MODE_SET
865
+
866
+  /**
867
+   * Use "HIGH SPEED" mode for probing.
868
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
869
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
870
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
871
+   */
872
+  //#define BLTOUCH_HS_MODE
873
+
874
+  // Safety: Enable voltage mode settings in the LCD menu.
875
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
876
+
877
+#endif // BLTOUCH
822 878
 
823 879
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
824 880
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Felix/DUAL/Configuration.h View File

@@ -810,15 +810,71 @@
810 810
  */
811 811
 //#define BLTOUCH
812 812
 #if ENABLED(BLTOUCH)
813
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
813
+  /**
814
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
815
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
816
+   * advanced commands.
817
+   *
818
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
819
+   *       check the wiring of the BROWN, RED and ORANGE wires.
820
+   *
821
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
822
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
823
+   *       like they would be with a real switch. So please check the wiring first.
824
+   *
825
+   * Settings for all BLTouch and clone probes:
826
+   */
827
+
828
+  // Safety: The probe needs time to recognize the command.
829
+  //         Minimum command delay (ms). Enable and increase if needed.
830
+  //#define BLTOUCH_DELAY 500
814 831
 
815 832
   /**
816
-   * BLTouch V3.0 and newer smart series
817
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
818
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
833
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
819 834
    */
820
-  //#define BLTOUCH_FORCE_5V_MODE
821
-#endif
835
+
836
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
837
+  //          in special cases, like noisy or filtered input configurations.
838
+  //#define BLTOUCH_FORCE_SW_MODE
839
+
840
+  /**
841
+   * Settings for BLTouch Smart 3.0 and 3.1
842
+   * Summary:
843
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
844
+   *   - High-Speed mode
845
+   *   - Disable LCD voltage options
846
+   */
847
+
848
+  /**
849
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
850
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
851
+   * If disabled, OD mode is the hard-coded default on 3.0
852
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
853
+   * differs, a mode set eeprom write will be completed at initialization.
854
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
855
+   */
856
+  //#define BLTOUCH_SET_5V_MODE
857
+
858
+  /**
859
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
860
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
861
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
862
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
863
+   */
864
+  //#define BLTOUCH_FORCE_MODE_SET
865
+
866
+  /**
867
+   * Use "HIGH SPEED" mode for probing.
868
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
869
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
870
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
871
+   */
872
+  //#define BLTOUCH_HS_MODE
873
+
874
+  // Safety: Enable voltage mode settings in the LCD menu.
875
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
876
+
877
+#endif // BLTOUCH
822 878
 
823 879
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
824 880
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/FlashForge/CreatorPro/Configuration.h View File

@@ -820,15 +820,71 @@
820 820
  */
821 821
 //#define BLTOUCH
822 822
 #if ENABLED(BLTOUCH)
823
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
823
+  /**
824
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
825
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
826
+   * advanced commands.
827
+   *
828
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
829
+   *       check the wiring of the BROWN, RED and ORANGE wires.
830
+   *
831
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
832
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
833
+   *       like they would be with a real switch. So please check the wiring first.
834
+   *
835
+   * Settings for all BLTouch and clone probes:
836
+   */
837
+
838
+  // Safety: The probe needs time to recognize the command.
839
+  //         Minimum command delay (ms). Enable and increase if needed.
840
+  //#define BLTOUCH_DELAY 500
824 841
 
825 842
   /**
826
-   * BLTouch V3.0 and newer smart series
827
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
828
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
843
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
829 844
    */
830
-  //#define BLTOUCH_FORCE_5V_MODE
831
-#endif
845
+
846
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
847
+  //          in special cases, like noisy or filtered input configurations.
848
+  //#define BLTOUCH_FORCE_SW_MODE
849
+
850
+  /**
851
+   * Settings for BLTouch Smart 3.0 and 3.1
852
+   * Summary:
853
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
854
+   *   - High-Speed mode
855
+   *   - Disable LCD voltage options
856
+   */
857
+
858
+  /**
859
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
860
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
861
+   * If disabled, OD mode is the hard-coded default on 3.0
862
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
863
+   * differs, a mode set eeprom write will be completed at initialization.
864
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
865
+   */
866
+  //#define BLTOUCH_SET_5V_MODE
867
+
868
+  /**
869
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
870
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
871
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
872
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
873
+   */
874
+  //#define BLTOUCH_FORCE_MODE_SET
875
+
876
+  /**
877
+   * Use "HIGH SPEED" mode for probing.
878
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
879
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
880
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
881
+   */
882
+  //#define BLTOUCH_HS_MODE
883
+
884
+  // Safety: Enable voltage mode settings in the LCD menu.
885
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
886
+
887
+#endif // BLTOUCH
832 888
 
833 889
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
834 890
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/FolgerTech/i3-2020/Configuration.h View File

@@ -834,15 +834,71 @@
834 834
  */
835 835
 //#define BLTOUCH
836 836
 #if ENABLED(BLTOUCH)
837
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
837
+  /**
838
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
839
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
840
+   * advanced commands.
841
+   *
842
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
843
+   *       check the wiring of the BROWN, RED and ORANGE wires.
844
+   *
845
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
846
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
847
+   *       like they would be with a real switch. So please check the wiring first.
848
+   *
849
+   * Settings for all BLTouch and clone probes:
850
+   */
851
+
852
+  // Safety: The probe needs time to recognize the command.
853
+  //         Minimum command delay (ms). Enable and increase if needed.
854
+  //#define BLTOUCH_DELAY 500
838 855
 
839 856
   /**
840
-   * BLTouch V3.0 and newer smart series
841
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
842
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
857
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
843 858
    */
844
-  //#define BLTOUCH_FORCE_5V_MODE
845
-#endif
859
+
860
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
861
+  //          in special cases, like noisy or filtered input configurations.
862
+  //#define BLTOUCH_FORCE_SW_MODE
863
+
864
+  /**
865
+   * Settings for BLTouch Smart 3.0 and 3.1
866
+   * Summary:
867
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
868
+   *   - High-Speed mode
869
+   *   - Disable LCD voltage options
870
+   */
871
+
872
+  /**
873
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
874
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
875
+   * If disabled, OD mode is the hard-coded default on 3.0
876
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
877
+   * differs, a mode set eeprom write will be completed at initialization.
878
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
879
+   */
880
+  //#define BLTOUCH_SET_5V_MODE
881
+
882
+  /**
883
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
884
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
885
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
886
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
887
+   */
888
+  //#define BLTOUCH_FORCE_MODE_SET
889
+
890
+  /**
891
+   * Use "HIGH SPEED" mode for probing.
892
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
893
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
894
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
895
+   */
896
+  //#define BLTOUCH_HS_MODE
897
+
898
+  // Safety: Enable voltage mode settings in the LCD menu.
899
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
900
+
901
+#endif // BLTOUCH
846 902
 
847 903
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
848 904
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Formbot/Raptor/Configuration.h View File

@@ -911,15 +911,71 @@
911 911
  */
912 912
 #define BLTOUCH
913 913
 #if ENABLED(BLTOUCH)
914
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
914
+  /**
915
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
916
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
917
+   * advanced commands.
918
+   *
919
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
920
+   *       check the wiring of the BROWN, RED and ORANGE wires.
921
+   *
922
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
923
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
924
+   *       like they would be with a real switch. So please check the wiring first.
925
+   *
926
+   * Settings for all BLTouch and clone probes:
927
+   */
928
+
929
+  // Safety: The probe needs time to recognize the command.
930
+  //         Minimum command delay (ms). Enable and increase if needed.
931
+  //#define BLTOUCH_DELAY 500
915 932
 
916 933
   /**
917
-   * BLTouch V3.0 and newer smart series
918
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
919
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
934
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
920 935
    */
921
-  //#define BLTOUCH_FORCE_5V_MODE
922
-#endif
936
+
937
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
938
+  //          in special cases, like noisy or filtered input configurations.
939
+  //#define BLTOUCH_FORCE_SW_MODE
940
+
941
+  /**
942
+   * Settings for BLTouch Smart 3.0 and 3.1
943
+   * Summary:
944
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
945
+   *   - High-Speed mode
946
+   *   - Disable LCD voltage options
947
+   */
948
+
949
+  /**
950
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
951
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
952
+   * If disabled, OD mode is the hard-coded default on 3.0
953
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
954
+   * differs, a mode set eeprom write will be completed at initialization.
955
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
956
+   */
957
+  //#define BLTOUCH_SET_5V_MODE
958
+
959
+  /**
960
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
961
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
962
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
963
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
964
+   */
965
+  //#define BLTOUCH_FORCE_MODE_SET
966
+
967
+  /**
968
+   * Use "HIGH SPEED" mode for probing.
969
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
970
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
971
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
972
+   */
973
+  //#define BLTOUCH_HS_MODE
974
+
975
+  // Safety: Enable voltage mode settings in the LCD menu.
976
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
977
+
978
+#endif // BLTOUCH
923 979
 
924 980
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
925 981
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Formbot/T_Rex_2+/Configuration.h View File

@@ -857,15 +857,71 @@
857 857
  */
858 858
 #define BLTOUCH
859 859
 #if ENABLED(BLTOUCH)
860
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
860
+  /**
861
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
862
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
863
+   * advanced commands.
864
+   *
865
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
866
+   *       check the wiring of the BROWN, RED and ORANGE wires.
867
+   *
868
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
869
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
870
+   *       like they would be with a real switch. So please check the wiring first.
871
+   *
872
+   * Settings for all BLTouch and clone probes:
873
+   */
874
+
875
+  // Safety: The probe needs time to recognize the command.
876
+  //         Minimum command delay (ms). Enable and increase if needed.
877
+  //#define BLTOUCH_DELAY 500
861 878
 
862 879
   /**
863
-   * BLTouch V3.0 and newer smart series
864
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
865
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
880
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
866 881
    */
867
-  //#define BLTOUCH_FORCE_5V_MODE
868
-#endif
882
+
883
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
884
+  //          in special cases, like noisy or filtered input configurations.
885
+  //#define BLTOUCH_FORCE_SW_MODE
886
+
887
+  /**
888
+   * Settings for BLTouch Smart 3.0 and 3.1
889
+   * Summary:
890
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
891
+   *   - High-Speed mode
892
+   *   - Disable LCD voltage options
893
+   */
894
+
895
+  /**
896
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
897
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
898
+   * If disabled, OD mode is the hard-coded default on 3.0
899
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
900
+   * differs, a mode set eeprom write will be completed at initialization.
901
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
902
+   */
903
+  //#define BLTOUCH_SET_5V_MODE
904
+
905
+  /**
906
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
907
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
908
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
909
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
910
+   */
911
+  //#define BLTOUCH_FORCE_MODE_SET
912
+
913
+  /**
914
+   * Use "HIGH SPEED" mode for probing.
915
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
916
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
917
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
918
+   */
919
+  //#define BLTOUCH_HS_MODE
920
+
921
+  // Safety: Enable voltage mode settings in the LCD menu.
922
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
923
+
924
+#endif // BLTOUCH
869 925
 
870 926
 
871 927
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)

+ 62
- 6
config/examples/Formbot/T_Rex_3/Configuration.h View File

@@ -844,15 +844,71 @@
844 844
  */
845 845
 #define BLTOUCH
846 846
 #if ENABLED(BLTOUCH)
847
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
847
+  /**
848
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
849
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
850
+   * advanced commands.
851
+   *
852
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
853
+   *       check the wiring of the BROWN, RED and ORANGE wires.
854
+   *
855
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
856
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
857
+   *       like they would be with a real switch. So please check the wiring first.
858
+   *
859
+   * Settings for all BLTouch and clone probes:
860
+   */
861
+
862
+  // Safety: The probe needs time to recognize the command.
863
+  //         Minimum command delay (ms). Enable and increase if needed.
864
+  //#define BLTOUCH_DELAY 500
848 865
 
849 866
   /**
850
-   * BLTouch V3.0 and newer smart series
851
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
852
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
867
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
853 868
    */
854
-  //#define BLTOUCH_FORCE_5V_MODE
855
-#endif
869
+
870
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
871
+  //          in special cases, like noisy or filtered input configurations.
872
+  //#define BLTOUCH_FORCE_SW_MODE
873
+
874
+  /**
875
+   * Settings for BLTouch Smart 3.0 and 3.1
876
+   * Summary:
877
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
878
+   *   - High-Speed mode
879
+   *   - Disable LCD voltage options
880
+   */
881
+
882
+  /**
883
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
884
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
885
+   * If disabled, OD mode is the hard-coded default on 3.0
886
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
887
+   * differs, a mode set eeprom write will be completed at initialization.
888
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
889
+   */
890
+  //#define BLTOUCH_SET_5V_MODE
891
+
892
+  /**
893
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
894
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
895
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
896
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
897
+   */
898
+  //#define BLTOUCH_FORCE_MODE_SET
899
+
900
+  /**
901
+   * Use "HIGH SPEED" mode for probing.
902
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
903
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
904
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
905
+   */
906
+  //#define BLTOUCH_HS_MODE
907
+
908
+  // Safety: Enable voltage mode settings in the LCD menu.
909
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
910
+
911
+#endif // BLTOUCH
856 912
 
857 913
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
858 914
 //#define SOLENOID_PROBE

+ 62
- 7
config/examples/Geeetech/A10M/Configuration.h View File

@@ -811,16 +811,71 @@
811 811
  */
812 812
 //#define BLTOUCH
813 813
 #if ENABLED(BLTOUCH)
814
-  #define BLTOUCH_DELAY 200   // Minimum Command delay (ms). Enable and increase if needed
815
-  #define BLTOUCH_HS_MODE
814
+  /**
815
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
816
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
817
+   * advanced commands.
818
+   *
819
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
820
+   *       check the wiring of the BROWN, RED and ORANGE wires.
821
+   *
822
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
823
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
824
+   *       like they would be with a real switch. So please check the wiring first.
825
+   *
826
+   * Settings for all BLTouch and clone probes:
827
+   */
828
+
829
+  // Safety: The probe needs time to recognize the command.
830
+  //         Minimum command delay (ms). Enable and increase if needed.
831
+  #define BLTOUCH_DELAY 200
816 832
 
817 833
   /**
818
-   * BLTouch V3.0 and newer smart series
819
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
820
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
834
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
821 835
    */
822
-  //#define BLTOUCH_FORCE_5V_MODE
823
-#endif
836
+
837
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
838
+  //          in special cases, like noisy or filtered input configurations.
839
+  //#define BLTOUCH_FORCE_SW_MODE
840
+
841
+  /**
842
+   * Settings for BLTouch Smart 3.0 and 3.1
843
+   * Summary:
844
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
845
+   *   - High-Speed mode
846
+   *   - Disable LCD voltage options
847
+   */
848
+
849
+  /**
850
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
851
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
852
+   * If disabled, OD mode is the hard-coded default on 3.0
853
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
854
+   * differs, a mode set eeprom write will be completed at initialization.
855
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
856
+   */
857
+  //#define BLTOUCH_SET_5V_MODE
858
+
859
+  /**
860
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
861
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
862
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
863
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
864
+   */
865
+  //#define BLTOUCH_FORCE_MODE_SET
866
+
867
+  /**
868
+   * Use "HIGH SPEED" mode for probing.
869
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
870
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
871
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
872
+   */
873
+  #define BLTOUCH_HS_MODE
874
+
875
+  // Safety: Enable voltage mode settings in the LCD menu.
876
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
877
+
878
+#endif // BLTOUCH
824 879
 
825 880
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
826 881
 //#define SOLENOID_PROBE

+ 62
- 7
config/examples/Geeetech/A20M/Configuration.h View File

@@ -811,16 +811,71 @@
811 811
  */
812 812
 //#define BLTOUCH
813 813
 #if ENABLED(BLTOUCH)
814
-  #define BLTOUCH_DELAY 200   // Minimum Command delay (ms). Enable and increase if needed
815
-  #define BLTOUCH_HS_MODE
814
+  /**
815
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
816
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
817
+   * advanced commands.
818
+   *
819
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
820
+   *       check the wiring of the BROWN, RED and ORANGE wires.
821
+   *
822
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
823
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
824
+   *       like they would be with a real switch. So please check the wiring first.
825
+   *
826
+   * Settings for all BLTouch and clone probes:
827
+   */
828
+
829
+  // Safety: The probe needs time to recognize the command.
830
+  //         Minimum command delay (ms). Enable and increase if needed.
831
+  #define BLTOUCH_DELAY 200
816 832
 
817 833
   /**
818
-   * BLTouch V3.0 and newer smart series
819
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
820
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
834
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
821 835
    */
822
-  //#define BLTOUCH_FORCE_5V_MODE
823
-#endif
836
+
837
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
838
+  //          in special cases, like noisy or filtered input configurations.
839
+  //#define BLTOUCH_FORCE_SW_MODE
840
+
841
+  /**
842
+   * Settings for BLTouch Smart 3.0 and 3.1
843
+   * Summary:
844
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
845
+   *   - High-Speed mode
846
+   *   - Disable LCD voltage options
847
+   */
848
+
849
+  /**
850
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
851
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
852
+   * If disabled, OD mode is the hard-coded default on 3.0
853
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
854
+   * differs, a mode set eeprom write will be completed at initialization.
855
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
856
+   */
857
+  //#define BLTOUCH_SET_5V_MODE
858
+
859
+  /**
860
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
861
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
862
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
863
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
864
+   */
865
+  //#define BLTOUCH_FORCE_MODE_SET
866
+
867
+  /**
868
+   * Use "HIGH SPEED" mode for probing.
869
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
870
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
871
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
872
+   */
873
+  #define BLTOUCH_HS_MODE
874
+
875
+  // Safety: Enable voltage mode settings in the LCD menu.
876
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
877
+
878
+#endif // BLTOUCH
824 879
 
825 880
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
826 881
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Geeetech/GT2560/Configuration.h View File

@@ -843,15 +843,71 @@
843 843
  */
844 844
 //#define BLTOUCH
845 845
 #if ENABLED(BLTOUCH)
846
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
846
+  /**
847
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
848
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
849
+   * advanced commands.
850
+   *
851
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
852
+   *       check the wiring of the BROWN, RED and ORANGE wires.
853
+   *
854
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
855
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
856
+   *       like they would be with a real switch. So please check the wiring first.
857
+   *
858
+   * Settings for all BLTouch and clone probes:
859
+   */
860
+
861
+  // Safety: The probe needs time to recognize the command.
862
+  //         Minimum command delay (ms). Enable and increase if needed.
863
+  //#define BLTOUCH_DELAY 500
847 864
 
848 865
   /**
849
-   * BLTouch V3.0 and newer smart series
850
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
851
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
866
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
852 867
    */
853
-  //#define BLTOUCH_FORCE_5V_MODE
854
-#endif
868
+
869
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
870
+  //          in special cases, like noisy or filtered input configurations.
871
+  //#define BLTOUCH_FORCE_SW_MODE
872
+
873
+  /**
874
+   * Settings for BLTouch Smart 3.0 and 3.1
875
+   * Summary:
876
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
877
+   *   - High-Speed mode
878
+   *   - Disable LCD voltage options
879
+   */
880
+
881
+  /**
882
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
883
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
884
+   * If disabled, OD mode is the hard-coded default on 3.0
885
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
886
+   * differs, a mode set eeprom write will be completed at initialization.
887
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
888
+   */
889
+  //#define BLTOUCH_SET_5V_MODE
890
+
891
+  /**
892
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
893
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
894
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
895
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
896
+   */
897
+  //#define BLTOUCH_FORCE_MODE_SET
898
+
899
+  /**
900
+   * Use "HIGH SPEED" mode for probing.
901
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
902
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
903
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
904
+   */
905
+  //#define BLTOUCH_HS_MODE
906
+
907
+  // Safety: Enable voltage mode settings in the LCD menu.
908
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
909
+
910
+#endif // BLTOUCH
855 911
 
856 912
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
857 913
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Geeetech/MeCreator2/Configuration.h View File

@@ -835,15 +835,71 @@
835 835
  */
836 836
 //#define BLTOUCH
837 837
 #if ENABLED(BLTOUCH)
838
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
838
+  /**
839
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
840
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
841
+   * advanced commands.
842
+   *
843
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
844
+   *       check the wiring of the BROWN, RED and ORANGE wires.
845
+   *
846
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
847
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
848
+   *       like they would be with a real switch. So please check the wiring first.
849
+   *
850
+   * Settings for all BLTouch and clone probes:
851
+   */
852
+
853
+  // Safety: The probe needs time to recognize the command.
854
+  //         Minimum command delay (ms). Enable and increase if needed.
855
+  //#define BLTOUCH_DELAY 500
839 856
 
840 857
   /**
841
-   * BLTouch V3.0 and newer smart series
842
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
843
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
858
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
844 859
    */
845
-  //#define BLTOUCH_FORCE_5V_MODE
846
-#endif
860
+
861
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
862
+  //          in special cases, like noisy or filtered input configurations.
863
+  //#define BLTOUCH_FORCE_SW_MODE
864
+
865
+  /**
866
+   * Settings for BLTouch Smart 3.0 and 3.1
867
+   * Summary:
868
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
869
+   *   - High-Speed mode
870
+   *   - Disable LCD voltage options
871
+   */
872
+
873
+  /**
874
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
875
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
876
+   * If disabled, OD mode is the hard-coded default on 3.0
877
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
878
+   * differs, a mode set eeprom write will be completed at initialization.
879
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
880
+   */
881
+  //#define BLTOUCH_SET_5V_MODE
882
+
883
+  /**
884
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
885
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
886
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
887
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
888
+   */
889
+  //#define BLTOUCH_FORCE_MODE_SET
890
+
891
+  /**
892
+   * Use "HIGH SPEED" mode for probing.
893
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
894
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
895
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
896
+   */
897
+  //#define BLTOUCH_HS_MODE
898
+
899
+  // Safety: Enable voltage mode settings in the LCD menu.
900
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
901
+
902
+#endif // BLTOUCH
847 903
 
848 904
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
849 905
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Geeetech/Prusa i3 Pro B/bltouch/Configuration.h View File

@@ -848,15 +848,71 @@
848 848
  */
849 849
 #define BLTOUCH
850 850
 #if ENABLED(BLTOUCH)
851
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
851
+  /**
852
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
853
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
854
+   * advanced commands.
855
+   *
856
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
857
+   *       check the wiring of the BROWN, RED and ORANGE wires.
858
+   *
859
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
860
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
861
+   *       like they would be with a real switch. So please check the wiring first.
862
+   *
863
+   * Settings for all BLTouch and clone probes:
864
+   */
865
+
866
+  // Safety: The probe needs time to recognize the command.
867
+  //         Minimum command delay (ms). Enable and increase if needed.
868
+  //#define BLTOUCH_DELAY 500
852 869
 
853 870
   /**
854
-   * BLTouch V3.0 and newer smart series
855
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
856
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
871
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
857 872
    */
858
-  //#define BLTOUCH_FORCE_5V_MODE
859
-#endif
873
+
874
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
875
+  //          in special cases, like noisy or filtered input configurations.
876
+  //#define BLTOUCH_FORCE_SW_MODE
877
+
878
+  /**
879
+   * Settings for BLTouch Smart 3.0 and 3.1
880
+   * Summary:
881
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
882
+   *   - High-Speed mode
883
+   *   - Disable LCD voltage options
884
+   */
885
+
886
+  /**
887
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
888
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
889
+   * If disabled, OD mode is the hard-coded default on 3.0
890
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
891
+   * differs, a mode set eeprom write will be completed at initialization.
892
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
893
+   */
894
+  //#define BLTOUCH_SET_5V_MODE
895
+
896
+  /**
897
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
898
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
899
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
900
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
901
+   */
902
+  //#define BLTOUCH_FORCE_MODE_SET
903
+
904
+  /**
905
+   * Use "HIGH SPEED" mode for probing.
906
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
907
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
908
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
909
+   */
910
+  //#define BLTOUCH_HS_MODE
911
+
912
+  // Safety: Enable voltage mode settings in the LCD menu.
913
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
914
+
915
+#endif // BLTOUCH
860 916
 
861 917
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
862 918
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Geeetech/Prusa i3 Pro B/noprobe/Configuration.h View File

@@ -848,15 +848,71 @@
848 848
  */
849 849
 //#define BLTOUCH
850 850
 #if ENABLED(BLTOUCH)
851
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
851
+  /**
852
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
853
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
854
+   * advanced commands.
855
+   *
856
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
857
+   *       check the wiring of the BROWN, RED and ORANGE wires.
858
+   *
859
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
860
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
861
+   *       like they would be with a real switch. So please check the wiring first.
862
+   *
863
+   * Settings for all BLTouch and clone probes:
864
+   */
865
+
866
+  // Safety: The probe needs time to recognize the command.
867
+  //         Minimum command delay (ms). Enable and increase if needed.
868
+  //#define BLTOUCH_DELAY 500
852 869
 
853 870
   /**
854
-   * BLTouch V3.0 and newer smart series
855
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
856
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
871
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
857 872
    */
858
-  //#define BLTOUCH_FORCE_5V_MODE
859
-#endif
873
+
874
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
875
+  //          in special cases, like noisy or filtered input configurations.
876
+  //#define BLTOUCH_FORCE_SW_MODE
877
+
878
+  /**
879
+   * Settings for BLTouch Smart 3.0 and 3.1
880
+   * Summary:
881
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
882
+   *   - High-Speed mode
883
+   *   - Disable LCD voltage options
884
+   */
885
+
886
+  /**
887
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
888
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
889
+   * If disabled, OD mode is the hard-coded default on 3.0
890
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
891
+   * differs, a mode set eeprom write will be completed at initialization.
892
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
893
+   */
894
+  //#define BLTOUCH_SET_5V_MODE
895
+
896
+  /**
897
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
898
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
899
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
900
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
901
+   */
902
+  //#define BLTOUCH_FORCE_MODE_SET
903
+
904
+  /**
905
+   * Use "HIGH SPEED" mode for probing.
906
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
907
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
908
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
909
+   */
910
+  //#define BLTOUCH_HS_MODE
911
+
912
+  // Safety: Enable voltage mode settings in the LCD menu.
913
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
914
+
915
+#endif // BLTOUCH
860 916
 
861 917
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
862 918
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Geeetech/Prusa i3 Pro C/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Geeetech/Prusa i3 Pro W/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Infitary/i3-M508/Configuration.h View File

@@ -832,15 +832,71 @@
832 832
  */
833 833
 //#define BLTOUCH
834 834
 #if ENABLED(BLTOUCH)
835
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
835
+  /**
836
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
837
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
838
+   * advanced commands.
839
+   *
840
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
841
+   *       check the wiring of the BROWN, RED and ORANGE wires.
842
+   *
843
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
844
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
845
+   *       like they would be with a real switch. So please check the wiring first.
846
+   *
847
+   * Settings for all BLTouch and clone probes:
848
+   */
849
+
850
+  // Safety: The probe needs time to recognize the command.
851
+  //         Minimum command delay (ms). Enable and increase if needed.
852
+  //#define BLTOUCH_DELAY 500
836 853
 
837 854
   /**
838
-   * BLTouch V3.0 and newer smart series
839
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
840
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
855
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
841 856
    */
842
-  //#define BLTOUCH_FORCE_5V_MODE
843
-#endif
857
+
858
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
859
+  //          in special cases, like noisy or filtered input configurations.
860
+  //#define BLTOUCH_FORCE_SW_MODE
861
+
862
+  /**
863
+   * Settings for BLTouch Smart 3.0 and 3.1
864
+   * Summary:
865
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
866
+   *   - High-Speed mode
867
+   *   - Disable LCD voltage options
868
+   */
869
+
870
+  /**
871
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
872
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
873
+   * If disabled, OD mode is the hard-coded default on 3.0
874
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
875
+   * differs, a mode set eeprom write will be completed at initialization.
876
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
877
+   */
878
+  //#define BLTOUCH_SET_5V_MODE
879
+
880
+  /**
881
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
882
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
883
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
884
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
885
+   */
886
+  //#define BLTOUCH_FORCE_MODE_SET
887
+
888
+  /**
889
+   * Use "HIGH SPEED" mode for probing.
890
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
891
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
892
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
893
+   */
894
+  //#define BLTOUCH_HS_MODE
895
+
896
+  // Safety: Enable voltage mode settings in the LCD menu.
897
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
898
+
899
+#endif // BLTOUCH
844 900
 
845 901
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
846 902
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/JGAurora/A5/Configuration.h View File

@@ -840,15 +840,71 @@
840 840
  */
841 841
 //#define BLTOUCH
842 842
 #if ENABLED(BLTOUCH)
843
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
843
+  /**
844
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
845
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
846
+   * advanced commands.
847
+   *
848
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
849
+   *       check the wiring of the BROWN, RED and ORANGE wires.
850
+   *
851
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
852
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
853
+   *       like they would be with a real switch. So please check the wiring first.
854
+   *
855
+   * Settings for all BLTouch and clone probes:
856
+   */
857
+
858
+  // Safety: The probe needs time to recognize the command.
859
+  //         Minimum command delay (ms). Enable and increase if needed.
860
+  //#define BLTOUCH_DELAY 500
844 861
 
845 862
   /**
846
-   * BLTouch V3.0 and newer smart series
847
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
848
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
863
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
849 864
    */
850
-  //#define BLTOUCH_FORCE_5V_MODE
851
-#endif
865
+
866
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
867
+  //          in special cases, like noisy or filtered input configurations.
868
+  //#define BLTOUCH_FORCE_SW_MODE
869
+
870
+  /**
871
+   * Settings for BLTouch Smart 3.0 and 3.1
872
+   * Summary:
873
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
874
+   *   - High-Speed mode
875
+   *   - Disable LCD voltage options
876
+   */
877
+
878
+  /**
879
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
880
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
881
+   * If disabled, OD mode is the hard-coded default on 3.0
882
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
883
+   * differs, a mode set eeprom write will be completed at initialization.
884
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
885
+   */
886
+  //#define BLTOUCH_SET_5V_MODE
887
+
888
+  /**
889
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
890
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
891
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
892
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
893
+   */
894
+  //#define BLTOUCH_FORCE_MODE_SET
895
+
896
+  /**
897
+   * Use "HIGH SPEED" mode for probing.
898
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
899
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
900
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
901
+   */
902
+  //#define BLTOUCH_HS_MODE
903
+
904
+  // Safety: Enable voltage mode settings in the LCD menu.
905
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
906
+
907
+#endif // BLTOUCH
852 908
 
853 909
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
854 910
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/MakerParts/Configuration.h View File

@@ -848,15 +848,71 @@
848 848
  */
849 849
 //#define BLTOUCH
850 850
 #if ENABLED(BLTOUCH)
851
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
851
+  /**
852
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
853
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
854
+   * advanced commands.
855
+   *
856
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
857
+   *       check the wiring of the BROWN, RED and ORANGE wires.
858
+   *
859
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
860
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
861
+   *       like they would be with a real switch. So please check the wiring first.
862
+   *
863
+   * Settings for all BLTouch and clone probes:
864
+   */
865
+
866
+  // Safety: The probe needs time to recognize the command.
867
+  //         Minimum command delay (ms). Enable and increase if needed.
868
+  //#define BLTOUCH_DELAY 500
852 869
 
853 870
   /**
854
-   * BLTouch V3.0 and newer smart series
855
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
856
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
871
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
857 872
    */
858
-  //#define BLTOUCH_FORCE_5V_MODE
859
-#endif
873
+
874
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
875
+  //          in special cases, like noisy or filtered input configurations.
876
+  //#define BLTOUCH_FORCE_SW_MODE
877
+
878
+  /**
879
+   * Settings for BLTouch Smart 3.0 and 3.1
880
+   * Summary:
881
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
882
+   *   - High-Speed mode
883
+   *   - Disable LCD voltage options
884
+   */
885
+
886
+  /**
887
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
888
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
889
+   * If disabled, OD mode is the hard-coded default on 3.0
890
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
891
+   * differs, a mode set eeprom write will be completed at initialization.
892
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
893
+   */
894
+  //#define BLTOUCH_SET_5V_MODE
895
+
896
+  /**
897
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
898
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
899
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
900
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
901
+   */
902
+  //#define BLTOUCH_FORCE_MODE_SET
903
+
904
+  /**
905
+   * Use "HIGH SPEED" mode for probing.
906
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
907
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
908
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
909
+   */
910
+  //#define BLTOUCH_HS_MODE
911
+
912
+  // Safety: Enable voltage mode settings in the LCD menu.
913
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
914
+
915
+#endif // BLTOUCH
860 916
 
861 917
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
862 918
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Malyan/M150/Configuration.h View File

@@ -848,15 +848,71 @@
848 848
  */
849 849
 //#define BLTOUCH
850 850
 #if ENABLED(BLTOUCH)
851
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
851
+  /**
852
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
853
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
854
+   * advanced commands.
855
+   *
856
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
857
+   *       check the wiring of the BROWN, RED and ORANGE wires.
858
+   *
859
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
860
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
861
+   *       like they would be with a real switch. So please check the wiring first.
862
+   *
863
+   * Settings for all BLTouch and clone probes:
864
+   */
865
+
866
+  // Safety: The probe needs time to recognize the command.
867
+  //         Minimum command delay (ms). Enable and increase if needed.
868
+  //#define BLTOUCH_DELAY 500
852 869
 
853 870
   /**
854
-   * BLTouch V3.0 and newer smart series
855
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
856
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
871
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
857 872
    */
858
-  //#define BLTOUCH_FORCE_5V_MODE
859
-#endif
873
+
874
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
875
+  //          in special cases, like noisy or filtered input configurations.
876
+  //#define BLTOUCH_FORCE_SW_MODE
877
+
878
+  /**
879
+   * Settings for BLTouch Smart 3.0 and 3.1
880
+   * Summary:
881
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
882
+   *   - High-Speed mode
883
+   *   - Disable LCD voltage options
884
+   */
885
+
886
+  /**
887
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
888
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
889
+   * If disabled, OD mode is the hard-coded default on 3.0
890
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
891
+   * differs, a mode set eeprom write will be completed at initialization.
892
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
893
+   */
894
+  //#define BLTOUCH_SET_5V_MODE
895
+
896
+  /**
897
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
898
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
899
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
900
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
901
+   */
902
+  //#define BLTOUCH_FORCE_MODE_SET
903
+
904
+  /**
905
+   * Use "HIGH SPEED" mode for probing.
906
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
907
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
908
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
909
+   */
910
+  //#define BLTOUCH_HS_MODE
911
+
912
+  // Safety: Enable voltage mode settings in the LCD menu.
913
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
914
+
915
+#endif // BLTOUCH
860 916
 
861 917
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
862 918
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Malyan/M200/Configuration.h View File

@@ -827,15 +827,71 @@
827 827
  */
828 828
 //#define BLTOUCH
829 829
 #if ENABLED(BLTOUCH)
830
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
830
+  /**
831
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
832
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
833
+   * advanced commands.
834
+   *
835
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
836
+   *       check the wiring of the BROWN, RED and ORANGE wires.
837
+   *
838
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
839
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
840
+   *       like they would be with a real switch. So please check the wiring first.
841
+   *
842
+   * Settings for all BLTouch and clone probes:
843
+   */
844
+
845
+  // Safety: The probe needs time to recognize the command.
846
+  //         Minimum command delay (ms). Enable and increase if needed.
847
+  //#define BLTOUCH_DELAY 500
831 848
 
832 849
   /**
833
-   * BLTouch V3.0 and newer smart series
834
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
835
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
850
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
836 851
    */
837
-  //#define BLTOUCH_FORCE_5V_MODE
838
-#endif
852
+
853
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
854
+  //          in special cases, like noisy or filtered input configurations.
855
+  //#define BLTOUCH_FORCE_SW_MODE
856
+
857
+  /**
858
+   * Settings for BLTouch Smart 3.0 and 3.1
859
+   * Summary:
860
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
861
+   *   - High-Speed mode
862
+   *   - Disable LCD voltage options
863
+   */
864
+
865
+  /**
866
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
867
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
868
+   * If disabled, OD mode is the hard-coded default on 3.0
869
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
870
+   * differs, a mode set eeprom write will be completed at initialization.
871
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
872
+   */
873
+  //#define BLTOUCH_SET_5V_MODE
874
+
875
+  /**
876
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
877
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
878
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
879
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
880
+   */
881
+  //#define BLTOUCH_FORCE_MODE_SET
882
+
883
+  /**
884
+   * Use "HIGH SPEED" mode for probing.
885
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
886
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
887
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
888
+   */
889
+  //#define BLTOUCH_HS_MODE
890
+
891
+  // Safety: Enable voltage mode settings in the LCD menu.
892
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
893
+
894
+#endif // BLTOUCH
839 895
 
840 896
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
841 897
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Micromake/C1/basic/Configuration.h View File

@@ -832,15 +832,71 @@
832 832
  */
833 833
 //#define BLTOUCH
834 834
 #if ENABLED(BLTOUCH)
835
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
835
+  /**
836
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
837
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
838
+   * advanced commands.
839
+   *
840
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
841
+   *       check the wiring of the BROWN, RED and ORANGE wires.
842
+   *
843
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
844
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
845
+   *       like they would be with a real switch. So please check the wiring first.
846
+   *
847
+   * Settings for all BLTouch and clone probes:
848
+   */
849
+
850
+  // Safety: The probe needs time to recognize the command.
851
+  //         Minimum command delay (ms). Enable and increase if needed.
852
+  //#define BLTOUCH_DELAY 500
836 853
 
837 854
   /**
838
-   * BLTouch V3.0 and newer smart series
839
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
840
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
855
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
841 856
    */
842
-  //#define BLTOUCH_FORCE_5V_MODE
843
-#endif
857
+
858
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
859
+  //          in special cases, like noisy or filtered input configurations.
860
+  //#define BLTOUCH_FORCE_SW_MODE
861
+
862
+  /**
863
+   * Settings for BLTouch Smart 3.0 and 3.1
864
+   * Summary:
865
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
866
+   *   - High-Speed mode
867
+   *   - Disable LCD voltage options
868
+   */
869
+
870
+  /**
871
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
872
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
873
+   * If disabled, OD mode is the hard-coded default on 3.0
874
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
875
+   * differs, a mode set eeprom write will be completed at initialization.
876
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
877
+   */
878
+  //#define BLTOUCH_SET_5V_MODE
879
+
880
+  /**
881
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
882
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
883
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
884
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
885
+   */
886
+  //#define BLTOUCH_FORCE_MODE_SET
887
+
888
+  /**
889
+   * Use "HIGH SPEED" mode for probing.
890
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
891
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
892
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
893
+   */
894
+  //#define BLTOUCH_HS_MODE
895
+
896
+  // Safety: Enable voltage mode settings in the LCD menu.
897
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
898
+
899
+#endif // BLTOUCH
844 900
 
845 901
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
846 902
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Micromake/C1/enhanced/Configuration.h View File

@@ -832,15 +832,71 @@
832 832
  */
833 833
 //#define BLTOUCH
834 834
 #if ENABLED(BLTOUCH)
835
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
835
+  /**
836
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
837
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
838
+   * advanced commands.
839
+   *
840
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
841
+   *       check the wiring of the BROWN, RED and ORANGE wires.
842
+   *
843
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
844
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
845
+   *       like they would be with a real switch. So please check the wiring first.
846
+   *
847
+   * Settings for all BLTouch and clone probes:
848
+   */
849
+
850
+  // Safety: The probe needs time to recognize the command.
851
+  //         Minimum command delay (ms). Enable and increase if needed.
852
+  //#define BLTOUCH_DELAY 500
836 853
 
837 854
   /**
838
-   * BLTouch V3.0 and newer smart series
839
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
840
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
855
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
841 856
    */
842
-  //#define BLTOUCH_FORCE_5V_MODE
843
-#endif
857
+
858
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
859
+  //          in special cases, like noisy or filtered input configurations.
860
+  //#define BLTOUCH_FORCE_SW_MODE
861
+
862
+  /**
863
+   * Settings for BLTouch Smart 3.0 and 3.1
864
+   * Summary:
865
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
866
+   *   - High-Speed mode
867
+   *   - Disable LCD voltage options
868
+   */
869
+
870
+  /**
871
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
872
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
873
+   * If disabled, OD mode is the hard-coded default on 3.0
874
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
875
+   * differs, a mode set eeprom write will be completed at initialization.
876
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
877
+   */
878
+  //#define BLTOUCH_SET_5V_MODE
879
+
880
+  /**
881
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
882
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
883
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
884
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
885
+   */
886
+  //#define BLTOUCH_FORCE_MODE_SET
887
+
888
+  /**
889
+   * Use "HIGH SPEED" mode for probing.
890
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
891
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
892
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
893
+   */
894
+  //#define BLTOUCH_HS_MODE
895
+
896
+  // Safety: Enable voltage mode settings in the LCD menu.
897
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
898
+
899
+#endif // BLTOUCH
844 900
 
845 901
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
846 902
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Mks/Robin/Configuration.h View File

@@ -829,15 +829,71 @@
829 829
  */
830 830
 //#define BLTOUCH
831 831
 #if ENABLED(BLTOUCH)
832
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
832
+  /**
833
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
834
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
835
+   * advanced commands.
836
+   *
837
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
838
+   *       check the wiring of the BROWN, RED and ORANGE wires.
839
+   *
840
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
841
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
842
+   *       like they would be with a real switch. So please check the wiring first.
843
+   *
844
+   * Settings for all BLTouch and clone probes:
845
+   */
846
+
847
+  // Safety: The probe needs time to recognize the command.
848
+  //         Minimum command delay (ms). Enable and increase if needed.
849
+  //#define BLTOUCH_DELAY 500
833 850
 
834 851
   /**
835
-   * BLTouch V3.0 and newer smart series
836
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
837
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
852
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
838 853
    */
839
-  //#define BLTOUCH_FORCE_5V_MODE
840
-#endif
854
+
855
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
856
+  //          in special cases, like noisy or filtered input configurations.
857
+  //#define BLTOUCH_FORCE_SW_MODE
858
+
859
+  /**
860
+   * Settings for BLTouch Smart 3.0 and 3.1
861
+   * Summary:
862
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
863
+   *   - High-Speed mode
864
+   *   - Disable LCD voltage options
865
+   */
866
+
867
+  /**
868
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
869
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
870
+   * If disabled, OD mode is the hard-coded default on 3.0
871
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
872
+   * differs, a mode set eeprom write will be completed at initialization.
873
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
874
+   */
875
+  //#define BLTOUCH_SET_5V_MODE
876
+
877
+  /**
878
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
879
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
880
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
881
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
882
+   */
883
+  //#define BLTOUCH_FORCE_MODE_SET
884
+
885
+  /**
886
+   * Use "HIGH SPEED" mode for probing.
887
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
888
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
889
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
890
+   */
891
+  //#define BLTOUCH_HS_MODE
892
+
893
+  // Safety: Enable voltage mode settings in the LCD menu.
894
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
895
+
896
+#endif // BLTOUCH
841 897
 
842 898
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
843 899
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Mks/Sbase/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Printrbot/PrintrboardG2/Configuration.h View File

@@ -836,15 +836,71 @@
836 836
  */
837 837
 //#define BLTOUCH
838 838
 #if ENABLED(BLTOUCH)
839
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
839
+  /**
840
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
841
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
842
+   * advanced commands.
843
+   *
844
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
845
+   *       check the wiring of the BROWN, RED and ORANGE wires.
846
+   *
847
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
848
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
849
+   *       like they would be with a real switch. So please check the wiring first.
850
+   *
851
+   * Settings for all BLTouch and clone probes:
852
+   */
853
+
854
+  // Safety: The probe needs time to recognize the command.
855
+  //         Minimum command delay (ms). Enable and increase if needed.
856
+  //#define BLTOUCH_DELAY 500
840 857
 
841 858
   /**
842
-   * BLTouch V3.0 and newer smart series
843
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
844
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
859
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
845 860
    */
846
-  //#define BLTOUCH_FORCE_5V_MODE
847
-#endif
861
+
862
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
863
+  //          in special cases, like noisy or filtered input configurations.
864
+  //#define BLTOUCH_FORCE_SW_MODE
865
+
866
+  /**
867
+   * Settings for BLTouch Smart 3.0 and 3.1
868
+   * Summary:
869
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
870
+   *   - High-Speed mode
871
+   *   - Disable LCD voltage options
872
+   */
873
+
874
+  /**
875
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
876
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
877
+   * If disabled, OD mode is the hard-coded default on 3.0
878
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
879
+   * differs, a mode set eeprom write will be completed at initialization.
880
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
881
+   */
882
+  //#define BLTOUCH_SET_5V_MODE
883
+
884
+  /**
885
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
886
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
887
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
888
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
889
+   */
890
+  //#define BLTOUCH_FORCE_MODE_SET
891
+
892
+  /**
893
+   * Use "HIGH SPEED" mode for probing.
894
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
895
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
896
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
897
+   */
898
+  //#define BLTOUCH_HS_MODE
899
+
900
+  // Safety: Enable voltage mode settings in the LCD menu.
901
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
902
+
903
+#endif // BLTOUCH
848 904
 
849 905
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
850 906
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/RapideLite/RL200/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/RepRapPro/Huxley/Configuration.h View File

@@ -868,15 +868,71 @@ Black rubber belt(MXL), 18 - tooth aluminium pulley : 87.489 step per mm (Huxley
868 868
  */
869 869
 //#define BLTOUCH
870 870
 #if ENABLED(BLTOUCH)
871
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
871
+  /**
872
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
873
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
874
+   * advanced commands.
875
+   *
876
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
877
+   *       check the wiring of the BROWN, RED and ORANGE wires.
878
+   *
879
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
880
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
881
+   *       like they would be with a real switch. So please check the wiring first.
882
+   *
883
+   * Settings for all BLTouch and clone probes:
884
+   */
885
+
886
+  // Safety: The probe needs time to recognize the command.
887
+  //         Minimum command delay (ms). Enable and increase if needed.
888
+  //#define BLTOUCH_DELAY 500
872 889
 
873 890
   /**
874
-   * BLTouch V3.0 and newer smart series
875
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
876
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
891
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
877 892
    */
878
-  //#define BLTOUCH_FORCE_5V_MODE
879
-#endif
893
+
894
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
895
+  //          in special cases, like noisy or filtered input configurations.
896
+  //#define BLTOUCH_FORCE_SW_MODE
897
+
898
+  /**
899
+   * Settings for BLTouch Smart 3.0 and 3.1
900
+   * Summary:
901
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
902
+   *   - High-Speed mode
903
+   *   - Disable LCD voltage options
904
+   */
905
+
906
+  /**
907
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
908
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
909
+   * If disabled, OD mode is the hard-coded default on 3.0
910
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
911
+   * differs, a mode set eeprom write will be completed at initialization.
912
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
913
+   */
914
+  //#define BLTOUCH_SET_5V_MODE
915
+
916
+  /**
917
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
918
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
919
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
920
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
921
+   */
922
+  //#define BLTOUCH_FORCE_MODE_SET
923
+
924
+  /**
925
+   * Use "HIGH SPEED" mode for probing.
926
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
927
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
928
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
929
+   */
930
+  //#define BLTOUCH_HS_MODE
931
+
932
+  // Safety: Enable voltage mode settings in the LCD menu.
933
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
934
+
935
+#endif // BLTOUCH
880 936
 
881 937
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
882 938
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/RepRapWorld/Megatronics/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/RigidBot/Configuration.h View File

@@ -826,15 +826,71 @@
826 826
  */
827 827
 //#define BLTOUCH
828 828
 #if ENABLED(BLTOUCH)
829
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
829
+  /**
830
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
831
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
832
+   * advanced commands.
833
+   *
834
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
835
+   *       check the wiring of the BROWN, RED and ORANGE wires.
836
+   *
837
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
838
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
839
+   *       like they would be with a real switch. So please check the wiring first.
840
+   *
841
+   * Settings for all BLTouch and clone probes:
842
+   */
843
+
844
+  // Safety: The probe needs time to recognize the command.
845
+  //         Minimum command delay (ms). Enable and increase if needed.
846
+  //#define BLTOUCH_DELAY 500
830 847
 
831 848
   /**
832
-   * BLTouch V3.0 and newer smart series
833
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
834
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
849
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
835 850
    */
836
-  //#define BLTOUCH_FORCE_5V_MODE
837
-#endif
851
+
852
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
853
+  //          in special cases, like noisy or filtered input configurations.
854
+  //#define BLTOUCH_FORCE_SW_MODE
855
+
856
+  /**
857
+   * Settings for BLTouch Smart 3.0 and 3.1
858
+   * Summary:
859
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
860
+   *   - High-Speed mode
861
+   *   - Disable LCD voltage options
862
+   */
863
+
864
+  /**
865
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
866
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
867
+   * If disabled, OD mode is the hard-coded default on 3.0
868
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
869
+   * differs, a mode set eeprom write will be completed at initialization.
870
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
871
+   */
872
+  //#define BLTOUCH_SET_5V_MODE
873
+
874
+  /**
875
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
876
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
877
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
878
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
879
+   */
880
+  //#define BLTOUCH_FORCE_MODE_SET
881
+
882
+  /**
883
+   * Use "HIGH SPEED" mode for probing.
884
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
885
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
886
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
887
+   */
888
+  //#define BLTOUCH_HS_MODE
889
+
890
+  // Safety: Enable voltage mode settings in the LCD menu.
891
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
892
+
893
+#endif // BLTOUCH
838 894
 
839 895
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
840 896
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/SCARA/Configuration.h View File

@@ -841,15 +841,71 @@
841 841
  */
842 842
 //#define BLTOUCH
843 843
 #if ENABLED(BLTOUCH)
844
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
844
+  /**
845
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
846
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
847
+   * advanced commands.
848
+   *
849
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
850
+   *       check the wiring of the BROWN, RED and ORANGE wires.
851
+   *
852
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
853
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
854
+   *       like they would be with a real switch. So please check the wiring first.
855
+   *
856
+   * Settings for all BLTouch and clone probes:
857
+   */
858
+
859
+  // Safety: The probe needs time to recognize the command.
860
+  //         Minimum command delay (ms). Enable and increase if needed.
861
+  //#define BLTOUCH_DELAY 500
845 862
 
846 863
   /**
847
-   * BLTouch V3.0 and newer smart series
848
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
849
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
864
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
850 865
    */
851
-  //#define BLTOUCH_FORCE_5V_MODE
852
-#endif
866
+
867
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
868
+  //          in special cases, like noisy or filtered input configurations.
869
+  //#define BLTOUCH_FORCE_SW_MODE
870
+
871
+  /**
872
+   * Settings for BLTouch Smart 3.0 and 3.1
873
+   * Summary:
874
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
875
+   *   - High-Speed mode
876
+   *   - Disable LCD voltage options
877
+   */
878
+
879
+  /**
880
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
881
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
882
+   * If disabled, OD mode is the hard-coded default on 3.0
883
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
884
+   * differs, a mode set eeprom write will be completed at initialization.
885
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
886
+   */
887
+  //#define BLTOUCH_SET_5V_MODE
888
+
889
+  /**
890
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
891
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
892
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
893
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
894
+   */
895
+  //#define BLTOUCH_FORCE_MODE_SET
896
+
897
+  /**
898
+   * Use "HIGH SPEED" mode for probing.
899
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
900
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
901
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
902
+   */
903
+  //#define BLTOUCH_HS_MODE
904
+
905
+  // Safety: Enable voltage mode settings in the LCD menu.
906
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
907
+
908
+#endif // BLTOUCH
853 909
 
854 910
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
855 911
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/STM32/Black_STM32F407VET6/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/STM32/STM32F10/Configuration.h View File

@@ -830,15 +830,71 @@
830 830
  */
831 831
 //#define BLTOUCH
832 832
 #if ENABLED(BLTOUCH)
833
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
833
+  /**
834
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
835
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
836
+   * advanced commands.
837
+   *
838
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
839
+   *       check the wiring of the BROWN, RED and ORANGE wires.
840
+   *
841
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
842
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
843
+   *       like they would be with a real switch. So please check the wiring first.
844
+   *
845
+   * Settings for all BLTouch and clone probes:
846
+   */
847
+
848
+  // Safety: The probe needs time to recognize the command.
849
+  //         Minimum command delay (ms). Enable and increase if needed.
850
+  //#define BLTOUCH_DELAY 500
834 851
 
835 852
   /**
836
-   * BLTouch V3.0 and newer smart series
837
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
838
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
853
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
839 854
    */
840
-  //#define BLTOUCH_FORCE_5V_MODE
841
-#endif
855
+
856
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
857
+  //          in special cases, like noisy or filtered input configurations.
858
+  //#define BLTOUCH_FORCE_SW_MODE
859
+
860
+  /**
861
+   * Settings for BLTouch Smart 3.0 and 3.1
862
+   * Summary:
863
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
864
+   *   - High-Speed mode
865
+   *   - Disable LCD voltage options
866
+   */
867
+
868
+  /**
869
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
870
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
871
+   * If disabled, OD mode is the hard-coded default on 3.0
872
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
873
+   * differs, a mode set eeprom write will be completed at initialization.
874
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
875
+   */
876
+  //#define BLTOUCH_SET_5V_MODE
877
+
878
+  /**
879
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
880
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
881
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
882
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
883
+   */
884
+  //#define BLTOUCH_FORCE_MODE_SET
885
+
886
+  /**
887
+   * Use "HIGH SPEED" mode for probing.
888
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
889
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
890
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
891
+   */
892
+  //#define BLTOUCH_HS_MODE
893
+
894
+  // Safety: Enable voltage mode settings in the LCD menu.
895
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
896
+
897
+#endif // BLTOUCH
842 898
 
843 899
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
844 900
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/STM32/STM32F4/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/STM32/stm32f103ret6/Configuration.h View File

@@ -830,15 +830,71 @@
830 830
  */
831 831
 //#define BLTOUCH
832 832
 #if ENABLED(BLTOUCH)
833
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
833
+  /**
834
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
835
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
836
+   * advanced commands.
837
+   *
838
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
839
+   *       check the wiring of the BROWN, RED and ORANGE wires.
840
+   *
841
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
842
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
843
+   *       like they would be with a real switch. So please check the wiring first.
844
+   *
845
+   * Settings for all BLTouch and clone probes:
846
+   */
847
+
848
+  // Safety: The probe needs time to recognize the command.
849
+  //         Minimum command delay (ms). Enable and increase if needed.
850
+  //#define BLTOUCH_DELAY 500
834 851
 
835 852
   /**
836
-   * BLTouch V3.0 and newer smart series
837
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
838
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
853
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
839 854
    */
840
-  //#define BLTOUCH_FORCE_5V_MODE
841
-#endif
855
+
856
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
857
+  //          in special cases, like noisy or filtered input configurations.
858
+  //#define BLTOUCH_FORCE_SW_MODE
859
+
860
+  /**
861
+   * Settings for BLTouch Smart 3.0 and 3.1
862
+   * Summary:
863
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
864
+   *   - High-Speed mode
865
+   *   - Disable LCD voltage options
866
+   */
867
+
868
+  /**
869
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
870
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
871
+   * If disabled, OD mode is the hard-coded default on 3.0
872
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
873
+   * differs, a mode set eeprom write will be completed at initialization.
874
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
875
+   */
876
+  //#define BLTOUCH_SET_5V_MODE
877
+
878
+  /**
879
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
880
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
881
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
882
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
883
+   */
884
+  //#define BLTOUCH_FORCE_MODE_SET
885
+
886
+  /**
887
+   * Use "HIGH SPEED" mode for probing.
888
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
889
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
890
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
891
+   */
892
+  //#define BLTOUCH_HS_MODE
893
+
894
+  // Safety: Enable voltage mode settings in the LCD menu.
895
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
896
+
897
+#endif // BLTOUCH
842 898
 
843 899
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
844 900
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Sanguinololu/Configuration.h View File

@@ -859,15 +859,71 @@
859 859
  */
860 860
 //#define BLTOUCH
861 861
 #if ENABLED(BLTOUCH)
862
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
862
+  /**
863
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
864
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
865
+   * advanced commands.
866
+   *
867
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
868
+   *       check the wiring of the BROWN, RED and ORANGE wires.
869
+   *
870
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
871
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
872
+   *       like they would be with a real switch. So please check the wiring first.
873
+   *
874
+   * Settings for all BLTouch and clone probes:
875
+   */
876
+
877
+  // Safety: The probe needs time to recognize the command.
878
+  //         Minimum command delay (ms). Enable and increase if needed.
879
+  //#define BLTOUCH_DELAY 500
863 880
 
864 881
   /**
865
-   * BLTouch V3.0 and newer smart series
866
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
867
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
882
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
868 883
    */
869
-  //#define BLTOUCH_FORCE_5V_MODE
870
-#endif
884
+
885
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
886
+  //          in special cases, like noisy or filtered input configurations.
887
+  //#define BLTOUCH_FORCE_SW_MODE
888
+
889
+  /**
890
+   * Settings for BLTouch Smart 3.0 and 3.1
891
+   * Summary:
892
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
893
+   *   - High-Speed mode
894
+   *   - Disable LCD voltage options
895
+   */
896
+
897
+  /**
898
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
899
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
900
+   * If disabled, OD mode is the hard-coded default on 3.0
901
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
902
+   * differs, a mode set eeprom write will be completed at initialization.
903
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
904
+   */
905
+  //#define BLTOUCH_SET_5V_MODE
906
+
907
+  /**
908
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
909
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
910
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
911
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
912
+   */
913
+  //#define BLTOUCH_FORCE_MODE_SET
914
+
915
+  /**
916
+   * Use "HIGH SPEED" mode for probing.
917
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
918
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
919
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
920
+   */
921
+  //#define BLTOUCH_HS_MODE
922
+
923
+  // Safety: Enable voltage mode settings in the LCD menu.
924
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
925
+
926
+#endif // BLTOUCH
871 927
 
872 928
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
873 929
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/TheBorg/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/TinyBoy2/Configuration.h View File

@@ -879,15 +879,71 @@
879 879
  */
880 880
 //#define BLTOUCH
881 881
 #if ENABLED(BLTOUCH)
882
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
882
+  /**
883
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
884
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
885
+   * advanced commands.
886
+   *
887
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
888
+   *       check the wiring of the BROWN, RED and ORANGE wires.
889
+   *
890
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
891
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
892
+   *       like they would be with a real switch. So please check the wiring first.
893
+   *
894
+   * Settings for all BLTouch and clone probes:
895
+   */
896
+
897
+  // Safety: The probe needs time to recognize the command.
898
+  //         Minimum command delay (ms). Enable and increase if needed.
899
+  //#define BLTOUCH_DELAY 500
883 900
 
884 901
   /**
885
-   * BLTouch V3.0 and newer smart series
886
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
887
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
902
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
888 903
    */
889
-  //#define BLTOUCH_FORCE_5V_MODE
890
-#endif
904
+
905
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
906
+  //          in special cases, like noisy or filtered input configurations.
907
+  //#define BLTOUCH_FORCE_SW_MODE
908
+
909
+  /**
910
+   * Settings for BLTouch Smart 3.0 and 3.1
911
+   * Summary:
912
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
913
+   *   - High-Speed mode
914
+   *   - Disable LCD voltage options
915
+   */
916
+
917
+  /**
918
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
919
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
920
+   * If disabled, OD mode is the hard-coded default on 3.0
921
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
922
+   * differs, a mode set eeprom write will be completed at initialization.
923
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
924
+   */
925
+  //#define BLTOUCH_SET_5V_MODE
926
+
927
+  /**
928
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
929
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
930
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
931
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
932
+   */
933
+  //#define BLTOUCH_FORCE_MODE_SET
934
+
935
+  /**
936
+   * Use "HIGH SPEED" mode for probing.
937
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
938
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
939
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
940
+   */
941
+  //#define BLTOUCH_HS_MODE
942
+
943
+  // Safety: Enable voltage mode settings in the LCD menu.
944
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
945
+
946
+#endif // BLTOUCH
891 947
 
892 948
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
893 949
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Tronxy/X1/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Tronxy/X3A/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Tronxy/X5S-2E/Configuration.h View File

@@ -849,15 +849,71 @@
849 849
  */
850 850
 //#define BLTOUCH
851 851
 #if ENABLED(BLTOUCH)
852
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
852
+  /**
853
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
854
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
855
+   * advanced commands.
856
+   *
857
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
858
+   *       check the wiring of the BROWN, RED and ORANGE wires.
859
+   *
860
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
861
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
862
+   *       like they would be with a real switch. So please check the wiring first.
863
+   *
864
+   * Settings for all BLTouch and clone probes:
865
+   */
866
+
867
+  // Safety: The probe needs time to recognize the command.
868
+  //         Minimum command delay (ms). Enable and increase if needed.
869
+  //#define BLTOUCH_DELAY 500
853 870
 
854 871
   /**
855
-   * BLTouch V3.0 and newer smart series
856
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
857
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
872
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
858 873
    */
859
-  //#define BLTOUCH_FORCE_5V_MODE
860
-#endif
874
+
875
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
876
+  //          in special cases, like noisy or filtered input configurations.
877
+  //#define BLTOUCH_FORCE_SW_MODE
878
+
879
+  /**
880
+   * Settings for BLTouch Smart 3.0 and 3.1
881
+   * Summary:
882
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
883
+   *   - High-Speed mode
884
+   *   - Disable LCD voltage options
885
+   */
886
+
887
+  /**
888
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
889
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
890
+   * If disabled, OD mode is the hard-coded default on 3.0
891
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
892
+   * differs, a mode set eeprom write will be completed at initialization.
893
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
894
+   */
895
+  //#define BLTOUCH_SET_5V_MODE
896
+
897
+  /**
898
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
899
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
900
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
901
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
902
+   */
903
+  //#define BLTOUCH_FORCE_MODE_SET
904
+
905
+  /**
906
+   * Use "HIGH SPEED" mode for probing.
907
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
908
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
909
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
910
+   */
911
+  //#define BLTOUCH_HS_MODE
912
+
913
+  // Safety: Enable voltage mode settings in the LCD menu.
914
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
915
+
916
+#endif // BLTOUCH
861 917
 
862 918
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
863 919
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Tronxy/X5S/Configuration.h View File

@@ -827,15 +827,71 @@
827 827
  */
828 828
 //#define BLTOUCH
829 829
 #if ENABLED(BLTOUCH)
830
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
830
+  /**
831
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
832
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
833
+   * advanced commands.
834
+   *
835
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
836
+   *       check the wiring of the BROWN, RED and ORANGE wires.
837
+   *
838
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
839
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
840
+   *       like they would be with a real switch. So please check the wiring first.
841
+   *
842
+   * Settings for all BLTouch and clone probes:
843
+   */
844
+
845
+  // Safety: The probe needs time to recognize the command.
846
+  //         Minimum command delay (ms). Enable and increase if needed.
847
+  //#define BLTOUCH_DELAY 500
831 848
 
832 849
   /**
833
-   * BLTouch V3.0 and newer smart series
834
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
835
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
850
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
836 851
    */
837
-  //#define BLTOUCH_FORCE_5V_MODE
838
-#endif
852
+
853
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
854
+  //          in special cases, like noisy or filtered input configurations.
855
+  //#define BLTOUCH_FORCE_SW_MODE
856
+
857
+  /**
858
+   * Settings for BLTouch Smart 3.0 and 3.1
859
+   * Summary:
860
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
861
+   *   - High-Speed mode
862
+   *   - Disable LCD voltage options
863
+   */
864
+
865
+  /**
866
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
867
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
868
+   * If disabled, OD mode is the hard-coded default on 3.0
869
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
870
+   * differs, a mode set eeprom write will be completed at initialization.
871
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
872
+   */
873
+  //#define BLTOUCH_SET_5V_MODE
874
+
875
+  /**
876
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
877
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
878
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
879
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
880
+   */
881
+  //#define BLTOUCH_FORCE_MODE_SET
882
+
883
+  /**
884
+   * Use "HIGH SPEED" mode for probing.
885
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
886
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
887
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
888
+   */
889
+  //#define BLTOUCH_HS_MODE
890
+
891
+  // Safety: Enable voltage mode settings in the LCD menu.
892
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
893
+
894
+#endif // BLTOUCH
839 895
 
840 896
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
841 897
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Tronxy/XY100/Configuration.h View File

@@ -839,15 +839,71 @@
839 839
  */
840 840
 //#define BLTOUCH
841 841
 #if ENABLED(BLTOUCH)
842
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
842
+  /**
843
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
844
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
845
+   * advanced commands.
846
+   *
847
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
848
+   *       check the wiring of the BROWN, RED and ORANGE wires.
849
+   *
850
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
851
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
852
+   *       like they would be with a real switch. So please check the wiring first.
853
+   *
854
+   * Settings for all BLTouch and clone probes:
855
+   */
856
+
857
+  // Safety: The probe needs time to recognize the command.
858
+  //         Minimum command delay (ms). Enable and increase if needed.
859
+  //#define BLTOUCH_DELAY 500
843 860
 
844 861
   /**
845
-   * BLTouch V3.0 and newer smart series
846
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
847
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
862
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
848 863
    */
849
-  //#define BLTOUCH_FORCE_5V_MODE
850
-#endif
864
+
865
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
866
+  //          in special cases, like noisy or filtered input configurations.
867
+  //#define BLTOUCH_FORCE_SW_MODE
868
+
869
+  /**
870
+   * Settings for BLTouch Smart 3.0 and 3.1
871
+   * Summary:
872
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
873
+   *   - High-Speed mode
874
+   *   - Disable LCD voltage options
875
+   */
876
+
877
+  /**
878
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
879
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
880
+   * If disabled, OD mode is the hard-coded default on 3.0
881
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
882
+   * differs, a mode set eeprom write will be completed at initialization.
883
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
884
+   */
885
+  //#define BLTOUCH_SET_5V_MODE
886
+
887
+  /**
888
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
889
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
890
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
891
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
892
+   */
893
+  //#define BLTOUCH_FORCE_MODE_SET
894
+
895
+  /**
896
+   * Use "HIGH SPEED" mode for probing.
897
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
898
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
899
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
900
+   */
901
+  //#define BLTOUCH_HS_MODE
902
+
903
+  // Safety: Enable voltage mode settings in the LCD menu.
904
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
905
+
906
+#endif // BLTOUCH
851 907
 
852 908
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
853 909
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/UltiMachine/Archim1/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/UltiMachine/Archim2/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/VORONDesign/Configuration.h View File

@@ -837,15 +837,71 @@
837 837
  */
838 838
 //#define BLTOUCH
839 839
 #if ENABLED(BLTOUCH)
840
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
840
+  /**
841
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
842
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
843
+   * advanced commands.
844
+   *
845
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
846
+   *       check the wiring of the BROWN, RED and ORANGE wires.
847
+   *
848
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
849
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
850
+   *       like they would be with a real switch. So please check the wiring first.
851
+   *
852
+   * Settings for all BLTouch and clone probes:
853
+   */
854
+
855
+  // Safety: The probe needs time to recognize the command.
856
+  //         Minimum command delay (ms). Enable and increase if needed.
857
+  //#define BLTOUCH_DELAY 500
841 858
 
842 859
   /**
843
-   * BLTouch V3.0 and newer smart series
844
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
845
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
860
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
846 861
    */
847
-  //#define BLTOUCH_FORCE_5V_MODE
848
-#endif
862
+
863
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
864
+  //          in special cases, like noisy or filtered input configurations.
865
+  //#define BLTOUCH_FORCE_SW_MODE
866
+
867
+  /**
868
+   * Settings for BLTouch Smart 3.0 and 3.1
869
+   * Summary:
870
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
871
+   *   - High-Speed mode
872
+   *   - Disable LCD voltage options
873
+   */
874
+
875
+  /**
876
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
877
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
878
+   * If disabled, OD mode is the hard-coded default on 3.0
879
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
880
+   * differs, a mode set eeprom write will be completed at initialization.
881
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
882
+   */
883
+  //#define BLTOUCH_SET_5V_MODE
884
+
885
+  /**
886
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
887
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
888
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
889
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
890
+   */
891
+  //#define BLTOUCH_FORCE_MODE_SET
892
+
893
+  /**
894
+   * Use "HIGH SPEED" mode for probing.
895
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
896
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
897
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
898
+   */
899
+  //#define BLTOUCH_HS_MODE
900
+
901
+  // Safety: Enable voltage mode settings in the LCD menu.
902
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
903
+
904
+#endif // BLTOUCH
849 905
 
850 906
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
851 907
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Velleman/K8200/Configuration.h View File

@@ -857,15 +857,71 @@
857 857
  */
858 858
 //#define BLTOUCH
859 859
 #if ENABLED(BLTOUCH)
860
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
860
+  /**
861
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
862
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
863
+   * advanced commands.
864
+   *
865
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
866
+   *       check the wiring of the BROWN, RED and ORANGE wires.
867
+   *
868
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
869
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
870
+   *       like they would be with a real switch. So please check the wiring first.
871
+   *
872
+   * Settings for all BLTouch and clone probes:
873
+   */
874
+
875
+  // Safety: The probe needs time to recognize the command.
876
+  //         Minimum command delay (ms). Enable and increase if needed.
877
+  //#define BLTOUCH_DELAY 500
861 878
 
862 879
   /**
863
-   * BLTouch V3.0 and newer smart series
864
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
865
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
880
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
866 881
    */
867
-  //#define BLTOUCH_FORCE_5V_MODE
868
-#endif
882
+
883
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
884
+  //          in special cases, like noisy or filtered input configurations.
885
+  //#define BLTOUCH_FORCE_SW_MODE
886
+
887
+  /**
888
+   * Settings for BLTouch Smart 3.0 and 3.1
889
+   * Summary:
890
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
891
+   *   - High-Speed mode
892
+   *   - Disable LCD voltage options
893
+   */
894
+
895
+  /**
896
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
897
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
898
+   * If disabled, OD mode is the hard-coded default on 3.0
899
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
900
+   * differs, a mode set eeprom write will be completed at initialization.
901
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
902
+   */
903
+  //#define BLTOUCH_SET_5V_MODE
904
+
905
+  /**
906
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
907
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
908
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
909
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
910
+   */
911
+  //#define BLTOUCH_FORCE_MODE_SET
912
+
913
+  /**
914
+   * Use "HIGH SPEED" mode for probing.
915
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
916
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
917
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
918
+   */
919
+  //#define BLTOUCH_HS_MODE
920
+
921
+  // Safety: Enable voltage mode settings in the LCD menu.
922
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
923
+
924
+#endif // BLTOUCH
869 925
 
870 926
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
871 927
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Velleman/K8400/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Velleman/K8400/Dual-head/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/WASP/PowerWASP/Configuration.h View File

@@ -847,15 +847,71 @@
847 847
  */
848 848
 //#define BLTOUCH
849 849
 #if ENABLED(BLTOUCH)
850
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
850
+  /**
851
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
852
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
853
+   * advanced commands.
854
+   *
855
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
856
+   *       check the wiring of the BROWN, RED and ORANGE wires.
857
+   *
858
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
859
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
860
+   *       like they would be with a real switch. So please check the wiring first.
861
+   *
862
+   * Settings for all BLTouch and clone probes:
863
+   */
864
+
865
+  // Safety: The probe needs time to recognize the command.
866
+  //         Minimum command delay (ms). Enable and increase if needed.
867
+  //#define BLTOUCH_DELAY 500
851 868
 
852 869
   /**
853
-   * BLTouch V3.0 and newer smart series
854
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
855
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
870
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
856 871
    */
857
-  //#define BLTOUCH_FORCE_5V_MODE
858
-#endif
872
+
873
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
874
+  //          in special cases, like noisy or filtered input configurations.
875
+  //#define BLTOUCH_FORCE_SW_MODE
876
+
877
+  /**
878
+   * Settings for BLTouch Smart 3.0 and 3.1
879
+   * Summary:
880
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
881
+   *   - High-Speed mode
882
+   *   - Disable LCD voltage options
883
+   */
884
+
885
+  /**
886
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
887
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
888
+   * If disabled, OD mode is the hard-coded default on 3.0
889
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
890
+   * differs, a mode set eeprom write will be completed at initialization.
891
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
892
+   */
893
+  //#define BLTOUCH_SET_5V_MODE
894
+
895
+  /**
896
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
897
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
898
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
899
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
900
+   */
901
+  //#define BLTOUCH_FORCE_MODE_SET
902
+
903
+  /**
904
+   * Use "HIGH SPEED" mode for probing.
905
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
906
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
907
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
908
+   */
909
+  //#define BLTOUCH_HS_MODE
910
+
911
+  // Safety: Enable voltage mode settings in the LCD menu.
912
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
913
+
914
+#endif // BLTOUCH
859 915
 
860 916
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
861 917
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/Wanhao/Duplicator 6/Configuration.h View File

@@ -838,15 +838,71 @@
838 838
  */
839 839
 //#define BLTOUCH
840 840
 #if ENABLED(BLTOUCH)
841
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
841
+  /**
842
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
843
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
844
+   * advanced commands.
845
+   *
846
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
847
+   *       check the wiring of the BROWN, RED and ORANGE wires.
848
+   *
849
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
850
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
851
+   *       like they would be with a real switch. So please check the wiring first.
852
+   *
853
+   * Settings for all BLTouch and clone probes:
854
+   */
855
+
856
+  // Safety: The probe needs time to recognize the command.
857
+  //         Minimum command delay (ms). Enable and increase if needed.
858
+  //#define BLTOUCH_DELAY 500
842 859
 
843 860
   /**
844
-   * BLTouch V3.0 and newer smart series
845
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
846
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
861
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
847 862
    */
848
-  //#define BLTOUCH_FORCE_5V_MODE
849
-#endif
863
+
864
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
865
+  //          in special cases, like noisy or filtered input configurations.
866
+  //#define BLTOUCH_FORCE_SW_MODE
867
+
868
+  /**
869
+   * Settings for BLTouch Smart 3.0 and 3.1
870
+   * Summary:
871
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
872
+   *   - High-Speed mode
873
+   *   - Disable LCD voltage options
874
+   */
875
+
876
+  /**
877
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
878
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
879
+   * If disabled, OD mode is the hard-coded default on 3.0
880
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
881
+   * differs, a mode set eeprom write will be completed at initialization.
882
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
883
+   */
884
+  //#define BLTOUCH_SET_5V_MODE
885
+
886
+  /**
887
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
888
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
889
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
890
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
891
+   */
892
+  //#define BLTOUCH_FORCE_MODE_SET
893
+
894
+  /**
895
+   * Use "HIGH SPEED" mode for probing.
896
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
897
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
898
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
899
+   */
900
+  //#define BLTOUCH_HS_MODE
901
+
902
+  // Safety: Enable voltage mode settings in the LCD menu.
903
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
904
+
905
+#endif // BLTOUCH
850 906
 
851 907
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
852 908
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/adafruit/ST7565/Configuration.h View File

@@ -828,15 +828,71 @@
828 828
  */
829 829
 //#define BLTOUCH
830 830
 #if ENABLED(BLTOUCH)
831
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
831
+  /**
832
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
833
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
834
+   * advanced commands.
835
+   *
836
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
837
+   *       check the wiring of the BROWN, RED and ORANGE wires.
838
+   *
839
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
840
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
841
+   *       like they would be with a real switch. So please check the wiring first.
842
+   *
843
+   * Settings for all BLTouch and clone probes:
844
+   */
845
+
846
+  // Safety: The probe needs time to recognize the command.
847
+  //         Minimum command delay (ms). Enable and increase if needed.
848
+  //#define BLTOUCH_DELAY 500
832 849
 
833 850
   /**
834
-   * BLTouch V3.0 and newer smart series
835
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
836
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
851
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
837 852
    */
838
-  //#define BLTOUCH_FORCE_5V_MODE
839
-#endif
853
+
854
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
855
+  //          in special cases, like noisy or filtered input configurations.
856
+  //#define BLTOUCH_FORCE_SW_MODE
857
+
858
+  /**
859
+   * Settings for BLTouch Smart 3.0 and 3.1
860
+   * Summary:
861
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
862
+   *   - High-Speed mode
863
+   *   - Disable LCD voltage options
864
+   */
865
+
866
+  /**
867
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
868
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
869
+   * If disabled, OD mode is the hard-coded default on 3.0
870
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
871
+   * differs, a mode set eeprom write will be completed at initialization.
872
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
873
+   */
874
+  //#define BLTOUCH_SET_5V_MODE
875
+
876
+  /**
877
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
878
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
879
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
880
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
881
+   */
882
+  //#define BLTOUCH_FORCE_MODE_SET
883
+
884
+  /**
885
+   * Use "HIGH SPEED" mode for probing.
886
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
887
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
888
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
889
+   */
890
+  //#define BLTOUCH_HS_MODE
891
+
892
+  // Safety: Enable voltage mode settings in the LCD menu.
893
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
894
+
895
+#endif // BLTOUCH
840 896
 
841 897
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
842 898
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/delta/Anycubic/Kossel/Configuration.h View File

@@ -964,15 +964,71 @@
964 964
  */
965 965
 //#define BLTOUCH
966 966
 #if ENABLED(BLTOUCH)
967
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
967
+  /**
968
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
969
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
970
+   * advanced commands.
971
+   *
972
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
973
+   *       check the wiring of the BROWN, RED and ORANGE wires.
974
+   *
975
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
976
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
977
+   *       like they would be with a real switch. So please check the wiring first.
978
+   *
979
+   * Settings for all BLTouch and clone probes:
980
+   */
981
+
982
+  // Safety: The probe needs time to recognize the command.
983
+  //         Minimum command delay (ms). Enable and increase if needed.
984
+  //#define BLTOUCH_DELAY 500
968 985
 
969 986
   /**
970
-   * BLTouch V3.0 and newer smart series
971
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
972
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
987
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
973 988
    */
974
-  //#define BLTOUCH_FORCE_5V_MODE
975
-#endif
989
+
990
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
991
+  //          in special cases, like noisy or filtered input configurations.
992
+  //#define BLTOUCH_FORCE_SW_MODE
993
+
994
+  /**
995
+   * Settings for BLTouch Smart 3.0 and 3.1
996
+   * Summary:
997
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
998
+   *   - High-Speed mode
999
+   *   - Disable LCD voltage options
1000
+   */
1001
+
1002
+  /**
1003
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
1004
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
1005
+   * If disabled, OD mode is the hard-coded default on 3.0
1006
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
1007
+   * differs, a mode set eeprom write will be completed at initialization.
1008
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
1009
+   */
1010
+  //#define BLTOUCH_SET_5V_MODE
1011
+
1012
+  /**
1013
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
1014
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
1015
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
1016
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
1017
+   */
1018
+  //#define BLTOUCH_FORCE_MODE_SET
1019
+
1020
+  /**
1021
+   * Use "HIGH SPEED" mode for probing.
1022
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
1023
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
1024
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
1025
+   */
1026
+  //#define BLTOUCH_HS_MODE
1027
+
1028
+  // Safety: Enable voltage mode settings in the LCD menu.
1029
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
1030
+
1031
+#endif // BLTOUCH
976 1032
 
977 1033
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
978 1034
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/delta/FLSUN/auto_calibrate/Configuration.h View File

@@ -910,15 +910,71 @@
910 910
  */
911 911
 //#define BLTOUCH
912 912
 #if ENABLED(BLTOUCH)
913
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
913
+  /**
914
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
915
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
916
+   * advanced commands.
917
+   *
918
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
919
+   *       check the wiring of the BROWN, RED and ORANGE wires.
920
+   *
921
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
922
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
923
+   *       like they would be with a real switch. So please check the wiring first.
924
+   *
925
+   * Settings for all BLTouch and clone probes:
926
+   */
927
+
928
+  // Safety: The probe needs time to recognize the command.
929
+  //         Minimum command delay (ms). Enable and increase if needed.
930
+  //#define BLTOUCH_DELAY 500
914 931
 
915 932
   /**
916
-   * BLTouch V3.0 and newer smart series
917
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
918
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
933
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
919 934
    */
920
-  //#define BLTOUCH_FORCE_5V_MODE
921
-#endif
935
+
936
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
937
+  //          in special cases, like noisy or filtered input configurations.
938
+  //#define BLTOUCH_FORCE_SW_MODE
939
+
940
+  /**
941
+   * Settings for BLTouch Smart 3.0 and 3.1
942
+   * Summary:
943
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
944
+   *   - High-Speed mode
945
+   *   - Disable LCD voltage options
946
+   */
947
+
948
+  /**
949
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
950
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
951
+   * If disabled, OD mode is the hard-coded default on 3.0
952
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
953
+   * differs, a mode set eeprom write will be completed at initialization.
954
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
955
+   */
956
+  //#define BLTOUCH_SET_5V_MODE
957
+
958
+  /**
959
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
960
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
961
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
962
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
963
+   */
964
+  //#define BLTOUCH_FORCE_MODE_SET
965
+
966
+  /**
967
+   * Use "HIGH SPEED" mode for probing.
968
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
969
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
970
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
971
+   */
972
+  //#define BLTOUCH_HS_MODE
973
+
974
+  // Safety: Enable voltage mode settings in the LCD menu.
975
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
976
+
977
+#endif // BLTOUCH
922 978
 
923 979
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
924 980
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/delta/FLSUN/kossel/Configuration.h View File

@@ -910,15 +910,71 @@
910 910
  */
911 911
 //#define BLTOUCH
912 912
 #if ENABLED(BLTOUCH)
913
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
913
+  /**
914
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
915
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
916
+   * advanced commands.
917
+   *
918
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
919
+   *       check the wiring of the BROWN, RED and ORANGE wires.
920
+   *
921
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
922
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
923
+   *       like they would be with a real switch. So please check the wiring first.
924
+   *
925
+   * Settings for all BLTouch and clone probes:
926
+   */
927
+
928
+  // Safety: The probe needs time to recognize the command.
929
+  //         Minimum command delay (ms). Enable and increase if needed.
930
+  //#define BLTOUCH_DELAY 500
914 931
 
915 932
   /**
916
-   * BLTouch V3.0 and newer smart series
917
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
918
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
933
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
919 934
    */
920
-  //#define BLTOUCH_FORCE_5V_MODE
921
-#endif
935
+
936
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
937
+  //          in special cases, like noisy or filtered input configurations.
938
+  //#define BLTOUCH_FORCE_SW_MODE
939
+
940
+  /**
941
+   * Settings for BLTouch Smart 3.0 and 3.1
942
+   * Summary:
943
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
944
+   *   - High-Speed mode
945
+   *   - Disable LCD voltage options
946
+   */
947
+
948
+  /**
949
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
950
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
951
+   * If disabled, OD mode is the hard-coded default on 3.0
952
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
953
+   * differs, a mode set eeprom write will be completed at initialization.
954
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
955
+   */
956
+  //#define BLTOUCH_SET_5V_MODE
957
+
958
+  /**
959
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
960
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
961
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
962
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
963
+   */
964
+  //#define BLTOUCH_FORCE_MODE_SET
965
+
966
+  /**
967
+   * Use "HIGH SPEED" mode for probing.
968
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
969
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
970
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
971
+   */
972
+  //#define BLTOUCH_HS_MODE
973
+
974
+  // Safety: Enable voltage mode settings in the LCD menu.
975
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
976
+
977
+#endif // BLTOUCH
922 978
 
923 979
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
924 980
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/delta/FLSUN/kossel_mini/Configuration.h View File

@@ -910,15 +910,71 @@
910 910
  */
911 911
 //#define BLTOUCH
912 912
 #if ENABLED(BLTOUCH)
913
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
913
+  /**
914
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
915
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
916
+   * advanced commands.
917
+   *
918
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
919
+   *       check the wiring of the BROWN, RED and ORANGE wires.
920
+   *
921
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
922
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
923
+   *       like they would be with a real switch. So please check the wiring first.
924
+   *
925
+   * Settings for all BLTouch and clone probes:
926
+   */
927
+
928
+  // Safety: The probe needs time to recognize the command.
929
+  //         Minimum command delay (ms). Enable and increase if needed.
930
+  //#define BLTOUCH_DELAY 500
914 931
 
915 932
   /**
916
-   * BLTouch V3.0 and newer smart series
917
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
918
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
933
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
919 934
    */
920
-  //#define BLTOUCH_FORCE_5V_MODE
921
-#endif
935
+
936
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
937
+  //          in special cases, like noisy or filtered input configurations.
938
+  //#define BLTOUCH_FORCE_SW_MODE
939
+
940
+  /**
941
+   * Settings for BLTouch Smart 3.0 and 3.1
942
+   * Summary:
943
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
944
+   *   - High-Speed mode
945
+   *   - Disable LCD voltage options
946
+   */
947
+
948
+  /**
949
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
950
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
951
+   * If disabled, OD mode is the hard-coded default on 3.0
952
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
953
+   * differs, a mode set eeprom write will be completed at initialization.
954
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
955
+   */
956
+  //#define BLTOUCH_SET_5V_MODE
957
+
958
+  /**
959
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
960
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
961
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
962
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
963
+   */
964
+  //#define BLTOUCH_FORCE_MODE_SET
965
+
966
+  /**
967
+   * Use "HIGH SPEED" mode for probing.
968
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
969
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
970
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
971
+   */
972
+  //#define BLTOUCH_HS_MODE
973
+
974
+  // Safety: Enable voltage mode settings in the LCD menu.
975
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
976
+
977
+#endif // BLTOUCH
922 978
 
923 979
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
924 980
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/delta/Geeetech/Rostock 301/Configuration.h View File

@@ -900,15 +900,71 @@
900 900
  */
901 901
 //#define BLTOUCH
902 902
 #if ENABLED(BLTOUCH)
903
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
903
+  /**
904
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
905
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
906
+   * advanced commands.
907
+   *
908
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
909
+   *       check the wiring of the BROWN, RED and ORANGE wires.
910
+   *
911
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
912
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
913
+   *       like they would be with a real switch. So please check the wiring first.
914
+   *
915
+   * Settings for all BLTouch and clone probes:
916
+   */
917
+
918
+  // Safety: The probe needs time to recognize the command.
919
+  //         Minimum command delay (ms). Enable and increase if needed.
920
+  //#define BLTOUCH_DELAY 500
904 921
 
905 922
   /**
906
-   * BLTouch V3.0 and newer smart series
907
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
908
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
923
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
909 924
    */
910
-  //#define BLTOUCH_FORCE_5V_MODE
911
-#endif
925
+
926
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
927
+  //          in special cases, like noisy or filtered input configurations.
928
+  //#define BLTOUCH_FORCE_SW_MODE
929
+
930
+  /**
931
+   * Settings for BLTouch Smart 3.0 and 3.1
932
+   * Summary:
933
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
934
+   *   - High-Speed mode
935
+   *   - Disable LCD voltage options
936
+   */
937
+
938
+  /**
939
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
940
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
941
+   * If disabled, OD mode is the hard-coded default on 3.0
942
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
943
+   * differs, a mode set eeprom write will be completed at initialization.
944
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
945
+   */
946
+  //#define BLTOUCH_SET_5V_MODE
947
+
948
+  /**
949
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
950
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
951
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
952
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
953
+   */
954
+  //#define BLTOUCH_FORCE_MODE_SET
955
+
956
+  /**
957
+   * Use "HIGH SPEED" mode for probing.
958
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
959
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
960
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
961
+   */
962
+  //#define BLTOUCH_HS_MODE
963
+
964
+  // Safety: Enable voltage mode settings in the LCD menu.
965
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
966
+
967
+#endif // BLTOUCH
912 968
 
913 969
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
914 970
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/delta/Hatchbox_Alpha/Configuration.h View File

@@ -915,15 +915,71 @@
915 915
  */
916 916
 //#define BLTOUCH
917 917
 #if ENABLED(BLTOUCH)
918
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
918
+  /**
919
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
920
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
921
+   * advanced commands.
922
+   *
923
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
924
+   *       check the wiring of the BROWN, RED and ORANGE wires.
925
+   *
926
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
927
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
928
+   *       like they would be with a real switch. So please check the wiring first.
929
+   *
930
+   * Settings for all BLTouch and clone probes:
931
+   */
932
+
933
+  // Safety: The probe needs time to recognize the command.
934
+  //         Minimum command delay (ms). Enable and increase if needed.
935
+  //#define BLTOUCH_DELAY 500
919 936
 
920 937
   /**
921
-   * BLTouch V3.0 and newer smart series
922
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
923
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
938
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
924 939
    */
925
-  //#define BLTOUCH_FORCE_5V_MODE
926
-#endif
940
+
941
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
942
+  //          in special cases, like noisy or filtered input configurations.
943
+  //#define BLTOUCH_FORCE_SW_MODE
944
+
945
+  /**
946
+   * Settings for BLTouch Smart 3.0 and 3.1
947
+   * Summary:
948
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
949
+   *   - High-Speed mode
950
+   *   - Disable LCD voltage options
951
+   */
952
+
953
+  /**
954
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
955
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
956
+   * If disabled, OD mode is the hard-coded default on 3.0
957
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
958
+   * differs, a mode set eeprom write will be completed at initialization.
959
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
960
+   */
961
+  //#define BLTOUCH_SET_5V_MODE
962
+
963
+  /**
964
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
965
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
966
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
967
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
968
+   */
969
+  //#define BLTOUCH_FORCE_MODE_SET
970
+
971
+  /**
972
+   * Use "HIGH SPEED" mode for probing.
973
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
974
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
975
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
976
+   */
977
+  //#define BLTOUCH_HS_MODE
978
+
979
+  // Safety: Enable voltage mode settings in the LCD menu.
980
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
981
+
982
+#endif // BLTOUCH
927 983
 
928 984
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
929 985
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/delta/MKS/SBASE/Configuration.h View File

@@ -900,15 +900,71 @@
900 900
  */
901 901
 //#define BLTOUCH
902 902
 #if ENABLED(BLTOUCH)
903
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
903
+  /**
904
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
905
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
906
+   * advanced commands.
907
+   *
908
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
909
+   *       check the wiring of the BROWN, RED and ORANGE wires.
910
+   *
911
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
912
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
913
+   *       like they would be with a real switch. So please check the wiring first.
914
+   *
915
+   * Settings for all BLTouch and clone probes:
916
+   */
917
+
918
+  // Safety: The probe needs time to recognize the command.
919
+  //         Minimum command delay (ms). Enable and increase if needed.
920
+  //#define BLTOUCH_DELAY 500
904 921
 
905 922
   /**
906
-   * BLTouch V3.0 and newer smart series
907
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
908
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
923
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
909 924
    */
910
-  //#define BLTOUCH_FORCE_5V_MODE
911
-#endif
925
+
926
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
927
+  //          in special cases, like noisy or filtered input configurations.
928
+  //#define BLTOUCH_FORCE_SW_MODE
929
+
930
+  /**
931
+   * Settings for BLTouch Smart 3.0 and 3.1
932
+   * Summary:
933
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
934
+   *   - High-Speed mode
935
+   *   - Disable LCD voltage options
936
+   */
937
+
938
+  /**
939
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
940
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
941
+   * If disabled, OD mode is the hard-coded default on 3.0
942
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
943
+   * differs, a mode set eeprom write will be completed at initialization.
944
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
945
+   */
946
+  //#define BLTOUCH_SET_5V_MODE
947
+
948
+  /**
949
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
950
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
951
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
952
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
953
+   */
954
+  //#define BLTOUCH_FORCE_MODE_SET
955
+
956
+  /**
957
+   * Use "HIGH SPEED" mode for probing.
958
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
959
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
960
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
961
+   */
962
+  //#define BLTOUCH_HS_MODE
963
+
964
+  // Safety: Enable voltage mode settings in the LCD menu.
965
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
966
+
967
+#endif // BLTOUCH
912 968
 
913 969
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
914 970
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/delta/generic/Configuration.h View File

@@ -900,15 +900,71 @@
900 900
  */
901 901
 //#define BLTOUCH
902 902
 #if ENABLED(BLTOUCH)
903
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
903
+  /**
904
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
905
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
906
+   * advanced commands.
907
+   *
908
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
909
+   *       check the wiring of the BROWN, RED and ORANGE wires.
910
+   *
911
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
912
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
913
+   *       like they would be with a real switch. So please check the wiring first.
914
+   *
915
+   * Settings for all BLTouch and clone probes:
916
+   */
917
+
918
+  // Safety: The probe needs time to recognize the command.
919
+  //         Minimum command delay (ms). Enable and increase if needed.
920
+  //#define BLTOUCH_DELAY 500
904 921
 
905 922
   /**
906
-   * BLTouch V3.0 and newer smart series
907
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
908
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
923
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
909 924
    */
910
-  //#define BLTOUCH_FORCE_5V_MODE
911
-#endif
925
+
926
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
927
+  //          in special cases, like noisy or filtered input configurations.
928
+  //#define BLTOUCH_FORCE_SW_MODE
929
+
930
+  /**
931
+   * Settings for BLTouch Smart 3.0 and 3.1
932
+   * Summary:
933
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
934
+   *   - High-Speed mode
935
+   *   - Disable LCD voltage options
936
+   */
937
+
938
+  /**
939
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
940
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
941
+   * If disabled, OD mode is the hard-coded default on 3.0
942
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
943
+   * differs, a mode set eeprom write will be completed at initialization.
944
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
945
+   */
946
+  //#define BLTOUCH_SET_5V_MODE
947
+
948
+  /**
949
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
950
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
951
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
952
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
953
+   */
954
+  //#define BLTOUCH_FORCE_MODE_SET
955
+
956
+  /**
957
+   * Use "HIGH SPEED" mode for probing.
958
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
959
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
960
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
961
+   */
962
+  //#define BLTOUCH_HS_MODE
963
+
964
+  // Safety: Enable voltage mode settings in the LCD menu.
965
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
966
+
967
+#endif // BLTOUCH
912 968
 
913 969
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
914 970
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/delta/kossel_mini/Configuration.h View File

@@ -900,15 +900,71 @@
900 900
  */
901 901
 //#define BLTOUCH
902 902
 #if ENABLED(BLTOUCH)
903
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
903
+  /**
904
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
905
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
906
+   * advanced commands.
907
+   *
908
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
909
+   *       check the wiring of the BROWN, RED and ORANGE wires.
910
+   *
911
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
912
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
913
+   *       like they would be with a real switch. So please check the wiring first.
914
+   *
915
+   * Settings for all BLTouch and clone probes:
916
+   */
917
+
918
+  // Safety: The probe needs time to recognize the command.
919
+  //         Minimum command delay (ms). Enable and increase if needed.
920
+  //#define BLTOUCH_DELAY 500
904 921
 
905 922
   /**
906
-   * BLTouch V3.0 and newer smart series
907
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
908
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
923
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
909 924
    */
910
-  //#define BLTOUCH_FORCE_5V_MODE
911
-#endif
925
+
926
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
927
+  //          in special cases, like noisy or filtered input configurations.
928
+  //#define BLTOUCH_FORCE_SW_MODE
929
+
930
+  /**
931
+   * Settings for BLTouch Smart 3.0 and 3.1
932
+   * Summary:
933
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
934
+   *   - High-Speed mode
935
+   *   - Disable LCD voltage options
936
+   */
937
+
938
+  /**
939
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
940
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
941
+   * If disabled, OD mode is the hard-coded default on 3.0
942
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
943
+   * differs, a mode set eeprom write will be completed at initialization.
944
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
945
+   */
946
+  //#define BLTOUCH_SET_5V_MODE
947
+
948
+  /**
949
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
950
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
951
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
952
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
953
+   */
954
+  //#define BLTOUCH_FORCE_MODE_SET
955
+
956
+  /**
957
+   * Use "HIGH SPEED" mode for probing.
958
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
959
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
960
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
961
+   */
962
+  //#define BLTOUCH_HS_MODE
963
+
964
+  // Safety: Enable voltage mode settings in the LCD menu.
965
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
966
+
967
+#endif // BLTOUCH
912 968
 
913 969
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
914 970
 //#define SOLENOID_PROBE

+ 62
- 6
config/examples/delta/kossel_pro/Configuration.h View File

@@ -893,15 +893,71 @@
893 893
  */
894 894
 //#define BLTOUCH
895 895
 #if ENABLED(BLTOUCH)
896
-  //#define BLTOUCH_DELAY 500   // Minimum Command delay (ms). Enable and increase if needed
896
+  /**
897
+   * Either: Use the defaults (recommended) or: For special purposes, use the following DEFINES
898
+   * Do not activate settings that the probe might not understand. Clones might misunderstand
899
+   * advanced commands.
900
+   *
901
+   * Note: If the probe is not deploying, check a "Cmd: Reset" and "Cmd: Self-Test" and then
902
+   *       check the wiring of the BROWN, RED and ORANGE wires.
903
+   *
904
+   * Note: If the trigger signal of your probe is not being recognized, it has been very often
905
+   *       because the BLACK and WHITE wires needed to be swapped. They are not "interchangeable"
906
+   *       like they would be with a real switch. So please check the wiring first.
907
+   *
908
+   * Settings for all BLTouch and clone probes:
909
+   */
910
+
911
+  // Safety: The probe needs time to recognize the command.
912
+  //         Minimum command delay (ms). Enable and increase if needed.
913
+  //#define BLTOUCH_DELAY 500
897 914
 
898 915
   /**
899
-   * BLTouch V3.0 and newer smart series
900
-   * For genuine BLTouch 3.0 sensors. Clones may be confused by 3.0 command angles. YMMV.
901
-   * If the pin trigger is not detected, first try swapping the black and white wires then toggle this.
916
+   * Settings for BLTOUCH Classic 1.2, 1.3 or BLTouch Smart 1.0, 2.0, 2.2, 3.0, 3.1, and most clones:
902 917
    */
903
-  //#define BLTOUCH_FORCE_5V_MODE
904
-#endif
918
+
919
+  // Feature: Switch into SW mode after a deploy. It makes the output pulse longer. Can be useful
920
+  //          in special cases, like noisy or filtered input configurations.
921
+  //#define BLTOUCH_FORCE_SW_MODE
922
+
923
+  /**
924
+   * Settings for BLTouch Smart 3.0 and 3.1
925
+   * Summary:
926
+   *   - Voltage modes: 5V and OD (open drain - "logic voltage free") output modes
927
+   *   - High-Speed mode
928
+   *   - Disable LCD voltage options
929
+   */
930
+
931
+  /**
932
+   * Danger: Don't activate 5V mode unless attached to a 5V-tolerant controller!
933
+   * V3.0 or 3.1: Set default mode to 5V mode at Marlin startup.
934
+   * If disabled, OD mode is the hard-coded default on 3.0
935
+   * On startup, Marlin will compare its eeprom to this vale. If the selected mode
936
+   * differs, a mode set eeprom write will be completed at initialization.
937
+   * Use the option below to force an eeprom write to a V3.1 probe regardless.
938
+   */
939
+  //#define BLTOUCH_SET_5V_MODE
940
+
941
+  /**
942
+   * Safety: Activate if connecting a probe with an unknown voltage mode.
943
+   * V3.0: Set a probe into mode selected above at Marlin startup. Required for 5V mode on 3.0
944
+   * V3.1: Force a probe with unknown mode into selected mode at Marlin startup ( = Probe EEPROM write )
945
+   * To preserve the life of the probe, use this once then turn it off and re-flash.
946
+   */
947
+  //#define BLTOUCH_FORCE_MODE_SET
948
+
949
+  /**
950
+   * Use "HIGH SPEED" mode for probing.
951
+   * Danger: Disable if your probe sometimes fails. Only suitable for stable well-adjusted systems.
952
+   * This feature was designed for Delta's with very fast Z moves however higher speed cartesians may function
953
+   * If the machine cannot raise the probe fast enough after a trigger, it may enter a fault state.
954
+   */
955
+  //#define BLTOUCH_HS_MODE
956
+
957
+  // Safety: Enable voltage mode settings in the LCD menu.
958
+  //#define BLTOUCH_LCD_VOLTAGE_MENU
959
+
960
+#endif // BLTOUCH
905 961
 
906 962
 // A probe that is deployed and stowed with a solenoid pin (SOL1_PIN)
907 963
 //#define SOLENOID_PROBE

+ 0
- 0
config/examples/delta/kossel_xl/Configuration.h View File


Some files were not shown because too many files changed in this diff

Loading…
Cancel
Save