Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit

Instructions on how to build and install pifacecad on Raspbian Stretch/RaspberrPi 3

Git stats


Failed to load latest commit information.
Latest commit message
Commit time


PiFace Control and Display Python module.

Contrast is adjusted with screwdriver + screw by IR node.


You can also find the documentation and some examples installed at:



Make sure you are using the latest version of Raspbian:

$ sudo apt-get update
$ sudo apt-get upgrade

Install pifacecad (for Python 3 and 2) with the following command:

$ sudo apt-get install python{,3}-pifacecad

Test by running the program:

$ python3 /usr/share/doc/python3-pifacecad/examples/

You will need to configure the IR receiver.

Install on Raspbian Strech and RaspberryPi 3

The piface packages are currently not in the main repositories. You can, however, simply build them from their sources:

  • Enable the spi-interface:
	$ sudo raspi-config
	Interfacing Options -> SPI -> Yes
	$ sudo aptitude install liblircclient-dev cython gcc python{,3}-setuptools python{,3}-dev
	$ git clone
	$ cd python-lirc/
	$ make py3 && sudo python3 install
	$ make py2 && sudo python install
	$ git clone
	$ cd pifacecommon/
	$ sudo python install
	$ sudo python3 install
	$ git clone
	$ cd pifacecad/
	$ sudo python install
	$ sudo python3 install
  • run the hello world demo:
	>>> import pifacecad

	>>> cad = pifacecad.PiFaceCAD()    # create PiFace Control and Display object
	>>> cad.lcd.backlight_on()         # turns the backlight on
	>>> cad.lcd.write("Hello, world!") # writes hello world on to the LCD
  • Cleanup:
	$ sudo rm -rf pifacecad/ pifacecommon/ python-lirc/