Skip to content

Latest commit

 

History

History
50 lines (43 loc) · 1.63 KB

README.md

File metadata and controls

50 lines (43 loc) · 1.63 KB
Raw

Relay control

Simple program for switching relays via GPIO on Linux with FastCGI HTTP-based API and web interface.

Tested boards

  • Raspberry Pi 3 Model B running Debian 10
  • Orange Pi Lite (Allwinner H3) running Armbian 21.02.2 Buster (make CFLAGS="-DSET_DIRECTION")
  • Orange Pi i96 (RDA8810) running Raspbian 8 on kernel 3.10.62

Installation

  • Install GNU C99-compliant compiler (gcc or clang) and FastCGI library with development headers (libfcgi-dev package in Debian)
  • Edit include/relay-conrol.h
  • Run make install
  • Install any HTTP server with FastCGI support. I am using lighttpd. There is a part of possible content in /etc/lighttpd/lighttpd.conf:
...
server.document-root = "/var/www/html"
server.username = "www-data"
server.groupname = "www-data"
...
server.modules = (
	...
        "mod_fastcgi",
	"mod_staticfile"
)
...
include_shell "/usr/share/lighttpd/create-mime.conf.pl" # for correct MIME type for html file
...
fastcgi.server = (
  "/relay" => ((
    "socket" => "/run/relay-control.sock",
    "check-local" => "disable"
  ))
)
  • Run make install
  • Add /usr/local/bin/relay-control to autostart. If you are using systemd simply copy relay-control.service to /etc/systemd/system and run systemctl enable --now relay-control.

API

  • To get relay info in CSV format request /relay?status=csv. Typical response:
relay,active,name
474,0,Relay A
475,0,Relay B
  • To set LOW or HIGH relay GPIO pin make POST request to /relay with body <"off" for LOW, "on" for HIGH>=<pin id>. Example request: on=475. Response: ok with code 200 or error with code 500.