You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
spydian/README.md

46 lines
1.9 KiB
Markdown

Spydian [![CodeFactor](https://www.codefactor.io/repository/github/trivernis/spydian/badge/master)](https://www.codefactor.io/repository/github/trivernis/spydian/overview/master)
===
Summary
---
6 years ago
This python project is the controlling software for the Spyder remote controlled car.
The car can be controlled with a (XBOX) Joystick and consists of a raspberry pi as core unit,
several sensors (Gyroscope, Ultrasonic, Camera) and a relay for switching lights and motors on
and off. The controlling part is achived by using pygame to get direct access to the controller
events. The software itself is splitted into several libraries for handling specific tasks.
6 years ago
Requirements
---
You need to build a basic Spyder setup yourself. This consists of a raspberry
pi as controlling unit, a gyroscope, a camera, two relays, an ultrasonic sensor and a temperature
sensor. Notice that you could manipulate the main program (`main.py`) to remove or add sensors.
The standard pins are:
Sensor | Pins
------------|-------
Ultrasonic | 11, 7
Motor-Relay | 16
Light-Relay | 15
Temperature | 11, 14
The light and the motor are switched on and off with the relay, because the raspberry pi
doesn't have enough energy to power all motors and lights. So use a seperate energy source
to power them.
6 years ago
If you are building your own setup it is recommended to only use the libraries and build the
main program yourself.
6 years ago
Install
---
To install the requirements execute the install.sh script. This script does not install Python but
uses pip. So first you need to install Python 2 and Python 3 because this software uses both
versions. You also need to connect all sensors and relays to the specific pins.
Usage
---
To execute the software the main.py script needs to be run. Open a console and type
`sudo python3 main.py`. Notice that the superuser rights are required because the script needs
access to the GPIO-Pins of the raspberry pi.