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.
[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'.
[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
# logics/sunset.py if sh.global.sun(): # if sh.global.sun() == True: sh.gloabl.sun(False) # set it to False