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

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

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

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

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

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

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

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