Renksu physical access control system
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Renksu physical access control system

This is currently set up to work with a single door to a single hackerspace, therefore YMMV.


(This assumes Raspbian)

Configure serial at /dev/ttyAMA0 with raspi-config, choose Interfacing options -> Serial, disable login shell over serial, enable serial hardware.

Alternatively remove the console=serial0 entry from /boot/cmdline.txt.

Give the user permissions to the required devices and install required packages (as root):

# gpasswd -a user dialout
# gpasswd -a user gpio
# apt-get install python3-venv python3-dev alsa-utils libttspico0 libttspico-utils libttspico-data

Create virtual environment and install pip packages

$ python3 -m venv venv
$ source venv/bin/activate
$ pip install -r requirements.txt

Create based on the example file, edit to taste and test:

$ cp
$ your_favorite_editor
$ ./

Edit renksu.service.example to set correct path and install (as root):

# cp renksu.service.example /etc/systemd/system/renksu.service
# systemctl enable renksu