Setting Up Your Pi Cap on the Raspberry Pi 1, 2, or 3

Add precise capacitive touch, proximity sensing, and high quality audio to your Raspberry Pi project with the Pi Cap.

We have worked hard to make setting up your Pi Cap as straightforward as possible, but the process depends on the model of Raspberry Pi you are using. These instructions are for the Raspberry Pi 1 A+/B+, Raspberry Pi 2 and Raspberry Pi 3.

Materials

To begin you will need:

• 1x Pi Cap

• 1x Raspberry Pi 1 A+ or B+, Raspberry Pi 2 or Raspberry Pi 3

• 1x microSD card (8 GB or larger recommended) loaded with Raspbian or NOOBS

• 1x USB micro power supply

• 1x Ethernet cable or official Raspberry Pi WiFi adapter – (optional)

• USB keyboard USB mouse HDMI display

• TV or monitor with an HDMI-to-HDMI cable

Step 1: NOOBs or Raspbian

Before you begin, make sure you have a microSD card which is loaded with NOOBs or Raspbian. Depending what set-up you use you either can use NOOBs or Raspbian. You can find the instructions for how to set up NOOBs or load Raspbian onto your card by following the links below: Putting Raspbian or NOOBS on a microSD card.

If this is your first time working with Raspberry Pi, you can find more resources to learn about what NOOBs, Raspbian, and Raspberry Pi, here.

Step 2: Select a Setup Method

The first step is to decide how you want to connect to your Raspberry Pi in order to set it up. If you want to keep a screen connected to the Raspberry Pi when it is in use, then please proceed to Step 3.

Alternatively, if you don’t want to keep a screen connected to your Raspberry Pi the whole time, you may be better off setting it up via a network connection. In this case, skip to Step 11.

Step 3: MicroSD Card

Insert your microSD card loaded with NOOBs or Raspbian into your Raspberry Pi.

Step 4: Mounting **

Mount the Pi Cap onto your Raspberry Pi so that it looks like the image to the right. Be careful to make sure that all the pins on the Pi line up correctly with the connector on the Pi Cap.

**Warning – if you get this wrong, you could damage the Pi Cap and your Pi Zero!

Step 5: Keyboard & Mouse

Connect a USB keyboard and mouse to your Pi.

Step 6: Screen

Connect an HDMI compatible screen (either a monitor or a TV). Turn on your screen.

Step 7: Power Up

Connect power via a USB micro power supply (like a non-Apple phone charger) – your Raspberry Pi will boot up at this stage.

Step 8: NOOBs

If you are using NOOBS, select and install Raspbian.

If your card is loaded with Raspbian, your screen should load the Raspberry Pi operating system automatically. If you see the logo in the middle of your screen you’re ready to move to the next step.

Step 9: Set Up an Internet Connection

We recommend doing this by connecting an Ethernet cable to your Raspberry Pi (image 1). This will ensure a stable internet connection. If you are using a Raspberry Pi 3, you can use the onboard WiFi with an official WiFi dongle (image 2).

Once connected, check that the internet connection is working by logging into the internet. If it’s not working, make sure you’re connected to your local network. For more information on this, you can check out: Setting up WiFi on the Pi.

Step 10: Terminal

You may then continue setup by running terminal on the Pi. Proceed to Step 17 to Update your Pi. For more information on this, you can check out Getting started with Terminal on the Pi

Step 11: Setting Up Your Raspberry Pi with a Network Connection

This is the best way to set up your Pi if you are unlikely to keep a screen connected to your Raspberry Pi once your project is set up.

To begin, load Raspbian onto a microSD card. You can find the instructions on how to upload it here. Once you have loaded Raspbian onto the microSD card, you need to add a file named “SSH” onto the /boot/ partition. Simply download this file here, extract it and copy paste the extracted ssh file onto the /boot/ partition. It should show up among the other files as shown on the image on the right. You can then eject the microSD card and insert into your Raspberry Pi.

If this is your first time working with Raspberry Pi, you can find more resources to learn about NOOBs, Raspbian, and Raspberry Pi, here.

Step 12: Mounting **

Mount the Pi Cap onto your Raspberry Pi so that it looks like the image to the right. Be careful to make sure that all the pins on the Pi line up correctly with the connector on the Pi Cap.

**Warning – if you get this wrong, you could damage the Pi Cap and your Pi Zero!

Step 13: Power up

Connect power via a USB micro power supply (like a non-Apple phone charger) – your Raspberry Pi will boot up at this stage. Give the Raspberry Pi about one minute to boot before proceeding to the next stage.

Step 14: Set up an internet connection

We recommend doing this by connecting an Ethernet cable to your Raspberry Pi (image 1). This will ensure a stable internet connection. If you are using a Raspberry Pi 3, you can use the onboard WiFi with an official WiFi dongle- but you will still have to set it up using the terminal (image 2).

Once connected, check that the internet connection is working by opening a browser window. If it’s not, check you’re connected to your local network. For more troubleshooting information on this, you can check out: Setting up WiFi on the Pi.

Step 15: SSH - Mac and Linux

You may then continue setup by via SSH – this stands for Secure Shell. It is a way of connecting to the terminal of another machine (in the case the Raspberry Pi) from your computer – provided that they are on the same network.

On Mac and Linux, this is as easy as running your terminal and typing “ssh pi@raspberrypi.local” (without the quotes) followed by Enter. There may be a security question regarding an unknown key at this point – you can safely continue, as all this is saying is that it has not connected to the Raspberry Pi before – the message should not appear the next time you connect.

You will then be prompted for a password – by default, this is “raspberry” (again, no quotes). You will now have a prompt that looks just as if you were looking at the terminal on the Raspberry Pi – but it is on your machine. Magic!

If you want to change the default password later on, there are loads of resources on the internet that explain how.

Step 16: SSH - Windows

Now you are connected, you can continue setup by via SSH – this stands for Secure SHell. It is a way of connecting to the terminal of another machine (in the case the Raspberry Pi) from your computer – provided that they are on the same network.

On Windows, you have to run a program called PuTTY (there is no installer, just a .exe file) – there is a link to download this below. When you run it, you will see a configuration screen. Under Host Name enter “pi@raspberrypi.local” (as always, don’t include the quotes) and click Open. Again, you may get a security prompt – you can safely continue and you should not see this prompt again. When asked for the password, enter “raspberry” (this is the last time I am writing no quotes!) and you will be logged in. Phew!

Step 17: Update your Pi!

So now that you have a terminal prompt, you can start entering commands to run on the Pi. To begin with, you are going to update the list of available packages that the Pi can install – type “sudo apt-get update” into the terminal, followed by Enter. By the way, “sudo” here means “do this command with superuser privileges” – it allows you to access to deeper parts of the Raspbian operating system than you would otherwise be able to. The “apt-get” command is used to interface with available software packages, and “update” speaks for itself. Packages are like apps.

This will take a little while. Once it is done, you should then run “sudo apt-get dist-upgrade” which will ensure that Raspbian itself and all installed packages are up to date too. This will take considerably longer – around 10 minutes, and you might need to answer yes to a couple of questions about disk space. Probably a good time for a cup of tea. Once this is complete, you will need to reboot the pi by entering “sync && sudo reboot” at the terminal.

Step 18: Install the picap package

With our Pi now as up-to-date as it can be, it is time to install the actual software package that supports the Pi Cap – conveniently called “picap”. If you were connected via SSH before, you will need to reconnect to the Pi as the reboot will have closed that connection.

At the terminal, type “sudo apt-get install picap” followed by enter. You may be asked to confirm that you are happy to install the picap package and the other packages that it requires – simply answer Y to these questions. Once this is complete, we need to configure the Pi Cap, which we cover in the next step.

Step 19: Configure the picap package

To configure the picap package, you need to run “picap-setup” at the terminal.

Firstly we ask whether you want to enable high quality audio on the Pi. We strongly recommend that you do this – it will enable the new, higher-quality audio driver that the Raspberry Pi team have worked hard on, which is a huge improvement on the previous version. Eventually this will be enabled as standard in Raspbian, but for now you have to do it manually.

Next we ask whether or not to install examples into your home folder. We recommend that you do this, but you can of course choose not to. You can install them into any directory you like later using the “install-picap-examples” command.

Once this is complete, we ask whether you would like to reboot the Pi in order to complete installation. If you choose not to do this, you need to perform one final reboot using “sync && sudo reboot” before you can use the Pi Cap.

Step 20: What next?

Now that you have all of the software installed and your Raspberry Pi is rebooted, you will probably want to do something with it!

Open a terminal (ssh-ing in if necessary), type “picap-intro” and hit Enter. This will take you to an interactive tour of the example code we’ve written, and show you what the Pi Cap is capable of.

Have fun!