IO Pi Tutorial 2 - Push the Button
Reading a button input using a Raspberry Pi and IO Pi
Created: 02/10/2015 | Last Updated: 22/05/2021
In this tutorial we will add a button and an LED to the IO Pi and detect when the button has been pressed. For this you will need your Raspberry Pi, an IO Pi, 1 red LED, 1 200R resistor and a push button.
If you have already completed tutorial 1 then you can jump straight to stage 1, otherwise you will need to complete the steps below.
We will use the AB Electronics python library to talk to the IO Pi, to download the library visit our Python Library and Demos knowledge base article.
You will need to enable i2c on your Raspberry Pi, see our other tutorial on i2c: I2C, SMBus and Raspbian Linux
The AB Electronics python library uses another library called python-smbus, you can install it using apt-get with the following commands.
sudo apt-get update
sudo apt-get install python-smbus
With the libraries installed and the Raspberry Pi is configured to use i2c we can begin building our first project.
Stage 1 – Connecting the button and the LED
If you haven’t done so install your IO Pi onto the Raspberry Pi by connecting it onto the GPIO header. Make sure your Raspberry Pi is turned off when you do this to minimise the risk of damaging the Raspberry Pi or the IO Pi.
Next connect the LED and resistor in series between Bus 2 – Pin 8 of the IO Pi and the ground pin as shown on the picture. Connect your push button between Bus 2 – Pin 1 and the ground pin.
The IO Pi contains two MCP23017 I/O controller chips from Microchip. The MCP23017 is an i2c based controller containing 16 I/O pins which can be configured individually as inputs or outputs. The two MCP23017 controllers are configured on different I2C addresses so you can control them independently from each other, for more information on setting the I2C addresses see the IO Pi datasheet at /docs/pdf/Datasheet-IOPi.pdf
The maximum current you can draw from any of the pins on the MCP23017 is 25mA so by using the 200R resistor in series with the LED we limit the current to a safe level.
For this tutorial we will start by creating a new python program file called tutorial2.py. You can use your favourite text editor for writing the program. You can find a complete example of tutorial2.py in the ABElectronics_Python_Libraries/IOPi/ folder.
At the top of your program you will need to import the IOPI library and time library.
from IOPi import IOPi
The IOPI library is used for all communication with your IO Pi, it gives you control over almost everything that can be done with the MCP23017 controller.
As we are only going to be using one of the MCP23017 controllers we will create an instance of the IOPI class and call it bus. If you want to use both controller chips you will need to create two separate instances of the IOPI class with the I2C addresses for each chip.
bus = IOPi(0x21)
0x21 is the I2C address for the controller chip on bus 2, if you have changed the address selection jumpers on your IO Pi then you will need to change this number to match the new address.
With our new instance of the IOPI class we will be able to access all of the available methods for controlling the IO Pi. Let’s begin by setting pin 1 as an input and pin 8 as an output.
The set_pin-direction method allows us to individually set the direction of each of the 16 pins on the bus.
set_pin-direction takes two variables, the first is the pin you want to control, pins 1 to 16. The second variable is the command byte for setting the pin direction. Setting a pin to 0 makes it an output while setting it to 1 makes it an input, just remember 0 = out, 1 = in.
Next we will turn off pin 8 with the write_pin method.
As with setPinDirection, write_pin takes two variables, the first is the pin to write to and the second is the value to send to the port. Sending a 0 turns a pin off while sending a 1 turns the pin on.
The IO Pi is now set up for turning our led on and off, now we need to set up the button.
There are a couple of ways you can connect a button to the IO Pi, you could connect it between an input pin and 5V or an input pin and ground.
If you use the 5V method then you will need a pull-down resistor connected between the input pin and ground. The inputs on the IO Pi contain a very small amount of capacitance and when you release the button even though the 5V is no longer connected there will be a small charge remaining on the pin which is enough for the IO Pi to get confused and not know if it should read the pin as on or off. A pull-down resistor takes away the remaining charge by allowing it to flow to ground.
The second method, which we are using here, is to connect the button between the input pin and ground. Normally you would need to use a resistor to act as a pull-up so there is a constant 5V supply to the pin when the button is not pressed but luckily the IO Pi comes with pull-up resistors inside of the chip which you can enable using the following method.
set_pin_pullup allows you to enable or disable the internal 100K pull-up resistors on any of the input pins. The method takes two variables, the first is the pin you want to control and the second tells it to enable or disable the pull-up. 1 enables the pull-up while 0 disables it.
One downside of using a pull-up resistor rather than a pull-down is that when the button is not pressed the IO Pi will always read the pin as active, so it would read 1 or on when the button is off and 0 or on when the button is pressed, which is backwards to what you would normally expect from a switch. This can be easily fixed with another useful method called invert_pin.
invert_pin does exactly what it says, it inverts the reading on an input pin so 1 becomes 0 and 0 becomes 1 and everything starts to look how it should again. The method uses the same variables as setPinPullup with the first setting the pin to invert and the second enables or disables the inverter with 1 or 0.
Now we have an LED output and a button for an input we can add a while loop where the button checking code will sit.
We need to check with an IF statement to see if the button is currently pressed, this can be done with the read_pin method.
if bus.read_pin(1) == 1:
read_pin takes one variable, the number of the pin to read. It returns a 1 or 0 showing the current state of the pin.
If the button is pressed we want to show it in some way so let’s print a message to the screen and light the LED for 2 seconds.
print 'button pressed' # print a message to the screen
If you run the program now you will see that the LED lights when you press the button but it will stay on after the button is released and not go out even after the program has ended. What we need is to add an ELSE statement onto the end of the IF statement so it turns the LED off after 2 seconds if the button is no longer pressed.
This is all the code we need to make the program work, it should now look like this.
from IOPi import IOPi
bus = IOPi(0x20)
bus.set_pin_direction(1, 1) # set pin 1 as an input
bus.set_pin_direction(8, 0) # set pin 8 as an output
bus.write_pin(8, 0) # turn off pin 8
bus.set_pin_pullup(1, 1) # enable the internal pull-up resistor on pin 1
bus.invert_pin(1, 1) # invert pin 1 so a button press will register as 1
if bus.read_pin(1) == 1: # check to see if the button is pressed
print 'button pressed' # print a message to the screen
bus.write_pin(8, 1) # turn on the led on pin 8
time.sleep(2) # wait 2 seconds
bus.write_pin(8, 0) # turn off the led on pin 8
Save your program and run it in a command terminal using
If everything goes as planned your LED should now turn on for 2 seconds every time you press the button.
(images created with Fritzing)
Note: documents in Portable Document Format (PDF) require Adobe Acrobat Reader 5.0 or higher to view, download Adobe Acrobat Reader or other PDF reading software for your computer or mobile device.