Difference between revisions of "Raspberry Relay"
(→Usage) |
|||
Line 20: | Line 20: | ||
== Examples == |
== Examples == |
||
= Shell = |
=== Shell === |
||
* First, [http://wiringpi.com/download-and-install/ install WiringPi] |
* First, [http://wiringpi.com/download-and-install/ install WiringPi] |
||
* Set the GPIO modes: |
* Set the GPIO modes: |
||
Line 33: | Line 33: | ||
gpio write X 0 |
gpio write X 0 |
||
For more information about the gpio utility, see [https://projects.drogon.net/raspberry-pi/wiringpi/the-gpio-utility/ this page] |
For more information about the gpio utility, see [https://projects.drogon.net/raspberry-pi/wiringpi/the-gpio-utility/ this page] |
||
= Python |
=== Python === |
||
* Install the RPi.GPIO Python module: |
* Install the RPi.GPIO Python module: |
||
sudo apt-get install python-rpi.gpio |
sudo apt-get install python-rpi.gpio |
Revision as of 15:36, 25 August 2014
Overview
The Raspberry Relay board can be connected to a Raspberry Pi using the 26-pin GPIO connector. The relays can be controlled using the Raspberry Pi GPIO pins. Optionally, the Pi can be powered by the micro USB port on the Relay board. This way, the connectors for power, ethernet and USB are on one side. Please note that the polyfuse will be bypassed if the Pi is powered via the Relay board. The polyfuse prevents damage when a short-circuit occurs.
Usage
The module can be controlled with the GPIO pins on the Pi. Set a pin high, the relay will switch on and when the pin is low the relay will switch off. The pins are wired as follows:
Relay no. | Pin number | Pin name (Broadcom ref.) | Pin name (wiringPi) |
---|---|---|---|
1 | 11 | GPIO17 | 0 |
2 | 12 | GPIO18 | 1 |
3 | 13 | GPIO21 (rev 1)/GPIO27 (rev 2) | 2 |
4 | 15 | GPIO22 | 3 |
Examples
Shell
- First, install WiringPi
- Set the GPIO modes:
gpio mode 0 out gpio mode 1 out gpio mode 2 out gpio mode 3 out
- Enabling a relay:
gpio write X 1
where X is the relay number (0 to 3)
- Disabling a relay:
gpio write X 0
For more information about the gpio utility, see this page
Python
- Install the RPi.GPIO Python module:
sudo apt-get install python-rpi.gpio
- start the python interpreter
python
- or create a script
nano gpio.py
- The Python script should look like this:
#!/usr/bin/env python #import the GPIO library import RPi.GPIO as GPIO #select the board mode pin numbering GPIO.setmode(GPIO.BOARD) #set the needed GPIO pins as output GPIO.setup(11, GPIO.OUT) #relay 1 GPIO.setup(12, GPIO.OUT) #relay 2 GPIO.setup(13, GPIO.OUT) #relay 3 GPIO.setup(15, GPIO.OUT) #relay 4 #toggle the relays GPIO.output(13,True) #Enable relay 3 GPIO.output(11,False) #Disable relay 1
- For more information on the RPi.GPIO module, see this page.
Datasheets
5A variant: Songle SRD-05VDC
10A variant: Omron G5LE-14