drober/blackhouse repository overview

⁠BlackHouse Domo Control

⁠Author info

Roberto Salgado (DRoBeR). :email: Contact me through Github if needed.

⁠Source code

Get code from BlackHouse Github Source⁠ pull requests are welcomed. :smile:

⁠Docker Images

Get images at BlackHouse Images from Docker Hub⁠ pull requests are welcomed. :smile:

⁠Controller

The main service is a container which will contact every device in the net. One must run a container on every node that want to use as switch/push button device

⁠Switch Device Support

⁠GPIO pins (any Raspberry Pi)

Mainly tested in Raspberry Pi Zero W

⁠TP-Link HS100

Currently the only non-GPIO device supported. It's cheap (I got a few for 20€ each) and easy to handle. Plus there are some nice python libraries to use it.

⁠Deployment

⁠Controller / Frontend

The main service is a container which will contact every device in the net. One must run a container on every node that want to use as switch/push button device

⁠Considerations

HTTP will listen at 5000 port. HTTPS will listen at 5001 port. It will only listen in one of them. Depending on if it can find or not the SSL certificates in container's /app/etc/ssl folder

⁠Running as a simple container

Example of running the controller in a Raspberry Pi 3

docker run -d -ti \
  -v /app/etc:/app/etc \
  --cap-add SYS_RAWIO --device /dev/mem \
  -e BH_SERVICE_TYPE=push \
  -p 5000:5000 -p 5001:5001 \
  drober/blackhouse:v1_pi3

⁠Deploying controller in a Docker Stack (swarm)

⁠Switch Device

⁠Considerations

HTTP will listen at 5002 port. HTTPS will listen at 5003 port. It will only listen in one of them. Depending on if it can find or not the SSL certificates in container's /app/etc/ssl folder

⁠Running as simple container

Example to run on a device name as gate which is a push device and is running on a Raspberry Pi Zero W

docker run -d -ti \
  --name blackhouse_switch_gate \
  -v /app/etc:/app/etc \
  --cap-add SYS_RAWIO --device /dev/mem \
  -e BH_SERVICE_TYPE=push \
  -p 5002:5002 -p 5003:5003 \
  drober/blackhouse:v1_piZeroW