smartdoor 2.0.0.dev1

Smartdoor system including NFC card detecting, key locking/unlocking, turning LED on/off, etc.

Smartdoor client system

Smartdoor system including NFC card detecting, key locking/unlocking, turning LED on/off, etc. with Raspberry Pi.

Quick Installation

$ python -m pip install smartdoor

Before getting started

smartdoor_host system

Smartdoor Host system which serves the web application for NFC key management must be run. Please install and deploy it in adavnce. (see here).

pigpio library

pigpio library enables hardware control for PWM signals. This is the optional library for smartdoor package. If you want to use it, please install it in advance. (see here)

How to use

1. Set up the configuration file

The default configuration file ca be generated by the following command:

smartdoor config --generate

The configuration file is located at ~/.config/smartdoor.toml. Please edit it according to your environment.

2. Run the main program

The main program can be executed by the following command:

smartdoor start

Then, the main program will be run in the foreground. If you want stop the program, press Ctrl+C.

3. Set up the auto start

The main program can be automatically run by systemd service. To register and start the service, execute the following command:

smartdoor service --register

Then, the service will be registered and started. To stop the service, execute the following command:

smartdoor service --stop