Feature analogin

docs/en/analogin.md

@@ -39,6 +39,7 @@ from kmk.modules.analogin import AnalogInput
 a = AnalogInput(
     input: AnalogIn,
     filter: Optional(Callable[AnalogIn, int]) = lambda input:input.value>>8,
+    sensitivity: 1,
 )
 
 a.value
@@ -55,6 +56,10 @@ An `AnalogIn` like object.
 A customizable function that reads and transforms `input.value`.
 The default transformation maps uint16 ([0-65535]) to uint8 ([0-255]) resolution.
 
+#### `sensitivity`
+Prevents noise from analog inputs from spamming events but will cause stepping
+in input if set to larger values
+
 #### `value`
 
 Holds the transformed value of the `AnalogIn` input.
@@ -95,25 +100,26 @@ AK = AnalogKey(
 ## Examples
 
 ### Analogio with AnalogKeys
+Emits a key press when analog input goes above the threshold
 
 ```python
 import board
 from analogio import AnalogIn
-from kmk.modules.analogin import AnalogIn
+from kmk.modules.analogin import AnalogInput, AnalogInputs, AnalogKey
 
-analog = AnalogIn(
+analogInputmap = AnalogInAnalogInputs(
     [
         AnalogInput(AnalogIn(board.A0)),
         AnalogInput(AnalogIn(board.A1)),
         AnalogInput(AnalogIn(board.A2)),
     ],
     [
-        [AnalogKey(KC.X), AnalogKey(KC.Y), AnalogKey(KC.Z)],
-        [KC.TRNS, KC.NO, AnalogKey(KC.W, threshold=96)],
+        [AnalogKey(KC.X), AnalogKey(KC.Y), AnalogKey(KC.Z)], ##layer 1
+        [KC.TRNS, KC.NO, AnalogKey(KC.W, threshold=96)],     ##layer 2
     ],
 )
 
-keyboard.modules.append(analog)
+keyboard.modules.append(analogInputmap)
 ```
 
 ### External DAC with AnalogEvent
@@ -149,7 +155,21 @@ HTT = AnalogEvent(
 
 a0 = AnalogInput(dac, lambda _: int(_.value / 0xFFFF * 1980) + 20)
 
-analog = AnalogIn(
+analogInputmap = AnalogInputs(
     [a0],
     [[HTT]],
 ```
+
+
+### Common Filters for different ranges
+
+```python
+
+#0-255
+lambda input:input.value>>8) #default Filter
+lambda input:(~input.value>>8)+256) #default Filter Inverted
+
+#0-127
+lambda input:input.value>>9)
+lambda input:(~input.value>>9)+128) #Inverted
+```

kmk/modules/analogin.py

@@ -42,10 +42,11 @@ def on_stop(self, event, keyboard):
 
 
 class AnalogInput:
-    def __init__(self, input, filter=lambda input: input.value >> 8):
+    def __init__(self, input, filter=lambda input: input.value >> 8, sensitivity=1):
         self.input = input
         self.value = 0
         self.delta = 0
+        self.sensitivity = sensitivity
         self.filter = filter
 
     def update(self):
@@ -56,7 +57,7 @@ def update(self):
         '''
         value = self.filter(self.input)
         self.delta = value - self.value
-        if self.delta != 0:
+        if self.delta not in range(-self.sensitivity, self.sensitivity):
             self.value = value
             return value
 

kmk/modules/midi.py

@@ -105,7 +105,7 @@ def on_powersave_disable(self, keyboard):
 
     def send(self, message):
         if self.midi:
-            self.midi.send(message)
+            self.midi.send(message,message.channel)
 
     def on_press(self, key, keyboard, *args, **kwargs):
         self.send(key.on_press_msg)