Difference between revisions of "Install RPi relay board"
(→Access the switches) |
|||
Line 39: | Line 39: | ||
= Install xPL switches controller = | = Install xPL switches controller = | ||
− | Download the [http://www.dspc.ch/xPL/Downloads/xpl- | + | Download the [http://www.dspc.ch/xPL/Downloads/xpl-piSwitches.pl switches controller] script. |
Move the script to xPL scripts directory: | Move the script to xPL scripts directory: | ||
SCRIPTS_BASE_DIR=/home/control/Documents/Controls | SCRIPTS_BASE_DIR=/home/control/Documents/Controls | ||
− | mv xpl- | + | mv xpl-piSwitches.pl $SCRIPTS_BASE_DIR |
chown control:users $SCRIPTS_BASE_DIR/*.pl | chown control:users $SCRIPTS_BASE_DIR/*.pl | ||
chmod 775 $SCRIPTS_BASE_DIR/*.pl | chmod 775 $SCRIPTS_BASE_DIR/*.pl | ||
Line 52: | Line 52: | ||
su control | su control | ||
SCRIPTS_BASE_DIR=/home/control/Documents/Controls | SCRIPTS_BASE_DIR=/home/control/Documents/Controls | ||
− | $SCRIPTS_BASE_DIR/xpl- | + | $SCRIPTS_BASE_DIR/xpl-piSwitches.pl -vn loungeAmps |
Open a 2nd terminal window (on any machine with xPL installed) and monitor the xPL protocol: | Open a 2nd terminal window (on any machine with xPL installed) and monitor the xPL protocol: | ||
Line 60: | Line 60: | ||
Open a 3rd terminal window (on any machine with xPL installed) and control the switches: | Open a 3rd terminal window (on any machine with xPL installed) and control the switches: | ||
SCRIPTS_BASE_DIR=/home/control/Documents/Controls | SCRIPTS_BASE_DIR=/home/control/Documents/Controls | ||
− | $SCRIPTS_BASE_DIR/xpl-send.pl -v -d dspc- | + | $SCRIPTS_BASE_DIR/xpl-send.pl -v -d dspc-switches.loungeAmps -c control.request command=request |
− | $SCRIPTS_BASE_DIR/xpl-send.pl -v -d dspc- | + | $SCRIPTS_BASE_DIR/xpl-send.pl -v -d dspc-switches.loungeAmps -c control.basic outlet=1 command=on |
− | $SCRIPTS_BASE_DIR/xpl-send.pl -v -d dspc- | + | $SCRIPTS_BASE_DIR/xpl-send.pl -v -d dspc-switches.loungeAmps -c control.basic outlet=1 command=off |
The first <code>xpl-send</code> command asks for the status of the switches. | The first <code>xpl-send</code> command asks for the status of the switches. | ||
Line 72: | Line 72: | ||
the xPL switches controller starts-up once <code>xpl-hub_started</code> has been emitted. | the xPL switches controller starts-up once <code>xpl-hub_started</code> has been emitted. | ||
− | Edit <code>/etc/init/xpl- | + | Edit <code>/etc/init/xpl-piSwitches.conf</code>: |
################################################################################ | ################################################################################ | ||
− | # xPL Raspberry Pi | + | # xPL Raspberry Pi switches, controls 3 relays |
# | # | ||
− | description "xPL RPi | + | description "xPL RPi switches" |
version "1.0" | version "1.0" | ||
author "Francois Corthay" | author "Francois Corthay" | ||
Line 84: | Line 84: | ||
# | # | ||
env SCRIPTS_DIR='/home/control/Documents/Controls' | env SCRIPTS_DIR='/home/control/Documents/Controls' | ||
− | env SCRIPT_NAME='xpl- | + | env SCRIPT_NAME='xpl-piSwitches.pl' |
env PARAMETERS='-n loungeAmps' | env PARAMETERS='-n loungeAmps' | ||
Line 103: | Line 103: | ||
Start the device and test it: | Start the device and test it: | ||
su root | su root | ||
− | service xpl- | + | service xpl-piSwitches start |
− | service xpl- | + | service xpl-piSwitches status |
initctl list | grep xpl | sort | initctl list | grep xpl | sort | ||
ps aux | grep -i xpl | grep -v grep | sed 's/.*\/Controls\///' | ps aux | grep -i xpl | grep -v grep | sed 's/.*\/Controls\///' | ||
Line 113: | Line 113: | ||
the scripts can be defined as services. | the scripts can be defined as services. | ||
− | Edit <code>/lib/systemd/system/xpl- | + | Edit <code>/lib/systemd/system/xpl-piSwitches.service</code>: |
[Unit] | [Unit] | ||
− | Description=RPi 3-line | + | Description=RPi 3-line switches xPL controller |
After=network.target | After=network.target | ||
[Service] | [Service] | ||
Type=simple | Type=simple | ||
− | ExecStart=/home/control/Documents/Controls/xpl- | + | ExecStart=/home/control/Documents/Controls/xpl-piSwitches.pl -n loungeAmps -w 2 |
Restart=always | Restart=always | ||
Line 128: | Line 128: | ||
Activate the service: | Activate the service: | ||
su | su | ||
− | systemctl enable xpl- | + | systemctl enable xpl-piSwitches.service |
− | service xpl- | + | service xpl-piSwitches start |
Reboot and check: | Reboot and check: | ||
ps ax | grep -v grep | grep -i xpl | ps ax | grep -v grep | grep -i xpl | ||
− | service xpl- | + | service xpl-piSwitches status |
= Install xPL buttons monitor = | = Install xPL buttons monitor = |
Revision as of 15:10, 23 February 2018
The Waveshare RPi Relay Board houses 3 relays controlled by Raspberry Pi General-Purpose Input/Outputs (GPIOs).
They can be controlled by:
- shell commands built from the WiringPi libraries
- C-programs compiled with the C library for Raspberry Pi
- python scripts
Contents
Access the switches
Install WiringPi:
su apt install -y git-core cd /tmp/ git clone git://git.drogon.net/wiringPi cd wiringPi/ git pull origin ./build
Check the installation:
which gpio gpio -v gpio readall
Test the relays:
PIN=25 gpio mode $PIN output ; gpio write $PIN 0 ; sleep 1 ; gpio write $PIN 1 # for PIN in `seq 1 30`; do for PIN in 25 28 29; do echo driving pin $PIN gpio mode $PIN output gpio write $PIN 0 sleep 1 gpio write $PIN 1 sleep 1 done
Install xPL switches controller
Download the switches controller script.
Move the script to xPL scripts directory:
SCRIPTS_BASE_DIR=/home/control/Documents/Controls mv xpl-piSwitches.pl $SCRIPTS_BASE_DIR chown control:users $SCRIPTS_BASE_DIR/*.pl chmod 775 $SCRIPTS_BASE_DIR/*.pl
Test xPL switches controller
Test it:
su control SCRIPTS_BASE_DIR=/home/control/Documents/Controls $SCRIPTS_BASE_DIR/xpl-piSwitches.pl -vn loungeAmps
Open a 2nd terminal window (on any machine with xPL installed) and monitor the xPL protocol:
SCRIPTS_BASE_DIR=/home/control/Documents/Controls $SCRIPTS_BASE_DIR/xpl-monitor.pl -vf
Open a 3rd terminal window (on any machine with xPL installed) and control the switches:
SCRIPTS_BASE_DIR=/home/control/Documents/Controls $SCRIPTS_BASE_DIR/xpl-send.pl -v -d dspc-switches.loungeAmps -c control.request command=request $SCRIPTS_BASE_DIR/xpl-send.pl -v -d dspc-switches.loungeAmps -c control.basic outlet=1 command=on $SCRIPTS_BASE_DIR/xpl-send.pl -v -d dspc-switches.loungeAmps -c control.basic outlet=1 command=off
The first xpl-send
command asks for the status of the switches.
The answer is seen in the xPL traffic monitor.
Launch the xPL switches controller at startup
On Ubuntu with upstart installed,
the xPL switches controller starts-up once xpl-hub_started
has been emitted.
Edit /etc/init/xpl-piSwitches.conf
:
################################################################################ # xPL Raspberry Pi switches, controls 3 relays # description "xPL RPi switches" version "1.0" author "Francois Corthay" #------------------------------------------------------------------------------- # Configuration variables # env SCRIPTS_DIR='/home/control/Documents/Controls' env SCRIPT_NAME='xpl-piSwitches.pl' env PARAMETERS='-n loungeAmps' #------------------------------------------------------------------------------- # Start and stop conditions # start on xpl-hub_started stop on shutdown respawn setuid control setgid users #------------------------------------------------------------------------------- # Start daemon # exec $SCRIPTS_DIR/$SCRIPT_NAME $PARAMETERS
Start the device and test it:
su root service xpl-piSwitches start service xpl-piSwitches status initctl list | grep xpl | sort ps aux | grep -i xpl | grep -v grep | sed 's/.*\/Controls\///'
Debian with SystemD
On Debian with systemd (such as https://www.raspbian.org/), the scripts can be defined as services.
Edit /lib/systemd/system/xpl-piSwitches.service
:
[Unit] Description=RPi 3-line switches xPL controller After=network.target [Service] Type=simple ExecStart=/home/control/Documents/Controls/xpl-piSwitches.pl -n loungeAmps -w 2 Restart=always [Install] WantedBy=multi-user.target
Activate the service:
su systemctl enable xpl-piSwitches.service service xpl-piSwitches start
Reboot and check:
ps ax | grep -v grep | grep -i xpl service xpl-piSwitches status
Install xPL buttons monitor
Download the buttons monitor script.
Move the script to xPL scripts directory:
SCRIPTS_BASE_DIR=/home/control/Documents/Controls mv xpl-piButtons.pl $SCRIPTS_BASE_DIR chown control:users $SCRIPTS_BASE_DIR/*.pl chmod 775 $SCRIPTS_BASE_DIR/*.pl
Test xPL buttons monitor
Test it:
su control SCRIPTS_BASE_DIR=/home/control/Documents/Controls $SCRIPTS_BASE_DIR/xpl-piButtons.pl -vn loungeAmps
Open a 2nd terminal window (on any machine with xPL installed) and monitor the xPL protocol:
SCRIPTS_BASE_DIR=/home/control/Documents/Controls $SCRIPTS_BASE_DIR/xpl-monitor.pl -vf
Press on a button. The corresponding message is seen in the xPL traffic monitor.
Launch the xPL buttons monitor at startup
Debian with SystemD
On Debian with systemd (such as Raspbian), the scripts can be defined as services.
Edit /lib/systemd/system/xpl-piButtons.service
:
[Unit] Description=RPi buttons xPL monitor After=network.target [Service] Type=simple ExecStart=/home/control/Documents/Controls/xpl-piButtons.pl -n loungeAmps -w 2 Restart=always [Install] WantedBy=multi-user.target
Activate the service:
su systemctl enable xpl-piButtons.service
Reboot and check:
ps ax | grep -v grep | grep -i xpl service xpl-piButtons status