Analog input

This example uses a 10K potentiometer to provide a varying voltage. For analog to digital I normally use an MCP3008 over SPI. That's not possible here though because the PiTFT uses both SPI channels on the Pi. So I've switched to an I2C ADC: ADS1115 16-Bit ADC - 4 Channel with Programmable Gain Amplifier.

Get the Adafruit Python library:

Download: file
cd /home/pi
git clone

If you need to enable i2c follow this guide: Configuring I2C


At the top of this script now we have some more imports for the threading and ADC.

The gain and sample rate are configured and the ADC initialized.

Download: file
import sys
import pygame
import os
import pygameui as ui
import logging
import RPi.GPIO as GPIO
import signal
from Adafruit_ADS1x15 import ADS1x15
import threading
import time
ADS1015 = 0x00  # 12-bit ADC
ADS1115 = 0x01  # 16-bit ADC
# Select the gain
# gain = 6144  # +/- 6.144V
gain = 4096  # +/- 4.096V
# gain = 2048  # +/- 2.048V
# gain = 1024  # +/- 1.024V
# gain = 512   # +/- 0.512V
# gain = 256   # +/- 0.256V
# Select the sample rate
sps = 8    # 8 samples per second
# sps = 16   # 16 samples per second
# sps = 32   # 32 samples per second
# sps = 64   # 64 samples per second
# sps = 128  # 128 samples per second
# sps = 250  # 250 samples per second
# sps = 475  # 475 samples per second
# sps = 860  # 860 samples per second
# Initialise the ADC using the default mode (use default I2C address)
# Set this to ADS1015 or ADS1115 depending on the ADC you are using!
adc = ADS1x15(ic=ADS1115)
#Setup the GPIOs as outputs - only 4 and 17 are available
GPIO.setup(4, GPIO.OUT)
GPIO.setup(17, GPIO.OUT)
log_format = '%(asctime)-6s: %(name)s - %(levelname)s - %(message)s'
console_handler = logging.StreamHandler()
logger = logging.getLogger()
os.putenv('SDL_FBDEV', '/dev/fb1')
os.putenv('SDL_MOUSEDRV', 'TSLIB')
os.putenv('SDL_MOUSEDEV', '/dev/input/touchscreen')

Potentiometer thread

A thread is used to constantly read the potentiometer. If you take the reading in-line in the scene update method then you'll slow down the screen refresh rate. This separate thread allows the screen to be redrawn in parallel with us reading a value from the ADC.

The class is defined as a callable - hence the __call__ method. It takes a reference to the pitft class so we can update values on it. There's a simple termination scheme used by checking a flag on every loop. Later on you'll see how we cleanly close the program by setting this flag.

So we simply read the voltage value from the ADC and set the label and progress bar position on the pitft. 

Download: file
class PotReader():
    def __init__(self, pitft):
        self.pitft = pitft
        self.terminated = False
    def terminate(self):
        self.terminated = True
    def __call__(self):
        while not self.terminated:
            # Read channel 0 in single-ended mode using the settings above
            volts = adc.readADCSingleEnded(0, gain, sps) / 1000
            self.pitft.set_progress(volts / 3.3)

UI definition

We've added a couple more widgets to the scene now and resized the buttons to accommodate them. We're showing the voltage on a label and a progress widget. The set_progress and set_volts_label methods are called from the PotReader thread to update the values in these widgets.

Download: file
class PiTft(ui.Scene):
    def __init__(self):
        self.on17_button = ui.Button(ui.Rect(MARGIN, MARGIN, 130, 60), '17 on')
        self.on4_button = ui.Button(ui.Rect(170, MARGIN, 130, 60), '4 on')
        self.off17_button = ui.Button(ui.Rect(MARGIN, 100, 130, 60), '17 off')
        self.off4_button = ui.Button(ui.Rect(170, 100, 130, 60), '4 off')
        self.progress_view = ui.ProgressView(ui.Rect(MARGIN, 200, 280, 40))
        self.volts_value = ui.Label(ui.Rect(135, 170, 50, 30), '')
    def gpi_button(self, btn, mbtn):
        if btn.text == '17 on':
            GPIO.output(17, False)
        elif btn.text == '4 on':
            GPIO.output(4, False)
        elif btn.text == '17 off':
            GPIO.output(17, True)
        elif btn.text == '4 off':
            GPIO.output(4, True)
    def set_progress(self, percent):
        self.progress_view.progress = percent
    def set_volts_label(self, volts):
        self.volts_value.text = '%.2f' % volts
    def update(self, dt):
        ui.Scene.update(self, dt)

And finally...

To start everything going we initialise pygameui, construct the pitft class and then start the potreader thread with a reference to pitft.

Since we're running this extra thread we need a clean way to stop the program. A signal handler is used to trap ctrl+c and terminate the PotReader thread before calling sys.exit - otherwise the program will not close.

Download: file
ui.init('Raspberry Pi UI', (320, 240))
pitft = PiTft()
# Start the thread running the callable
potreader = PotReader(pitft)
def signal_handler(signal, frame):
    print 'You pressed Ctrl+C!'
signal.signal(signal.SIGINT, signal_handler)

You can run this final example from the pygamelcd project:

Download: file
sudo python
This guide was first published on Feb 01, 2016. It was last updated on Feb 01, 2016. This page (Analog input) was last updated on May 20, 2019.