add setter/getter for gesture-gain

Author: bablokb

adafruit_apds9960/apds9960.py

@@ -123,6 +123,8 @@
 _BIT_POS_CONTROL_PGAIN = const(2)
 _BIT_MASK_CONTROL_PGAIN = const(0x0C)
 
+_BIT_POS_GCONF2_GGAIN = const(5)
+_BIT_MASK_GCONF2_GGAIN = const(0x60)
 
 # pylint: disable-msg=too-many-instance-attributes
 class APDS9960:
@@ -224,7 +226,7 @@ def __init__(
             self._write8(_APDS9960_GEXTH, 0x1E)
             # GEXPERS: 2 (4 cycles), GEXMSK: 0 (default) GFIFOTH: 2 (8 datasets)
             self._write8(_APDS9960_GCONF1, 0x82)
-            # GGAIN: 2 (4x), GLDRIVE: 100 mA (default), GGAIN: 1 (2x)
+            # GGAIN: 2 (4x), GLDRIVE: 100 mA (default), GWTIME: 1 (2.8ms)
             self._write8(_APDS9960_GCONF2, 0x41)
             # GPULSE: 5 (6 pulses), GPLEN: 2 (16 us)
             self._write8(_APDS9960_GPULSE, 0x85)
@@ -423,6 +425,30 @@ def enable_gesture(self) -> bool:
     def enable_gesture(self, value: bool) -> None:
         self._set_bit(_APDS9960_ENABLE, _BIT_MASK_ENABLE_GESTURE, value)
 
+    @property
+    def gesture_gain(self) -> int:
+        """Gesture mode gain value.
+
+        This sets the gain multiplier for the ADC during gesture engine operations.
+
+        .. csv-table::
+           :header: "``gesture_gain``", "Gain Multiplier", "Note"
+
+           0, "1x", "Power-on Default"
+           1, "2x", ""
+           2, "4x", "Driver Default"
+           3, "8x", ""
+           """
+        return self._get_bits(
+            _APDS9960_GCONF2, _BIT_POS_GCONF2_GGAIN, _BIT_MASK_GCONF2_GGAIN
+        )
+
+    @gesture_gain.setter
+    def gesture_gain(self, value: int) -> None:
+        self._set_bits(
+            _APDS9960_GCONF2, _BIT_POS_GCONF2_GGAIN, _BIT_MASK_GCONF2_GGAIN, value
+        )
+
     @property
     def rotation(self) -> int:
         """Clock-wise offset to apply to gesture results.