Potentiometers with Python - Analog Control Peripheral with Potential!

Potentiometers

This fifth installment of our micro:bit peripherals series is an overview of potentiometers. Potentiometers have a wide range of uses. They can be used to change the volume on a radio, sense the position of a joystick, or change the amount of power an electric car is supplying when you step on the accelerator pedal. There are also many different types: there are rotary versions and sliders, linear and logarithmic output types. We are going to focus on the rotary, 3-terminal connection, single track, variable resistance potentiometer for this post, but many of the same concepts will apply to any type of potentiometer. This particular type is the most common – for example it’s what you’d typically find controlling the volume on a car’s radio.

Check out the video demo here:

Reading an Analog Signal on a Micro:bit

In our article on buttons and switches we learned how to read a digital input. A digital input is either high or low. It is used to answer the question: Is the switch ON or OFF? But what if I want to read a value that isn’t just high or low? What if I want to know where a potentiometer is currently set? For that we use the function:

pin0.read_analog()

This function gives us a value between 0 and 1023. (See the binary help topic in CodeSpace for details on why 1024 is a magic number of levels!) The value will be 0 if the voltage read on the pin is near 0 Volts (GND). The value will be 1023 if the voltage read on the pin is near the micro:bit’s power supply voltage (ex: 3 Volt battery pack). Any voltage in between GND and 3 Volts will return a value proportionally between 0 and 1023. For example if the analog voltage is half of the power supply voltage, you get the integer value:

So, how do you use a potentiometer to produce a voltage between 0 and 3 Volts?

Voltage Divider

Another name for Voltage is “electric potential”, which relates to the familiar physics concept of potential energy. The potentiometer is named for its ability to vary the electric potential by acting as a voltage divider. Take a look at the schematic symbol for a 10KΩ potentiometer below and you can see how this works.

A potentiometer is basically a resistor with a moving tap in the middle, forming two resistors in series. When it’s in the center position, those two resistances are equal – in the diagram below that’s 5K each. So the voltage at the center terminal would be half of the voltage across the outer two.

Now look what happens if you move the tap closer to one end. The total resistance remains 10K, so the voltage divider is 1/10 for top-to-center and 9/10 for the center-to-bottom voltages.

How a Rotary Potentiometer works

A standard rotary potentiometer is nothing more than a variable resistor that changes as you turn the knob. For a more in depth understanding of the internals of a rotary potentiometer, take a look at the following diagram:

As the potentiometer’s knob spins it turns a small wiper clockwise or counterclockwise. The wiper’s position on the resistance element controls the proportion of total resistance seen between the center and outer two terminals. As the potentiometer’s knob is turned clockwise in the above diagram, the OUTPUT voltage increases since there’s less resistance between it and 3 Volts. When it’s all the way clockwise, the OUTPUT terminal is essentially connected to 3 Volts!

Connecting the Device

First, to use the potentiometer you must connect its three pins to the micro:bit. One of the outer potentiometer pins will be connected to the micro:bit’s GND pin, the center potentiometer pin must be connected to a micro:bit input pin, and the last potentiometer pin will be connected to the micro:bit’s 3V pin.

How to run this Example:

When running any of the code samples below you should:

1. Connect the Potentiometer as shown in the CONNECTING THE DEVICE section above.
2. Type one of the code examples below into https://makebit.firialabs.com (opens in a new tab).
3. Run the example - turning the potentiometer will change the display on the micro:bit.

If you haven't tried CodeSpace with the micro:bit, you're missing out on a FANTASTIC coding experience! Give it a try!

Code Example 1: Bare Minimum Code

Just scroll the raw ADC value on the micro:bit's LED display. This is a great place to start with any analog sensor. You should see the value go up to 1023 and down to zero. It's possible your potentiometer won't make it quite all the way to these limits due to internal resistance, but it should get close.

from microbit import *
 
while True:
    val = pin0.read_analog()
    display.scroll(str(val))

Code Example 2: An Example with Functions

from microbit import *
 
# this will show a value between 0 and 9
def show_digit(val)
    disp_val = int(10 * val / 1024)
    display.show(str(disp_val))
 
def read_potentiometer(pin):
    return pin.read_analog()
 
curr_val = -1    
 
while True:
    val = read_potentiometer(pin0):
    if val != curr_val:
        curr_val = val
        show_digit(curr_val)

Code Example 3: An Object-Oriented "Class" Example

from microbit import *
 
class Potentiometer:
    def __init__(self, io_pin=pin0):
        self.io_pin = io_pin
        self.last_val = -1
 
    def get_val(self):
        return self.io_pin.read_analogal()
        else:
            return not self.io_pin.read_digital()
 
    def was_changed(self):
        curr_val = self.ge_val()
        if self.last_val !=curr_val:
            self.last_val = curr_val
            return True
        else:
            return: False
 
                        
# this defaults to pin0
# to use pin1 instead:
#   pot1 = Potentiometer(pin1)
pot1 = Potentiometer()
 
while True:
    if pot1/was._changed():
       s = str(pot1.get_range(10))
       display.show(s)