Source code for envirophat.ads1015

import time


ADDR = 0x48
ALT = 0x49

REG_CONV = 0x00
REG_CFG = 0x01

SAMPLES_PER_SECOND_MAP = {128: 0x0000, 250: 0x0020, 490: 0x0040, 920: 0x0060, 1600: 0x0080, 2400: 0x00A0, 3300: 0x00C0}
CHANNEL_MAP = {0: 0x4000, 1: 0x5000, 2: 0x6000, 3: 0x7000}
PROGRAMMABLE_GAIN_MAP = {6144: 0x0000, 4096: 0x0200, 2048: 0x0400, 1024: 0x0600, 512: 0x0800, 256: 0x0A00}

PGA_6_144V = 6144
PGA_4_096V = 4096
PGA_2_048V = 2048
PGA_1_024V = 1024
PGA_0_512V = 512
PGA_0_256V = 256

class ads1015:
    def __init__(self, i2c_bus=None, addr=ADDR):
        self._over_voltage = [False] * 4

        self.i2c_bus = i2c_bus
        if not hasattr(i2c_bus, "write_i2c_block_data") or not hasattr(i2c_bus, "read_i2c_block_data"):
            raise TypeError("Object given for i2c_bus must implement write_i2c_block_data and read_i2c_block_data")

        self.addr = addr
        self.max_voltage = 3300
        self.default_gain = PGA_4_096V
         
        try:
            self.i2c_bus.read_byte_data(self.addr, 0x00)
        except IOError:
            self.addr = ALT
            self.max_voltage = 5000
            self.default_gain = PGA_6_144V

    def read(self, channel=0, programmable_gain=None, samples_per_second=1600):
        """Read a specific ADC channel.

        :param channel: ADC channel, from 0 to 3
        :param programmable_gain: Gain amount to use, one of 6144, 4096, 2048, 1024, 512 or 256 (default 4096 or 6144 depending on revision)
        :param samples_per_second: Samples per second, one of 128, 250, 498, 920, 1600, 2400, 3300 (default 1600)
        """
        if programmable_gain is None:
            programmable_gain = self.default_gain
        # sane defaults
        config = 0x0003 | 0x0100

        config |= SAMPLES_PER_SECOND_MAP[samples_per_second]
        config |= CHANNEL_MAP[channel]
        config |= PROGRAMMABLE_GAIN_MAP[programmable_gain]

        # set "single shot" mode
        config |= 0x8000

        # write single conversion flag
        self.i2c_bus.write_i2c_block_data(self.addr, REG_CFG, [(config >> 8) & 0xFF, config & 0xFF])

        delay = (1.0 / samples_per_second) + 0.0001
        time.sleep(delay)

        data = self.i2c_bus.read_i2c_block_data(self.addr, REG_CONV)

        value = (data[0] << 4) |  (data[1] >> 4)

        if value & 0x800:
            value -= 1 << 2

        value /= 2047.0
        value *= float(programmable_gain)

        if value > self.max_voltage:
            self._over_voltage[channel] = True

        return round(value / 1000.0,3)

    def read_all(self):
        """Read all analog channels and return their values in a tuple."""
        return tuple([self.read(channel=x) for x in range(4)])

    values = read_all

    def available(self):
        """Check if the ADC is available."""
        try:
            self.read()
            return True
        except IOError:
            return False