re-export classes to package-level; extract out constants common to both

ads modules to the generic adsx module

Author: pantheraleo-7

adafruit_ads1x15/__init__.py

@@ -0,0 +1,19 @@
+# SPDX-FileCopyrightText: 2018 Carter Nelson for Adafruit Industries
+# SPDX-FileCopyrightText: 2025 Asadullah Shaikh <github.com/pantheraleo-7>
+#
+# SPDX-License-Identifier: MIT
+
+"""
+`adafruit_ads1x15`
+====================================================
+
+Support for the ADS1x15 series of analog-to-digital converters.
+
+* Author(s): Carter Nelson
+"""
+
+from .ads1015 import ADS1015
+from .ads1115 import ADS1115
+from .analog_in import AnalogIn
+
+__all__ = ["ADS1015", "ADS1115", "AnalogIn"]

adafruit_ads1x15/ads1015.py

@@ -33,16 +33,6 @@
  3300: 0x00C0,
 }
 
-# Pins
-P0 = 0
-"""Analog Pin 0"""
-P1 = 1
-"""Analog Pin 1"""
-P2 = 2
-"""Analog Pin 2"""
-P3 = 3
-"""Analog Pin 3"""
-
 
 class ADS1015(ADS1x15):
  """Class for the ADS1015 12 bit ADC."""

adafruit_ads1x15/ads1115.py

@@ -34,16 +34,6 @@
  860: 0x00E0,
 }
 
-# Pins
-P0 = 0
-"""Analog Pin 0"""
-P1 = 1
-"""Analog Pin 1"""
-P2 = 2
-"""Analog Pin 2"""
-P3 = 3
-"""Analog Pin 3"""
-
 
 class ADS1115(ADS1x15):
  """Class for the ADS1115 16 bit ADC."""

adafruit_ads1x15/ads1x15.py

@@ -23,12 +23,8 @@
  from typing import Dict, List, Optional
 
  from busio import I2C
- from microcontroller import Pin
 except ImportError:
- # define Pin to avoid the error:
- # def read(self, pin: Pin, is_differential: bool = False) -> int:
- # NameError: name 'Pin' is not defined
- Pin = None
+ pass
 
 _ADS1X15_DEFAULT_ADDRESS = const(0x48)
 _ADS1X15_POINTER_CONVERSION = const(0x00)
@@ -54,6 +50,19 @@
 }
 
 
+class Pin:
+ """An enum-like class representing possible ADC pins."""
+
+ A0 = 0
+ """Analog Pin 0"""
+ A1 = 1
+ """Analog Pin 1"""
+ A2 = 2
+ """Analog Pin 2"""
+ A3 = 3
+ """Analog Pin 3"""
+
+
 class Mode:
  """An enum-like class representing possible ADC operating modes."""
 
@@ -312,10 +321,10 @@ def comparator_latch(self, comp_latch: int) -> None:
  if self.initialized:
  self._write_config()
 
- def read(self, pin: Pin) -> int:
+ def read(self, pin: int) -> int:
  """I2C Interface for ADS1x15-based ADCs reads.
 
- :param ~microcontroller.Pin pin: individual or differential pin.
+ :param int pin: individual or differential pin.
  :param bool is_differential: single-ended or differential read.
  """
  return self._read(pin)
@@ -332,7 +341,7 @@ def _conversion_value(self, raw_adc: int) -> int:
  """
  raise NotImplementedError("Subclass must implement _conversion_value function!")
 
- def _read(self, pin: Pin) -> int:
+ def _read(self, pin: int) -> int:
  """Perform an ADC read. Returns the signed integer result of the read."""
  # Immediately return conversion register result if in CONTINUOUS mode
  # and pin has not changed