SD Card Image From Scratch
First, download the latest Raspbian Jessite Lite image from the RPi download page, and install on an SD card of 4GB or larger (we recommend 8GB to leave plenty of space for photographs), following these instructions.
If you use a different distribution and encounter errors then we may not be able to help.
The following instructions are for the latest version of Raspbian Jessie Lite (27th May 2016).
We recommend use of a B+ or V2 B Pi for setup and testing, though you could also use an A+ or Zero with a USB wired LAN adapter. Wireless LAN is more tricky to set up so wired is preferred. The V3 Pi is now also supported but is more work to configure (see below).
Insert the SD card into your Pi, connect to your LAN, and apply power to the Pi. Don't connect the PITS board yet.
The following steps can be done from a USB keyboard attached to the Pi, or an ssh session from another computer. The latter is more difficult to set up but does mean that you can "cut and paste" the commands below. For WIndows users, we recommend "putty" as an easy to use ssh client.
Using either the keyboard or ssh, login using user “pi” and password “raspberry”, then type:
You then need to set a few things:
- Enable Camera
- Advanced Options --> Enable SPI (if you are going to use the LoRa board)
- Advanced Options --> Enable I2C (if you will at some time use the BMP085 or BMP180)
- Advanced Options --> Enable One-Wire support
Note that the I2C/SPI/OneWire settings have been moved to "Interfacing Options" in the latest Raspbian update.
Then close raspi-config and allow it to reboot (you will be prompted for this).
Once the Pi has started, login again and type this command:
sudo systemctl mask serial-getty@ttyAMA0.service
That disables the serial port login. We also need to stop the kernel from using the serial port, by editing the cmdline.txt file:
sudo nano /boot/cmdline.txt
and remove the part that says console=serial0,115200
Save your changes.
Pi V3 and Pi Zero W
You need to disable the bluetooth module, and map the freed serial port to the GPIO pins. To do this, edit /boot/config.txt:
sudo nano /boot/config.txt
then go to the end of the file and add a new line containing this:
Exit the editor, saving your changes.
Now type this command:
sudo systemctl disable hciuart
sudo apt-get install git
Although PIGPIO driver and tools are included in Jessie now, the dev files for compilation are not, so it still needs to be installed manually.
sudo make install
The first make step takes some time to complete.
sudo apt-get install wiringpi
Install SSDV Software
Now install the equally excellent SSDV (Slow Scan Digital Video) software from Phil Heron. This provides a command-line app which converts between JPG and SSDV formats. In our case we convert from JPG to SSDV and then transmit the resulting packets over the radio link. Install using these commands:
git clone https://github.com/fsphil/ssdv.git
sudo make install
This is only needed if you wish to use a USB webcam instead of the Pi camera.
sudo apt-get install fswebcam
The PITS tracker software is on github, and can be installed as follows:
git clone https://github.com/PiInTheSky/pits.git
The build process compiles and links the tracker program, creates a default configuration file, and sets the software up to start automatically when the Pi boots.
Shut down the Pi (sudo halt), remove power, connect the Pi camera (threading the cable through the slot in the PITS board) and then and connect the PITS board (click here if it's not obvious how to do that). With the camera and PITS boards connected, apply power and wait for it to boot.
Once it has started (to the login prompt on the monitor) the tracker program and camera script will automatically start. After a few seconds you will see the camera preview appear on the monitor, and this will repeat approx twice a minute. Meanwhile the tracker software runs in the background.
You should see the red WARN light come on straightaway. This will stay on until the GPS receives lock, which first time could take 2 minutes or so. If after 5 minutes there is no lock, move the GPS antenna to a window, or outside. The receiver is very sensitive and you should get a lock anyway so long as it has sight of a window.
Once GPS lock has been established, the WARN LED will go out and the green OK light will flash.
At this point you should set up a radio receiver to decode the transmissions.
When you are done testing for now, you can login and then shutdown the Pi with "sudo halt".
If you want to see what the tracker is doing, then login to the Pi, then kill the tracker and restart it with:
sudo killall startup
sudo killall tracker
Updating The Software
Periodically we update the software on github, and we do recommend that you always use the latest available.
To be informed of any updates, you need a github account, after which you can go to https://github.com/PiInTheSky/pits and "star" the repository.
Alternatively, follow https://twitter.com/pitsproject on Twitter.
To download and build the latest software, perform these commands either at the Pi keyboard or in an ssh session:
git pull origin master