Skip to content
Go to file

Pan-Tilt HAT

Pan-Tilt HAT is a two-channel servo driver designed to control a tiny servo-powered Pan/Tilt assembly. It also controls either PWM-dimmed lights or WS2812 pixels; up to 24 RGB or 18 RGBW.


Full install (recommended):

We've created an easy installation script that will install all pre-requisites and get your Pan-Tilt HAT up and running with minimal efforts. To run it, fire up Terminal which you'll find in Menu -> Accessories -> Terminal on your Raspberry Pi desktop, as illustrated below:

Finding the terminal

In the new terminal window type the command exactly as it appears below (check for typos) and follow the on-screen instructions:

curl | bash

Alternatively, on Raspbian, you can download the pimoroni-dashboard and install your product by browsing to the relevant entry:

sudo apt-get install pimoroni

(you will find the Dashboard under 'Accessories' too, in the Pi menu - or just run pimoroni-dashboard at the command line)

If you choose to download examples you'll find them in /home/pi/Pimoroni/pantilthat/.

Manual install:

Library install for Python 3:

on Raspbian:

sudo apt-get install python3-pantilthat

other environments:

sudo pip3 install pantilthat

Library install for Python 2:

on Raspbian:

sudo apt-get install python-pantilthat

other environments:

sudo pip2 install pantilthat


If you want to contribute, or like living on the edge of your seat by having the latest code, you should clone this repository, cd to the library directory, and run:

sudo python3 install

(or sudo python install whichever your primary Python environment may be)

In all cases you will have to enable the i2c bus.

Breakout Header Pinout

The breakout header on Pan Tilt HAT is connected directly to the GPIO pins.

Below is a map of the breakout functions and corresponding BCM pins:

2 3 14 15 18 10 9 11 8

Documentation & Support

You can’t perform that action at this time.