rename consts

Author: caternuson

adafruit_cap1188/cap1188.py

@@ -48,30 +48,30 @@
 __repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_CAP1188.git"
 
 # pylint: disable=bad-whitespace
-CAP1188_MID                 = const(0x5D)
-CAP1188_PID                 = const(0x50)
-CAP1188_MAIN_CONTROL        = const(0x00)
-CAP1188_GENERAL_STATUS      = const(0x02)
-CAP1188_INPUT_STATUS        = const(0x03)
-CAP1188_LED_STATUS          = const(0x04)
-CAP1188_NOISE_FLAGS         = const(0x0A)
-CAP1188_DELTA_COUNT         =(const(0x10),
+_CAP1188_MID                = const(0x5D)
+_CAP1188_PID                = const(0x50)
+_CAP1188_MAIN_CONTROL       = const(0x00)
+_CAP1188_GENERAL_STATUS     = const(0x02)
+_CAP1188_INPUT_STATUS       = const(0x03)
+_CAP1188_LED_STATUS         = const(0x04)
+_CAP1188_NOISE_FLAGS        = const(0x0A)
+_CAP1188_DELTA_COUNT        =(const(0x10),
                               const(0x11),
                               const(0x12),
                               const(0x13),
                               const(0x14),
                               const(0x15),
                               const(0x16),
                               const(0x17))
-CAP1188_SENSITIVTY          = const(0x1F)
-CAP1188_CAL_ACTIVATE        = const(0x26)
-CAP1188_MULTI_TOUCH_CFG     = const(0x2A)
-CAP1188_THESHOLD_1          = const(0x30)
-CAP1188_STANDBY_CFG         = const(0x41)
-CAP1188_LED_LINKING         = const(0x72)
-CAP1188_PRODUCT_ID          = const(0xFD)
-CAP1188_MANU_ID             = const(0xFE)
-CAP1188_REVISION            = const(0xFF)
+_CAP1188_SENSITIVTY         = const(0x1F)
+_CAP1188_CAL_ACTIVATE       = const(0x26)
+_CAP1188_MULTI_TOUCH_CFG    = const(0x2A)
+_CAP1188_THESHOLD_1         = const(0x30)
+_CAP1188_STANDBY_CFG        = const(0x41)
+_CAP1188_LED_LINKING        = const(0x72)
+_CAP1188_PRODUCT_ID         = const(0xFD)
+_CAP1188_MANU_ID            = const(0xFE)
+_CAP1188_REVISION           = const(0xFF)
 # pylint: enable=bad-whitespace
 
 _SENSITIVITY = (128, 64, 32, 16, 8, 4, 2, 1)
@@ -97,14 +97,14 @@ def raw_value(self):
     @property
     def threshold(self):
         """The touch threshold value."""
-        return self._cap1188._read_register(CAP1188_THESHOLD_1 + self._pin - 1)
+        return self._cap1188._read_register(_CAP1188_THESHOLD_1 + self._pin - 1)
 
     @threshold.setter
     def threshold(self, value):
         value = int(value)
         if not 0 <= value <= 127:
             raise ValueError("Threshold value must be in range 0 to 127.")
-        self._cap1188._write_register(CAP1188_THESHOLD_1 + self._pin - 1, value)
+        self._cap1188._write_register(_CAP1188_THESHOLD_1 + self._pin - 1, value)
 
     def recalibrate(self):
         """Perform a self recalibration."""
@@ -114,15 +114,15 @@ def recalibrate(self):
 class CAP1188:
     """CAP1188 driver base, must be extended for I2C/SPI interfacing."""
     def __init__(self):
-        mid = self._read_register(CAP1188_MANU_ID)
-        if mid != CAP1188_MID:
+        mid = self._read_register(_CAP1188_MANU_ID)
+        if mid != _CAP1188_MID:
             raise RuntimeError('Failed to find CAP1188! Manufacturer ID: 0x{:02x}'.format(mid))
-        pid = self._read_register(CAP1188_PRODUCT_ID)
-        if pid != CAP1188_PID:
+        pid = self._read_register(_CAP1188_PRODUCT_ID)
+        if pid != _CAP1188_PID:
             raise RuntimeError('Failed to find CAP1188! Product ID: 0x{:02x}'.format(pid))
         self._channels = [None]*8
-        self._write_register(CAP1188_LED_LINKING, 0xFF)     # turn on LED linking
-        self._write_register(CAP1188_MULTI_TOUCH_CFG, 0x00) # allow multi touch
+        self._write_register(_CAP1188_LED_LINKING, 0xFF)     # turn on LED linking
+        self._write_register(_CAP1188_MULTI_TOUCH_CFG, 0x00) # allow multi touch
         self._write_register(0x2F, 0x10) # turn off input-1-sets-all-inputs feature
         self.recalibrate()
 
@@ -132,7 +132,7 @@ def __getitem__(self, key):
         if pin < 1 or pin > 8:
             raise IndexError('Pin must be a value 1-8.')
         if self._channels[index] is None:
-            self._channels[index] = CAP1188_Channel(self, pin)
+            self._channels[index] = _CAP1188_Channel(self, pin)
         return self._channels[index]
 
     @property
@@ -144,23 +144,23 @@ def touched_pins(self):
     def touched(self):
         """Return 8 bit value representing touch state of all pins."""
         # clear the INT bit and any previously touched pins
-        current = self._read_register(CAP1188_MAIN_CONTROL)
-        self._write_register(CAP1188_MAIN_CONTROL, current & ~0x01)
+        current = self._read_register(_CAP1188_MAIN_CONTROL)
+        self._write_register(_CAP1188_MAIN_CONTROL, current & ~0x01)
         # return only currently touched pins
-        return self._read_register(CAP1188_INPUT_STATUS)
+        return self._read_register(_CAP1188_INPUT_STATUS)
 
     @property
     def sensitivity(self):
         """The sensitvity of touch detections. Range is 1 (least) to 128 (most)."""
-        return _SENSITIVITY[self._read_register(CAP1188_SENSITIVTY) >> 4 & 0x07]
+        return _SENSITIVITY[self._read_register(_CAP1188_SENSITIVTY) >> 4 & 0x07]
 
     @sensitivity.setter
     def sensitivity(self, value):
         if value not in _SENSITIVITY:
             raise ValueError("Sensitivty must be one of: {}".format(_SENSITIVITY))
         value = _SENSITIVITY.index(value) << 4
-        new_setting = self._read_register(CAP1188_SENSITIVTY) & 0x8F | value
-        self._write_register(CAP1188_SENSITIVTY, new_setting)
+        new_setting = self._read_register(_CAP1188_SENSITIVTY) & 0x8F | value
+        self._write_register(_CAP1188_SENSITIVTY, new_setting)
 
     @property
     def thresholds(self):
@@ -172,11 +172,11 @@ def thresholds(self, value):
         value = int(value)
         if not 0 <= value <= 127:
             raise ValueError("Threshold value must be in range 0 to 127.")
-        self._write_block(CAP1188_THESHOLD_1, bytearray((value,)*8))
+        self._write_block(_CAP1188_THESHOLD_1, bytearray((value,)*8))
 
     def threshold_values(self):
         """Return tuple of touch threshold values for all channels."""
-        return tuple(self._read_block(CAP1188_THESHOLD_1, 8))
+        return tuple(self._read_block(_CAP1188_THESHOLD_1, 8))
 
     def recalibrate(self):
         """Perform a self recalibration on all the pins."""
@@ -187,13 +187,13 @@ def delta_count(self, pin):
         if pin < 1 or pin > 8:
             raise IndexError('Pin must be a value 1-8.')
         # 8 bit 2's complement
-        raw_value = self._read_register(CAP1188_DELTA_COUNT[pin-1])
+        raw_value = self._read_register(_CAP1188_DELTA_COUNT[pin-1])
         raw_value = raw_value - 256 if raw_value & 128 else raw_value
         return raw_value
 
     def recalibrate_pins(self, mask):
         """Recalibrate pins specified by bit mask."""
-        self._write_register(CAP1188_CAL_ACTIVATE, mask)
+        self._write_register(_CAP1188_CAL_ACTIVATE, mask)
 
     def _read_register(self, address):
         """Return 8 bit value of register at address."""

adafruit_cap1188/i2c.py

@@ -50,12 +50,12 @@
 __repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_CAP1188.git"
 
 # pylint: disable=bad-whitespace
-CAP1188_DEFAULT_ADDRESS     = const(0x29)
+_CAP1188_DEFAULT_ADDRESS     = const(0x29)
 # pylint: enable=bad-whitespace
 
 class CAP1188_I2C(CAP1188):
     """Driver for the CAP1188 connected over I2C."""
-    def __init__(self, i2c, address=CAP1188_DEFAULT_ADDRESS):
+    def __init__(self, i2c, address=_CAP1188_DEFAULT_ADDRESS):
         self._i2c = i2c_device.I2CDevice(i2c, address)
         self._buf = bytearray(2)
         super().__init__()

adafruit_cap1188/spi.py

@@ -50,9 +50,9 @@
 __repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_CAP1188.git"
 
 # pylint: disable=bad-whitespace
-CAP1188_SPI_SET_ADDR        = const(0x7D)
-CAP1188_SPI_WRITE_DATA      = const(0x7E)
-CAP1188_SPI_READ_DATA       = const(0x7F)
+_CAP1188_SPI_SET_ADDR        = const(0x7D)
+_CAP1188_SPI_WRITE_DATA      = const(0x7E)
+_CAP1188_SPI_READ_DATA       = const(0x7F)
 # pylint: enable=bad-whitespace
 
 class CAP1188_SPI(CAP1188):
@@ -65,30 +65,30 @@ def __init__(self, spi, cs):
     def _read_register(self, address):
         # pylint: disable=no-member
         """Return 8 bit value of register at address."""
-        self._buf[0] = CAP1188_SPI_SET_ADDR
+        self._buf[0] = _CAP1188_SPI_SET_ADDR
         self._buf[1] = address
-        self._buf[2] = CAP1188_SPI_READ_DATA
+        self._buf[2] = _CAP1188_SPI_READ_DATA
         with self._spi as spi:
             spi.write_readinto(self._buf, self._buf)
         return self._buf[3]
 
     def _write_register(self, address, value):
         # pylint: disable=no-member
         """Write 8 bit value to registter at address."""
-        self._buf[0] = CAP1188_SPI_SET_ADDR
+        self._buf[0] = _CAP1188_SPI_SET_ADDR
         self._buf[1] = address
-        self._buf[2] = CAP1188_SPI_WRITE_DATA
+        self._buf[2] = _CAP1188_SPI_WRITE_DATA
         self._buf[3] = value
         with self._spi as spi:
             spi.write(self._buf)
 
     def _read_block(self, start, length):
         # pylint: disable=no-member
         """Return byte array of values from start address to length."""
-        self._buf[0] = CAP1188_SPI_SET_ADDR
+        self._buf[0] = _CAP1188_SPI_SET_ADDR
         self._buf[1] = start
-        self._buf[2] = CAP1188_SPI_READ_DATA
-        result = bytearray((CAP1188_SPI_READ_DATA,)*length)
+        self._buf[2] = _CAP1188_SPI_READ_DATA
+        result = bytearray((_CAP1188_SPI_READ_DATA,)*length)
         with self._spi as spi:
             spi.write(self._buf, end=3)
             spi.write_readinto(result, result)
@@ -97,11 +97,11 @@ def _read_block(self, start, length):
     def _write_block(self, start, data):
         # pylint: disable=no-member
         """Write out data beginning at start address."""
-        self._buf[0] = CAP1188_SPI_SET_ADDR
+        self._buf[0] = _CAP1188_SPI_SET_ADDR
         self._buf[1] = start
         with self._spi as spi:
             spi.write(self._buf, end=2)
-            self._buf[0] = CAP1188_SPI_WRITE_DATA
+            self._buf[0] = _CAP1188_SPI_WRITE_DATA
             for value in data:
                 self._buf[1] = value
                 spi.write(self._buf, end=2)