Allow passing debounce_threshold in keypad.py

docs/en/scanners.md

@@ -11,7 +11,11 @@ need to swap it out with an alternative scanner.
 ## Keypad Scanners
 The scanners in `kmk.scanners.keypad` wrap the `keypad` module that ships with
 CircuitPython and support the same configuration and tuning options as their
-upstream. You can find out more in the [CircuitPython
+upstream.
+
+**Some users may need to tweak debounce parameters**, `interval=0.01,debounce_threshold=5` is a good starting point. `debounce_threshold` is only applicable for CircuitPython >= 9.2.0
+
+You can find out more in the [CircuitPython
 documentation](https://docs.circuitpython.org/en/latest/shared-bindings/keypad/index.html).
 
 ### keypad MatrixScanner
@@ -30,7 +34,8 @@ class MyKeyboard(KMKKeyboard):
             row_pins=self.row_pins,
             # optional arguments with defaults:
             columns_to_anodes=DiodeOrientation.COL2ROW,
-            interval=0.02,  # Debounce time in floating point seconds
+            interval=0.02, # Matrix sampling interval in ms
+            debounce_threshold=None, # Number of samples needed to change state, values greater than 1 enable debouncing. Only applicable for CircuitPython >= 9.2.0
             max_events=64
         )
 
@@ -68,7 +73,8 @@ class MyKeyboard(KMKKeyboard):
             # optional arguments with defaults:
             value_when_pressed=False,
             pull=True,
-            interval=0.02,  # Debounce time in floating point seconds
+            interval=0.02, # Matrix sampling interval in ms
+            debounce_threshold=None, # Number of samples needed to change state, values greater than 1 enable debouncing. Only applicable for CircuitPython >= 9.2.0
             max_events=64
         )
 ```
@@ -94,7 +100,8 @@ class MyKeyboard(KMKKeyboard):
             # optional arguments with defaults:
             value_to_latch=True, # 74HC165: True, CD4021: False
             value_when_pressed=False,
-            interval=0.02,  # Debounce time in floating point seconds
+            interval=0.02, # Matrix sampling interval in ms
+            debounce_threshold=None, # Number of samples needed to change state, values greater than 1 enable debouncing. Only applicable for CircuitPython >= 9.2.0
             max_events=64
         )
 ```

kmk/scanners/keypad.py

@@ -43,15 +43,26 @@ def __init__(
         *,
         columns_to_anodes=DiodeOrientation.COL2ROW,
         interval=0.02,
+        debounce_threshold=None,
         max_events=64,
     ):
-        self.keypad = keypad.KeyMatrix(
+        args = [
             row_pins,
             column_pins,
-            columns_to_anodes=(columns_to_anodes == DiodeOrientation.COL2ROW),
-            interval=interval,
-            max_events=max_events,
-        )
+        ]
+        for i in args:
+            if i is None:
+                args.pop(i)
+        kwargs = {
+            'columns_to_anodes': columns_to_anodes,
+            'interval': interval,
+            'debounce_threshold': debounce_threshold,
+            'max_events': max_events,
+        }
+        for key, value in kwargs.items():
+            if value is None:
+                kwargs.pop(key)
+        self.keypad = keypad.Keys(*args, **kwargs)
         super().__init__()
 
 
@@ -69,15 +80,26 @@ def __init__(
         value_when_pressed=False,
         pull=True,
         interval=0.02,
+        debounce_threshold=None,
         max_events=64,
     ):
-        self.keypad = keypad.Keys(
+        args = [
             pins,
-            value_when_pressed=value_when_pressed,
-            pull=pull,
-            interval=interval,
-            max_events=max_events,
-        )
+        ]
+        for i in args:
+            if i is None:
+                args.pop(i)
+        kwargs = {
+            'value_when_pressed': value_when_pressed,
+            'pull': pull,
+            'interval': interval,
+            'debounce_threshold': debounce_threshold,
+            'max_events': max_events,
+        }
+        for key, value in kwargs.items():
+            if value is None:
+                kwargs.pop(key)
+        self.keypad = keypad.Keys(*args, **kwargs)
         super().__init__()
 
 
@@ -88,20 +110,31 @@ def __init__(
         clock,
         data,
         latch,
-        value_to_latch=True,
         key_count,
+        value_to_latch=True,
         value_when_pressed=False,
         interval=0.02,
+        debounce_threshold=None,
         max_events=64,
     ):
-        self.keypad = keypad.ShiftRegisterKeys(
-            clock=clock,
-            data=data,
-            latch=latch,
-            value_to_latch=value_to_latch,
-            key_count=key_count,
-            value_when_pressed=value_when_pressed,
-            interval=interval,
-            max_events=max_events,
-        )
+        args = [
+            clock,
+            data,
+            latch,
+            key_count,
+        ]
+        for i in args:
+            if i is None:
+                args.pop(i)
+        kwargs = {
+            'value_to_latch': value_to_latch,
+            'value_when_pressed': value_when_pressed,
+            'interval': interval,
+            'debounce_threshold': debounce_threshold,
+            'max_events': max_events,
+        }
+        for key, value in kwargs.items():
+            if value is None:
+                kwargs.pop(key)
+        self.keypad = keypad.Keys(*args, **kwargs)
         super().__init__()

util/aspell.en.pws

@@ -33,6 +33,7 @@ Crkbd
 Crowboard
 Ctrl
 Cygwin
+debounce
 DFU
 DISCOVERABLE
 DIY