update examples and readme

Author: pantheraleo-7

README.rst

@@ -67,24 +67,24 @@ Single Ended
 .. code-block:: python
 
     import time
+
     import board
-    import busio
-    import adafruit_ads1x15.ads1015 as ADS
-    from adafruit_ads1x15.analog_in import AnalogIn
+
+    from adafruit_ads1x15 import ADS1015, AnalogIn, ads1x15
 
     # Create the I2C bus
-    i2c = busio.I2C(board.SCL, board.SDA)
+    i2c = board.I2C()
 
     # Create the ADC object using the I2C bus
-    ads = ADS.ADS1015(i2c)
+    ads = ADS1015(i2c)
 
     # Create single-ended input on channel 0
-    chan = AnalogIn(ads, ADS.P0)
+    chan = AnalogIn(ads, ads1x15.Pin.A0)
 
     # Create differential input between channel 0 and 1
-    #chan = AnalogIn(ads, ADS.P0, ADS.P1)
+    # chan = AnalogIn(ads, ads1x15.Pin.A0, ads1x15.Pin.A1)
 
-    print("{:>5}\t{:>5}".format('raw', 'v'))
+    print("{:>5}\t{:>5}".format("raw", "v"))
 
     while True:
         print("{:>5}\t{:>5.3f}".format(chan.value, chan.voltage))

examples/ads1x15_ads1115_simpletest.py

@@ -4,24 +4,22 @@
 import time
 
 import board
-import busio
 
-import adafruit_ads1x15.ads1115 as ADS
-from adafruit_ads1x15.analog_in import AnalogIn
+from adafruit_ads1x15 import ADS1115, AnalogIn, ads1x15
 
 # Create the I2C bus
-i2c = busio.I2C(board.SCL, board.SDA)
+i2c = board.I2C()
 
 # Create the ADC object using the I2C bus
-ads = ADS.ADS1115(i2c)
+ads = ADS1115(i2c)
 # you can specify an I2C adress instead of the default 0x48
 # ads = ADS.ADS1115(i2c, address=0x49)
 
 # Create single-ended input on channel 0
-chan = AnalogIn(ads, ADS.P0)
+chan = AnalogIn(ads, ads1x15.Pin.A0)
 
 # Create differential input between channel 0 and 1
-# chan = AnalogIn(ads, ADS.P0, ADS.P1)
+# chan = AnalogIn(ads, ads1x15.Pin.A0, ads1x15.Pin.A1)
 
 print("{:>5}\t{:>5}".format("raw", "v"))
 

examples/ads1x15_comparator_example.py

@@ -4,40 +4,35 @@
 import time
 
 import board
-import busio
 import countio
 
-import adafruit_ads1x15.ads1015 as ADS
-
-# import adafruit_ads1x15.ads1115 as ADS
-from adafruit_ads1x15.ads1x15 import Comp_Latch, Comp_Mode, Comp_Polarity, Mode
-from adafruit_ads1x15.analog_in import AnalogIn
+from adafruit_ads1x15 import ADS1015, AnalogIn, ads1x15
 
 # Create the I2C bus
-i2c = busio.I2C(board.SCL, board.SDA)
+i2c = board.I2C()
 
 # Create the ADS object
-ads = ADS.ADS1015(i2c)
+ads = ADS1015(i2c)
 # ads = ADS.ADS1115(i2c)
 
-# Create a single-ended channel on Pin 0
+# Create a single-ended channel on Pin A0
 #   Max counts for ADS1015 = 2047
 #                  ADS1115 = 32767
-chan = AnalogIn(ads, ADS.P0)
+chan = AnalogIn(ads, ads1x15.Pin.A0)
 
 # Create Interrupt-driven input to track comparator changes
 int_pin = countio.Counter(board.GP9, edge=countio.Edge.RISE)
 
 # Set ADC to continuously read new data
-ads.mode = Mode.CONTINUOUS
+ads.mode = ads1x15.Mode.CONTINUOUS
 # Set comparator to assert after 1 ADC conversion
 ads.comparator_queue_length = 1
 # Set comparator to use traditional threshold instead of window
-ads.comparator_mode = Comp_Mode.TRADITIONAL
+ads.comparator_mode = ads1x15.Comp_Mode.TRADITIONAL
 # Set comparator output to de-assert if readings no longer above threshold
-ads.comparator_latch = Comp_Latch.NONLATCHING
+ads.comparator_latch = ads1x15.Comp_Latch.NONLATCHING
 # Set comparator output to logic LOW when asserted
-ads.comparator_polarity = Comp_Polarity.ACTIVE_LOW
+ads.comparator_polarity = ads1x15.Comp_Polarity.ACTIVE_LOW
 # Gain should be explicitly set to ensure threshold values are calculated correctly
 ads.gain = 1
 # Set comparator low threshold to 2V

examples/ads1x15_fast_read.py

@@ -6,9 +6,7 @@
 import board
 import busio
 
-import adafruit_ads1x15.ads1015 as ADS
-from adafruit_ads1x15.ads1x15 import Mode
-from adafruit_ads1x15.analog_in import AnalogIn
+from adafruit_ads1x15 import ADS1015, AnalogIn, ads1x15
 
 # Data collection setup
 RATE = 3300
@@ -21,18 +19,18 @@
 i2c = busio.I2C(board.SCL, board.SDA, frequency=1000000)
 
 # Create the ADC object using the I2C bus
-ads = ADS.ADS1015(i2c)
+ads = ADS1015(i2c)
 
 # Create single-ended input on channel 0
-chan0 = AnalogIn(ads, ADS.P0)
+chan = AnalogIn(ads, ads1x15.Pin.A0)
 
 # ADC Configuration
-ads.mode = Mode.CONTINUOUS
+ads.mode = ads1x15.Mode.CONTINUOUS
 ads.data_rate = RATE
 
 # First ADC channel read in continuous mode configures device
 # and waits 2 conversion cycles
-_ = chan0.value
+_ = chan.value
 
 sample_interval = 1.0 / ads.data_rate
 
@@ -51,7 +49,7 @@
         pass
 
     # Read conversion value for ADC channel
-    data[i] = chan0.value
+    data[i] = chan.value
 
     # Loop timing
     time_last_sample = time.monotonic()

examples/ads1x15_gain_example.py

@@ -4,23 +4,20 @@
 import time
 
 import board
-import busio
 
-# import adafruit_ads1x15.ads1015 as ADS
-import adafruit_ads1x15.ads1115 as ADS
-from adafruit_ads1x15.analog_in import AnalogIn
+from adafruit_ads1x15 import ADS1115, AnalogIn, ads1x15
 
 # Create the I2C bus
-i2c = busio.I2C(board.SCL, board.SDA)
+i2c = board.I2C()
 
 # Create the ADS object
 # ads = ADS.ADS1015(i2c)
-ads = ADS.ADS1115(i2c)
+ads = ADS1115(i2c)
 
-# Create a single-ended channel on Pin 0
+# Create a single-ended channel on Pin A0
 #   Max counts for ADS1015 = 2047
 #                  ADS1115 = 32767
-chan = AnalogIn(ads, ADS.P0)
+chan = AnalogIn(ads, ads1x15.Pin.A0)
 
 # The ADS1015 and ADS1115 both have the same gain options.
 #

examples/ads1x15_simpletest.py

@@ -4,22 +4,20 @@
 import time
 
 import board
-import busio
 
-import adafruit_ads1x15.ads1015 as ADS
-from adafruit_ads1x15.analog_in import AnalogIn
+from adafruit_ads1x15 import ADS1015, AnalogIn, ads1x15
 
 # Create the I2C bus
-i2c = busio.I2C(board.SCL, board.SDA)
+i2c = board.I2C()
 
 # Create the ADC object using the I2C bus
-ads = ADS.ADS1015(i2c)
+ads = ADS1015(i2c)
 
 # Create single-ended input on channel 0
-chan = AnalogIn(ads, ADS.P0)
+chan = AnalogIn(ads, ads1x15.Pin.A0)
 
 # Create differential input between channel 0 and 1
-# chan = AnalogIn(ads, ADS.P0, ADS.P1)
+# chan = AnalogIn(ads, ads1x15.Pin.A0, ads1x15.Pin.A1)
 
 print("{:>5}\t{:>5}".format("raw", "v"))