ProtoCentral TLA20xx MicroPython Library

MicroPython library for the ProtoCentral TLA20xx breakout — a TI TLA2024 / TLA2022 12-bit, 4-channel I²C ADC (ADS101x-class) with a programmable input mux, gain (PGA), and data rate. The same driver also runs on a Raspberry Pi (via a lightweight smbus2 shim), so one codebase covers MCUs (Raspberry Pi Pico, ESP32) and Linux SBCs alike.

Don't have one? Buy it here

Features

• TI TLA2024 (4-channel) / TLA2022 (1-channel) 12-bit delta-sigma ADC
• Programmable input mux: 4 single-ended or differential pairs (AIN0–AIN3)
• Programmable gain / full-scale range from ±6.144 V down to ±0.256 V
• Selectable data rate, 128 SPS to 3300 SPS
• Continuous and single-shot conversion modes
• I²C interface, default address 0x48
• Qwiic / STEMMA QT connector for solder-free wiring
• One driver for MicroPython and Raspberry Pi / Linux

Installation

MicroPython (Raspberry Pi Pico, ESP32, …)

Install over the network with mip:

mpremote mip install github:Protocentral/protocentral-micropython-tla20xx

Or copy protocentral_tla20xx.py to the board manually (e.g. mpremote cp protocentral_tla20xx.py :).

Raspberry Pi / Linux

sudo raspi-config            # Interface Options -> enable I2C
pip install protocentral-tla20xx
i2cdetect -y 1               # confirm the ADC shows up at 0x48

Hardware Setup

The board uses I²C. Connect power, ground, and the two I²C lines; the default address is 0x48 (ADDR strap: GND→0x48, VDD→0x49, SDA→0x4A, SCL→0x4B). Set the address in your own script to match the strap. Analog inputs are AIN0–AIN3.

Adafruit QT Py ESP32-C3 (MicroPython)

The examples default to this board — plug the breakout into the STEMMA QT / Qwiic connector for solder-free wiring, or wire it by hand:

Raspberry Pi Pico (MicroPython)

ESP32 (MicroPython)

Raspberry Pi (Linux)

Quick Start

MicroPython

import time
from machine import Pin, I2C
from protocentral_tla20xx import TLA20XX, MUX_AIN0_GND, FSR_2_048V, DR_128SPS, OP_CONTINUOUS

i2c = I2C(0, scl=Pin(6), sda=Pin(5), freq=400000)   # Adafruit QT Py ESP32-C3; set pins for your board

TLA20XX_I2C_ADDR = 0x48        # ADDR strap: GND=0x48, VDD=0x49, SDA=0x4A, SCL=0x4B
adc = TLA20XX(i2c, TLA20XX_I2C_ADDR)
adc.begin()
adc.set_mode(OP_CONTINUOUS)
adc.set_dr(DR_128SPS)
adc.set_fsr(FSR_2_048V)        # at +/-2.048 V, 1 LSB ~= 1 mV
adc.set_mux(MUX_AIN0_GND)

while True:
    print("count={:>6}   {:.2f} mV".format(adc.read_adc(), adc.read_voltage()))
    time.sleep(0.5)

Raspberry Pi / Linux

Same driver — swap machine.I2C for the smbus2 shim:

import time
from protocentral_tla20xx_linux import I2C
from protocentral_tla20xx import TLA20XX, MUX_AIN0_GND, FSR_2_048V, DR_128SPS, OP_CONTINUOUS

TLA20XX_I2C_ADDR = 0x48        # ADDR strap: GND=0x48, VDD=0x49, SDA=0x4A, SCL=0x4B

with I2C(bus=1) as i2c:
    adc = TLA20XX(i2c, TLA20XX_I2C_ADDR)
    adc.begin()
    adc.set_mode(OP_CONTINUOUS)
    adc.set_dr(DR_128SPS)
    adc.set_fsr(FSR_2_048V)
    adc.set_mux(MUX_AIN0_GND)
    while True:
        print("count={:>6}   {:.2f} mV".format(adc.read_adc(), adc.read_voltage()))
        time.sleep(0.5)

API Reference

Constructor

Methods

Method and constant names mirror the ProtoCentral TLA20xx Arduino library so sketches translate directly.

Constants

Examples

License

Software: MIT License — see LICENSE.md.

Hardware: the TLA20xx breakout board is open-source hardware licensed under CERN-OHL-P v2.