Raspberry Pi HTTP Interface for GPIO Control
Haskell
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app v.0.0.2.0 with docs Feb 3, 2017
src/Piserv
.gitignore
API.md bump API docs and bundle new binary for v0.1.0.0 Feb 4, 2017
LICENSE
README.md spell Raspbian properly Feb 7, 2017
Setup.hs init commit Feb 3, 2017
piserv.cabal
piserver.tar.gz
stack.yaml init commit Feb 3, 2017

README.md

piserv

A haskell-powered web server for Raspberry Pi GPIO control making use of the haskell wiringPi package and servant.

Running the server

Download this repo and use the zipped binary piserver on your RPi. Only tested on a Model B+ RPi as of yet.

Please install the low-level wiringpi library first on your RPi thus:

> sudo apt-get install wiringpi

Then run the binary on your RPi as either root or by setting the environment variable in your profile as follows:

> echo "export WIRINGPI_GPIOMEM=1" >> ~/.profile

The server will run by default on PORT=8080. You can parameterize the PORT for the executable at runtime as follows:

> ./piserver 8081 # where 8081 is port 8081 for example

You can test the server using a simple curl like:

curl -i http://localhost:8080/piboardrev

Endpoints

Please see API.md for the automatically generated API documentation. You can get this by hitting /docs endpoint. Alternatively, any non-matched URL will return this documentation.

GET /health should return OK if the server is running.

Building the package on your own RPi

I installed my GHC 8.0.1 / Stack LTS 7.18 / LLVM-3.7 setup using the script here.

I include the binary as it took a long time to build. Some packages, notably text, vector, bytestring, aeson, lens are probably best installed one at a time using stack before unleashing the full stack build.

My RPi build (for binary included here) is as follows:

Linux raspberrypi 4.4.34-v7+ #930 armv7l GNU/Linux Raspbian "Jessie".

CPU Param Value
processor 0
model name ARMv7 Processor rev 5 (v7l)
BogoMIPS 38.40
Features half thumb fastmult vfp edsp neon vfpv3 tls vfpv4 idiva idivt vfpd32 lpae evtstrm
CPU implementer 0x41
CPU architecture 7
CPU variant 0x0
CPU part 0xc07
CPU revision 5