documenting base class again

adafruit_mcp3xxx/analog_in.py

@@ -33,7 +33,7 @@ class AnalogIn():
 
     :param ~mcp3004.MCP3004,~mcp3008.MCP3008 mcp: The mcp object.
     :param ~digitalio.DigitalInOut positive_pin: Required pin for single-ended.
-    :param ~digitalio.DigitalInOut negative_pin: Optional pin for differential reads.
+    :param ~mcp3xxx.MCP3xxx.DIFF_PINS negative_pin: Optional pin for differential reads.
 
     """
     def __init__(self, mcp, positive_pin, negative_pin=None):

adafruit_mcp3xxx/mcp3002.py

@@ -48,18 +48,12 @@ class MCP3002(MCP3xxx):
         - 0: CH0 = IN+, CH1 = IN-
         - 1: CH1 = IN+, CH0 = IN-
     """
-    MCP3002_DIFF_PINS = {
+    DIFF_PINS = {
         (0, 1) : P0,
         (1, 0) : P1
     }
 
     def read(self, pin, is_differential=False):
-        """SPI Interface for MCP3xxx-based ADCs reads.
-
-        :param int pin: individual or differential pin.
-        :param bool is_differential: single-ended or differential read.
-
-        """
         command = (_MCP3002_DIFF_READ if is_differential else _MCP3002_SINGLE_READ) << 6
         command |= pin << 3
         self._out_buf[0] = command

adafruit_mcp3xxx/mcp3004.py

@@ -45,7 +45,7 @@ class MCP3004(MCP3xxx):
         - 2: CH2 = IN+, CH3 = IN-
         - 3: CH3 = IN+, CH2 = IN-
     """
-    MCP3004_DIFF_PINS = {
+    DIFF_PINS = {
         (0, 1) : P0,
         (1, 0) : P1,
         (2, 3) : P2,

adafruit_mcp3xxx/mcp3008.py

@@ -53,7 +53,7 @@ class MCP3008(MCP3xxx):
         - 6: CH6 = IN+, CH7 = IN-
         - 7: CH7 = IN+, CH6 = IN-
     """
-    MCP3008_DIFF_PINS = {
+    DIFF_PINS = {
         (0, 1) : P0,
         (1, 0) : P1,
         (2, 3) : P2,

adafruit_mcp3xxx/mcp3xxx.py

@@ -70,6 +70,8 @@ def __init__(self, spi_bus, cs, ref_voltage=3.3):
         self._in_buf = bytearray(3)
         self._ref_voltage = ref_voltage
 
+    DIFF_PINS = {}
+
     @property
     def reference_voltage(self):
         """Returns the MCP3xxx's reference voltage."""

docs/api.rst

@@ -1,13 +1,21 @@
 API
 ------------
 
+.. automodule:: adafruit_mcp3xxx.mcp3xxx
+    :members:
+
 .. automodule:: adafruit_mcp3xxx.analog_in
     :members:
 
+.. automodule:: adafruit_mcp3xxx.mcp3002
+    :members:
+    :show-inheritance:
+    :exclude-members: read
+
 .. automodule:: adafruit_mcp3xxx.mcp3004
     :members:
-    :inherited-members:
+    :show-inheritance:
 
 .. automodule:: adafruit_mcp3xxx.mcp3008
     :members:
-    :inherited-members:
+    :show-inheritance: