Das hier wird die Steuereinheit des Maschinendecks!
The server currently only runs on Python 3. To install all dependencies, simply do pip install -r requirements.txt.
###Backend
python server.py
You need to serve the web folder. You can do this with the Simple Python HTTPServer. cd to web and run the following command: python -m http.server 8080.
Now you can visit the Control Panel on http://localhost:8080/
To add new switches to your kommandozentrale, simply add a new one to config.json. Every switch in config.json (attribute switches) needs to have at least a class-attribute, telling it which of switch_classes.pys classes is uses. This and all other attributes, for example GPIO-Pins etc, get passed to the class as initial_data. The metadata attribute of every switch gets passed to the client. If your switch doesn't match the ones already defined in switch_classes.py, you can easily add one. Each switch must:
- have an
__init__function, which accepts the argumentinitial_dataand any keyword arguments. - have a
getModulesfunction, returning a list of tuples of all functions which should be advertised to the clients and a dict of information for the client - have a
getStatefunction, which returns the current state - store its state, if it can't get it easily, because the class is reinitilized on every call (might change in the future)
switch_classes.py contains a SwitchClass which contains some convenience methods for creating new switch classes. It provides an __init__, getState and getModules function which satify the above. getModules returns all functions which have an attribute is_public which is set to True (decorators.py contains a publicMethod which you can use. getModules loads the client infomation from switch.client_information. SwitchClass also contains a setState which sets self.state to the passed state and stores the state in a shelve-store named kommanozentrale.db. In it there is a loadState function which gets the current state from the shelve-store, too.
This project is under a GPL license (see LICENSE), unless otherwise indicated in the file.