Documentation

Preparing Your Raspberry Pi for Pi-Plates

WARNING: DO NOT OVERCLOCK YOUR RASPBERRY PI 2! We’ve had some customers try overclocking with the RPi 2 and it caused incompatibility with the interface to the Pi-Plates.

Enable SPI on your Raspberry Pi

First of all, make sure you have downloaded the very latest version of Raspian from the RaspberryPi.org.  The latest versions not only support the newest hardware but have also simplified the use of Python with GPIO pins. In addition, your Raspberry Pi will boot straight into the graphics-user-interface (GUI) with these newer versions making it easy to set things up.

The following steps assume your Raspberry Pi is on, that you are connected to the internet, and that you have booted to the startup screen. If so, click on the menu button on the upper left and then on the Preferences tab below that. After another submenu pops out to the right, click on the area where it says Raspberry Pi Configuration:

Setup1B

After that, the Raspberry Pi Configuration window will pop up with some tabs across the top. Click on the Interfaces tab and then locate the line that says SPI:

Setup2B

Click the button in front of Enabled and then click on the OK button. You will then be presented with the following message:

Setup3

Click the Yes button and wait for your Raspberry Pi to reboot and display the GUI again before the next step:

Downloading the Pi-Plates Python Modules

Start by clicking on the icon shown in the image below to open a terminal window :

Setup4

A terminal window will then pop up in the middle of your screen presenting you with a command line interface (CLI):

Setup5

Install the Pi-Plates python modules by typing sudo pip install pi-plates and hitting <ENTER> on your keyboard. If all goes well, you should see the following on your terminal:

Setup6

Downloading the Python SPI Drivers

Note that the depending on the version of Raspian you’re using, the following may not be necessary – the 2016-05-27 version no longer requires this step.

Install the Python SPI library by typing sudo apt-get install python-spidev on the command line next and hitting <ENTER>:

2016-05-17-182134_1920x1080_scrot

Congratulations, you’re ready to talk to your Pi-Plates using Python!

 


Attaching Your Pi-Plate to the RPI

If you have purchased a base, go here for assembly instructions.

Otherwise, it should be pretty straight forward to plug your Pi-Plate onto your Raspberry Pi board. Before doing so, however, inspect the header pins on your Raspberry Pi and ensure that they are straight. Once that is done, simply align the Pi-Plate over the Raspberry Pi and push them together. Try to keep the assembly square and you should be good to go.

If you have additional Pi-Plates, repeat the above steps using the included 15mm standoffs to act as spacers between the boards.

If you have an RPI 1 model A+, B+, or Raspberry Pi 2 model B, you may want to bring out all 40 of the pins. If that is the case, you will have to solder on the 14 pin header that came with your Pi-Plate. To do this, look at the included header and note the side that has been grounded down – this is the side that will be adjacent to the existing 26 pin header. Slide it into the bottom of the board and then carefully solder the pins on the top of the board.


Setting the Address of Your Pi-Plate

All Pi-Plates include a header populated with some jumpers for selecting the address of the board. When shipped, each board is preset to address 0. If you want to use a different address, move the jumpers according to the diagram below:

AddressHeaders

Note that the address is only read during power up. If you want to change your Pi-Plate address, you will have to power down it down, move the jumpers to select your address, and then power back up.


 

Raspberry Pi Pins used by Pi-Plates

The following pins are used by Pi-Plate boards:

RPIpinsUsed

  • None of the current Pi-Plates use the new signals on the A+, B+, and revision 2 RPI boards.
  • The following pins are dedicated to Pi-Plates and cannot be shared:
    • Pin 22 / GPIO 25
    • Pin 26 / GPIO 7
  • The following pins are used for SPI communication and can be used by other SPI-enabled devices selected by CE0. They cannot be used for GPIO:
    • Pin 19 / GPIO 10
    • Pin 21 / GPIO 9
    • Pin 23 / GPIO 11
  • The following pins may be used by Pi-Plates if their features are enabled:
    • Pin 15 / GPIO 22
    • Pin 12 / GPIO 18
  • The DAQCplate board can be powered by the RPi or it can provide power to the RPi along with the rest of the stack via the connections on the analog input terminal block.
  • Pi-Plates use a very small amount of the 3.3V power for pull ups and driving a single level translator.

DAQCplate Documentation

Command Set Quick Reference Guide

Users Guide


MOTORplate Documentation

Command Set Quick Reference Guide

Users Guide


RELAYplate Documentetion

Command Set Quick Reference Guide

Users Guide


CASEplate Assembly Instructions

When I examine myself and my methods of thought I come to the conclusion that the gift of fantasy has meant more to me than my talent for absorbing positive knowledge. Albert Einstein