Section | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Overview of an complete Configuration
...
Structure of the configuration file
The configuration file has 5 main sections to group the components configured.
Header of the file
The file start with the following header.
Code Block |
---|
<?xml version="1.0" encoding="UTF-8"?>
<sensor_configuration config_version="1" schema_version="1.0"> |
The config_version and schema_version variables are values that indicate the version of template that we use. The config_version will be updated every time a new configuration is uploaded to the system (when we modify any sensor, device, action or gateway configuration). It is an indicative parameter and is not mandatory (you can make manual changes and republish the configuration files directly without the need of updating this value). The schema_version indicates which schema is used by the template. A change in schema will probably need a new software update to the affected modules.
We will go over them in the next pages.
Code Block |
---|
<?xml version="1.0" encoding="UTF-8"?> <component_template config_version="1.1" schema_version="1.0"> <description>Azeti Demo Container Kit Meeting Room</description> <vendor>azeti</vendor> <version>1.12</version> <class>multi sensor</class> <sensors> <sensor sensor_id="Name of Sensor"> . </sensor> </sensors> <devices> <device device_id="Name of Device"> . </device> </devices> <actions> <action action_id="Name of Action"> . </action> </actions> <ac_rules> <rule="Name of Rule"> . </rule> </ac_rules> </component_template> |
→ Sensors
The complete sensors configuration is done between the labels <sensors></sensors>. The individual configuration for a sensor is between the labels <sensor></sensor>. Let us see one example of sensor and its configuration: the following code configures a sensor that will reflect the status of the first digital input of an ADAM-4150 device.
→ Devices
The complete devices configuration is done between the labels <devices></devices>. The individual configuration for a device is between the labels <device></device>. A device can be a physical or virtual device that gathers information. In this configuration section we define the technology that will be used, and all parameters necessary to make the device working. We define as well gateways, that will basically be the units that receive the information and bring them to the sensors.
→ Actions
Our system is capable of performing actions. Actions materialize usually in writing a register in a device, or wait some time before activating some status, sending information, etc. The possibilities of the Site Controller, with its automation controller capabilities, are endless once we configure the right actions for our modules. The complete actions configuration is done between the labels <actions></actions>. The individual configuration for a device is between the labels <action></action>.Let us copy an example of actions in order to see how they are used:
→ AC_Rules
The system is able to perform action also automated, through the use of the Automation Controller. These rules are being configured between the <rules></rules> labels.
Information flow
This section describes how the information flow from the sensors to the Site Controller, and eventually to our Cloud server. This will be illustrated with examples and diagrams that will help you understand how are the events and results flowing in the system. The diagrams pretend to illustrate a concrete flow of information, therefore in each of them we will draw and describe the main modules and topics involved outlining their role in the information flow.
...