Keypad Matrix Python Package

I packaged up the Matrix Keypad code into a downloadable and installable PyPI package. Let me know if you have any issues but it seems download and install well with PIP and once you make the symlinks to the adafruit code you should be good to go.

Also if there is anyone that has a Beagle Bone that can help me port this over to it aswell I would appreciate it. I've had a few requests but I don't own one yet to do the work on. (unless someone ones to send me one :) )


Python Library for Matrix Keypads. Written and tested on a Model B Raspberry Pi. Supports both a 3x4 and 4x4 keypad included
Current Version:
Project Page:Project_Page
PyPI page:PyPI_Page



If you are using the Raspberry Pi you will need to install the Python Development Toolkit. First update your package list:
sudo apt-get update
Now install the Dev Kit:
sudo apt-get install python-dev
Then to install Rpi.GPIO itself:
sudo apt-get install python-rpi.gpio
Installing Setuptools next so that you can use PIP is also helpful:
If the I2C Port expander MCP23017 or MCP23008 is being used on a RPi, the Adafruit Python library for I2C and the MCP will need to be installed.
You can clone the whole library like so:
git clone
or the two files needed can be pulled out, &
If using a BeagleBone Black you must install the Adafruit_BBIO. This will give us access to the Adafruit_BBIO.GPIO library that will interface with the pins. Instructions on installing the BBIO library can be found here. The easiest way to install is:
/usr/bin/ntpdate -b -s -u
opkg update && opkg install python-pip python-setuptools
pip install Adafruit_BBIO
For manual installation:
git clone git://
#set the date and time
/usr/bin/ntpdate -b -s -u
#install dependency
opkg update && opkg install python-distutils
cd adafruit-beaglebone-io-python
python install


You can use the source from just downloading the files or Install it as a library via PIP:
pip install matrix_keypad
If using the Adafruit I2C code on a Raspberry Pi, you will need to create links to the Adafruit I2C and MCP230xx code since they are not installed as packages.:
sudo ln -s [path to Adafruit python code]/AdafruitMCP230xx/*.py /usr/local/lib/python2.7/dist-packages/matrix_keypad
Note: you will have to change the part in the brackets and maybe the path to the where the matrix keypad package is

Files Included



See the demo scripts included to see this all in action.
To call the library select which one you intend to use and use the correct line:
from matrix_keypad import MCP230xx
from matrix_keypad import RPi_GPIO
from matrix_keypad import BBb_GPIO
Then initialize and give the library a short name so it is easier to reference later. For the MCP version:
kp = MCP230xx.keypad(address = 0x21, num_gpios = 8, columnCount = 4)
The variables in the keypad function call in this example are the I2C address, then if you are using the MCP23017 or MCP23008 you have to put the number of GPIO pin avaialable (default is 8), Then the "columnCount" is 3 for the 4x3 keypads and 4 for the 4x4 keypads.
For the standard GPIO version you only have to reference the column count and only if you want to change it to the 4x4, it defaults at the 3x4:
kp = RPi_GPIO.keypad(ColumnCount = 4)
It is possible to just check to see if a digit is currently pressed.:
checkKeypad = kp.getKey()
Or a simple function to call the keypad library and loop through it waiting for a digit press
def digit():
    # Loop while waiting for a keypress
    digitPressed = None
    while digitPressed == None:
        digitPressed = kp.getKey()
    return digitPressed

Version History

Initial Scripts
Initial package build
Initial package build and push to PyPI
Updating the to demo selecting the 4x4 keypad
Moved Version Log in README
Updated README Links
Updated References to include the PiLarm code as the inspiration for the "" code
Updates to the code in both main libs to fix some indenting and other issues from coping the code from blogger to a text file.
Updates to the keypad picking section for the constants to make it actually work
Fixes to more indenting issues. :(
Updated main libs and the demo code.
Added install directions to handle the links to the adafruit code
Updated and to reflect new package name.
Updated README as well
Updating the README project links
Updating the code's comments
Beta code added for BeagleBone Black support
Updated the demo code to include examples intializing the BBb_GPIO code
Update all library and demo code with new Comment Header
Updated the BBb library with feedback from testers

Code References

Column and Row scanning adapted from Bandono's matrixQPI which is wiringPi based.
Support for the BeagleBone Black has been added with the help of Daniel Marcus, Details on his project can be found here; is based on some work that Jeff Highsmith had done in making his PiLarm that was featured on Make.
FileTypePy VersionUploaded onSize
matrix_keypad-1.2.2.tar.gz (md5)Source2013-09-106KB (md5)Source2013-09-1014KB
  • Downloads (All Versions):
  • 4 downloads in the last day
  • 212 downloads in the last week
  • 923 downloads in the last month
create2013-08-19 21:39crump199.27.73.20
add Owner crump2013-08-19 21:39crump199.27.73.20
update hosting_mode2013-08-20 13:45crump199.27.73.22
update hosting_mode2013-08-20 13:45crump199.27.73.20
new release2013-09-10 11:30crump199.27.73.21
add source file matrix_keypad-1.2.2.tar.gz2013-09-10 11:30crump199.27.73.21
add source file matrix_keypad-1.2.2.zip2013-09-10 11:30crump199.27.73.21


  1. This comment has been removed by a blog administrator.

  2. Thanks for this. Can you tell me a little about the connections between the keypad and the MCP23008? I can't get the rows and columns right by guessing. Thanks!

  3. I got this setup and it works great, however it kills the CPU and runs it at around 90%. I'm assuming this is because it's constantly calling getKey(). Is there anyway to lessen this load? Maybe a way of converting this to use RPi.GPIO's new interrupt support?

  4. @DreadCodeMonkey The pad4pi library uses RPi.GPIO's interrupt support instead of a polling loop. It uses negligible CPU on my Pi while waiting for a key press.

  5. This comment has been removed by the author.

  6. I am really happy with your blog because your article is very unique and powerful for new reader.Prefer to study this kind of material. Nicely written information in this post,the quality of content is fine and the conclusion is lovely. Things are very open and intensely clear explanation of issues. PHP Training in Chennai

    PHP Online Training in Chennai

    Machine Learning Training in Chennai

    iOT Training in Chennai

    Blockchain Training in Chennai

    Open Stack Training in Chennai

  7. Thanks for provide great informatics and looking beautiful blog, really nice required information & the things i never imagined and i would request, wright more blog and blog post like that for us. Thanks you
    DevOps Training in Chennai

    DevOps Online Training in Chennai

    DevOps Training in Bangalore

    DevOps Training in Hyderabad

    DevOps Training in Coimbatore

    DevOps Training

    DevOps Online Training

  8. It is really great to create this wonderful blog to read. Ogen Infosystem is a leading web designing and development service provider in Delhi, India.
    Website Designing Company in India

  9. Water bodies are the main source of transportation for international freight forwarding. Due to this, sea freight company in Delhi,
    Freight Forwarder in Vietnam
    Shipping Company In India

  10. I use to read the blogs on daily bases, but today i found your blog quite interesting and unique, providing the great information and helpful to all. Keep it up and waiting for your latest updates thanks. We offers multiple services in digital marketing, some of our services are:
    Digital marketing Company
    SMM Services
    PPC Services in Delhi
    Website Design & Development Packages
    Web Development Packages
    Web Development Package
    Social Media Management Packages
    Social Media Management Services

  11. I am really happy to say it’s an interesting post to read . I learn new information from your article , you are doing a great job . Keep it up

    Devops Training in Hyderabad

    Hadoop Training in Hyderabad

    Python Training in Hyderabad

    Tableau Training in Hyderabad

    Selenium Training in Hyderabad

  12. Goodness, this is enticing research. I'm cheerful I seen this as and got to section it. extraordinary occupation upon this content material. I leaned toward it bounty. much thanks to you for the inescapable and specific data. Download Dll Fixer Crack

  13. That is a valuable instrument and every individual who utilizes the component and downloads information and riding on the web, needs to utilize this application.Malwarebytes Anti-Malware Serial

  14. Thank you for sharing such a nice and interesting blog and really very helpful article.
    Oracle Recruiting Cloud Training


  15. One of the first benefits is that it is easy to get software that is free.