RelayControl

A simple RESTful app to control relay boards.

Support

• Raspberry Pi

Support for other GPIO control (sysfs, MRAA, ...) can be easily implemented, just in inherit the Relay class.

REST API

Method	Request	Action
GET	/	Help: list all routes
GET	/relays	List all relays and their states
GET	/relays/<relay_id>	Get state for one relay
POST	/relays/<relay_id>	Set state for one relay
GET	/relays/<relay_id>/toggle	Toggle the state of one relay

Sample usage

List all relays

curl http://10.1.28.238:8080/relays | jq -r .

[
  {
    "state": 0,
    "id": "1"
  },
  {
    "state": 1,
    "id": "0"
  },
  {
    "state": 1,
    "id": "3"
  },
  {
    "state": 0,
    "id": "2"
  },
  {
    "state": 1,
    "id": "5"
  },
  {
    "state": 1,
    "id": "4"
  },
  {
    "state": 1,
    "id": "7"
  },
  {
    "state": 1,
    "id": "6"
  }
]

Get state of one relay

curl http://10.1.28.238:8080/relays/3 | jq -r .

{
  "state": 1,
  "id": "3"
}

Set state for one relay

curl -X POST --data "state=false" http://10.1.28.238:8080/relays/3 | jq -r .

{
  "state": 0,
  "id": "3"
}