The ConfigTree utility provides a flexible way to define tree-like structures for storing configuration data.

These structures can then be easily transferred from one system to another. The Home Automation Manager and the ready condition and command providers store data in the ConfigTree so that automation logic can be ported across platforms.

Overview

The built-in conditions, commands and rules in the Home Automation Manager (HAM) system are available in the Config Tree hierarchical structure so that you are able to easily import predefined automation logic. The providers of automation components as well as HAM itself implement configuration types for the Config Tree that reflect the current automated control actions in HAM. By using the features for exporting and importing of the Config Tree module, it is possible to port automation sequences from one system to another.

How to Configure Automation Components

There are four main approaches to modeling the configuration of the automation components in a specific system with the help of the Config Tree:

• By using configuration files in XML, ZIP or binary format (compliant with the Config Tree) which configuration types are recognized by the HAM core and providers. To avoid mistakes, it is recommended that you originally create the automation logic through HAM and then export it as a file through the Config Tree.
• By importing a configuration file for a part of the system and allowing the user to configure manually the rest of it through HAM.
• By automatically importing configurations using the "ConfigTree" manifest header.
• The user will configure the entire system through HAM via the console commands or the Web Admin Console.

Import/Export Automation Configurations Directly from the Config Tree

Every different type of automation rule, command and condition is saved as a Config Tree configuration with the command/condition/rule instances as its nodes. This enables you to import and export individual commands/conditions/rules (as config nodes in XML or Binary format) as well as all commands/conditions/rules (as zipped configurations). See the "User Guide" of Config Tree module.

Import/Export Automation Configurations from HAM

If you are using the Application Abstraction Layer you can import and export only the commands/conditions/rules that are assigned to a specific application. This is achieved through the Import/Export tab in the Home Automation page of the Web Admin Console. See the "User Guide" of Home Automation Manager module.

Commands

Each type of commands registered by the Home Automation Manager has a separate configuration type. It stores information about all available commands of this type:

• LogCommand
• GroupCommand
• EventCommand
• SceneCommand
• RuleStateCommand
• FilterRuleStateCommand

More information about the predefined commands is available here.

Conditions

Each of the condition types that are registered by the HAM has a separate configuration type. In it, information of all its instances are stored:

• AbsoluteTimerCondition
• AstroTimerCondition
• DailyPeriodCondition
• DailyTimerCondition
• EventCondition
• IntervalTimerCondition
• LogicCondition
• NthDayTimerCondition
• StatusCondition

More information about the predefined conditions can be found here.

Rules

All rules that are created in the HAM module are represented in the Config Tree as configurations of Rules configuration type.

You can edit and port these configurations via the Config Tree API, or via the available user interfaces.