See http://mknx.github.io/smarthome/ for more information and documentation.

Directory and File Overview

This should give you an overview of the most important files and directories.

etc/smarthome.conf

This is a global configuration file where you could specify the location and timezone of your smart home.

etc/plugin.conf

In this configuration file you configure the plugins and their attributes.

etc/logic.conf

In the logic.conf you specify your logics and when they will be run.

# etc/logic.conf
[AtSunset]
    filename = sunset.py
    crontab = sunset

items/

This directory contains one or more item configuration files. The filename does not matter, except it has to end with '.conf'.

# items/global.conf
[global]
    [[sun]]
        type = bool
        attribute = foo

logics/

This directory contains your logic files. Simple or sophisitcated python scripts. You could address your smarthome item by sh.item.path. If you want to read an item call sh.item.path() or to set an item sh.item.path(Value).

# logics/sunset.py
if sh.global.sun():  # if sh.global.sun() == True:
    sh.gloabl.sun(False)  # set it to False