# Introduction
Ohm Automation represents the Home Automation ecosystem offered by Chiarini Automazioni srl.
{% hint style="info" %}
*OHMe* is the application that allows users to interact with products from the *Ohm Automation* ecosystem developed by [Chiarini Automazioni](https://www.chiariniautomazioni.it).
{% endhint %}
*OHMe* app is available on [Android](https://play.google.com/store/apps/details?id=com.smartface.user\&hl=en_US\&gl=US) and [iOS](https://apps.apple.com/us/app/smartface-chiarini-automazioni/id1038355474).
It is possible to interact with the system via the web by accessing the page [app.ohmautomation.io](https://app.ohmautomation.io).
Technicians have access to an app for system configuration and diagnostics, available for [Android](https://play.google.com/store/apps/details?id=com.smartface.tech\&hl=en_US\&gl=US).
# Android Guide
Some simple tips to help you interact with the user app.
The image below shows the app's interface once opened.
*Groups* are simply a way to organize your system. Typically, they are aligned with rooms (living room, master bedroom, etc.) or areas (day zone, night zone, exterior, etc.).
This guide is organized by topic, and we recommend following the suggested order. Happy reading!
# Lights
Instructions for controlling dimmable and RGB lights.
## Relay Lights
Relay lights allow for simple on and off switching, and a simple *tap* on them allows to change their state.
{% hint style="info" %}
Adjusting brightness is possible only with dimmable or RGB lights.
{% endhint %}
## Dimmable Lights
All lights that allow brightness adjustment are dimmable.
To turn dimmable lights on and off, a simple *tap* is enough, just like with regular lights. To adjust the brightness (from 1 to 100%), a long press on the light is required. The screen below displays the slider for setting the light intensity.
{% hint style="info" %}
The minimum adjustable brightness level is 1%, while to completely turn off the light, it requires a *tap* on it. Upon turning on, the light will restore to its previous state.
{% endhint %}
## RGB Lights
RGB lights are those that allow you to set a color. There are also RGBW lights, which include white adjustment, allowing for brighter colors.
Just like with dimmable lights, RGB lights require only a *tap* to turn on/off, while a long press is needed to adjust the color.
To change the color, you need to drag the cursor over the color wheel or click directly on the desired point. You can also adjust the color intensity by moving the slider on the bar below.
If the light in question also has a white setting (in the case of RGBW), you can turn the white on/off by clicking the **Set White** button, while a long press will open the window for setting the brightness (similar to dimmable lights).
To adjust the white brightness, simply move your finger on the dedicated slider.
### Favorite Colors
By clicking the `+` button, you can add the selected color to your favorites, creating a quickly accessible color palette.
{% hint style="info" %}
You can access your saved favorites by pressing the button with a star icon.
{% endhint %}
# Thermostat and Humidistat
Guide summarizing the main features of the thermostat; the steps described apply to the humidistat and, in general, to the management of any sensor for which control has been activated.
The app lets you adjust the temperature, create weekly events (for automatic control), and recognize when the associated load (for example, a solenoid valve) has been activated. In this short guide, we will show a simple example.
{% hint style="success" %}
Once the app is open, click the room/group where you want to adjust the temperature. In this example, we will modify the settings for the Living Room.
{% endhint %}
## Sensors Page
Select the Sensors page (button in the bottom bar) to view thermostats, humidistats, sensors, etc. in that room/group.
In the image, you can see only one thermostat; the interface makes the current configuration easy to understand:
* transparency and the **`OFF`** label indicate that it is currently off
* the measured temperature is 22.4°C
{% hint style="success" %}
Click on the thermostat to change the settings.
{% endhint %}
## Activation and Adjustment
After tapping the thermostat, you will see the following page.
To turn on the thermostat, tap the switch in the *Activation* section.
To adjust the temperature, you can use the **`+`** and **`-`** buttons or tap the value to enter the setpoint directly. If the thermostat supports both heating and cooling, you can choose the mode in the dedicated section.
{% hint style="success" %}
For now, we will just turn on the thermostat and set the temperature to 23°C. Then press the blue button at the bottom right to confirm.
{% endhint %}
After saving, the thermostat display will look as follows.
Where the **`OFF`** label appeared before, now the 22.5°C setpoint is shown and the thermostat is no longer transparent.
The bright red background, where the setpoint is displayed, indicates a thermostat *heat call*, so the associated loads (e.g., solenoid valve) will be activated.
When the room reaches the set temperature, the red background becomes less intense, as shown in the following image.
## Calendar
To enable automatic thermostat management, you can configure events in the dedicated calendar.
To access the calendar, simply click the dedicated icon on the thermostat. You can also access the calendar from settings by scrolling down to the **Calendar** section.
Once the calendar page is open, click the **+** button at the bottom right.
A page with several options will open, including:
* option to define a name
* selector to enable/disable the event
* selection of weekdays
* event start and end time
* setpoint and mode configuration
* whether to enable or disable the thermostat during that time slot
* option to turn off the thermostat at the end of the event
{% hint style="danger" %}
The *Turn off at end of event* option (enabled by default) automatically switches off the thermostat at the end of the time slot.
Often, you may not want to turn the thermostat off completely, but instead adjust the setpoint to a lower/higher value (depending on whether you are heating or cooling). To do this, disable this option and create other events with the desired setpoint.
{% endhint %}
If there are active events, the calendar icon will be shown in blue.
{% hint style="info" %}
Events are set to impulsive behavior by default, so even if you are within one of the configured time slots, you can still manually adjust the setpoint. This temporary setting will remain until a new event is executed.
{% endhint %}
### Example
In the event below, we selected all weekdays and set the time slot to 05:00 - 08:00.
Now set a 20°C setpoint and choose *Heat* as the mode. Also disable the *Turn off at end of event* option, so the thermostat is not switched off at the end of the time slot.
{% hint style="success" %}
Then press *Save* in the top right corner to confirm the configuration.
{% endhint %}
## Tips
If you press and hold the thermostat, a simpler interface appears, allowing you to quickly adjust the setpoint.
You can also quickly access the thermostat by tapping the temperature value shown in the rooms/groups on the main screen. In this case too, a long press will open the quick setpoint screen.
# Security System
Everything you need to know to manage your Security System.
The app is designed to allow you to activate and deactivate the Alarm System as quickly as possible, which is why you'll find the padlock prominently displayed on the main screen, indicating whether it's active or not.
{% hint style="info" %}
The padlock icon is displayed both in the top bar and in the system status information section.
{% endhint %}
When the alarm system is activated, the padlock appears locked and is green, as shown in the following photo.
In the event that the system detects an unwanted presence or tampering, the padlock will be replaced by a red bell.
## Activation / Deactivation
To activate or deactivate the Alarm System, simply click on one of the two padlocks on the main screen.
Once the padlock button is clicked, a window will open that allows you to enter the password and perform one of the following operations:
* **Advanced Settings** button: for access to more comprehensive management
* **Activate** button (closed padlock): **activation** of the alarm
* **Deactivate** button (open padlock): **deactivation** of the alarm
Enter the password, then click on the button to perform the desired operation.
{% hint style="warning" %}
The password must always be entered, even to access the **Advanced Settings**.
{% endhint %}
## Biometric Control
To further speed up operations on the alarm system, it is possible to enable biometric control (both facial and fingerprint), thus avoiding the need to enter a password.
{% hint style="warning" %}
To activate the following feature, it is necessary that biometric verification has been enabled on your device.
{% endhint %}
To use biometric control, you need to access the application settings.
Click on the red icon and confirm the activation of the feature by following the on-screen instructions.
{% hint style="info" %}
On Android, each device has a different management of biometric control (the sensors used are very different from each other), so there is no standardized process among the various smartphone/tablet manufacturers.
{% endhint %}
Once this process is completed, the icon should appear green.
Return to the main screen and click on the lock. You will now be prompted to perform biometric verification, and if successful, the password will be entered automatically.
## Advanced Settings
By accessing the advanced settings, you will have the ability to manage individual alarm sensors, and in the event that multiple alarm sectors have been configured, you will have the opportunity to manage the zones separately.
The buttons at the bottom allow you to quickly set all sectors to the same mode.
By clicking on the alarm sector, you can access the list of associated sensors.
{% hint style="info" %}
If only one alarm zone has been configured, you will see directly the list of alarm sensors.
{% endhint %}
By pressing one of the three options (disabled, enabled, or excluded), you can set the operating mode for each individual sensor. To save, press the blue button at the bottom right.
## What Does *Exclusion* Mean?
Excluding a sensor from the alarm system temporarily removes it from the system's management as if it did not exist. This can help prevent it from signaling tampering or tamper alerts in the event of a malfunction.
{% hint style="info" %}
Excluding all alarm sensors can be useful in cases where there is a power outage, which is detected as tampering with the alarm system.
{% endhint %}
## Manumission / Tamper
The tampering event can be detected in the following cases:
* Faulty alarm sensor
* Lack of communication between alarm sensors and siren, due to issues with the data network or if a board is faulty, disconnected, or tampered with
* Power failure
* Restart of the Home Automation System
* Actual tampering
* Configuration changes by a technician using the **OHMe Tech** app
{% hint style="warning" %}
It is very important to emphasize that an Alarm System operates on th**e principle of prevention**, so it is possible that tamper alerts are triggered even if the power outage is caused by your service provider or due to overload, and not necessarily by malicious intent.
Since there is no way to determine the cause of the service interruption, the system still detects the tampering and the siren goes off.
Alarm Systems are often equipped with a key to deactivate the siren, thus preventing it from sounding during power outages or maintenance on the system.
{% endhint %}
# Irrigation
The main functions for taking care of your garden, wherever you are.
To access the Irrigation System, simply press the three dots at the top right, then the *Irrigation* button.
## The Basics
Managing irrigation is a bit like listening to music, the main controls are as follows:
* **Start:** press the green button with the sprinkler symbol to start the irrigation cycle.
* **Pause:** Did you forget to move something off the lawn? Temporarily pause the cycle by pressing the blue button. Pressing the *Start* button again will resume the cycle from where it was paused.
* **Stop:** using the red button, you can completely stop the cycle. By pressing the *Start* button again, the cycle will restart from the beginning.
* **Back / Forward:** these two buttons allow you to go back to the previous stage or move to the next one.
{% hint style="info" %}
We talked about the *irrigation cycle*, as it's essential to divide the garden into zones to ensure adequate system pressure, thus ensuring a correct water supply. Each zone corresponds to a specific phase of the cycle.
{% endhint %}
In addition to the main buttons, these are the elements you will find on the page:
* **Weather Forecasts:** useful if you're away from home to avoid watering when it rains.
* **Rain Gauge:** If you have installed a rain sensor, you can check the condition of your lawn; the system will automatically avoid initiating the irrigation cycle if the garden is sufficiently moist.
* **Irrigation Cycle Information:** here you can find a summary of what is happening; if the cycle is in progress, the percentage of completion, and which phase (zone) is being irrigated at that moment.
* **Zones / Phases:** Below are the zones/phases that have been configured, which you can modify in terms of time, order, and name.
{% hint style="info" %}
Remember that since these are *predictions*, it is not possible to achieve the same performance as a rain gauge.
It is possible to link irrigation to weather conditions, so as to automatically avoid starting the cycle if rain is forecast; contact your technician to activate this option.
{% endhint %}
## Zones / Phases
When we talk about *zones* or *phases*, we essentially mean the same thing. Each zone of the garden is associated with a specific phase in the irrigation cycle. You can intervene in the phases to manage the system.
The cell representing the zone (or phase) is characterized by:
* **Play Button:** if you wish to water a specific area, you can press the *play* button and choose to start only that phase or also the subsequent ones.
* **Name:** The name allows you to distinguish different phases and you can [modify](#modify-the-configuration) it as you wish.
* **Duration:** the phase duration is expressed in minutes, and you can modify it by clicking directly on the value.
* **Completion Percentage:** The percentage value indicates the progress of the specific phase.
### Modify the Configuration
To modify the phase configuration, you need to press the three dots in the upper right corner, then the *Edit* button.
Here are the operations you can perform:
* **Arrange the Phases:** To rearrange the phases, simply press and hold the phase you want to move, then drag it to the desired location.
* **Edit the Name:** click directly on the text.
* **Modify the Duration:** click directly on the value.
Once you have completed the changes, click on the three dots at the top right again, then select *Close Edit* (click the *Cancel* button if you wish to discard them
## Calendar
The ideal setup is to program an automatic irrigation cycle, while the *manual* start or stop will be reserved for isolated cases.
To configure the scheduling, press the button with the three dots at the top right, then the *Calendar* button.
Once you have opened the calendar page, by pressing the **+** button at the bottom right, you can proceed with creating an event; by pressing the three dots at the top right, you can enable/disable all configured events.
### Event Creation
Creating an event is quite simple. It allows you to set a name for the event (e.g., *Evening Irrigation*), define the start time of the cycle, and specify the days of the week you want this configuration to be active.
{% hint style="info" %}
If you wish to irrigate more than once a day, you must create an equivalent number of events.
{% endhint %}
{% hint style="info" %}
To edit an existing event, simply click on it.
{% endhint %}
# Scheduling
Here we explain how to set up advanced routines.
Scheduling allows you to perform a series of operations at the desired time and days of the week, thus automating your routines.
Click on the three dots at the top right, then on the *Scheduling* button.
Scheduling allows you to perform a series of operations at the desired time and days of the week, thus automating your *routines*.
Click on the three dots in the top right, then on the *Scheduling* button.
To add new events, simply click the **+** button at the bottom right.
You can set the execution time and the days of the week for which you want the scheduling to be valid; click on *Set Operations* to define the list of operations you desire (you can define as many as you want).
# Automations
Thanks to Automations, you can make your home smarter by automating daily habits and simplifying interaction with your system.
{% hint style="info" %}
Example: If it rains and everyone is out of the house, then close all the windows.
{% endhint %}
## If this, then that
Setting up automations is really easy; each configured command and condition is translated into simple text, so you can check that your rules are set up correctly.
You can always review the latest execution of each automation and check which conditions were met, allowing you to test your configuration. Additionally, each execution is logged in the history, accessible from the app.
The user interface allows for configuring simple automations without risking system compromise. More advanced automations are possible but require the intervention of your trusted technician.
## Example
Click the `+` button in the bottom-right corner.
Assign a name and a description to your automation to make it easily recognizable.
Press the **Set Conditions** button to define the conditions required for the automation to execute.
After configuring the conditions, define the desired actions. Press the **Set Operations** button to proceed.
## System Update Check
This feature requires the system to be updated to at least version **24.09.24**. If your system is not updated, ask your technician for a free system update.
{% hint style="warning" %}
Not all systems are currently compatible. If you have any questions, contact us directly.
{% endhint %}
# Set Operation
The first step is to choose the item on which the operation will be performed.
Once the item is defined, you can click the **Choose Function** button and select the operation to execute.
{% hint style="info" %}
If you wish to perform the operation with a delay, you can set a timer. This configuration is very useful if other operations have been set up. For example, if you want a light to stay on for 30 seconds, you can configure a first operation to turn on the light, and a second operation to turn it off after a 30-second delay.
{% endhint %}
# Set Condition
The first step is to select the item for which the condition will be evaluated.
Once the item is defined, you can click on the **Choose Function** button and select the function to be checked.
{% hint style="info" %}
If you want the condition to be satisfied only if the selected state persists for a minimum amount of time, you can configure a timer.
{% endhint %}
# Shortcuts
*Shortcuts* are one of the most useful features because they allow you to perform numerous operations in one go.
{% hint style="info" %}
The shortcuts created by your technician are system-bound and cannot be modified (though you can hide them), but by accessing the dedicated page, you can add new ones.
{% endhint %}
Click on the button with three dots in the top right, then on *Edit*.
To add a new Shortcut, simply click the **+** button at the bottom right.
You can customize the appearance (color and icon), assign a name and description, define operations, and specify the status of an item.
# Share Shortcut
Shortcuts can be easily shared even with users who don't have the application, thanks to the generation of a custom *link* that can be sent via message or email.
Here's an example of a link generated by the application (click it to view it in your browser):
First, you need to access the Shortcuts page by clicking on the hand icon at the top right.
To share a shortcut, simply perform a long press on the desired Shortcut.
## Link Creation
The window that opens allows you to create the link and customize its usage settings.
### Link Name
Represents the identifying name of the shared *link*, which will facilitate subsequent management. This name will be used to record usage in the system History and as the title of notifications (if enabled).
{% hint style="success" %}
Hospitality facilities can use this field to set guest names, facilitating link management.
{% endhint %}
### Validity
Allows you to limit the availability of the link over time.
By setting a future date in the *Valid from* field, the link will be viewable in the browser, but the Shortcut cannot be executed until the specified date. The user will receive an informative message with the activation date indication.
The *Expiration* field allows you to automatically delete the link on the established date. Users who try to open the link after expiration will see an error message.
### Restrictions
This function allows you to further restrict the validity of the link, limiting it to specific days of the week and time slots.
### Notification
By filling in this field, you will receive a notification every time the Shared Shortcut is executed. The notification title will correspond to the link name, while the content will be the custom text entered.
### Password
By enabling this option, the user will need to enter a password to execute the Shortcut, adding an additional security layer.
## Shared Shortcuts Management
By clicking on the three dots at the top right in the *Shortcuts* screen, you can select the *Shared Shortcuts* option.
From this section, you can delete existing links or modify them.
{% hint style="success" %}
Hospitality facilities can modify the *Validity* field based on new guest check-in and check-out times, keeping access authorizations always up to date.
{% endhint %}
# Favorites
Add your most used shortcuts to the Home screen.
To add the most used shortcuts to the *Home* screen, simply click on the three dots in the top right corner, then **Set Favorites**.
A page will open allowing you to choose the Shortcuts to add as favorites, then click the button at the bottom right to confirm.
Below is an example of how favorites are displayed.
{% hint style="info" %}
To reorder your favorites, simply hold down on the item you wish to move.
{% endhint %}
# Meteo
The system frequently updates current weather forecast data, allowing you to view various information, including:
* Temperature
* Humidity
* Precipitation
* Wind
* Visibility
* Air Quality
* Sunrise/Sunset
{% hint style="info" %}
This information can be used in Automations. For instance, you can turn on outdoor lights after sunset or deactivate the VMC if the external humidity is too high.
{% endhint %}
To access the page with all the information, click on the weather widget on the main screen.
{% hint style="warning" %}
Some information (e.g., air quality) requires the system to be updated to the latest versions.
{% endhint %}
# Multi System
It may happen that you have multiple systems (home, office, vacation home, etc.) and therefore want to access each of them quickly. This guide explains how to proceed.
If you are logged into only one system, from the main screen you need to click on •••, then select the **Systems** option.
On the Systems page, click on •••, then choose the **Add System** option.
Enter the credentials for the new system and press **Log In**.
The app will automatically connect to the new system. To switch systems, simply click on the specific box.
Once you have logged into more than one system, a house icon will appear in the main screen, allowing you to quickly switch between systems.
# Password Recovery
If you forget your password, you can request a reset by accessing the user app settings.
Click on the three dots in the top right corner and select the option *Reset User Password*.
An email will then be sent to the address associated with your account. Click the *Recover Password* button in the email received.
A window will automatically open in your default browser. You will then be asked to enter the new password twice (the second time for confirmation).
{% hint style="warning" %}
It is possible to change the email address from the app as well, but you must have the password. Otherwise, please contact us directly. The password reset requires a correct email address associated with the account.
If you do not receive the reset link at your email address, it is possible that a different address was associated.
{% endhint %}
# Account Deletion
The account deletion procedure requires special attention. To avoid errors, we introduced an internally managed process. *Before proceeding, we verify the reasons for the request.*
{% hint style="danger" %}
If the account belongs to the System owner, deleting it will also result in the deletion of the System and all related data.
{% endhint %}
{% hint style="info" %}
If the account belongs to a secondary user, you can request its deletion from the technician who configured the system.
{% endhint %}
## Request deletion
The deletion request can be sent directly from the app. Alternatively, you can contact support at .
To send a deletion request, go to the app settings and open the *Account* section.
Once in the *Account* section, scroll down to the *Delete Account* option.
A window will open where you will be asked to provide the reason for your request.
Tapping *Send Request* will start the verification process.
# iOS Guide
Some simple tips to help you interact with the user app.
The image below shows the app interface once opened.
*Groups* are simply a way to organize your system. They are typically matched with rooms (living room, master bedroom, etc.) or zones (day area, night area, outdoor, etc.).
The guide is divided by topic and we recommend proceeding with the suggested order. Happy reading!
# Lights
Instructions for controlling dimmable and RGB lights.
## Relay Lights
Relay lights allow simple on/off control. A single *tap* is enough to toggle their state.
{% hint style="info" %}
Brightness adjustment is only available for dimmable or RGB lights.
{% endhint %}
## Dimmable Lights
Dimmable lights are those that allow you to adjust brightness.
To turn dimmable lights on or off, a single *tap* is enough, just like regular lights. To set the brightness level (from 1 to 100%), press and hold the light to open the adjustment screen.
The screen below shows the slider for intensity control.
{% hint style="info" %}
The minimum brightness is 1%. To turn the light off completely, tap on it or use the *power* button in the adjustment screen. When turned back on, the light will restore its previous state.
{% endhint %}
## RGB Lights
RGB lights are those that allow you to set a color. There are also RGBW lights, which include white channel control, enabling brighter and more vivid colors.
As with dimmable lights, a single *tap* turns RGB lights on or off. To adjust the color, press and hold to open the dedicated screen.
To change the color, drag the cursor on the color wheel or tap directly on the desired point. You can also adjust the color intensity using the slider below the wheel.
If the light also supports white control (RGBW), you can adjust the white channel in the dedicated section.
To set the white brightness, move the slider. To turn the white channel on or off, tap the button to the right of the slider.
### Favorite Colors
Tap the `+` button to save the currently selected color to your favorites, building a color palette for quick access.
# Thermostat and Humidistat
Guide summarizing the main thermostat features; the steps described also apply to the humidistat and, in general, to the management of any sensor for which control has been enabled.
The app lets you adjust temperature, create weekly events (for automated control), and detect when the associated load (for example, a solenoid valve) is active. In this short guide, we will show a simple example.
{% hint style="success" %}
Once the app is open, tap the room/group where you want to adjust the temperature. In this example, we will modify the settings for the *Bedroom*.
{% endhint %}
## Sensors Page
Open the Sensors page (button in the bottom bar) to view thermostats, humidistats, sensors, and other devices in that room/group.
In the image, you can see a single thermostat; the interface makes it easy to understand the current configuration:
* transparency and the **`OFF`** label indicate that it is currently off
* the measured temperature is 28.9°C
{% hint style="success" %}
Now tap the thermostat to edit its settings.
{% endhint %}
## Activation and Adjustment
After tapping the thermostat, you will see the following page.
To activate the thermostat, tap the *power* button `⏻`.
To adjust the temperature, you can use the **`-`** and **`+`** buttons or tap the value to enter the setpoint directly. If the thermostat supports both heating and cooling, you can choose the mode in the dedicated section.
{% hint style="success" %}
For now, we will just activate the thermostat and set the temperature to 27°C. Then press the Save button at the top right `✓`.
{% endhint %}
After saving, the thermostat display will look like this.
Where the **`OFF`** label previously appeared, you now see the 27°C setpoint, and the thermostat is no longer transparent.
The bright blue background behind the setpoint indicates a thermostat *cooling call*, so the associated loads (for example, a solenoid valve) will be activated.
When the room reaches the set temperature, the blue background will appear less intense, as shown in the following image.
## Calendar
To enable automatic thermostat control, you can configure events in the dedicated calendar.
To access the calendar, simply tap the dedicated icon on the thermostat.
Once the calendar page is open, tap the `+` button at the top right to create a new event. The following screen will open.
In addition to defining the event name, you can select the days of the week and the event start/end time. You can also define the desired setpoint and mode (heating/cooling).
Main options:
* event name
* toggle to enable/disable the event
* day-of-week selection
* event start and end time
* setpoint and mode configuration
* whether to activate or deactivate the thermostat during that time slot
* option to deactivate the thermostat at the end of the event
{% hint style="danger" %}
The *Deactivate at end of event* option (enabled by default) automatically turns off the thermostat at the end of the time slot.
Often, you do not want to completely turn off the thermostat, but instead adjust the setpoint to a lower/higher value (depending on whether you are in heating or cooling mode). To do this, disable this option and create additional events with the desired setpoint.
{% endhint %}
If there are active events, the calendar icon will be shown in blue.
{% hint style="info" %}
Events use impulsive management by default, so even if you are currently within one of the configured time slots, you can still manually adjust the setpoint. This temporary setting will be kept until a new event is executed.
{% endhint %}
### Example
In the event below, we selected every day and set the time slot to 19:00 - 23:00.
We then set a 26.5°C setpoint and choose *Cooling* as mode. We also disable the *Deactivate at end of event* option, so the thermostat will not be turned off at the end of the time slot.
{% hint style="success" %}
Then tap *Save* at the top right to confirm the configuration.
{% endhint %}
## Tips
If you press and hold the thermostat, a simpler interface will appear, where you can quickly adjust the setpoint.
You can also quickly access the thermostat by tapping the temperature value shown on rooms/groups in the main screen. In this case too, after a long press, the quick setpoint screen will be displayed.
# Security System
Everything you need to know to manage your alarm system.
The app is designed to let you activate and deactivate the Alarm System as quickly as possible. That is why, on the main screen, you can clearly see the shield that indicates whether it is active or not.
{% hint style="info" %}
The shield is shown both in the top bar and in the section dedicated to system status information.
{% endhint %}
When the alarm system is active, the shield appears green with a check mark `✔`, as shown in the following image.
If the system detects an unwanted presence or tampering, the shield will be replaced by a red bell.
## Activation / Deactivation
To activate or deactivate the Alarm System, simply tap the shield on the main screen.
Once you tap the shield button, a window will open that allows you to manage the Alarm System.
{% hint style="warning" %}
Every operation (activation/deactivation/exclusion and access to *Advanced Settings*) requires entering the password.
{% endhint %}
## Face ID / Touch ID
To make alarm system operations even faster, you can enable biometric authentication (both face and fingerprint), so you can avoid entering the password.
{% hint style="warning" %}
To enable this feature, biometric authentication must already be enabled on your device.
{% endhint %}
To use biometric authentication, open the Alarm System screen and scroll down until you find the dedicated option.
Enable the option and enter the alarm system password in the window that appears.
Once this step is complete, press **Save** and the option should appear green.
## Advanced Settings
In *Advanced Settings*, you can manage each alarm sensor individually. If multiple alarm areas are configured, you can also manage zones separately.
The 3 buttons at the top let you quickly set all areas to the same mode.
By tapping an alarm area, you can access the list of associated sensors.
{% hint style="info" %}
If only one alarm area is configured, you will directly see the alarm sensor list.
{% endhint %}
By selecting one of the three options (disable, enable, or exclude), you can set the operating mode of each individual sensor. To save, tap the check mark at the top right.
As with areas, the three buttons at the top let you quickly set all sensors to the same mode.
## What Does Exclusion Mean?
Excluding an alarm sensor temporarily removes it from alarm system management, as if it did not exist. This helps avoid reports such as tampering events in case of a fault.
{% hint style="info" %}
Excluding all alarm sensors can be useful in cases of power outages, an event that may be detected as tampering with the alarm system.
{% endhint %}
## Tampering / Tamper
A tampering event (or tamper) can be detected in the following cases:
* Faulty alarm sensor
* Missing communication between alarm sensors and siren, due to data network issues, or if a board is faulty, disconnected, or tampered with
* Power loss
* Home Automation System restart
* Actual tampering
* Configuration changes made by a technician using the **OHMe Tech** app
{% hint style="warning" %}
It is very important to point out that an Alarm System works with a **prevention logic**. Because of this, tampering events may also be reported if power is lost due to your utility provider or an overload, and therefore not because of malicious intent.
Since there is no way to determine the exact cause of the service interruption, the system still detects tampering and the siren sounds.
Alarm Systems are often equipped with a **key to exclude the siren**, so it does not sound during planned power outages or maintenance on the system.
{% endhint %}
# Irrigation
The main features to take care of your garden, wherever you are.
To access the Irrigation System, simply tap the three dots in the top right corner, then select the *Irrigation* option.
## The Basics
Managing irrigation is a bit like listening to music; the main buttons are:
* **Start:** tap the blue button with the sprinkler icon to start the irrigation cycle.
* **Pause:** did you forget to move something off the lawn? Temporarily pause the cycle by tapping the yellow button. Tapping *Start* again resumes the cycle from where it was paused.
* **Stop:** with the red button, you can stop the cycle completely. Tapping *Start* again restarts the cycle from the beginning.
* **Back / Forward:** these two buttons let you go back to the previous phase or move to the next one.
{% hint style="info" %}
We talked about an *irrigation cycle* because it is essential to divide the garden into zones to ensure adequate system pressure and proper water distribution. Each zone corresponds to a specific cycle phase.
{% endhint %}
In addition to the main buttons, these are the elements you will find on the page:
* **Weather Forecast:** useful when you are away from home to avoid watering when it is raining.
* **Rain Gauge:** if you have installed a rain sensor, you can check the condition of your lawn; the system will automatically avoid starting the irrigation cycle if the garden is sufficiently moist.
* **Irrigation Cycle Information:** here you will find a summary of what is happening; if the cycle is running, the completion percentage and which phase (zone) is currently being irrigated.
* **Zones / Phases:** below, you will find the configured zones/phases, and you can edit their duration, order, and name.
{% hint style="info" %}
You can link irrigation to weather conditions to automatically avoid starting the cycle if rain is forecast; contact your technician to activate this option.
Keep in mind that, since these are *forecasts*, they cannot provide the same reliability as a rain gauge.
{% endhint %}
## Zones / Phases
When we talk about *zones* or *phases*, we are essentially referring to the same thing. Each garden zone is associated with a specific phase of the irrigation cycle. Phases are what you can edit to manage the system.
The card representing the zone (or phase) includes:
* **Start Button:** if you want to irrigate a specific zone, you can tap *Start* and choose whether to start only that phase or the following ones as well.
* **Name:** the name helps distinguish the different phases, and [you can edit it](#modifying-the-configuration) as needed.
* **Duration:** phase duration is shown in minutes, and you can change it by tapping directly on the value.
* **Completion Percentage:** the percentage value indicates the progress of the specific phase.
### Modifying the Configuration
To modify phase configuration, tap the pencil icon button in the top right corner.
You can perform the following actions:
* **Reorder Phases:** to reorder phases, press and hold the phase you want to move, then drag it where you want.
* **Edit Name:** tap directly on the text.
* **Edit Duration:** tap directly on the value.
Once you complete your changes, tap the Save button `✓`; to discard them, tap the Cancel button `X`.
## Calendar
The ideal setup is to schedule automatic execution of the irrigation cycle, while *manual* start or stop should be used only in specific cases.
To configure scheduling, tap the *Calendar* button in the top right corner.
Once the calendar page is open, tap the three dots in the top right corner to:
* **Activate All:** tap this button to enable all configured events.
* **Deactivate All:** tap this button to disable all configured events.
To add a new event, tap the `+` button in the top right corner.
### Event Creation
Creating an event is quite simple and allows you to set a name for the event (e.g. *Morning*), define the cycle start time, and choose the days of the week when it will run.
{% hint style="info" %}
If you want to irrigate more than once per day, you need to create an equivalent number of events.
{% endhint %}
{% hint style="info" %}
To edit an existing event, just tap on it.
{% endhint %}
# Scheduling
Scheduling allows you to run a series of operations at the desired time and on selected days of the week, automating your *routines*.
Tap the three dots in the top right corner, then select the *Scheduling* option.
To add new events, simply tap the `+` button in the top right corner.
Each event lets you define the execution time and the days of the week when it will run; tap *Set Operations* to define the list of operations you want (you can add as many as you like).
## Advanced Settings
Main options:
* *Execute one time, then delete it*: the event will run only once and then be removed.
* *Date*: by selecting the *Date* option in the *When* section, you can define a specific day for event execution.
# Automations
Thanks to Automations, you can make your home smarter by automating daily habits and simplifying interaction with your system.
{% hint style="info" %}
Example: If it rains and everyone is out of the house, then close all the windows.
{% endhint %}
## If this, then that
Setting up automations is really easy; each configured command and condition is translated into simple text, so you can check that your rules are set up correctly.
You can always review the latest execution of each automation and check which conditions were met, allowing you to test your configuration. Additionally, each execution is logged in the history, accessible from the app.
The user interface allows for configuring simple automations without risking system compromise. More advanced automations are possible but require the intervention of your trusted technician.
## Example
Click the `+` button in the top-right corner.
Assign a name and a description to your automation to make it easily recognizable.
Press the **Set Conditions** button to define the conditions required for the automation to execute.
After configuring the conditions, define the desired actions. Press the **Set Operations** button to proceed.
## System Update Check
This feature requires the system to be updated to at least version **24.09.24**. If your system is not updated, ask your technician for a free system update.
{% hint style="warning" %}
Not all systems are currently compatible. If you have any questions, contact us directly.
{% endhint %}
# Set Operation
The first step is to choose the item on which the operation will be performed.
Once the item is defined, you can click the **Choose Function** button and select the operation to execute.
{% hint style="info" %}
If you wish to perform the operation with a delay, you can set a timer. This configuration is very useful if other operations have been set up. For example, if you want a light to stay on for 30 seconds, you can configure a first operation to turn on the light, and a second operation to turn it off after a 30-second delay.
{% endhint %}
# Set Condition
The first step is to select the item for which the condition will be evaluated.
Once the item is defined, you can click on the **Choose Function** button and select the function to be checked.
{% hint style="info" %}
If you want the condition to be satisfied only if the selected state persists for a minimum amount of time, you can configure a timer.
{% endhint %}
# Shortcuts
*Shortcuts* are one of the most useful features, as they allow you to perform multiple operations with a single tap. Until now, only your technician could create new ones or modify existing ones.
We are excited to announce that this feature is now available to users as well! The shortcuts created by your technician are system-bound and cannot be modified (although you can hide them). However, by accessing the dedicated page, you can add new ones.
Click on the three dots in the top right corner, then select *Edit Configuration*.
To add a new shortcut, simply click the **+** button in the bottom right corner.
You can customize the appearance (color and icon), assign a name and description, define the operations, and set the desired state of an element.
# Share Shortcut
Shortcuts can be easily shared even with users who don't have the application, thanks to the generation of a custom *link* that can be sent via message or email.
Here's an example of a link generated by the application (click it to view it in your browser):
First, you need to access the Shortcuts page by clicking on the hand icon at the top left.
To share a shortcut, simply perform a long press on the desired Shortcut.
## Link Creation
The window that opens allows you to create the link and customize its usage settings.
### Link Name
Represents the identifying name of the shared *link*, which will facilitate subsequent management. This name will be used to record usage in the system History and as the title of notifications (if enabled).
{% hint style="success" %}
Hospitality facilities can use this field to set guest names, facilitating link management.
{% endhint %}
### Validity
Allows you to limit the availability of the link over time.
By setting a future date in the *Valid from* field, the link will be viewable in the browser, but the Shortcut cannot be executed until the specified date. The user will receive an informative message with the activation date indication.
The *Expiration* field allows you to automatically delete the link on the established date. Users who try to open the link after expiration will see an error message.
### Restrictions
This function allows you to further restrict the validity of the link, limiting it to specific days of the week and time slots.
### Notification
By filling in this field, you will receive a notification every time the Shared Shortcut is executed. The notification title will correspond to the link name, while the content will be the custom text entered.
### Password
By enabling this option, the user will need to enter a password to execute the Shortcut, adding an additional security layer.
## Shared Shortcuts Management
By clicking on the three dots at the top right in the *Shortcuts* screen, you can select the *Shared Shortcuts* option.
From this section, you can delete existing links (via long press) or modify them (by clicking on them).
{% hint style="success" %}
Hospitality facilities can modify the *Validity* field based on new guest check-in and check-out times, keeping access authorizations always up to date.
{% endhint %}
# Favorites
To add the most used shortcuts to the *Home* screen, simply click on the three dots at the top right and select **Set Favorites**.
A page will open allowing you to choose the Shortcuts to add as favorites. Then click the button at the bottom right to confirm.
Below is an example of how favorites are displayed.
{% hint style="info" %}
To reorder favorites, simply press and hold the item you wish to move.
{% endhint %}
{% hint style="warning" %}
On **iPad**, to reorder items you need to press the three dots at the top right, then select the option **Reorder Favorites**.
{% endhint %}
# Apple Watch
Managing Shortcuts from Apple Watch.
To sync Shortcuts on your Apple Watch, open the app’s *Settings*, then scroll down to the *Apple Watch* section.
If you don’t see the Shortcuts on your Apple Watch, tap the *Sync* button.\
If you want to limit the number of displayed shortcuts, you can tap *Choose Shortcuts* and select only the ones you want to show.
{% hint style="info" %}
If you have more than one system, the Shortcuts on Apple Watch will display the name of the corresponding system.
{% endhint %}
# Meteo
The system frequently updates current weather forecast data, allowing you to view various information, including:
* Temperature
* Humidity
* Precipitation
* Wind
* Visibility
* Air Quality
* Sunrise/Sunset
{% hint style="info" %}
This information can be used in Automations. For instance, you can turn on outdoor lights after sunset or deactivate the VMC if the external humidity is too high.
{% endhint %}
To access the page with all the information, click on the weather widget on the main screen.
{% hint style="warning" %}
Some information (e.g., air quality) requires the system to be updated to the latest versions.
{% endhint %}
# Universal Search
Search and interact quickly with your smart system.
## What is Universal Search?
OHMe Universal Search is a powerful tool that lets you find and manage any item in your smart home from a single search bar. No need to browse through complicated menus—everything is accessible in seconds.
{% hint style="warning" %}
You need to update to iOS 26 or later to use this feature.
{% endhint %}
***
### How it works
* By typing a keyword, you can instantly locate devices such as lights, thermostats, sensors, your solar system, and much more.
* For example, typing “lights on” shows you immediately which lights are active and allows you to switch them off with a tap.
* By entering a category (like “lights”, “thermostats”, “sensors”), you get a complete overview of all items of that type.
***
### Quick actions
* Not just search and view: you can interact directly with every device.
* Turn devices on or off, set thermostat temperatures, control window or blind openings, start music, change calendar events.
* OHMe suggests smart quick actions, enabling advanced management without navigating multiple menus.
***
### Advantages
* Everything under control in a simple, intuitive way.
* Centralized management: save time and streamline your experience.
* Perform advanced operations quickly, with no unnecessary steps.
# Multi System
It may happen that you have multiple systems (home, office, vacation home, etc.) and therefore want to access each of them quickly. This guide explains how to proceed.
If you are logged into only one system, from the main screen you need to click on •••, then select the **Systems** option.
On the Systems page, click on •••, then choose the **Add System** option.
Enter the credentials for the new system and press **Log In**.
The app will automatically connect to the new system. To switch systems, simply click on the specific box.
Once you have logged into more than one system, a house icon will appear in the top-left corner of the main screen, allowing you to quickly switch between systems.
# Password Recovery
If you no longer remember your password, you can start the reset process by going to the app Settings and then to the *Account* section.
Tap *Reset User Password* to start the recovery process.
An email will be sent to the address associated with your account. In the email you receive, tap the *Recover Password* button.
A window will automatically open in your default browser. Enter the new password twice (the second time is for confirmation).
{% hint style="warning" %}
Password reset requires a valid email address to be associated with the account. If you do not receive the reset link, a different email address may have been linked.
You can also change the email address from the app, but you must know your current password. Otherwise, contact us directly.
{% endhint %}
# Account Deletion
The account deletion procedure requires special attention. To avoid potential user errors, we have established a process that we manage internally. *Before proceeding, we conduct a verification of the reasons behind this decision.*
{% hint style="danger" %}
If the account matches the owner of the System, its deletion corresponds to the deletion of the System and all related data.
{% endhint %}
{% hint style="info" %}
If the account you have corresponds to a secondary user, you can request its deletion from the technician who configured the system.
{% endhint %}
## Request Deletion
The deletion request can be sent directly from the app, but you can also contact support at .
To submit a deletion request, you need to access the app settings, then click the three dots at the top right and select the *Delete Account* option.
A window will open asking you to specify the reasons for the cancellation.
Clicking *Send Request* will initiate the verification process.
# Alexa
Expand interaction methods by configuring voice control.
{% hint style="info" %}
If you already have the *Alexa* app installed and are logged in with an *Amazon* account, you can click [here](https://skills-store.amazon.it/deeplink/dp/B08BXLPC1H?deviceType=app\&share\&refSuffix=ss_copy) to configure the *skill* directly.
{% endhint %}
{% embed url="" %}
Alexa Skill Link
{% endembed %}
Connecting Alexa to your system is quite simple and requires the following steps:
* Install the **Alexa** app
* Create an Amazon account or log in if you already have one
* In the Alexa app, go to **More** and access the **Skills and Games** section
* Search for the **OHMe - Domotica Chiarini** *skill*
* To configure the skill, you must log in using your home automation system credentials
Once these steps are completed, the device search will begin; this search takes place through the cloud, so you can configure it from any network.
The devices found will be added automatically.
{% hint style="info" %}
To simplify interaction, we recommend creating *Groups* and *Routines*.
{% endhint %}
{% embed url="" %}
{% hint style="warning" %}
If changes are made to Shortcuts or devices (e.g., new elements, name changes, etc.), you need to restart the search by saying: *Alexa, find devices*.
{% endhint %}
# Google Assistant
{% hint style="info" %}
If you already have the *Google Home* app installed and are logged in with a *Google* account, you can click [here](https://madeby.google.com/home-app/?deeplink=setup/ha_linking?agent_id=chiarini-home) to configure the *action* directly.
{% endhint %}
{% embed url="" %}
Google Assistant Action Link
{% endembed %}
Connecting Google Assistant to your system is quite simple and requires the following steps:
* Install the **Google Home** app
* Create a Google account or log in if you already have one
* In the Google Home app, go to **Settings** and access the **Google Assistant** section
* Click on **Manage all Assistant settings**, then click on **Home Control**
* Press the search button and type "Chiarini", then click on the *action* found
* To configure the action, you must log in using your home automation system credentials
Once these steps are completed, the device search will begin; this search takes place through the cloud, so you can configure it from any network.
The devices found will be added automatically.
{% hint style="info" %}
To simplify interaction, we recommend creating *Rooms* and *Routines*.
{% endhint %}
{% embed url="" %}
{% hint style="warning" %}
If changes are made to Shortcuts or devices (e.g., new elements, name changes, etc.), you need to restart the search by saying: *Hey Google, sync devices*.
{% endhint %}
# Siri
On iOS, you can create custom voice commands to execute *Shortcuts*. It's also possible to combine actions from different apps and services to create more complex routines.
To configure voice commands with *Siri*, there are two ways:
* From the [OHMe](https://apps.apple.com/it/app/ohme-domotica-chiarini/id1038355474) app
* From the [Shortcuts](https://apps.apple.com/it/app/comandi/id1462947752) app
### OHMe
To create voice commands from the *OHMe* app, access the *Shortcuts* page, then press the three dots in the top right corner and click on *Edit Configuration*.
Once configuration mode is enabled, you can click the three dots on the shortcut of interest, then select *Add to Siri*.
The opened screen allows you to modify the voice command to make it easier and more natural to pronounce.
{% hint style="info" %}
The generated commands will be usable on all devices (iPhone, iPad, Mac, HomePod, etc.) connected to the same Apple account.
{% endhint %}
### Shortcuts
You can also create voice commands from the *Shortcuts* app, and in this case, you can add additional actions to the command, even from different apps and services.
{% embed url="" %}
Shortcuts App Link
{% endembed %}
{% embed url="" %}
Example of a Shortcut
{% endembed %}
# Sonos
This short guide explains how to connect your Home Automation System to Sonos.
{% embed url="" %}
To connect Sonos, open the OHMe app settings, search for *Sonos*, and select the dedicated option.
{% hint style="info" %}
This guide shows the steps for iOS devices, but aside from a few visual differences, the procedure is similar on Android devices as well.
{% endhint %}
On the next screen, you can link your Sonos account. Click the *Connect Sonos* button to continue.
Clicking the button will open the following screen.
Click the *Continue* button, then enter your Sonos account credentials.
{% hint style="danger" %}
You need to create a Sonos account before continuing.
To register an account, go to [this page](https://login.sonos.com/signin/register).
{% endhint %}
After entering your credentials, press *Sign In* and accept the terms by selecting *I Consent*.
{% hint style="info" %}
By doing this, you authorize OHMe to control your Sonos System.
{% endhint %}
Once the connection is completed, the *Sonos* page should show the *Disconnect Sonos* button.
To access Sonos features, select the *Sonos* option from the main menu.
The available features are more limited than in the official app, but the connection allows you to create scenarios and automations that also include music.
Clicking a Group opens a dedicated page.
## Voice Synthesis
Among the integrated features, *Voice Synthesis* deserves a special mention.
To access this feature, click the three dots `⋯` on the *Sonos Devices* page, then select the *Voice Synthesis* option.
Thanks to voice synthesis integration, you can convert text messages into voice messages that will be played by selected *Sonos Players*.
This function can also be used in scenarios, for example to announce when someone arrives home.
You can also play voice messages in response to an event, for example:
* a door opening
* when the alarm is sounding
* when someone rings the doorbell
* when a button is pressed
* and many others
# SolarEdge
Connect your Solar Power System to the smart home system.
{% embed url="" %}
To connect your [SolarEdge](https://www.chiariniautomazioni.it/pv) Solar Power System to your Smart Home System, you need to contact your installer and request the activation of **API Access**.
This setting allows the generation of an alphanumeric key which, in combination with the **Site ID**, establishes the connection.
Once you have obtained this information, contact the technician who configured your Smart Home System to set up the connection.
{% hint style="info" %}
If there are any issues during the setup, ask your technician to contact us.
{% endhint %}
# Cloud Call
The Cloud Calls license allows you to receive automatic voice calls containing warning messages, ensuring that you don't miss important information. A simple Internet connection is required to activate the service.
{% hint style="success" %}
**Example with the Alarm System:** When suspicious activity is detected, Cloud Calls will send a call to notify the event.
{% endhint %}
{% hint style="info" %}
No on-site intervention is necessary; activating the new functionality only requires a simple remote update.
{% endhint %}
## Voice Messages
You can customize calls by setting up a voice message, thanks to the Text to Speech integration, which converts any text into speech.
The message can also include dynamic information, such as the value of a sensor:
> 💬 "The temperature in the fridge cell has exceeded 5°C!"
### Cost Savings and Sustainability
This service not only saves money but also eliminates the need for additional hardware installation, making it a more environmentally sustainable option as well as cost-effective.
## Pricing
{% hint style="success" %}
We offer the opportunity to try the service for free for 1 month.
{% endhint %}
After the trial period, you can choose to subscribe to a plan.
{% hint style="info" %}
We have very affordable rates, and it will take several years of subscription before reaching the cost of installing a traditional PBX system.
{% endhint %}
As the service is subscription-based, at the end of the contract period (minimum 1 year), you can cancel without any additional charges.
For more information, please contact us at .
# Monitoring
The **Cloud Monitoring** service allows you to check the real-time connection of your system, ensuring its proper functioning and continuity
In case of disconnection or malfunction, the service automatically sends notifications, emails, and calls if your system is disconnected, for example, due to a total blackout or internet connectivity issues.
{% hint style="info" %}
To receive the call, it is necessary to activate the Cloud Calls license.
{% endhint %}
## Pricing
{% hint style="warning" %}
This service requires the activation of a license.
{% endhint %}
The cost of the basic license is less than the price of a cup of coffee per month, but for more details on pricing, please contact us at .
# Experimental Functionality
When you see the icon of a flask, it indicates that the feature is experimental. These features are still under testing and might not work as expected, so use them with caution.
{% hint style="info" %}
If you encounter any issues or would like to share your experience, please don’t hesitate to write to our dedicated email address at . Your feedback is invaluable in helping us improve!
{% endhint %}
# Prima di Cominciare
Se siete alle prime armi, partite da questa guida passo-passo.
## Prima di cominciare
La prima cosa da fare è dotarsi di un tablet o smartphone **Android** ed installare l'app **Chiarini Home Automation Tech** presente sul [Google Play Store](https://play.google.com/store/apps/details?id=com.smartface.tech\&hl=it\&gl=US) (è possibile scaricare l'app anche sui Chromebook che includono *Google Play*).
> Il dispositivo Android deve essere aggiornato almeno alla versione **7.0** del sistema operativo.
Di seguito l'icona dell'app:
### Avete una licenza?
L'applicazione è disponibile gratuitamente ed installabile su un numero illimitato di dispositivi, ma richiede una licenza per poter essere usata.
È possibile acquistare una licenza contattando direttamente **Chiarini Automazioni srl** o dal sito [web](https://www.chiariniautomazioni.it/).
> Nel caso voleste testare il prodotto e quindi ottenere una licenza demo dovete scrivere all'indirizzo [**domotica@chiariniautomazioni.it**](mailto:domotica@chiariniautomazioni.it).
### Registrazione Tecnico
Aprire l'app e cliccare su **Registrati** (se siete già registrati cliccate su **Accedi**).
Compilate tutti i campi richiesti e completate la registrazione seguendo le istruzioni.
{% hint style="warning" %}
Affinché la registrazione risulti completa è necessario confermare l'indirizzo e-mail.
{% endhint %}
Una volta completata la registrazione potete accedere cliccando il pulsante **Accedi**.
### Dashboard Impianti
Una volta completato l'accesso verrà visualizzata la seguente schermata.
In alto a sinistra vengono visualizzate le informazioni dell'utente tecnico (azienda, nome e cognome, ecc.) e delle richieste di supporto effettuate dai clienti.
Per aggiungere un sistema cliccare il tasto **+**.
Una volta cliccato il tasto **+** verrà mostrato un *pop-up* con tre possibili opzioni:
1. *Crea nuovo sistema*: scegliere questa opzione se si desidera configurare un nuovo sistema (richiede una connessione ad Internet)
2. *Accedi ad un sistema esistente*: scegliere questa opzione se si desidera accedere ad un sistema esistente di cui si conoscono le credenziali (richiede una connessione ad Internet)
3. *Cerca schede nella Rete Locale*: scegliere questa opzione se si desidera procedere con la configurazione dei primi *input/output* delle schede appena collegate (non richiede una connessione Internet, ma le possibilità di configurazione sono limitate)
> Se si sceglie la terza opzione è bene tener presente che le schede non devono essere già state legate ad un Impianto.
#### Cercare Schede nella Rete Locale
Nel caso in cui non si disponga di una connessione ad Internet, ma si voglia comunque procedere con la configurazione degli *input/output* a bordo scheda, cliccare su *Cerca schede nella Rete Locale*.
> Le schede devono essere connesse alla medesima rete del dispositivo da cui si desidera effettuare la configurazione.
Nel caso in cui non sia ancora stata cablata la rete è possibile creare una connessione in loco connettendo la scheda (o le schede), che si desidera configurare, ad un *Router* che disponga anche di una connessione *Wi-Fi* (necessaria per permettere al dispositivo Android di collegarsi alla rete).
È bene ricordare che su qualsiasi Router la porta Ethernet di colore differente (nell'esempio sopra quella blu) va usata solo per collegare il cavo di rete relativo alla connessione Internet, mentre alle altre porte è possibile collegare degli *Switch Ethernet* o direttamente le schede.
> Se si desidera una connessione Internet, ma l'impianto non ne offre alcuna, consigliamo di usare (in fase di installazione) un Router Wi-Fi con slot SIM.
Una volta che con il vostro tablet/smartphone vi siete collegati alla rete Wi-Fi potete procedere alla ricerca delle schede cliccando il pulsante **+**, presente nella schermata principale, e quindi *Cerca schede nella Rete Locale*.
Si aprirà una nuova schermata con la lista delle schede trovate; nel caso in cui si desideri effettuare una nuova ricerca è sufficiente premere il tasto *Scopri* in basso a sinistra.
Se state usando un tablet, nella parte destra della pagina vedrete una rappresentazione grafica della scheda; per visualizzare tale schermata anche da smartphone, è necessario cliccare sulla scheda che si desidera modificare.
Nel caso in cui abbiate collegato molte schede potrebbe risultare complicato individuare quella che state configurando, potete quindi usare il tasto *Individua*; così facendo la scheda interessata inizierà a lampeggiare di vari colori.
In questa modalità la configurazione è limitata, in quanto le schede non sono state associate a nessun sistema/impianto e quindi non possono "parlare" tra di loro; potete in ogni caso definire input e output, e legarli tra loro solo nel caso in cui appartengano alla stessa scheda (pulsante e luce ad esempio).
#### Creare un Nuovo Sistema
Nel caso in caso in cui si desideri configurare un nuovo Sistema scegliere l'opzione *Crea nuovo sistema* e completare il form con le informazioni richieste.
> In questo caso le informazioni richieste sono quelle del cliente per cui si sta configurando l'Impianto; l'indirizzo e-mail deve essere valido e va confermato (tale indirizzo verrà usato nei casi di password dimenticata, ripristino password ecc.).
Una volta creato il Sistema (e confermato l'indirizzo e-mail del cliente) è possibile effettuare l'accesso cliccando nuovamente il pulsante **+**, quindi *Accedi a sistema esistente*.
#### Accedere ad un Sistema Esistente
Nel caso in cui si debba accedere ad un Sistema esistente, e si conoscano le credenziali, scegliere l'opzione *Accedi a sistema esistente*.
Quindi cliccare sul riquadro (o sul tasto *Connetti*) per effettuare la connessione al Sistema.
Nel caso in cui non siate in possesso dello *username* e della *password* del cliente è possibile accedere al Sistema in seguito ad una richiesta di supporto, effettuata dal proprietario dell'impianto dell'app utente.
> Per visualizzare le richieste di supporto attive cliccare su *Supporto* dalla schermata principale, quindi cliccare sulla richiesta per connettersi al Sistema.
Per inviare una richiesta dall'app utente è necessario accedere alle Impostazioni dell'app.
Quindi cliccare su *Richiesta di Supporto*.
> L'utente può definire il periodo di durata del supporto indicando la **Scadenza**.
#### Collegare le Schede ad un Sistema
Per prima cosa è necessario accedere al Sistema, in automatico verrà effettuata una ricerca delle schede nella rete locale (se si vuole ripetere l'operazione di ricerca è sufficiente cliccare il tasto *Scopri* in basso a sinistra).
Le schede già connesse presentano una nuvoletta verde con la spunta alla sinistra del nome, nel caso contrario verrà visualizzata una nuvoletta rossa. È stata scelta l'icona di una nuvola perché le schede, una volta connesse al sistema, saranno anche connesse al *Cloud*.
Prima di connettere la nuova scheda al Sistema dobbiamo procedere come segue:
1. Cliccare su di essa.
2. Cliccare sul pulsante con il pennino.
3. Scegliere l'opzione *Modifica Scheda.*
Così facendo si aprirà la pagina di configurazione della scheda; qui possiamo definire un nome, una descrizione (per definire ad esempio dove verrà collocata, o una sintesi di cosa ci andremo a collegare) e il ruolo.
Per il ruolo esistono tre opzioni:
1. **Master**: può essere definita una sola scheda *Master* per impianto, questa sarà la scheda che si collegherà direttamente al *Cloud* e che permetterà alle altre di comunicare.
2. **Slave**: tutte le schede non *Master* avranno questo ruolo.
3. **Auto**: in questo caso le schede definiranno il loro ruolo in modo automatico.
È fondamentale definire quale scheda sarà il *Master* dell'impianto, mentre le altre possono essere configurate con ruolo *Auto*, ma consigliamo di definirne solo alcune e di configurare le rimanenti con il ruolo di *Slave*.
Nel caso di guasto al *Master* le schede definite con ruolo *Auto* cambieranno in automatico il loro ruolo, così da garantire la presenza di almeno un *Master*. Il criterio di scelta del *Master* è in questo caso del tutto casuale, e avviene tra coloro che sono state configurate con ruolo *Auto*. In generale consigliamo di definire almeno una scheda con ruolo *Auto*, così da avere sempre almeno un *Master* di riserva. Non appena la scheda *Master* originale ritorna a funzionare il sostituto torna ad assumere il ruolo di *Slave*.
In sostanza il *Master* fa le veci del *Gateway* presente in altri prodotti. In genere il *Gateway* permette ai dispositivi intelligenti collegati ad un impianto di parlare tra di loro e di essere gestibili da un'interfaccia grafica (ad esempio un'app su tablet/smartphone) o attraverso il controllo vocale.
Nel sistema prodotto da *Chiarini Automazioni* le schede rappresentano i dispositivi intelligenti, ed ogni input/output ad esse collegato diventa a sua volta una periferica *smart* (non è quindi necessario acquistare costosi dispositivi intelligenti, ma qualsiasi dispositivo standard può diventarlo); la scheda *Master* è il *Gateway* che permette a tutte le schede (e quindi agli input/output collegati) di dialogare.
> A differenza di molti prodotti offerti dalla concorrenza, per avere un *Gateway* non è richiesto alcun dispositivo aggiuntivo (tutte le schede sono dotate dell'hardware che le permette di essere configurate come *Gateway*), ed in presenza di guasto un'altra scheda può intervenire in automatico per garantire la comunicazione con il sistema.
Esempi di configurazione:
| Numero Schede | Master | Slave | Auto |
| ------------- | ------ | ----- | ---- |
| 1 | 1 | 0 | 0 |
| 2 | 1 | 0 | 1 |
| 3 | 1 | 1 | 1 |
| 4 (o più) | 1 | 2 | 1 |
Riassumendo:
* Definire solo una scheda *Master*
* Consigliamo di definire almeno una scheda con ruolo *Auto*
* Definire le schede rimanenti come *Slave*
> Per scollegare una scheda dal Sistema è necessario accedere alla pagina *Modifica Scheda* e quindi cliccare il tasto *Ripristina alle impostazioni di fabbrica*.
#### Eliminazione di un Sistema
Si tratta di un'operazione delicata, soprattutto se il Sistema è in funzione già da tempo ed include quindi delle schede e degli utenti utilizzatori. Per questo motivo la cancellazione dei dati è possibile soltanto contattandoci direttamente.
Nella pagina relativa alle impostazioni del sistema è presente la sezione *Eliminazione Sistema*. Cliccando il tasto *Invia Richiesta* vi sarà richiesto un recapito telefonico ed una motivazione, quindi verrà inviata una richiesta di cancellazione, a cui seguirà una telefonata da parte nostra, per accertarci che la richiesta sia stata fatta coscienziosamente.
#### Alcune Considerazioni
Nel caso in cui sia già chiara la distribuzione degli input/output è possibile procedere con la configurazione del Sistema prima che le schede siano installate nell'edificio di destinazione.
Per la creazione del Sistema via app è sufficiente una connessione Internet, mentre per configurare le schede è necessario fornire ad esse alimentazione e collegarle ad una rete mediante cavo ethernet.
# Collegamenti Base
Questa guida ti permette di comprendere la configurazione e il cablaggio dei collegamenti più comuni.
## Introduzione
Il seguente documento permette di comprendere le modalità di collegamento e configurazione degli input ed output più comuni.
Il modello di scheda che verrà preso in esame è *Uniboard* (codice CHIUNIB MASTER) prodotto da Chiarini Automazioni srl.
In generale non ci sono limiti ai dispositivi collegabili, ma nella guida verranno elencati quelli di più comune installazione.
La scheda è dotata di due entità computazionali che la rendono affidabile, ma soprattutto le permettono di garantire l'esecuzione di alcune delle funzioni principali anche in seguito al guasto o a problemi sulla *SOM*, che rappresenta il vero cervello della scheda e le permette di essere "intelligente".
Essendo ogni scheda dotata di una SOM e di una presa Ethernet, a differenza di molti sistemi offerti dalla concorrenza, non è richiesta l'installazione di alcun *Gateway* per permettere l'accesso da Remoto.
Gli output ed input sono fisicamente collegati al microcontrollore (indicato con *MCU* nella figura che segue) che comunica con la *SOM* attraverso un *BUS seriale*.
Rispetto alla domotica tradizionale l'accensione/spegnimento di una luce da pulsante (nel caso in cui input ed output siano collegati alla medesima scheda) non dipende da alcun *BUS*, ma viene interamente gestita dal microcontrollore, quindi guasti sul *BUS* non ne compromettono il funzionamento.
## Chiarini Uniboard SOM-9R
**Tensione di alimentazione:** tra 11 e 13.8V.
**Ingombro:** 9 moduli DIN.
### Morsetti `A`-`I`
La scheda presenta 9 uscite Relè (da **`A`** a **`I`**), di cui le prime 7 (da **`A`** a **`G`**) all’occorrenza possono essere tradotte in uscite analogiche 0-10V (vedi in alto a sinistra nello schema).
Ad ogni relè è associato un led di stato e un selettore per forzarne l’attivazione.
È inoltre possibile impostare i morsetti da **`A`** ad **`I`** come ingressi digitali.
> **Nota importante:** i morsetti indicati con le lettere da **`A`** ad **`I`** rappresentano il medesimo pin del microcontrollore (sono *morsetti multifunzione*), pertanto se si decide ad esempio di cablare il morsetto **`A`** come uscita relè, non sarà possibile sfruttarlo come ingresso digitale (Digital IN) o uscita analogica (Analog OUT).
I selettori da **`R1`** a **`R9`** servono per forzare manualmente le uscite relè, utili in caso di guasto o durante la prima fase di installazione, quando la scheda non è ancora stata configurata dall'applicazione.
### Morsetti `I1`-`I9` e `DI`
I morsetti da **`I1`** a **`I9`** sono configurabili sia come ingressi analogici che digitali (la configurazione va fatta dall’applicazione dedicata).
È possibile collegare sensori di temperatura, umidità, di luce, allarme, e in generale qualsiasi sensore che fornisca un segnale elettrico; per i sensori non direttamente supportati è prevista la possibilità di definire, dall’applicazione, la formula matematica che descrive la curva (nel caso in cui non venga fornita il sensore restituirà un valore tra 0 e 1023, che corrisponde all’intervallo 0-5V).
Tali morsetti supportano anche semplici ingressi del tipo ON/OFF (pulsanti, micro, ecc.).
Il morsetto **`DI`** è invece un ingresso esclusivamente digitale.
La scheda dispone di un’uscita 5V, utile ad esempio per sonde che richiedono tale tensione in ingresso.
### Morsetti speciali
I morsetti **`QC`** e **`QD`** permettono il collegamento di periferiche che sfruttano il *bus I2C*, ma non sono al momento supportati e non vanno quindi usati.
I morsetti **`L`** e **`R`** rappresentano le uscite audio per il collegamento di diffusori; al momento il software non integra la riproduzione sonora, ma è possibile un'integrazione su richiesta.
### Interfaccia di comunicazione
Con **`ETH`** è indicata la porta Ethernet che permette alla scheda di essere collegata ad una rete e di comunicare con altre schede o dispositivi che supportano il protocollo IP.
Per poter effettuare la configurazione della scheda dall’app dedicata è necessario collegarla ad una rete, ed è consigliato isolare la rete del Sistema Domotico da quella dedicata ad altri servizi.
### Riferimento Negativo
La scheda lavora con riferimento a negativo, quindi gli input vanno sempre collegati al **`-`**.
> Questa scelta favorisce l'assenza di disturbi ed evita di portare tensione sugli ingressi.
L'esempio sottostante mostra il collegamento di un pulsante; come si evince dall'immagine il pulsante va collegato all'ingresso della scheda (**`I1`** nell'esempio) e al **`-`**.
### Dip Switch
Esistono due file di *dip switch* sotto il coperchio della scheda:
1. **RELAY:** questi *dip* permettono di attivare i relè dei morsetti **`A`**-**`I`**; vanno usati solo i *dip* dal numero 1 al 9 e in posizione \_ON\_attivano il relè corrispondente (il numero 10 non va usato e va lasciato su *OFF*).
2. **10K:** questi *dip* permettono di attivare la resistenza da *10KOhm* dei morsetti **`I1`**-**`I9`**; vanno usati solo i *dip* dal numero 1 al 9 e in posizione *ON* attivano la resistenza, mentre il 10 è fondamentale che sia lasciato su *OFF*, altrimenti la scheda non si avvia.
Per accedere ai *dip* è necessario:
1. Rimuovere il coperchio trasparente;
2. Rimuovere il modulo con i selettori **`R1`**-**`R9`** e il pulsante **`RESET`** facendo leva con un cacciavite;
3. Scorrere la mascherina con il logo sollevando l'estremità destra.
{% embed url="" %}
Per l'assemblaggio dovete:
1. Reinserire la mascherina dall'alto, premendo finché non risulta ben incastrata;
2. Collegare il modulo con i selettori **`R1`**-**`R9`** e il pulsante **`RESET`**;
3. Riagganciare il coperchio trasparente.
## Funzioni base interfaccia
In questa sezione elencheremo alcuni dei pulsanti e icone di cui è bene conoscere la funzione e il significato.
Il pulsante **blu** con il dischetto permette di salvare la configurazione della scheda; una volta confermato il salvataggio, il led verde della scheda comincerà a lampeggiare con maggiore frequenza, e tornerà a lampeggiare normalmente una volta terminato tale processo. Quando, in questa guida, si richiederà di salvare la configurazione della scheda, andrà premuto questo pulsante.
Il pulsante **rosso** permette di riavviare la scheda.
Il pulsante **giallo** è rivolto alla ricerca di aggiornamenti.
Il tasto alla destra del nome presenta l'icona di un **cestino** nel caso in cui abbiate già configurato degli elementi, permettendovi di eliminarli tutti con un singolo *tap*. Nel caso in cui non ci sia alcun elemento configurato il pulsante (che avrà l'icona di un **razzo**) vi permetterà di accelerare la configurazione, sfruttando dei modelli predefiniti (vedi immagine sotto).
## Collegamenti frequenti
In questa sezione andremo ad elencare alcuni dei collegamenti più frequenti, mostrando sia la modalità di cablaggio che i passaggi per procedere con la configurazione dall'app.
Alcuni tipologie di input e output richiedono di attivare/disattivare i *dip RELAY* o i *dip 10K*. Tali *dip swicth* si trovano sotto il coperchio della scheda, rimovibile aiutandosi con un cacciavite. La prima fila di *dip* a partire da sinistra si riferisce all'abilitazione dei relè (disattivi di default), la seconda fila permette invece di attivare la resistenza da 10KOhm (attivi di default, ad esclusione del *10*). Il decimo *dip* di entrambe le file non va usato e deve rimanere su *OFF* affinché la scheda si avvii correttamente.
### Luce e Pulsante
Di seguito un esempio di collegamento di un pulsante e di una luce (il collegamento vale per qualsiasi output che richieda un relé).
> Affinché la lampadina funzioni è necessario abilitare il relè; i *dip switch* per l'abilitazione dei relè sono sotto il coperchio di plastica che presenta il logo.
Una volta rimosso il coperchio è possibile abilitare il relé impostando il *dip switch* della fila *RELAY* su *ON*; il relè 1 corrisponde al \_dip\_1 e così via.
Il pulsante richiede invece che il *dip* della fila *10K* sia attivo (di default sono tutti su *ON*); tale impostazione permette di attivare la resistenza di 10KOhm necessaria ad input digitali (es. pulsanti) e molti sensori (es. temperatura e crepuscolare).
Una volta terminato il cablaggio e abilitati i *dip* è ora di procedere con la configurazione dall'app dedicata:
1. Accedere al Sistema (creato in precedenza) o selezionare *Cerca schede nella rete locale*.
2. Cliccare sulla scheda desiderata (cliccate su *Individua Scheda* se non sapete di quale si tratta).
3. Cliccare sul morsetto che desiderate configurare (nell'esempio abbiamo scelto il relè **`A`**).
4. Scegliere *Luce*.
Procediamo quindi definendo un nome e premiamo il tasto con la spunta per confermare.
Ci sono alcune impostazioni extra e tra queste menzioniamo:
* *Non interagibile da interfaccia*: permette di rendere l'output non interagibile dall'app utente, utile quando configurate carichi di cui volete mostrare lo stato, ma che l'utente non può attivare (es. elettrovalvole, comandi finestre, valvole irrigazione, ecc.).
* *Impostazioni Timer*: qui potete definire il tempo massimo di attivazione dell'output, dopo il quale viene automaticamente spento; utile per luci di passaggio e comando aperture (cancello, porta, cancelletto, ecc.).
Ora premete il pulsante con l'icona di un dischetto, quindi sul tasto *Conferma* per salvare la configurazione; il led verde della scheda lampeggerà più rapidamente e tornerà a lampeggiare normalmente una volta completato il salvataggio.
Cliccate quindi su *Lista Elementi* per accedere alla pagina con tutti gli elementi configurati sulla scheda. Lì troverete la luce appena configurata. Cliccate sul pulsante alla destra del nome (dovrebbe diventare verde come in figura) e dopo un piccolo istante il relè dovrebbe attivarsi (sulla scheda il led rosso corrispondente dovrebbe risultare acceso); premete nuovamente per spegnere.
Procediamo ora con la configurazione del pulsante; premere sul morsetto che avete scelto (nell'esempio è **`I1`**) e scegliere *Input*.
Quindi scorrere la pagina fino a *Output collegati* e spuntare l'output configurato in precedenza; in automatico al pulsante verrà dato un nome di default (che potete cambiare). È possibile selezionare quanti output si desiderano, ma sono proposti solo quelli configurati sulla scheda. Un input può comandare output remoti (collegati ad altre schede), ma in quel caso non è possibile la dimmerazione continua per output analogici (è permessa l'accensione/spegnimento o il set di un valore preciso di luminosità); quindi se desiderate una gestione completa di luci dotate di dimmer, output ed input devono essere collegati alla stessa scheda.
> Nel caso in cui l'input debba gestire un output remoto (collegato ad un'altra scheda) dovete scorrere la pagina sino a *Logica Input* e definire cosa volete che succeda quando l'input è ad *ON* e ad *OFF*; lì potete definire una lista di operazioni di vario genere (es. spegnere tutte le luci del sistema e attivare l'allarme).
L'input presenta molte altre opzioni tra cui citiamo:
* *Campanello*: questa funzione permette all'input di avviare la suoneria dei dispositivi (in genere tablet a muro) configurati come *Dispositivi Locali* nell'app utente.
* *Imposta Notifica*: qui potete configurare l'invio di un messaggio in base allo stato dell'input.
Una volta salvata la configurazione dell'input e quella della scheda, ritornate alla pagina con la lista degli elementi. Come vedete dalla figura in basso l'input mostra ben evidenziato lo stato corrente; provate quindi a premere il pulsante, lo stato dovrebbe cambiare, così come quello dell'output collegato.
#### Dimmer
Nel caso in cui si voglia collegare un output analogico (es. striscia led dimmerabile) il collegamento va effettuato come segue.
Il *dip*, che nell'esempio precedente avevamo impostato su *ON*, andrà invece lasciato su *OFF*.
> È molto importante che il dip sia nella posizione giusta, altrimenti si rischia di danneggiare il relè.
Lato app va semplicemente scelta la tipologia *Output Analogico*; una volta confermata la configurazione il morsetto configurato si colorerà di arancione, mentre quello del relè corrispondente sarà disattivo.
> Ricordiamo che i morsetti da **`A`** a **`G`** possono essere configurati sia come output analogici che digitali (relè), ma una modalità esclude l'altra.
Salvate la configurazione, quindi nella pagina *Lista Elementi* troverete il nuovo output; lo *slider* permette di impostare il valore percentuale del dimmer. L'eventuale pulsante collegato si comporterà come ci si aspetta, ovvero permetterà di regolare il valore tenendolo premuto.
### Sensori
In questa sezione verrà mostrato il collegamento di alcuni dei sensori più comuni e spiegheremo come configurarli dall'app.
In generale non ci sono grandi vincoli sulla tipologia di sensori che potete collegare, in quanto è sufficiente che siano analogici e che, nel caso in cui richiedano alimentazione, funzionino a 5V.
Supportiamo direttamente alcune tipologie di sensore, ma permettiamo di definire una formula e l'unità di misura, così da poter collegare anche dispositivi non integrati ufficialmente.
Di seguito le unità di misura di default per le tipologie di sensore principali.
| Tipo di Sensore | Unità di Misura |
| -------------------- | ----------------------------------- |
| Temperatura | °C |
| Umidità | % |
| Sensore di luce | % |
| Sensore di movimento | *Valore espresso in count* (0-1023) |
Se non si desidera usare unità di misura differenti, il campo *Unità di Misura* può essere lasciato vuoto.
> Se si ha bisogno della temperatura in *Fahrenheit* è sufficiente indicare *°F* come unità di misura (la conversione viene calcolata automaticamente).
Nel caso in cui i valori restituiti da un sensore non risultino precisi, rispetto ad una sonda di riferimento, potete definire un valore di taratura (sia negativo che positivo); tale valore può essere usato solo nel caso in cui l'errore sia più o meno costante al variare del valore misurato.
#### Sensore di Temperatura
Di seguito lo schema di collegamento di un sensore di temperatura *NTC 10KOhm*.
Come nel caso del pulsante, anche per questo tipo di sonda di temperatura è necessario impostare il *dip 10K* corrispondente su *ON*.
> Ci sono sonde di temperature più complesse che restituiscono già un valore in tensione, in quel caso non è necessario attivare il *dip 10K*.
Nel caso si scelga di adottare una sonda *NTC 10KOhm* la configurazione risulta molto semplice. È sufficiente cliccare sul morsetto corrispondente (nel nostro caso **`I2`**), scegliere *Sensore* e quindi selezionare *Sensore di Temperatura* come tipologia.
È possibile usare qualsiasi tipo di termistore, o sonda di temperatura 0-5V, ma in quel caso va definita la formula che permette di calcolarne il valore.
> Se si collega un termistore di diversa resistenza (es. *NTC 100KOhm*) il *dip 10K* va impostato su *OFF* e va collegata una resistenza da 100KOhm. Va inoltre definita la formula, in quanto il sensore di temperatura di default (e per cui è automaticamente definita la formula) è l'*NTC 10KOhm*.
Nel caso in cui si desideri salvare i dati del sensore è necessario attivare l'opzione dedicata. Dall'app utente sarà poi possibile visualizzare grafici giornalieri, settimanali, mensili e annuali; inoltre, i dati sono esportabili in formato *tsv* e quindi importabili in *Microsoft Excel* o software analoghi. Sul cloud viene salvato un dato contenente il valor medio, il minimo e il massimo di ogni fascia oraria (la media viene calcolata raccogliendo un valore ogni minuto); vengono registrati un massimo di 10 mila dati per sensore (raggiunto il limite il dato più vecchio viene eliminato per lasciar posto a quello più recente), nel caso si desiderasse uno storico più ampio è necessario contattarci.
In genere i sensori di temperatura vengono collegati per permettere la gestione di riscaldamento/raffrescamento, per fare ciò è necessario configurare un *Termostato*.
> Il termostato va sempre configurato sulla scheda a cui è stato collegato il sensore.
L'app permette di creare un termostato (e di modificarlo) direttamente dalla pagina di configurazione del sensore; scorrendo totalmente la pagina troverete il tasto *Crea Termostato* (o *Modifica Termostato* nel caso in cui ne abbiate già creato uno).
Nel sistema un termostato viene inteso come una *Gestione Soglia*, ovvero un elemento in grado di gestire output ed operazioni di vario genere sulla base del controllo di una soglia, e della modalità di funzionamento scelta. Quindi in generale ad un oggetto *Gestione Soglia* può essere associato qualsiasi tipo di sensore.
Nel caso di un termostato la soglia viene definita sulla base del set di temperatura, e le modalità di funzionamento principali sono *Caldo* e *Freddo* (ma ce ne sono altre).
#### Sensore di Umidità
Di seguito lo schema di collegamento di un sensore di umidità che integra un *Honeywell HIH-4030*. A differenza del sensore di temperatura non dobbiamo attivare il *dip 10K*, ma abbiamo da effettuare tre collegamenti:
1. Ingresso (es. **`I1`**)
2. Negativo
3. Alimentazione 5V
Ci sono varie tipologie di sensori di umidità, ma consigliamo di scegliere sensori che presentano una curva approssimativamente lineare e con poca dipendenza dalla temperatura. Se optate per un sensore che integra un *Honeywell HIH-4030* non avete bisogno di definire alcuna formula.
Per configurare un umidostato i passaggi sono analoghi a quelli svolti per il termostato
#### Sensore di Luce
Se si tratta di una fotoresistenza da 10KOhm il collegamento è analogo a quello del sensore di temperatura, quindi va attivato il *dip 10K* corrispondente; se il valore di resistenza è differente va collegata una resistenza adeguata e il *dip 10K* va tenuto disattivato.
È possibile sfruttare il sensore di luce per configurare un Crepuscolare, seguendo i medesimi passaggi descritti per il Termostato; il Crepuscolare permette ad esempio di gestire l'accensione/spegnimento delle luci in base alla luminosità ambientale rilevata.
L'intensità di luce viene espressa come valore percentuale; il valore espresso in *count* (0-1023) è massimo se c'è completamente buio.
#### Sensore Personalizzato
Come sottolineato all'inizio del capitolo non ci sono vincoli al tipo di sensore che potete collegare, se non il fatto che sia analogico e che, nel caso in cui richieda di essere alimentato, funzioni a 5V.
Per ottenere un valore adeguato potete definire una formula e la relativa unità di misura (vedi [*Definire una Formula*](#definire-una-formula)).
Anche un sensore personalizzato può essere legato ad una *Gestione Soglia*.
#### Gestione Soglia
Un oggetto *Gestione Soglia* va in genere legato ad un sensore (ma non necessariamente) e permette di attivare/disattivare output (ma anche cicli, scenari, ecc.) sulla base di un valore di set (ovvero la nostra soglia) e della modalità di funzionamento scelta.
Ci sono tre modalità principali, che assumono dei nomi differenti in base alla tipologia del sensore scelto, ma in generale sono così definite:
1. **Sotto-Soglia:** quando si attiva questa modalità l'output (nel caso del termostato è quello di *Riscaldamento*) verrà attivato quando il sensore misura un valore al di sotto di quello di set, e verrà disattivato nel caso contrario.
2. **Sopra-Soglia:** quando si attiva questa modalità l'output (nel caso del termostato è quello di *Raffreddamento*) verrà attivato quando il sensore misura un valore al di sopra di quello di set, e verrà disattivato nel caso contrario.
3. **Entrambi:** in questa modalità sono attive entrambe le gestioni spiegate in precedenza.
> Alla *Gestione Soglia* è possibile legare sensori di qualsiasi tipo e come output possono essere comandati luci, carichi, finestre, cicli e scenari (questi ultimi due possono includere a loro volta operazioni di vario genere, per comprendere le infinite possibilità consigliamo di sperimentare).
Nel caso specifico di Termostato e Umidostato gli output che vengono attivati/disattivati dalla *Gestione Soglia* contribuiscono in genere ad aumentare/diminuire il valore misurato dal sensore, ma non deve essere necessariamente così.
Il Crepuscolare, ad esempio, permette l'attivazione di luci quando il sensore di luce rileva buio; in questo caso l'accensione degli output non deve aumentare il livello di luce misurato dal sensore, altrimenti questi si spegnerebbero immediatamente. Il sensore va infatti collocato lontano dalle luci comandate, in quanto deve rilevare solo la luce naturale.
> Possono essere scelti più output, quindi un *Crepuscolare* può accendere/spegnere più luci contemporaneamente.
Cliccando sul pulsante *Impostazioni avanzate* è possibile personalizzare ulteriormente la *Gestione Soglia*, ed in particolare potete definire:
* **Attivo all'avvio della scheda:** qui potete scegliere se desiderate che sia attivo di default nel caso di riavvio della scheda.
* **Valore minimo/massimo di set:** utile per limitare l'utente a scegliere valori consoni al tipo di sensore e di collocazione (es. nella stanza di un hotel è bene non permettere set troppo alti/bassi).
* **Valore Delta di Set:** disponibile dalla versione `23.07.04`, permette di impostare uno scostamento rispetto al set, in modo che la gestione soglia non si fermi al raggiungimento del set, ma solo una volta superato il `set +/- delta` (a seconda della modalità). Se ad esempio la gestione soglia corrisponde ad un termostato, e abbiamo delta pari a 0.5, un set di 20 gradi e modalità caldo, il termostato si fermerà superati i 20.5 gradi (ovvero `20°C + 0.5°C`).
* **Differenziale:** il software sceglie per voi il valore più opportuno in base al tipo di sensore scelto, ma potete cambiarlo a vostro piacimento. Il differenziale permette di evitare continui cambi di stato negli output quando il sensore misura un valore in prossimità del set; nel caso ad esempio di un termostato, con un differenziale pari a 0.5°C, il carico di riscaldamento si disattiva raggiunto un valore superiore al set (es. 20°C) e si riattiva ad una temperatura pari al set meno il differenziale (quindi a 19.5°C, ovvero `20°C - 0.5°C`).
* **Valore set di default:** valore di set in caso di riavvio della scheda.
* **Valore di sicurezza:** utile nel caso del termostato, questo valore è il set per la modalità antigelo.
* **Tipologia di Gestione Soglia:** scegliete *continuo* se desiderate che gli output collegati vengano mantenuti nello stato previsto durante il funzionamento (consigliamo questa opzione per termostato e umidostato), mentre optate per *impulsivo* se preferite che gli output vengano comandati solo al superamento/raggiungimento della soglia (consigliato per crepuscolare se desiderate che le luci siano comandabili anche manualmente). L'opzione *analogico* permette di comandare output analogici o con set percentuali (come luci dimmerabili, valvole proporzionali, finestre e aperture in genere); in questo caso potete definire una formula che permette di impostare l'output ad una percentuale che dipende dal valore misurato dal sensore `{value}` e da quello di set `{set}`, ad esempio `20 * ({set} - {value})`.
* **Modalità disponibili:** qui potete scegliere le modalità che volete rendere disponibili all'utente, ovviamente anche sulla base della gestione che avete scelto (quindi suggeriamo di non scegliere ad esempio *Sopra-Soglia*, se il vostro termostato gestisce solo il riscaldamento).
* **Modalità predefinita:** qui potete scegliere la modalità di default in caso di riavvio della scheda.
#### Definire una Formula
Se si scelgono altre tipologie di sonda (da quelle ufficialmente supportate), è necessario definire la formula che permette di ottenere il valore corretto (in genere viene fornita dal produttore).
Nel caso in cui la formula richiami il valore di tensione (0-5V) è sufficiente scrivere `{volt}` (vanno incluse anche le parentesi graffe), nel caso si debba utilizzare il *count* (è un parametro che esprime la tensione 0-5V con un valore da 0 a 1023) va usata la variabile `{count}`.
Esempio di formula: `(5 - {volt}) * 10`
Qui una lista delle funzioni matematiche più comuni:
* **Somma:** si usa il simbolo `+`.
* **Differenza:** si usa il simbolo `-`.
* **Prodotto:** si usa il simbolo `*`.
* **Rapporto:** si usa il simbolo `/`.
* **Logaritmo:** per calcolare il logaritmo in base `e` di `x` si usa `math.log(x)`, nel caso di logaritmo in base `y` di `x` si usa `math.log(x, y)`.
* **Potenza:** per calcolare il valore di `e` elevato alla `x` si usa `math.exp(x)`, nel caso di `x` elevato alla `y` si deve usare `math.pow(x, y)`.
È possibile richiamare nella formula il valore di altri sensori (ma non solo); in questo caso ogni parametro va definito incluso nelle parentesi graffe, ad esempio se vogliamo calcolare la media tra due temperature: `({T1} + {T2}) / 2`
Una volta definita la formula vanno definiti i parametri, cliccando sul tasto **Parametri Formula**.
L'app vi permette di salvare le formule, così da per poterle riutilizzare (vedi immagine in basso).
Quindi se dovete configurare altri sensori di quel tipo potete premere il pulsante *Scegli Formula* e scegliere una di quelle salvate.
### Aperture (es. Finestre)
Per apertura si intende qualsiasi dispositivo che:
* può essere aperto e chiuso;
* può essere impostato ad una percentuale di apertura precisa;
* è dotato di finecorsa per bloccare in sicurezza la movimentazione.
Un cancello o una basculante, dotati in genere di una scheda di controllo, non vanno configurati come aperture, ma è possibile comandarne l'apertura/chiusura e lo stop sfruttando gli ingressi dedicati.
> Nel caso in cui l'apertura sia comandata da pulsanti/input fisici è importante che questi vengano cablati sulla medesima scheda e che l'apertura sia configurata su di essa, così da evitare possibili ritardi. Suggeriamo inoltre che gli output vengano collegati alla stessa scheda su cui si trovano gli input.
> Prima di configurare un'apertura è consigliato configurare gli input e gli output.
Per configurare un'apertura cliccare sulla scheda a cui verranno collegati gli output e gli eventuali pulsanti, andare sulla pagina *Lista Elementi* e cliccare sul pulsante in basso a destra con i tre puntini, quindi cliccare su *Aggiungi* **+**.
Tapparelle e Imposte motorizzate possono essere facilmente integrate nel sistema, evitando l'uso di costose schede di controllo, abbiamo infatti previsto due tipi di gestione che si adattano bene a questi due casi:
* **Tapparella:** presenta un output per l'apertura ed uno per la chiusura; il cablaggio e la configurazione dei pulsanti è opzionale.
* **Imposte:** rispetto alla tapparella va definito un output di apertura/chiusura per ciascuna imposta; anche in questo caso i pulsanti sono opzionali.
Per poter impostare con una discreta precisione la percentuale di apertura è necessario definire tre tempi (in secondi):
1. Tempo di *apertura*
2. Tempo di *chiusura*
3. Tempo di *sicurezza*
Il tempo di sicurezza permette di prolungare il tempo di apertura/chiusura totale senza influire sul valore percentuale indicato nell'interfaccia, così da assicurarsi ulteriormente che l'apertura sia completamente aperta/chiusa; in genere è sufficiente impostare 2/3 secondi.
Nel caso in cui si scelgano le *Imposte* vanno definiti altri due tempi per ciascuna imposta:
1. Ritardo di *apertura*
2. Ritardo di *chiusura*
Le imposte richiedono che, durante l'apertura/chiusura, una delle due si muova per prima; i due ritardi permettono quindi di evitare che le imposte si incrocino.
### Serrature
Le classiche serrature elettriche di porte e cancelletti vanno collegate alle uscite relè della scheda (quindi il *dip RELAY* corrispondente va attivato), ricordandosi di definire un timer (in genere è sufficiente 1 secondo, ma spesso anche 0.5 secondi).
Il timer evita che l'output rimanga attivo per un tempo superiore a quello indicato.
Per permettere un'interazione più intuitiva consigliamo di configurare delle *Scorciatoie* dedicate e di assegnare un'icona adeguata nelle impostazioni dell'interfaccia.
### Input ON/OFF
Esistono molteplici tipologie di input digitali, ma in generale per tutti vale lo schema di collegamento del pulsante (mostrato in precedenza) e che prevede un collegamento a due fili, il comune negativo (che va collegato ad uno dei morsetti con il simbolo **`-`**) e l'output dell'ingresso, che va collegato ad uno dei morsetti abilitati alla lettura:
* morsetti da **`I1`** a **`I9`** (che sono input sia analogici che digitali);
* morsetto **`DI`** che è esclusivamente un input digitale;
* morsetti da **`A`** a **`I`**, nel caso in cui questi si vogliano configurare come input digitali; ricordiamo che questi sono morsetti multifunzione (vedi capitolo dedicato).
> Per i morsetti da **`I1`** a **`I9`** è richiesta l'attivazione del *dip 10K*. Per gli altri input non è necessaria, in quanto la resistenza 10KOhm è già integrata.
### Sistema di Allarme
Il sistema da noi sviluppato non richiede centraline d'allarme, in quanto la scheda è da sola in grado di offrire le medesime funzioni. Potete quindi collegare i sensori di allarme (di movimento, perimetrali, di contatto, ecc.) e la sirena direttamente alle schede.
Non ci sono vincoli sui collegamenti, i sensori possono essere cablati su schede differenti, e per legarli allo stesso sistema di allarme dovete semplicemente definire i *Settori*.
Di seguito gli step per una corretta e rapida configurazione:
1. Cablare e configurare il *Carico di Allarme* (la sirena in genere);
2. Cablare e configurare i *Sensori di Allarme*;
3. Accertatevi (dall'app di configurazione) di aver legato i sensori al carico (e viceversa);
4. Configurare i *Settori*;
5. Configurare le *Password*.
#### Carico di Allarme
In genere, come carico di allarme, si collega una sirena in NC (normalmente chiuso), ma potete collegare l'output che desiderate (una luce ad esempio).
Per configurare un carico di allarme cliccate sul morsetto desiderato e scegliete *Carico di Allarme*.
Per motivi di sicurezza l'output è in genere *normalmente chiuso*, ma nel caso vogliate configurare un output *NO*, disattivate l'opzione dedicata.
Trattandosi in genere di una sirena, che deve suonare in caso di allarme o manomissione, è possibile definire il *Ciclo di Allarme*, definendo il tempo per cui è attiva (in cui suona), la durata della pausa, e il numero di cicli da effettuare.
Affinché il carico funzioni è necessario legarlo ai sensori di allarme collegati al sistema, e ciò è possibile nella sezione *Sensori di Allarme Connessi*. In genere tale impostazione avviene in automatico, ma è buona pratica verificare la corretta impostazione una volta configurati tutti i sensori di allarme.
#### Sensore di Allarme
Nel caso in cui i sensori di allarme siano analogici il collegamento va effettuato come nello schema seguente.
Al fine di rilevare gli stati di *allarme* e di *manomissione* (o *tamper*) è necessario collegare due resistenze (noi supportiamo direttamente la coppia *21KOhm-5KOhm*). È possibile usare resistenze diverse, ma in quel caso è necessario effettuare un'operazione di taratura e indicare i nuovi valori nel software di configurazione.
Anche per il sensore di allarme va attivato il *dip 10K*.
Per configurare un sensore di allarme è necessario cliccare sul morsetto scelto (nell'esempio abbiamo scelto **`I3`**) e scegliere *Sensore di Allarme*.
Se avete cablato un sensore analogico, usando le resistenze suggerite, non dovete fare molto, in quanto la maggior parte delle impostazioni vengono gestite in automatico. Se si tratta del sensore che fa da tamper alla sirena, dovete attivare l'impostazione specifica.
Nel sistema d'allarme concepito da noi ogni sensore è come fosse un sistema a sé, capace autonomamente di avvisare l'utente se viene rilevato un malintenzionato o una manomissione; ogni sensore, se attivo, invia una notifica se rileva allarme o tamper, e fa suonare la sirena (che in generale abbiamo definito carico di allarme) se questa è stata configurata e legata al sensore. Non sono quindi necessarie centraline di allarme e dispositivi ulteriori.
Se è presente una sirena, affinché questa suoni, è necessario legarla al sensore. Scorrendo fino alla voce *Carico di Allarme connesso* è possibile, cliccando su *Imposta Carico*, definire la sirena. Tale operazione avviene in genere automaticamente, ma se riscontrate problemi verificate che tale impostazione sia corretta.
Per tutti i sensori è possibile definire il *Tempo di Attivazione* e quello di *Disattivazione*, che permettono di ritardare l'avviso di allarme o manomissione (per permette ad esempio la disattivazione dell'allarme dal tablet all'ingresso). In quel frangente di tempo i sensori sono comunque attivi, ma viene ritardato l'invio delle notifiche e il suono della sirena, nel caso in cui il sistema di allarme rimanga attivo dopo quel tempo.
> Una volta cablati e configurati tutti i sensori di allarme, vi consigliamo di verificare, sulla pagina di configurazione del carico di allarme, che tutti i sensori siano correttamente connessi ad esso. Fatto ciò, salvate la configurazione della scheda su cui si trova il carico di allarme.
#### Settori
La configurazione dei settori di allarme è necessaria per permettere l'interazione con i sensori e i carichi di allarme dall'app utente; non influisce sul funzionamento, ma solo sull'interfaccia e sull'accesso ai dispositivi. Per procedere alla creazione di un settore cliccare su *Settori* nella scheda dedicata alla configurazione del Sistema di Allarme, quindi cliccare sul tasto **+** per aggiungerne uno nuovo.
Ad ogni settore potete associare i sensori e i carichi di allarme che desiderate. In presenza di pochi sensori vi consigliamo di creare un solo settore; in genere il carico di allarme è unico per impianto, associatelo quindi al settore principale. Premete \_Salva\_per confermare la configurazione.
#### Password
L'accesso ai settori dall'app utente non è possibile senza la configurazione delle password. Cliccate sul tasto *Password* nella scheda dedicata alla configurazione del Sistema di Allarme, quindi sul tasto **+**.
Spesso si desidera definire molteplici password, soprattutto se si vuole limitare l'accesso ad alcuni settori, quindi potete definire un nome una descrizione per aiutarvi a comprendere la sua natura. Cliccando su *Configura i Settori* potete definire quali settori verranno visualizzati all'inserimento della password.
Per gestire l'allarme dall'app utente è necessario premere sul pulsante con l'icona di un lucchetto.
Digitare la password e premere su *Impostazioni Avanzate* per visualizzare i settori. Per una rapida attivazione/disattivazione di tutti i sensori contenuti nei settori di allarme (accessibili con quella password), scegliere *Attiva tutti* o *Disattiva tutti* e premere il pulsante *Conferma*.
### Sistema di Irrigazione
In generale un Sistema di Irrigazione prevede l'installazione di elettrovalvole apposite; il collegamento di quest'ultime alla scheda avviene come per qualsiasi output e richiede l'attivazione del *dip RELAY* dedicato. Nel caso ci fossero dubbi fate riferimento alla guida relativa alla configurazione di una luce.
Per la configurazione delle elettrovalvole dall'app, procedete come voleste configurare un output generico (consigliamo di attivare l'opzione *Non interagibile da interfaccia*, per evitare che l'utente possa interagire da app, attivando/disattivando l'elettrovalvola "manualmente"). Una volta configurate e cablate tutte le elettrovalvole, dovete procedere con la configurazione di un *Ciclo*. Per farlo accedete alla pagina *Lista Elementi* della scheda su cui desiderate configurarlo, premete il pulsante con i tre puntini in basso a destra, quindi il tasto *Aggiungi* (consigliamo di configurarlo sulla scheda a cui avete collegato la maggior parte delle elettrovalvole).
I Cicli sono oggetti avanzati che permettono di eseguire una serie di operazioni seguendo una sequenza di fasi. Per ciascuna fase è possibile definire:
* Durata
* Operazioni quando la fase viene avviata
* Operazioni quando la fase viene messa in pausa
* Operazioni quando la fase viene messa in stop
Una fase può essere configurata senza operazioni, utile se si desidera inserire una pausa all'interno del ciclo. Il ciclo può essere *infinito*, e quindi continuerà ad eseguire in *loop* la sequenza di fasi finché non verrà messo in stop o in pausa; nel caso in cui si definisca un numero preciso di ripetizioni, il ciclo ripeterà la sequenza di fasi per quel numero di volte.
È inoltre possibile definire una lista di operazioni da eseguire al termine del ciclo.
Nel caso specifico del Sistema di Irrigazione ogni fase può corrispondere all'attivazione di una delle elettrovalvole installate, o di un gruppo di esse. Prendiamo il caso più frequente di una elettrovalvola per ciascuna zona del giardino, e immaginiamo di avere 2 zone e di voler irrigare una zona alla volta, il nostro ciclo sarà così definito:
* *Ripetizioni:* 1.
* *Operazioni al termine:* 2 operazioni che forzano la disattivazione di ciascuna elettrovalvola.
* *Fasi:* 2 fasi, una per ciascuna zona.
Ogni fase sarà così definita:
* *Nome:* nome della zona (es. Viale Ingresso).
* *Operazioni all'avvio:* attivazione dell'elettrovalvola della zona che state configurando.
* *Operazioni se in pausa:* disattivazione elettrovalvola.
* *Operazioni se in stop:* disattivazione elettrovalvola.
* *Durata:* quella che ritenete opportuna (es. 600 secondi); l'utente potrà comunque modificarla da app, ma il valore che imposterete dall'app di configurazione sarà quello di default.
Una volta definito il ciclo potete creare il Sistema di Irrigazione, che presenta le seguenti proprietà:
* *Ciclo:* qui dovete definire il ciclo che avete creato in precedenza.
* *Pluviometro:* questa opzione è facoltativa e permette di associare un Sensore di Pioggia al Sistema di Irrigazione, così da limitare il funzionamento nel caso in cui ci siano state delle precipitazioni.
# Logica
Questa guida permette di comprendere le nozioni fondamentali, per la configurazione di espressioni logiche secondo i principi di "Se questo allora quello".
## Configurazione Avanzata
Ci sono situazioni che richiedono la configurazione di una logica avanzata, capace, sulla base di una serie di condizioni, di eseguire una lista di operazioni.
La configurazione della logica si basa sui principi di **Se Questo allora Quello** e permette facilmente di creare combinazioni molto potenti.
Ci sono due entità da configurare e legare tra loro:
* *Gruppi di Input*: non sono altro che dei contenitori di condizioni e possono essere legati a più di una *Regola*.
* *Regole:* contengono la lista di operazioni da eseguire nel caso in cui il *Gruppo di Input* collegato sia verificato.
Nel caso in cui abbiate bisogno di un parametro che vari sulla base di uno stato, di una serie di condizioni, in base all'interazione dell'utente e così via, potete fare affidamento sulle *Variabili Virtuali*.
Non è richiesta alcuna competenza nella programmazione di *PLC*, in quanto la configurazione avviene attraverso un'interfaccia semplice ed intuitiva.
Per procedere con la configurazione della Logica è necessario premere il tasto *Configura Logica* presente nella schermata principale.
Come spiegato nella pagina *Come Fare*, il primo step è rappresentato dalla creazione di un *Gruppo di Input*. Potete cliccare sul tasto *Crea Gruppo di Input*, o cliccare sulla pagina *Condizioni* in basso, quindi il pulsante con i tre puntini in basso a destra e infine *Aggiungi*.
Quindi la schermata che avremo sarà la seguente.
### Gruppi di Input
La configurazione di un'espressione logica parte dalla definizione delle condizioni, ovvero del nostro **Se**.
Prima di procedere alla spiegazione della configurazione, è bene comprendere la natura dei *Gruppi di Input*, soprattutto se non avete esperienza con gli operatori logici e con i *PLC*.
L'app permette di definire un gruppo di condizioni, ovvero il *Gruppo di Input*, e di legarle tra loro attraverso operatore logico \_AND\_o *OR*. Un *Gruppo di Input* può contenere anche una sola condizione e, affinché sia verificato, è necessario che:
* tutte le condizioni siano verificate, se si sceglie l'operatore logico *AND*;
* almeno una delle condizioni sia verificata, se si sceglie l'operatore logico *OR*.
Se ad esempio abbiamo 3 condizioni, e le leghiamo tra loro dall'operatore logico *AND*, è come dicessimo *«**Se** la condizione 1 **e** la condizione 2 **e** la condizione 3 sono verificate, allora il Gruppo di Input è verificato»*.
Se le 3 condizioni le leghiamo dall'operatore logico *OR*, è come dicessimo *«**Se** la condizione 1 **o** la condizione 2 **o** la condizione 3 è verificata, allora il Gruppo di Input è verificato»*.
Nel caso in cui volessimo legare tra loro alcune condizioni con operatore *AND* e altre con *OR*, è possibile inserire in un altro *Gruppo di Input* una o più condizioni che dipendano da uno dei *Gruppi di Input* configurati in precedenza.
Di seguito un esempio per comprendere meglio questo aspetto.
*Vogliamo creare un'espressione logica che ci permetta di spegnere il riscaldamento se nella stanza abbiamo almeno una finestra aperta, e se fuori c'è freddo, così da non riscaldare a vuoto.*
Creiamo quindi un *Gruppo di Input* con due condizioni legate dall'operatore *OR*:
1. Finestra 1 è aperta da più di 60 secondi
2. Finestra 2 è aperta da più di 60 secondi
Diamo al gruppo il nome: "Finestra Aperta". Quindi l'espressione che otteniamo è *«**Se** la Finestra 1 è aperta da più di 60 secondi **o** la Finestra 2 è aperta da più di 60 secondi, il Gruppo di Input "Finestra Aperta" è verificato»*.
Ora creiamo un secondo *Gruppo di Input* e aggiungiamo le seguenti condizioni legate dall'operatore *AND*:
1. La Temperatura Esterna misura un valore minore di 10°C
2. Il *Gruppo di Input* "Finestra Aperta" è verificato
In questo caso avremo: *«**Se** la sonda Temperatura Esterna misura un valore minore di 10°C **e** il Gruppo di Input "Finestra Aperta" è verificato, allora il Gruppo di Input è verificato»*.
Quest'ultimo *Gruppo di Input* lo leghiamo infine ad una *Regola* che disattiva il riscaldamento, così da avere che: *«Se la sonda Temperatura Esterna misura un valore minore di 10°C, e almeno una delle due finestre è aperta, allora spegni il riscaldamento»*.
> Non c'è alcun limite al numero di *Gruppi di Input* che potete legare tra loro.
I *Gruppi di Input* hanno le seguenti proprietà:
1. Nome
2. Descrizione
3. Operatore logico (*AND* ed *OR*)
4. Condizioni
#### Condizioni
Scegliere innanzitutto l'operatore logico (*AND* o *OR*), quindi procedere con la configurazione delle condizioni.
Per configurare le condizioni è necessario premere il tasto *Configura le Condizioni*.
Trattandosi di un nuovo *Gruppo di Input* non ci sono condizioni presenti, per aggiungerne di nuove premere il pulsante **+** in alto a destra.
Per ogni *Condizione* è necessario definire:
* *Elemento della Condizione:* cliccando sul tasto con il pennino è possibile scegliere l'elemento su cui verrà valutata la condizione (Meteo, Calendario, Orologio, luci, sensori, input, ecc.).
* *Funzione:* qui va scelta la funzione che permette di ottenere il valore da valutare (ad esempio il valore misurato da un sensore o lo stato di un output).
* *Condizione:* in base al tipo di elemento e della funzione scelta, potrete scegliere tra una serie di condizioni (*maggiore di*, *uguale*, *diverso*, ecc.).
* *Valore:* qui dovete definire il valore del confronto.
È inoltre possibile definire un *Timer*, che a sua volta contiene due proprietà:
* Condizione Timer
* Valore in secondi
Ad esempio se impostate un valore pari a 10 secondi e scegliete *Maggiore di* come condizione del timer, la condizione sull'elemento sarà verificata solo se rimarrà tale per un tempo superiore a 10 secondi.
Cliccando il tasto con l'icona di una freccia è possibile visualizzare utili informazioni sui vari campi.
Qui di seguito un esempio pratico.
L'esempio in questione rappresenta una condizione su un sensore di temperatura, ed è verificata se il valore misurato dalla sonda è maggiore o uguale di 10°C per almeno 30 secondi.
Una volta salvata la configurazione del Gruppo di Input premete il tasto **+** in basso a destra, quindi il pulsante *Salva*, così da inviare la configurazione alle schede; fatto ciò potrete visualizzare lo stato delle singole condizioni e su quale scheda vengono valutate.
### Regole
Una *Regola* permette di eseguire una sequenza di operazioni nel caso in cui il *Gruppo di Input* a cui è stata legata sia verificato (o non verificato, nel caso si attivi l'opzione opportuna).
Per configurare una regola è necessario accedere alla pagina *Regole*, premere il pulsante con i tre puntini, quindi *Aggiungi*.
Le regole presentano numerose proprietà:
* *Nome* e *Descrizione*.
* *Regola abilitata:* una regola può essere disabilitata, così da evitarne l'eliminazione nel caso in cui la si voglia riattivare in un secondo momento.
* *Tipologia*: una regola può essere *Impulsiva* o *Continua*.
* *Gruppo di Input collegato:* qui va definito il *Gruppo di Input* che desiderate collegare, inoltre potete scegliere se desiderate che le operazioni della regola vengano eseguite quando il *Gruppo di Input* non è verificato.
* *Operazioni:* qui potete definire la lista di operazioni da eseguire.
* *Notifica:* le regole possono inviare una notifica quando il *Gruppo di Input* collegato è verificato.
* *Registro Eventi:* questa opzione permette di registrare un evento ogni qualvolta il *Gruppo di Input* collegato è verificato.
* *Alexa:* attivando questa opzione è possibile sfruttare lo stato del *Gruppo di Input* collegato per permettere ad *Amazon Alexa* di eseguire delle *Routine*; la configurazione delle *Routine* va fatta dall'app di *Alexa* e richiede di attivare la *Skill* di [Chiarini Home Automation](https://skills-store.amazon.it/deeplink/dp/B08BXLPC1H?deviceType=app\&share\&refSuffix=ss_copy).
La tipologia della regola merita un ulteriore approfondimento:
* *Regola Impulsiva:* l'esecuzione delle operazioni avviene solo quando il *Gruppo di Input* collegato passa dallo stato di *non verificato* allo stato *verificato*.
* *Regola Continua:* in caso di regola continua le operazioni vengono eseguite fintanto che il *Gruppo di Input* è verificato.
In generale consigliamo di scegliere l'opzione *Impulsiva*, ma se ad esempio la regola attiva un output, e questo è bene che rimanga attivo fintanto che le condizioni lo richiedono, optate per l'opzione *Continua* (in questo caso le operazioni non vengono comunque ripetute ogni istante, ma ad intervalli di 10 secondi).
> Se attivate l'opzione che permette l'esecuzione delle operazioni quando il *Gruppo di Input* non è verificato, sia la *Notifica* che il *Registro Eventi* vengono eseguiti in quel caso.
#### Operazioni
Dopo aver definito il *Gruppo di Input* e la tipologia della Regola, potete configurare la lista di operazioni.
Per procedere con la configurazione delle operazioni dovete cliccare il tasto *Configura Operazioni*.
Per aggiungere un'operazione dovete cliccare il tasto **+** in alto a destra, quindi per ciascuna operazione potete definire:
* *Elemento dell'Operazione:* l'elemento su cui verrà eseguita l'operazione.
* *Funzione:* funzione da eseguire sull'elemento scelto (es. attiva, disattiva, apri, ecc.).
* *Timer:* qui potete definire dopo quanto tempo volete che la singola operazione venga eseguita.
Una volta salvata la regola, premete il pulsante **+** in basso a destra e quindi *Salva*, così da inviare la configurazione aggiornata alle schede.
Nella schermata delle regole potete controllare quanto sta accadendo nel sistema: quali regole sono abilitate, quali sono state eseguite impulsivamente e quali lo sono in modo continuo. Cliccando sul tasto relativo alle operazioni potete vedere un riassunto della lista di operazioni configurata.
### Variabili Virtuali
Ci sono casi in cui dovete appoggiavi ad un parametro virtuale per poter eseguire delle operazioni o valutare delle condizioni.
In generale le *Variabili Virtuali* ampliano le funzioni previste dal sistema, in quanto potete associare ad esse il significato che desiderate.
Una *Variabile Virtuale* è bene configurarla sulla stessa scheda in cui si trovano gli elementi a cui volete legarla; nel caso in cui gli elementi appartengano a più schede consigliamo di configurarla sulla scheda che avete definito come *Master*.
Per configurare la variabile virtuale dovete accedere alla scheda e andare nella pagina *Lista Elementi*; cliccate sui tre puntini in basso a destra, quindi sul tasto *Aggiungi*; lì potete scegliere *Variabile Virtuale* dalla finestra *Scegli Tipologia*.
Oltre al nome e alla descrizione potete definire:
* *Tipologia:* potete scegliere se desiderate che la variabile possa assumere un valore (tra un massimo e un minimo), lo stato ON/OFF o che agisca in modo impulsivo.
* *Logica:* qui è possibile definire una lista di operazioni da eseguire quando l'elemento assume lo stato *ON* e *OFF*.
> Nel caso in cui scegliate il tipo *Impulsivo,* lo stato di *ON* viene assunto per un istante, dopodiché torna automaticamente allo stato *OFF*.
Le variabili virtuali possono essere visualizzate nell'app utente, sfruttate per definire le condizioni dei *Gruppi di Input* o usate nelle operazioni delle Regole. Possono essere usate anche in sostituzione di output nella configurazione di elementi *Gestione Soglia*.
# Interfaccia
## Configurazione Interfaccia
La seguente guida vi spiegherà come personalizzare l'interfaccia dell'app utente creando *Gruppi* e personalizzando l'aspetto degli elementi.
### Personalizzazione Elementi
L'app *Chiarini Home Automation Tech* permette inoltre di personalizzare i nomi dei dispositivi senza variare il nome di configurazione; questa funzione vi permette quindi di assegnare un nome utile a voi tecnici, che ad esempio richiama quello assegnato in schemi e progetti, e un secondo nome più familiare e comprensibile all'utente. Oltre al nome è possibile assegnare un'icona personalizzata per ciascuno degli elementi che avete configurato.
Per la personalizzazione dell'interfaccia dovete accedere alle *Impostazioni del Sistema*, quindi cliccare sulla pagina con l'icona di un pennello in basso a destra.
Una volta aperta la pagina per la personalizzazione dell'interfaccia (quella con l'icona del pennello) è possibile visualizzare gli elementi configurati nel sistema e modificare il loro aspetto.
Per modificare un elemento è sufficiente premere su di esso.
Per tutti gli elementi è possibile definire le seguenti proprietà:
* *Nome* alternativo
* *Icona* (premere sul pulsante *Imposta Icona*)
Nel caso in cui l'elemento sia una luce, è possibile definire se si tratta di una *Luce Esterna*; nel caso in cui questa opzione sia stata attivata, alla pressione del tasto rapido per spegnere tutte le luci nell'app utente, questa luce non verrà spenta.
Se l'elemento è un *Input* o una *Variabile Virtuale* si potrà definire:
* Testo nel caso in cui lo stato dell'elemento è *OFF*
* Testo nel caso in cui lo stato dell'elemento è *ON*
Se ad esempio l'*Input* corrisponde ad un sensore di contatto posto su una porta, potremo definire una configurazione come quella mostrata nella figura seguente.
Per salvare la configurazione dell'Interfaccia è necessario premere il pulsante con i tre puntini in basso a destra, quindi *Salva*.
### Creazione dei Gruppi
Un *Gruppo* permette di raccogliere una serie di elementi, anche di categorie diverse, così da offrire all'utente una migliore organizzazione dell'interfaccia. I *Gruppi* molto spesso rappresentano le stanze di una casa, i piani di un edificio, o i vari ambienti, sta a voi definire l'organizzazione ottimale.
Sempre dalla pagina che ci permette di personalizzare nomi ed icone degli elementi, abbiamo la possibilità di creare dei *Gruppi* predefiniti.
Per configurare un gruppo cliccate sul pulsante con i tre puntini in basso a destra, quindi *Gruppi*; per creare un nuovo elemento cliccate il tasto *Nuovo Gruppo*.
Definite innanzitutto il nome, quindi cliccate su *Conferma*.
Potete quindi definire una descrizione e scegliere gli elementi che desiderate includere nel gruppo. Per salvare il gruppo premete il tasto *Salva*.
Il gruppo creato vi apparirà come segue.
In generale per ogni gruppo è possibile definire le seguenti proprietà:
* *Nome* e *Descrizione*
* *Icona* (premendo il tasto con il simbolo di un'immagine e un pennino)
* *Colore* (premendo il tasto con la tavolozza dei colori)
* *Elementi* (luci, carichi, sensori, ecc.)
Per modificare gli elementi, il nome e la descrizione del gruppo, cliccate sul tasto con l'icona di un pennino, mentre il tasto con l'icona di un cestino permette di eliminarlo.
> I gruppi definiti nell'app di configurazione non possono essere modificati dall'utente, ma soltanto nascosti; in ogni caso ogni utente dell'impianto può creare dall'applicazione i propri gruppi, non visibili agli altri utenti.
# Scorciatoie
## Configurazione Scorciatoie
Le *Scorciatoie* sono la nostra interpretazione degli *Scenari*, che in un Sistema Domotico permettono di eseguire molteplici operazioni in seguito ad un'unica interazione.
Le *Scorciatoie* hanno utilità solo nell'app utente, e possono essere eseguite "manualmente" (premendo il tasto virtuale che le rappresenta) o automaticamente (ad esempio in base alla posizione GPS). A differenza dei classici *Scenari* le scorciatoie possono essere condivise anche con persone che non hanno l'app e accesso all'impianto; il *link* generato dall'app utente ha una validità temporale limitata (definibile dall'utente), può essere protetto da password, inviare una notifica quando usato, e molto altro. Piccoli Bed & Breakfast e affittacamere possono offrire ai propri ospiti l'ingresso alle stanze, evitando la consegna delle chiavi; utenti privati possono condividere il *link*, per aprire la porta e il cancello di casa, con amici invitati per cena, per evitare il disturbante suono del campanello; l'impresa di pulizie può accedere ad un edificio, negli orari e giorni prestabiliti, senza possedere chiavi o codici, ed una notifica può avvisare il proprietario del loro ingresso. Il *link* può essere bloccato in qualsiasi istante, così da impedirne il funzionamento.
L'immagine seguente mostra un esempio della schermata delle scorciatoie nell'app utente.
Dall'app di configurazione è possibile configurare le *Scorciatoie* che si desidera offrire di default, ma anche l'utente può aggiungerne di proprie.
Per accedere alla pagina delle *Scorciatoie* dovete premere il pulsante *Impostazioni Sistema* e cliccare il tasto con l'icona di una mano.
Per creare una nuova Scorciatoia dovete cliccare il tasto con i tre puntini in basso a destra, quindi *Aggiungi*.
Per ciascuna *Scorciatoia* è possibile definire le seguenti proprietà:
* *Nome e Descrizione:* la descrizione permette di ricordare all'utente le operazioni che vengono eseguite.
* *Richiesta di conferma:* se attivate questa opzione all'utente verrà richiesta la conferma di esecuzione ogni volta che cliccherà la *Scorciatoia* (utile se vengono aperte porte, cancelli, ecc.).
* *Aspetto:* potete assegnare un colore ed un icona a piacimento, così da rendere la *Scorciatoia* facilmente individuabile.
* *Stato:* se definite un elemento, la *Scorciatoia* visualizzerà informazioni sullo stato di quell'elemento (es. valore sensore, stato luce, ecc.).
* *Operazioni:* qui potete definire la lista di operazioni da eseguire.
* *Parametro:* se definito all'utente verrà richiesto di inserire un valore per il parametro scelto.
Per salvare la configurazione delle *Scorciatoie* è necessario premere il tasto **+** in basso a destra, quindi *Salva*.
### Parametro
I parametri proposti nella configurazione della *Scorciatoia* dipendono dalle funzioni scelte. La funzione *Attiva* di una luce collegata ad un relè non offre parametri, ma nel caso in cui la luce sia *dimmerabile* potete definire la percentuale di luminosità.
Per impostare un parametro cliccare sul tasto *Nome Parametro* e scegliere quello desiderato, quindi cliccare *Conferma*.
Una volta scelto il parametro dovete definire il campo *Testo Suggerito*, che verrà visualizzato dall'utente all'inserimento del valore. La tipologia (*numero*, *testo*, *vero/falso* e *password*) viene definita in automatico, sulla base del parametro scelto, ma è possibile cambiarla cliccando sul tasto *Tipologia*.
*Cosa rende questa proprietà molto potente?* La possibilità di impostare molteplici elementi con lo stesso set in un colpo solo.
Prendiamo il caso di una casa con 10 finestre che desiderate impostare alla medesima percentuale di apertura. Per evitare di creare più scorciatoie che impostano le finestre a percentuali predefinite, potete crearne una sola e impostare come *Parametro* la *Percentuale* di apertura; in questo modo all'utente verrà richiesto di inserire la percentuale, e tutte le 10 finestre si apriranno del medesimo valore.
Il medesimo approccio è applicabile per molti altri elementi di un impianto: termostati, luci con dimmer, e così via.
# Utenti e Permessi
## Configurazione Utenti
La seguente guida vi spiegherà come creare nuovi utenti in un impianto, aggiungerli a gruppi e definire i loro permessi.
> Se prevedete di aggiungere numerosi utenti vi consigliamo di creare *Gruppi Utente*, così ogni nuovo utente potrà ereditare i permessi del gruppo, evitandovi di doverli associare ad ogni utente singolarmente.
Per gestire gli utenti dovete accedere alle impostazioni del sistema, cliccando il tasto *Impostazioni Sistema*, quindi il pulsante con l'icona di un ingranaggio.
Scorrendo la pagina potete trovare la sezione *Proprietario del Sistema*, che vi permette di modificare le impostazioni dell'utente principale, e la sezione *Utenti*, che vi permette di gestire gli utenti e i gruppi utente.
### Proprietario del Sistema
Qui potete modificare i dati del vostro cliente, che è di fatto l'unico utente a cui non possono essere ristretti i permessi, ha quindi accesso ad ogni parte del sistema (non alla configurazione ovviamente).
Il tasto *Aggiorna Token* permette di aggiornare il token di accesso, ovvero la chiave che identifica l'utente nel sistema. Questa chiave non viene chiesta per accedere o interagire con il sistema, ma viene gestita automaticamente. *Quando dovete aggiornare il Token?* Solo se si sospetta un accesso non desiderato al sistema, in quel caso è quindi opportuno cambiare la password dell'utente e aggiornare questo token.
Il tasto *Modifica dati* permette di gestire le informazioni del cliente (nome, cognome, ecc.), e le credenziali di accesso (email, nome utente, password).
### Utenti
Per gestire e aggiungere utenti dovete cliccare sul tasto *Modifica Utenti*. Per creare un nuovo utente cliccate il pulsante *Nuovo Utente*.
Una volta premuto il pulsante *Nuovo Utente* si aprirà una pagina che vi guiderà passo-passo alla configurazione di un nuovo profilo.
Come per il proprietario del sistema, anche per tutti gli altri utenti trovate il tasto *Aggiorna Token*, da utilizzare nel caso in cui l'utente in questione abbia effettuato attività non previste.
Il tasto con l'icona di un binocolo vi permette di visualizzare i gruppi in cui l'utente è stato inserito.
> Nel caso in cui i nuovi utenti non riuscissero ad interagire con il sistema, suggeriamo di riavviare le schede dell'impianto.
### Gruppi Utente
Cliccando il tasto *Modifica Gruppi* potete gestire i gruppi utente e crearne di nuovi. Premete il tasto *Nuovo Gruppo* per aggiungerne uno.
Definite il nome del gruppo e cliccate *Conferma*.
Cliccando il tasto con l'icona di un pennino potete modificare il nome del gruppo, mentre se cliccate il tasto con l'icona di due persone potete aggiungere/togliere gli utenti dal gruppo.
Il tasto in alto a destra, con l'icona di un re, vi permette di definire gli utenti *admin*. Un utente *admin* ottiene il permesso di interagire con tutti gli elementi dell'impianto, al pari del proprietario; alcune impostazioni del sistema (es. attivazione di *Alexa*, *Sonos*, ecc.) possono essere gestite solo dal proprietario.
### Definire i Permessi
Vi sarà capitato, durante la configurazione dei vari elementi dell'impianto, di trovare la sezione *Permessi*.
L'esempio sopra si riferisce alla configurazione dei permessi di una luce; cliccando il tasto *Imposta Permessi* è possibile limitare l'accesso a tale elemento. Per aggiungere nuovi vincoli di accesso è necessario cliccare il tasto **+** in alto a destra, quindi selezionare l'utente (o il gruppo utente) di cui si desiderano definire i permessi.
Nell'immagine sopra è stato definito un permesso di sola lettura per l'utente *paola.rossi*, ma cosa comporta?
Ci sono due tipi di permessi:
* *Lettura:* l'utente può visualizzare l'elemento.
* *Scrittura:* l'utente può modificare lo stato dell'elemento.
Ad esempio, nel caso in cui si definisca un permesso di sola lettura per una luce, l'utente potrà visualizzare sull'app se la luce è accesa o spenta, ma non potrà interagire con essa.
*Quando ha senso fornire il permesso di sola scrittura?* Se desiderate nascondere degli elementi all'utente, ma avete configurato delle scorciatoie che interagiscono con essi, a cui il suddetto utente può accedere, dovete permettere l'accesso in scrittura.
Se i permessi vengono definiti per un *Gruppo Utente*, tali permessi verranno ereditati da tutti gli utenti che ne fanno parte.
> I permessi definiti per i singoli utenti hanno sempre la precedenza sui permessi del gruppo (ad esclusione del gruppo *admin*). Se un utente appartiene a più gruppi, viene data la precedenza al permesso del gruppo che limita maggiormente l'utente.
Per ciascun elemento dell'impianto (scorciatoie comprese) è possibile definire i permessi di accesso.
# Integrazione con Shelly
Qui viene descritto come connettere i principali dispositivi Shelly al sistema.
## Requisiti
Affinché possiate integrare *Shelly* è necessario aver configurato come scheda *Master* una delle nostre schede o un nostro dispositivo Gateway.
## Shelly
Si tratta di piccole schede prodotte da *Allterco Robotics* basate sul microcontrollore *ESP32* (o *ESP8266* nei modelli più vecchi) che permettono di portare qualche funzione domotica presso impianti elettrici tradizionali.
[Qui](https://shelly.cloud) potete trovare informazioni sui prodotti.
Abbiamo sviluppato un modulo che permette di integrare facilmente tali dispositivi nel nostro ecosistema.
> Suggeriamo di usare *Shelly* dove non ci siano alternative, trattandosi di dispositivi Wi-Fi, con software non sviluppato da noi, non possiamo offrire alcuna garanzia sulle prestazioni, per quanto i nostri test ci abbiano restituito risultati positivi.
### Ricerca e Connessione Dispositivi
Dalla pagina principale del Sistema cliccare sui tre puntini in alto a destra, quindi su *Dispositivi Shelly*. All'apertura della pagina verrà effettuata una ricerca automatica, e verranno mostrati i dispositivi compatibili connessi alla rete.
> Affinché gli *Shelly* risultino individuabili è importante che siano stati connessi alla medesima rete da cui state effettuando la ricerca e che la connessione con il Sistema Domotico sia *Locale*.
Potete quindi aggiungere i dispositivi al Sistema cliccando sul tasto *Aggiungi*; automaticamente lo *Shelly* verrà configurato per comunicare con il Sistema via *MQTT*.
Nel caso in cui lo *Shelly* non sia già stato connesso alla rete Wi-Fi, potete effettuare tale operazione direttamente dall'app, ma dovete connettervi alla rete offerta dallo *Shelly*. Quindi cliccando su *Rete Wi-Fi* potete definire i parametri di connessione. Se preferite, la connessione alla rete la potete completare dall'app di *Shelly*.
### Configurazione Output/Input
Una volta connessi i dispositivi al Sistema Domotico, è possibile procedere con la configurazione di input e output.
Questa operazione è possibile anche da Remoto, ma la prima configurazione consigliamo sempre di effettuarla in rete locale.
Gli output ed input connessi ad uno *Shelly* godono di tutti i vantaggi del nostro ecosistema, come fossero output ed input delle schede di nostra produzione.
#### Output
Tra le schede dell'impianto selezionate la *Master*, quindi cliccate sulla pagina *Lista Elementi*.
Cliccate sui tre puntini in basso a destra, quindi su *Aggiungi*.
Scegliete *Output* dalla lista, quindi scorrete la pagina alla sezione *Connessione*. È qui che dovete definire il tipo di collegamento del vostro output:
* Cliccate su *Scegli Tipologia* e scegliete *Shelly.*
* Definite poi il numero del morsetto, tenendo presente che il conteggio tra input e output è separato; ad esempio su *Shelly1 V3*, che ha un solo output relè e un input, dovrete scegliere *0* sia per la configurazione dell'output, che per la configurazione dell'eventuale input (es. pulsante); nel caso di *Shelly H\&T* dovete selezionare il morsetto *0* per la temperatura e il morsetto *1* per l'umidità.
* Scegliete quindi lo *Shelly,* tra quelli che avete connesso al Sistema, cliccando sul tasto *Scegli Shelly*.
Procedete quindi con la configurazione selezionando se si tratta di un relè o di un output analogico, e definite tutti i parametri come fareste per un qualsasi output delle schede di nostra produzione.
#### Input
Per la configurazione degli input dovete procedere seguendo i medesimi passaggi.
# MQTT API
Qui viene descritto come connettere dispositivi di qualsiasi tipo, in grado di comunicare con il protocollo MQTT.
## Requisiti
Affinché possiate integrare i vostri dispositivi è necessario aver configurato come scheda *Master* una delle nostre schede o un nostro dispositivo Gateway.
## MQTT
**MQTT** è l’acronimo di **Message Queuing Telemetry Transport** e indica un protocollo di trasmissione dati TCP/IP basato su un modello di pubblicazione e sottoscrizione che opera attraverso un apposito *Message Broker*.
La scheda *Master* del Sistema (o il Gateway che forniamo in impianti privi di schede) fa le veci del *Broker*, quindi il dispositivo è ad essa che si deve connettere.
### Connessione al Broker
Dall'applicazione tecnico potete ottenere l'indirizzo IP della scheda *Master*, quindi per la connessione al *Broker* è sufficiente definire:
* **Porta:** 1883
* **Indirizzo Server:** IP scheda *Master* o `ohmb-master.local`
{% hint style="warning" %}
Consigliamo di impostare un indirizzo **IP statico** per la scheda *Master*, per evitare che questo cambi in seguito a riavvii della scheda o del router.
{% endhint %}
### Configurazione Elemento
Per poter integrare output e input via MQTT è necessario, in fase di configurazione di un elemento, definire **MQTT** come tipo di collegamento.
Di seguito gli elementi che supportano questo tipo di connessione:
* Output
* Input
* Sensori
* Led RGB
* Variabili Virtuali
Questi i parametri che possono essere definiti:
* Topic Lettura
* Topic Scrittura (solo Output e Led RGB)
* Path Messaggio (payload)
#### Path Messaggio
Tale parametro va definito solo nel caso in qui il messaggio (o *payload*) contenga un **JSON**. Il *path* permette infatti di definire il percorso per l'ottenimento del valore.
Se abbiamo ad esempio il seguente JSON:
```json
{
"temp": {
"value": 22.5,
"unity": "C"
},
"hum": {
"value": 46,
"unity": "%"
}
}
```
i *path* per ottenere i valori di temperatura e umidità saranno:
* Temperatura: `temp/value`
* Umidità: `hum/value`
Se il JSON contenesse un array (lista) come in questo caso:
```json
{
"sensors": [
{
"id": "abc",
"value": 22.5,
"type": "temperature"
},
{
"id": "xyz",
"value": 46,
"type": "humidity"
}
]
}
```
i *path* da definire saranno:
* Temperatura: `sensors/0/value`
* Umidità: `sensors/1/value`
### Publish
I topic per la pubblicazione degli stati non devono avere un formato particolare, ma è importante che siano univoci per ciascun input e output che desiderate integrare; è invece importante che il messaggio contenga soltanto il valore.
Quindi se vogliamo integrare un sensore di temperatura, il topic potrebbe essere `test/temperatura` e il messaggio il valore numerico che vogliamo comunicare.
Non ci sono vincoli sull'origine del valore numerico, potrebbe ad esempio trattarsi di un valore di temperatura ottenuto tramite internet sfruttando qualche API Meteo, o in seguito alla digitazione di un valore da tastiera.
Di seguito il formato del valore da inviare a seconda del tipo di elemento:
* *Sensore*: invio del valore numerico con `.` come separatore decimale (es. `23.4`).
* *Input*: inviare **0** nel caso di input non verificato, **1** se verificato.
* *Output Digitale (relè)*: **0** se disattivo, **1** se attivo.
* *Output Analogico*: valore tra **1** (o valore minimo di dimmerazione) e **255** (o valore massimo di dimmerazione) se attivo; se è disattivo va inviato `0:x`, dove `x` è il valore prima di essere disattivato (es. `0:130`).
* *Variabile Virtuale*: numero intero o decimale (con il `.` come separatore decimale).
### Subscribe
Nel caso si voglia integrare un output va definito anche il topic per la ricezione delle richieste. Anche in questo caso non ci sono vincoli, se non la definizione di topic univoci per ciascun output.
Il topic per la ricezione delle richieste potrebbe essere ad esempio `out_1/comando`, e a seconda del tipo di richiesta il messaggio sarà:
* `on`: per l'attivazione dell'output
* `off`: per la disattivazione
* Valore tra `0` e `255`: se l'uscita è analogica viene inviato un valore numerico (`0` corrisponde alla minima intensità, `255` alla massima)
Anche in questo caso non è obbligatorio che il comando sia inviato ad un output reale, o comunque connesso fisicamente al dispositivo che volete integrare, ma tale valore potrebbe essere allegato ad una richiesta HTTP o ad un messaggio via bus seriale.
## Esempi
Il codice sottostante (in *Python*) è stato testato su un *Raspberry Pi*, e permette di integrare un sensore *DHT*, per l'invio di temperatura e umidità:
```python
import Adafruit_DHT
import time
import uuid
import paho.mqtt.client as mqtt
disconnected = False
last_message_sent = time.time()
class SuperClient(mqtt.Client):
def loop(self, timeout=1.0, max_packets=1):
time.sleep(0.001)
return super(SuperClient, self).loop()
class DHTSensor(object):
def __init__(self, pin):
self.pin = pin
self.temperature = 0.0
self.humidity = 0.0
self.old_temperature = 0.0
self.old_humidity = 0.0
self.last_update = 0
def check(self) -> bool:
return self.old_humidity != self.humidity or self.old_temperature != self.temperature
def upate(self) -> bool:
if time.time() - self.last_update > 5:
self.old_humidity = self.humidity
self.old_temperature = self.temperature
humidity, temperature = Adafruit_DHT.read(sensor=Adafruit_DHT.DHT22, pin=self.pin)
if None not in [humidity, temperature]:
self.humidity = round(float(humidity), 1)
self.temperature = round(float(temperature), 1)
self.last_update = time.time()
return self.check()
return False
# The callback for when the client receives a CONNACK response from the server.
def on_connect(client, userdata, flags, rc):
global disconnected
disconnected = False
# The callback for when the client receives a CONNACK response from the server.
def on_disconnect(client, userdata, rc):
global disconnected
disconnected = True
def set_client(host):
try:
global mqtt_client
client_id = "rasp-" + str(uuid.uuid4())
mqtt_client = SuperClient(client_id=client_id, clean_session=True)
# Set callbacks methods
mqtt_client.on_connect = on_connect
mqtt_client.on_disconnect = on_disconnect
mqtt_client._host = host
mqtt_client._port = 1883
mqtt_client._keepalive = 60
#mqtt_client.max_queued_messages_set(queue_size=1)
# Start connection
mqtt_client.loop_start()
mqtt_client.reconnect()
except:
pass
def update_via_mqtt(sensor: DHTSensor):
global mqtt_client
try:
mqtt_client.publish(topic=f"rasp/dht/humidity/{sensor.pin}", payload=f"{sensor.humidity}", qos=0, retain=True)
mqtt_client.publish(topic=f"rasp/dht/temperature/{sensor.pin}", payload=f"{sensor.temperature}", qos=0, retain=True)
except:
pass
set_client(host="x.x.x.x")
sensors = [DHTSensor(pin=19), DHTSensor(pin=26)]
# Set client loop
while True:
for sensor in sensors:
if sensor.upate():
update_via_mqtt(sensor=sensor)
if time.time() - last_message_sent > 10:
for sensor in sensors:
update_via_mqtt(sensor=sensor)
last_message_sent = time.time()
time.sleep(0.1)
```
# Ulteriori Approfondimenti
## Extra
Qui potete trovare tutto ciò che non è stato affrontato nelle guide precedenti.
### Posizione Impianto
L'app di configurazione vi permette di visualizzare una mappa con la posizione geografica degli impianti. Cliccando sugli elementi della mappa è possibile visualizzare il nome dell'impianto e, cliccando su di esso, potete effettuare la connessione.
Per impostare la posizione del sistema dovete accedere all'impianto, quindi cliccare *Impostazioni Impianto*; lì cliccate il tasto *Posizione*, così da aprire la mappa. Per definire la posizione dovete cliccare direttamente sulla mappa; è possibile cercare l'indirizzo preciso cliccando sul tasto *Cerca* in alto a destra.
Una volta confermata la posizione scelta (premendo la spunta in basso), per salvare le modifiche dovete premere il pulsante *Salva* in basso a destra.
### Backup
L'app permette di effettuare il *backup* dei sistemi a cui ci si è collegati, della *Logica*, della configurazione degli elementi di una scheda e delle sue impostazioni.
Per effettuare il *backup* dei sistemi è sufficiente cliccare i tre puntini in alto a destra presenti nella pagina iniziale, quindi *Backup Connessione Sistemi*.
Se si desidera salvare un *backup* della configurazione della *Logica* è necessario accedere al sistema, quindi cliccare *Impostazioni Sistema*, quindi scorrere la pagina visualizzata fino alla sezione *Backup Logica*; lì troverete il pulsante *Gestisci Backup Logica*.
Per il *backup* della configurazione degli elementi e delle impostazioni di una scheda dovete cliccare sulla scheda interessata, quindi il pulsante verde con la nuvoletta presente nella pagina con lo schema della scheda.
Per effettuare il *backup* è sufficiente premere sul pulsante blu (con l'icona di una nuvola) in basso a destra; vi verrà richiesto di descrivere il *backup* che state effettuando, così da distinguerlo dagli altri. Consigliamo di descrivere le modifiche importanti che avete effettuato, così risulterà più semplice scegliere quale ripristinare.
#### Ripristino Backup
Per ripristinare un *backup* dovete cliccare su di esso e confermare l'operazione. Il ripristino di un *backup*, una volta avviato, non può essere annullato; in ogni caso la configurazione ripristinata risulterà attiva solo in seguito al salvataggio.
# Eliminazione Account
Di seguito i passaggi per richiedere l'eliminazione dell'account.
La procedura di eliminazione dell'account richiede particolare attenzione. Al fine di evitare eventuali errori da parte dell'utente, abbiamo istituito un processo che gestiamo internamente. *Prima di procedere, eseguiamo una verifica delle ragioni che hanno motivato tale decisione.*
## Richiedere l'eliminazione
La richiesta di eliminazione può essere inviata direttamente dall'app, ma è possibile contattare il supporto all'indirizzo .
Per richiedere l'eliminazione dall'app è necessario accedere alle impostazioni dell'utente tecnico, premendo il pulsante con un pennino sulla prima casella.
Successivamente cliccare sul tasto in alto a destra (con l'icona di un utente e la `x`).
Si aprirà una finestra in cui ti sarà chiesto di specificare le motivazioni della cancellazione.
Cliccando *Invia Richiesta* verrà avviato il processo di verifica.
# API Documentation V1
Public API documentation Version 1.
### Before You Begin
Making the requests described here exposes the system you are connecting to, so credentials and tokens must be stored securely.
### Obtain Session Token
`POST` `https://api.ohmautomation.io/control/v1/auth`
This *endpoint* allows you to obtain the session token required to make all other requests.
**Headers**
| Name | Type | Description |
| ------------ | ------ | ------------------ |
| Content-Type | string | `application/json` |
**Request Body**
| Name | Type | Description |
| ------------------------------------------ | ------ | ------------- |
| username\* | string | Username |
| password\* | string | User password |
{% tabs %}
{% tab title="200" %}
```
{
"token": "r:qwertyuiop1234567890"
}
```
{% endtab %}
{% endtabs %}
### Delete Session
`POST` `https://api.ohmautomation.io/control/v1/logout`
This *endpoint* allows you to delete the session, making the token unusable.
**Headers**
| Name | Type | Description |
| ------------------------------------------------- | ------ | --------------------------- |
| X-Session-Token\* | string | Session token to be deleted |
{% tabs %}
{% tab title="200" %}
```
{
"token":
}
```
{% endtab %}
{% endtabs %}
### Shortcuts JSON
`GET` `https://api.ohmautomation.io/control/v1/shortcuts?token=abc`
This *endpoint* retrieves a *JSON* with the user’s shortcut configuration corresponding to the token.
**Query Parameters**
| Name | Type | Description |
| --------------------------------------- | ------ | ------------- |
| token\* | string | Session token |
{% tabs %}
{% tab title="200 JSON with shortcut configuration" %}
```
{
"shortcuts": [
{
"askConfirm": false,
"category": "shortcut",
"color": "#117ED9",
"desc": "Turn off all lights",
"icon": "house_2",
"id": "abc123",
"itemACL": [
{
"id": "qwerty",
"read": true,
"write": true
}
],
"name": "Demo",
"objectId": "system",
"operations": [
{
"function": {
"args": {},
"name": "turn_off_all_lights"
},
"objectId": "system",
"timer": {
"days": 0,
"hours": 0,
"min": 0,
"sec": 0
}
}
],
"parameters": []
},
{
"askConfirm": false,
"category": "shortcut",
"color": "#FFB300",
"desc": "Toggle TV",
"icon": "tv",
"id": "abc1234",
"itemACL": [
{
"id": "qwerty",
"read": true,
"write": true
}
],
"name": "TV",
"objectId": "ac278aa6-fdd8-4899-960e-55ad702452ce",
"operations": [
{
"function": {
"args": {},
"name": "toggle"
},
"objectId": "ac278aa6-fdd8-4899-960e-55ad702452ce",
"timer": {
"days": 0,
"hours": 0,
"min": 0,
"sec": 0
}
}
],
"parameters": []
},
{
"askConfirm": false,
"category": "shortcut",
"color": "#880E4F",
"desc": "Open/Close gate",
"icon": "gate",
"id": "abc12345",
"itemACL": [
{
"id": "qwerty",
"read": true,
"write": true
}
],
"name": "Gate",
"objectId": "",
"operations": [
{
"function": {
"args": {},
"name": "on"
},
"objectId": "a41f6a53-3b69-44e4-abf2-fed4bed8785c",
"timer": {
"days": 0,
"hours": 0,
"min": 0,
"sec": 0
}
}
],
"parameters": []
}
]
}
```
{% endtab %}
{% endtabs %}
It is possible to avoid using the token in the URL by attaching it to the *Headers*.
### Shortcuts JSON with Headers
`GET` `https://api.ohmautomation.io/control/v1/shortcuts`
As with the previous method, this also retrieves a *JSON* with the shortcut configuration, but the token is indicated in the *Headers*. We recommend this approach since it doesn't expose the token in the URL.
**Headers**
| Name | Type | Description |
| ------------------------------------------------- | ------ | ------------------ |
| Content-Type | string | `application/json` |
| X-Session-Token\* | string | Session token |
{% tabs %}
{% tab title="200" %}
```
{
"shortcuts": [
{
"askConfirm": false,
"category": "shortcut",
"color": "#117ED9",
"desc": "Turn off all lights",
"icon": "house_2",
"id": "abc123",
"itemACL": [
{
"id": "qwerty",
"read": true,
"write": true
}
],
"name": "Demo",
"objectId": "system",
"operations": [
{
"function": {
"args": {},
"name": "turn_off_all_lights"
},
"objectId": "system",
"timer": {
"days": 0,
"hours": 0,
"min": 0,
"sec": 0
}
}
],
"parameters": []
},
{
"askConfirm": false,
"category": "shortcut",
"color": "#FFB300",
"desc": "Toggle TV",
"icon": "tv",
"id": "abc1234",
"itemACL": [
{
"id": "qwerty",
"read": true,
"write": true
}
],
"name": "TV",
"objectId": "ac278aa6-fdd8-4899-960e-55ad702452ce",
"operations": [
{
"function": {
"args": {},
"name": "toggle"
},
"objectId": "ac278aa6-fdd8-4899-960e-55ad702452ce",
"timer": {
"days": 0,
"hours": 0,
"min": 0,
"sec": 0
}
}
],
"parameters": []
},
{
"askConfirm": false,
"category": "shortcut",
"color": "#880E4F",
"desc": "Open/Close gate",
"icon": "gate",
"id": "abc12345",
"itemACL": [
{
"id": "qwerty",
"read": true,
"write": true
}
],
"name": "Gate",
"objectId": "",
"operations": [
{
"function": {
"args": {},
"name": "on"
},
"objectId": "a41f6a53-3b69-44e4-abf2-fed4bed8785c",
"timer": {
"days": 0,
"hours": 0,
"min": 0,
"sec": 0
}
}
],
"parameters": []
}
]
}
```
{% endtab %}
{% endtabs %}
### Execute Shortcut
`POST` `https://api.ohmautomation.io/control/v1/shortcut`
**Headers**
| Name | Type | Description |
| ------------------------------------------------- | ------ | ------------------ |
| Content-Type | string | `application/json` |
| X-Session-Token\* | string | Session token |
**Request Body**
| Name | Type | Description |
| ----------------------------------------- | ------ | ----------- |
| id\* | string | Shortcut ID |
| command\* | string | `run` |
{% tabs %}
{% tab title="200" %}
```
```
{% endtab %}
{% endtabs %}
### View Shortcut via Web
`GET` `https://api.ohmautomation.io/control/v1/shortcut?token=abc&link=0&lang=it`
This *endpoint* allows viewing and executing a shortcut.
**Query Parameters**
| Name | Type | Description |
| --------------------------------------- | ------ | ---------------------------------- |
| token\* | string | Session token |
| id\* | string | Shortcut ID |
| lang | string | Display language (`en` by default) |
{% tabs %}
{% tab title="200 Web page for executing the shortcut" %}
```
HTML
```
{% endtab %}
{% endtabs %}
# OHMq Specifications
Specifications for integrating third-party devices.
To facilitate the integration of third-party devices compatible with the *MQTT* protocol, specifications have been defined to easily communicate with an *Ohm Automation* home automation system.
## MQTT Protocol
Communication occurs over the local network using the *MQTT* protocol and requires adherence to a specific format for *topics* and *payloads*.
### Topics
Topics are generally defined as follows:
```
ohmq////
```
Where:
* `ohmq`: required prefix.
* `device_id`: ID of the device to integrate, which must be unique. It is preferable to use the *MAC address* without the `:`.
* `message_type`: defines the type of message, such as a state message (`state`) or command (`command`).
* `category`: if the message is directed at a specific element, it indicates its category (e.g., `board`, `output`, etc.).
* `item_id`: ID of the board element to which the message refers.
For example, the topic `ohmq/a861a504ab/command/output/R1` refers to a message to execute a command on the output with ID `R1` belonging to the device `a861a504ab` (a more specific example will follow).
{% hint style="info" %}
`item_id` refers to the element ID, which is typically aligned with the coding assigned to it (e.g., written on the terminal); there are no strict constraints on the format of the ID, but it must be unique to the device. If the output represents the first relay on the board, its coding (and thus its ID) might be `R1`.
{% endhint %}
There is also a "universal" topic that all boards supporting *OHMq* specifications must subscribe to:
```
ohmq/universe
```
Messages sent to this topic must be handled by all devices, and in particular, all boards must support the [Discovery](#discovery).
### Payload
The *payload* is generally in JSON format, and its content varies depending on the type of message.
The two main types of messages are:
* `state`: state message.
* `command`: command message.
#### **Command Messages**
Command messages must always contain the `action` field, which defines the operation to be performed. For example, to turn on an output, the message would be:
```json
{
"action": "on"
}
```
{% hint style="warning" %}
Important Command messages must always be sent with the `retain` setting set to `false`, as they should not be stored but only have value at the moment they are sent.
{% endhint %}
#### **State Messages**
State messages must be sent to notify the system of a change in the state of a given element. For example, after turning on a light, the message might be:
```json
{
"on": true,
"value": 255
}
```
When a button is pressed, the message would be:
```json
{
"value": 1
}
```
{% hint style="warning" %}
Important State messages require the `retain` setting to be `true`, allowing the state to be recovered later.
{% endhint %}
## Discovery
All boards must support this functionality as it is the official way to allow the system to discover the boards.
To ensure this function, boards must *subscribe* to the `ohmq/universe` topic and respond with their configuration to the following message:
```json
{
"action": "announce"
}
```
The configuration must be sent in JSON format and should look something like:
```json
{
"id": "a861a504ab",
"name": "Example",
"model": "ESP32",
"ip": "192.168.0.x",
"mac": "00:00:00:00:00",
"supported_commands": ["find", "set_network", "set_name", "restart"],
"outputs": [{"code": "R1", "n": 14}],
"inputs": [{"code": "I1", "n": 16}],
"sensors": [{"code": "S1", "n": 2}]
}
```
Fields of particular interest include:
* `supported_commands`: indicates the types of commands supported by the board (e.g., `find` indicates the ability to be visually located, perhaps with a flashing or color-changing LED).
* `outputs` / `inputs`: the list of outputs/inputs managed by the board.
The configuration message should be sent to the following topic:
```
ohmq//hi
```
### mDNS
To enable quicker and easier implementation, support is provided for the `_mqtt._tcp.local.` service of *mDNS*, allowing connection to the broker using `ohmb-master.local` as the hostname and `1883` as the port.
## Categories
The main categories are:
* `board`: represents the board.
* `output`: for managing outputs.
* `input`: for managing digital inputs.
* `sensor`: for managing analog inputs.
### `board`
The topic for sending commands to the board is:
```
ohmb//command/board
```
Commands must always include the `action` parameter, which defines the operation to be performed. Here are the main operations and their corresponding *payload*.
#### **`find`**
This operation allows physically locating the board, useful if there are many devices and it is necessary to identify the correct one for wiring.
The message sent to the board will simply be:
```json
{
"action": "find"
}
```
After receiving this message, any action that allows the visual identification of the device can be performed, such as making a dedicated LED flash.
#### **`restart`**
This operation requires restarting the board, and the message sent will be:
```json
{
"action": "restart"
}
```
#### **`set_name`**
To ensure easy identification of the board in the configuration app, it is recommended to assign a name that allows for easy differentiation between boards. Therefore, the board must support the `set_name` command and implement a strategy for saving the assigned name.
The message received by the board will look like:
```json
{
"action": "set_name",
"name": "Board 1"
}
```
### `output`
Each output is defined as follows:
```json
{
"code": "R1",
"n": 10
}
```
Where `code` indicates the user-visible coding, such as on the terminal, and `n` represents the pin number used on the microcontroller.
When sending the board configuration, it is essential to include at least the `code` parameter, as it is used for MQTT communication.
#### **Commands**
The topic for commands sent to an output is:
```
ohmb//command/output/
```
For simplicity and convenience, the board can subscribe to the topic `ohmb//command/output/+`, using the `_wildcard_` `+`.
As with the board, commands should be sent in JSON format with the `action` parameter, and include:
* `on`: to activate.
* `off`: to deactivate.
* `toggle`: to change the state.
* `set`: to set a value between `0` and `255` for analog outputs.
* `preset`: to set the value of an analog output without activating it, so it takes the desired value only after a subsequent activation.
For example:
```json
{
"action": "set",
"value": 120
}
```
#### **State**
The state of the output should be sent to the topic:
```
ohmb//state/output/
```
{% hint style="warning" %}
It is crucial to send the state every time the element's value changes.
{% endhint %}
The state should be sent as follows:
```json
{
"is_on": false,
"value": 210
}
```
For digital (binary) outputs, the `value` parameter will be `0` (when off) or `255` (when on).
The `is_on` parameter indicates whether the output is on or off. The `value` parameter must be sent for analog outputs, even when the element is off, as it helps restore the previous state upon reactivation.
### `input`
Each input is defined as follows:
```json
{
"code": "I1",
"n": 16
}
```
Where `code` indicates the user-visible coding, such as on the terminal, and `n` represents the pin number used on the microcontroller.
When sending the board configuration, it is essential to include at least the `code` parameter, as it is used for MQTT communication.
#### **State**
The state of the input should be sent to the topic:
```
ohmb//state/input/
```
{% hint style="warning" %}
It is crucial to send the state every time the element's value changes.
{% endhint %}
The state should be sent as follows:
```json
{
"value": 1
}
```
Items in the `input` category are understood as digital (binary) inputs, so they only assume values `0` and `1`. For analog inputs, refer to the `sensor` category.
### `sensor`
Each sensor (analog input) is defined as follows:
```json
{
"code": "S1",
"n": 2
}
```
Where `code` indicates the user-visible coding, such as on the terminal, and `n` represents the pin number used on the microcontroller.
When sending the board configuration, it is essential to include at least the `code` parameter, as it is used for MQTT communication.
#### **State**
The state of the sensor should be sent to the topic:
```
ohmb//state/sensor/
```
{% hint style="warning" %}
For sensors, it is advisable to limit the frequency of data transmission to avoid overloading the MQTT Broker. Except for certain types of sensors (e.g., alarm sensors), there is generally no advantage in sending real-time state changes. It is therefore advisable to implement filters (e.g., exponential smoothing).
{% endhint %}
The state should be sent as follows:
```json
{
"value": 22.5
}
```
# Troubleshooting
Everyone makes mistakes! Here are some suggestions to resolve the most common problems.
## The app is unresponsive or crashes
Whether you have an *Android* or *iOS* device, it is important to check that the app is updated.
If updating doesn't solve the issue, try deleting and reinstalling the app. Once reinstalled, you will need to log in again.
If the problem persists, contact us at , and please provide the following details:
* The platform (*Android* or *iOS*)
* The operating system version (found in your device settings)
* Which page of the app the issue occurs on
* The username of your system
## Error 408
If the app shows **Error 408** where the connection type usually appears (the text *Cloud* or *Local Network*), it means that the system's devices cannot connect to the Cloud, so communication between the app and the system is not possible when you are away from home.
We recommend checking your home internet network. If it's not working, the issue likely lies there. Otherwise, try rebooting the system.
## Connection problem
If the app seems unable to communicate with the system (e.g., you try to turn lights on/off, and nothing happens), check the installed devices and see if any error LEDs are on.
{% hint style="info" %}
If a blue LED is lit on one of the devices, the problem is related to the Cloud connection and might be due to your internet connection. If your internet seems to work, try rebooting the device by pressing the **Reset** button.
{% endhint %}
{% hint style="danger" %}
If a red LED is on, there may be a communication issue between the devices, and therefore, between the devices and the app. Try rebooting the device with the red LED by pressing the **Reset** button. If that doesn't work, try rebooting all the devices.
{% endhint %}
If none of these solutions resolve the issue, contact your trusted technician. You can also submit a support request directly from the app:
* **Android:** go to the app settings by clicking the three dots in the top-right corner, then "Settings." You will find the "Support Request" button there.
* **iOS:** go to the app settings by clicking the gear icon, then the three dots in the top-right corner, and finally the "Support Request" button.
# Introduzione
Ohm Automation rappresenta l'ecosistema di Home Automation (Domotica) offerta da Chiarini Automazioni srl.
{% hint style="info" %}
*OHMe* è l'applicazione che permette agli utenti di interagire con i prodotti dell'ecosistema *Ohm Automation* sviluppato da [Chiarini Automazioni](https://www.chiariniautomazioni.it).
{% endhint %}
L'app *OHMe* è disponibile sia su [Android](https://play.google.com/store/apps/details?id=com.smartface.user\&hl=en_US\&gl=US) che [iOS](https://apps.apple.com/us/app/smartface-chiarini-automazioni/id1038355474).
È possibile interagire con il sistema anche via web, accedendo alla pagina [app.ohmautomation.io](https://app.ohmautomation.io).
I tecnici hanno a disposizione un'app per la configurazione e diagnostica del sistema, disponibile per [Android](https://play.google.com/store/apps/details?id=com.smartface.tech\&hl=en_US\&gl=US).
# Guida Android
Alcuni semplici suggerimenti per aiutarti ad interagire con l'app utente.
L'immagine sottostante mostra l'interfaccia dell'app una volta aperta.
I *Gruppi* non sono altro che un modo per organizzare il tuo sistema. In genere si fanno coincidere con le stanze (soggiorno, camera matrimoniale, ecc.) o con le zone (zona giorno, zona notte, esterno, ecc.).
La guida è suddivisa per argomento e vi consigliamo di procedere con l'ordine suggerito. Buona Lettura!
# Luci
Istruzioni per il controllo delle luci on/off, dimmerabili e RGB.
## Luci Relè
Le luci relè permettono la semplice accensione e spegnimento, ed è sufficiente un *tap* su di esse per cambiarle di stato.
{% hint style="info" %}
La regolazione della luminosità è possibile solo con le luci dimmerabili o RGB.
{% endhint %}
## Luci Dimmerabili
Sono dimmerabili tutte quelle luci che permettono di regolare la luminosità.
Per accendere e spegnere le luci dimmerabili è sufficiente un *tap*, al pari delle normali luci, mentre per impostare la luminosità (valore da 1 a 100%) è necessario un tocco prolungato sulla luce. La schermata sottostante mostra il cursore per la regolazione dell'intensità.
{% hint style="info" %}
La minima luminosità impostabile è pari all'1%, mentre per spegnere completamente la luce è necessario un *tap* su di essa. All'accensione la luce ripristinerà lo stato precedente.
{% endhint %}
## Luci RGB
Sono RGB tutte quelle luci che permettono di impostare un colore. Esistono anche luci RGBW, che presentano anche la regolazione del bianco, così da permettere colori più brillanti.
Come per le luci dimmerabili anche per quelle RGB è sufficiente un *tap* per accendere/spegnere la luce, mentre per la regolazione del colore è necessario un tocco prolungato.
Per cambiare colore devi trascinare il cursore sulla ruota dei colori o cliccare direttamente sul punto desiderato. Puoi anche definire l'intensità del colore, muovendo il cursore della barra sottostante.
Se la luce in questione presenta anche l'impostazione del bianco (nel caso di RGBW), puoi accendere/spegnere il bianco cliccando sul tasto **Imposta Bianco**, mentre con una pressione prolungata si aprirà la finestra per l'impostazione della luminosità (al pari delle luci dimmerabili).
Per impostare la luminosità del bianco è sufficiente muovere il dito sul cursore dedicato.
### Colori Preferiti
Cliccando il tasto `+` è possibile aggiungere il colore selezionato ai preferiti, così da crearsi una palette di colori accessibile rapidamente.
{% hint style="info" %}
I preferiti salvati li potete richiamare premendo il tasto con l'icona di una stella.
{% endhint %}
# Gestione Termostato e Umidostato
Guida che riassume le principali funzionalità del termostato; i passaggi descritti valgono per l'umidostato e in generale per la gestione di qualsiasi sensore per cui è stato attivato il controllo.
L’app permette di regolare la temperatura, di creare eventi settimanali (per una gestione automatica) e di riconoscere quando il carico associato (ad esempio un’elettrovalvola) è entrata in funzione. In questa breve guida mostreremo un semplice esempio.
{% hint style="success" %}
Una volta aperta l’app cliccare sulla stanza/gruppo di cui si vuole regolare la temperatura. Nell’esempio proposto modificheremo la regolazione della stanza Salotto.
{% endhint %}
## Pagina Sensori
Selezionare la pagina dei Sensori (pulsante presente nella barra inferiore) per visualizzare termostati, umidostati, sensori (ecc.) presenti in quella stanza/gruppo.
Nell’immagine potete vedere un solo termostato; la grafica ci permette facilmente di capire l’attuale configurazione:
* la trasparenza e la scritta **`OFF`** ci indicano che è attualmente spento
* la temperatura misurata è di 22.4°C
{% hint style="success" %}
Clicchiamo quindi sul termostato per modificare le impostazioni.
{% endhint %}
## Attivazione e Regolazione
Una volta cliccato sul termostato ci ritroviamo la seguente pagina.
Per attivare il termostato dobbiamo cliccare sull'interruttore presente nella sezione *Attivazione*.
Per regolare la temperatura possiamo usare i pulsanti **`+`** e **`-`** o cliccare sul valore per immettere direttamente il set. Nel caso in cui il termostato permetta di gestire sia il riscaldamento che il raffrescamento, è possibile definire la modalità nella sezione dedicata.
{% hint style="success" %}
Per ora ci limiteremo ad attivare il termostato e ad impostare la temperatura a 23°C. Quindi premiamo il pulsante blu in basso a destra per confermare.
{% endhint %}
Una volta effettuato il salvataggio la grafica del termostato si presenterà come segue.
Dove prima compariva la scritta **`OFF`** ora appare il set di 22.5°C e il termostato non appare più in trasparenza.
Lo sfondo rosso acceso, su cui compare il set, segnala la *chiamata caldo* del termostato, per cui i carichi ad esso associati (es. elettrovalvola) verranno attivati.
Nel caso in cui l'ambiente raggiunga la temperatura di set lo sfondo rosso si presenterà meno intenso, come mostrato nell'immagine seguente.
## Calendario
Per attivare una gestione automatica del termostato è possibile configurare degli eventi nel calendario dedicato.
Per accedere al calendario è sufficiente cliccare sull'icona dedicata presente sul termostato. È possibile accedere al calendario anche dalle impostazioni, scorrendo fino alla sezione **Calendario**.
Una volta aperta la pagina del calendario potete cliccare sul pulsante **+** in basso a destra.
Si aprirà una pagina ricca di opzioni, tra cui in particolare:
* possibilità di definire un nome
* selettore per attivare/disattivare l'evento
* selezione dei giorni della settimana
* orario di inizio e di fine evento
* impostazione del valore di set e della modalità
* se desiderate attivare o disattivare il termostato in quella fascia oraria
* opzione per disattivare il termostato a fine evento
{% hint style="danger" %}
L'opzione *Disattiva a fine evento* (attiva di default) permette di disattivare in automatico il termostato al termine della fascia oraria.
Spesso non si desidera spegnere completamente il termostato, ma piuttosto rimodulare il set con un valore più basso/alto (a seconda che parliamo di caldo o freddo); per fare ciò è necessario disattivare tale opzione e creare altri eventi con il set desiderato.
{% endhint %}
Se ci sono eventi attivi l'icona del calendario verrà visualizzata in blu.
{% hint style="info" %}
Gli eventi presentano di default una gestione impulsiva, quindi anche se vi trovate in una delle fasce orarie che avete configurato potete comunque ritoccare manualmente il set; tale impostazione temporanea verrà mantenuta fintanto che non verrà eseguito un nuovo evento.
{% endhint %}
### Esempio
Nell'evento sottostante abbiamo selezionato tutti i giorni feriali e abbiamo definito la fascia oraria 05:00 - 08:00.
Andiamo quindi ad impostare un set di 20°C e scegliamo *Caldo* come modalità. Disattiviamo inoltre l'opzione *Disattiva a fine evento*, così evitiamo che il termostato venga disattivato al termine della fascia oraria.
{% hint style="success" %}
Premiamo quindi su *Salva* in alto a destra per confermare la nostra configurazione.
{% endhint %}
## Suggerimenti
Se tenete premuto sul termostato vi comparirà un'interfaccia più semplice, da cui potete rapidamente regolare il set.
Potete inoltre accedere rapidamente al termostato premendo sul valore di temperatura presente sulle stanze/gruppi della schermata principale; anche in questo caso, in seguito ad una lunga pressione, verrà visualizzata la schermata di set rapido.
# Sistema di Allarme
Tutto quello che ti serve sapere per gestire il tuo sistema di allarme.
L'app è stata progettata per permetterti di attivare e disattivare il Sistema di Allarme il più velocemente possibile, ecco perché nella schermata principale trovi bene in vista il lucchetto che ti segnala se è attivo o meno.
{% hint style="info" %}
Il lucchetto è presente sia nella barra in alto, sia nella sezione dedicata alle informazioni di stato del sistema.
{% endhint %}
Quando il sistema di allarme è attivo, il lucchetto appare chiuso e verde, come mostrato nella foto seguente.
Nel caso in cui il sistema rilevi una presenza indesiderata o una manomissione, il lucchetto verrà sostituito da una campanella rossa.
## Attivazione / Disattivazione
Per attivare o disattivare il Sistema di Allarme è sufficiente cliccare su uno dei due lucchetti nella schermata principale.
Una volta cliccato il tasto con il lucchetto si aprirà una finestra che permette di inserire la password e di eseguire una delle seguenti operazioni:
* Tasto **Disattiva** (lucchetto aperto): **disattivazione** allarme
* Tasto **Attiva** (lucchetto chiuso): **attivazione** allarme
* Tasto **Impostazioni Avanzate**: per accedere ad una gestione più completa
Inserite la password, quindi cliccate sul pulsante per effettuare l'operazione desiderata.
{% hint style="warning" %}
La password va sempre inserita, anche per accedere alle **Impostazioni Avanzate**.
{% endhint %}
## Controllo Biometrico
Per velocizzare ulteriormente le operazioni sul sistema di allarme è possibile attivare il controllo biometrico (sia facciale che impronta), così da evitare l'immissione della password.
{% hint style="warning" %}
Per poter attivare la seguente funzione è necessario che il controllo biometrico sia stato attivato sul vostro dispositivo.
{% endhint %}
Per sfruttare il controllo biometrico dovete accedere alle impostazioni dell'applicazione.
Cliccate sull'icona rossa e confermate l'attivazione di tale funzionalità seguendo le indicazioni a schermo.
{% hint style="info" %}
Su Android ogni dispositivo presenta una differente gestione del controllo biometrico (i sensori usati sono tra loro molto diversi), quindi non esiste un processo uniformato tra i vari produttori di smartphone/tablet.
{% endhint %}
Una volta completata tale operazione l'icona dovrebbe apparire verde.
Tornate quindi nella schermata principale e cliccate sul lucchetto. Ora vi verrà richiesto di effettuare il controllo biometrico, e in caso di verifica positiva, la password verrà inserita automaticamente.
## Impostazioni Avanzate
Accedendo alle impostazioni avanzate avrete modo di gestire i sensori di allarme singolarmente, e nel caso in cui siano stati configurati più settori di allarme, avrete la possibilità di gestire le zone separatamente.
Il tasti in basso permettono di impostare rapidamente tutti i settori sulla medesima modalità.
Cliccando sul settore di allarme potete accedere alla lista dei sensori associati.
{% hint style="info" %}
Se è stato configurato un solo settore di allarme vedrete direttamente la lista dei sensori di allarme.
{% endhint %}
Premendo su una delle tre opzioni (disattivato, attivato o escluso) potete impostare la modalità di funzionamento di ogni singolo sensore. Per salvare premete il tasto blu in basso a destra.
## Cosa significa Esclusione?
Escludere un sensore di allarme permette di rimuoverlo temporaneamente dalla gestione del sistema di allarme, come se non esistesse, così da evitare che segnali ad esempio delle manomissioni (o tamper) nel caso di un guasto.
{% hint style="info" %}
Escludere tutti i sensori di allarme può essere utile nei casi in cui sia saltata la corrente, evento che viene rilevato come manomissione dell'impianto di allarme.
{% endhint %}
## Manomissione / Tamper
L'evento di manomissione (o tamper) può essere rilevato nei seguenti casi:
* Sensore di allarme guasto
* Mancata comunicazione tra sensori di allarme e sirena, a causa di problemi alla rete dati o nel caso in cui una scheda sia guasta o sia stata scollegata o appunto manomessa
* Mancanza di alimentazione
* Riavvio del Sistema Domotico
* Reale manomissione
* Modifiche alla configurazione da parte di un tecnico usando l'app **OHMe Tech**
{% hint style="warning" %}
È molto importante sottolineare che un Sistema di Allarme lavora con la **logica della prevenzione** e quindi è possibile che vengano segnalate delle manomissioni anche nel caso in cui la corrente sia mancata a causa del vostro gestore, o per sovraccarico, e quindi non a causa di malintenzionati.
Non essendoci modo di capire la causa dell'interruzione del servizio, il sistema rileva comunque la manomissione e la sirena suona.
Spesso i Sistemi di Allarme vengono dotati di una **chiave per escludere la sirena**, così da evitare che suoni quando sono previste interruzioni di corrente o interventi sull'impianto.
{% endhint %}
# Irrigazione
Le funzioni principali per la cura del tuo giardino, ovunque tu sia.
Per accedere al Sistema di Irrigazione è sufficiente premere i tre puntini in alto a destra, quindi il tasto *Irrigazione*.
## Le Basi
Gestire l'irrigazione è un pò come ascoltare la musica, i pulsanti principali sono infatti i seguenti:
* **Avvia:** premi il tasto verde con il simbolo di un irrigatore per avviare il ciclo di irrigazione.
* **Pausa:** hai dimenticato di spostare qualcosa dal prato? Sospendi temporaneamente il ciclo premendo il tasto blu. Premendo nuovamente il tasto *Avvia* il ciclo ripartirà da dove lo hai sospeso.
* **Stop:** con il tasto rosso puoi fermare completamente il ciclo. Premendo nuovamente il tasto *Avvia* il ciclo ripartirà dall'inizio.
* **Indietro / Avanti:** questi due tasti ti permettono di tornare alla fase precedente o di passare alla successiva.
{% hint style="info" %}
Abbiamo parlato di *ciclo di irrigazione*, poiché è essenziale suddividere il giardino in zone per garantire una pressione dell'impianto adeguata, assicurando così un corretto apporto di acqua. Ogni zona corrisponde a una fase specifica del ciclo.
{% endhint %}
Oltre ai pulsanti principali questi sono gli elementi che trovate nella pagina:
* **Previsioni Meteo:** se siete lontani da casa sono utili per evitare di irrigare quando piove.
* **Pluviometro:** se avete installato un sensore di pioggia potete conoscere lo stato del vostro prato; il sistema eviterà automaticamente di avviare il ciclo di irrigazione se il giardino risulterà sufficientemente umido.
* **Informazioni Ciclo di Irrigazione:** qui trovate un riassunto di quanto sta succedendo; se il ciclo è in esecuzione, la percentuale di completamento e qual è la fase (zona) irrigata in quel momento.
* **Zone / Fasi:** a seguire trovate le zone/fasi che sono state configurate e di cui potete modificare il tempo, l'ordinamento e il nome.
{% hint style="info" %}
È possibile legare l'irrigazione alle condizioni meteo, così da evitare automaticamente l'avvio del ciclo se è prevista pioggia; contattate il vostro tecnico per attivare questa opzione.
Ricordiamo che trattandosi di *previsioni* non è possibile ottenere le medesime prestazioni di un pluviometro.
{% endhint %}
## Zone / Fasi
Quando parliamo di *zone* o *fasi*, intendiamo fondamentalmente la stessa cosa. Ogni zona del giardino è associata a una specifica fase del ciclo di irrigazione. È sulle fasi che avete la possibilità di intervenire per gestire il sistema.
La casella che rappresenta la zona (o fase) è caratterizzata da:
* **Pulsante Play:** se desiderate irrigare una zona specifica potete premere il pulsante *play* e scegliere se avviare solo quella fase o anche le successive.
* **Nome:** il nome vi permette di distinguere le diverse fasi e [potete modificarlo](#modificare-la-configurazione) a vostro piacimento.
* **Durata:** la durata della fase è espressa in minuti e potete modificarla premendo direttamente sul valore.
* **Percentuale di Completamento:** il valore percentuale indica lo stato di avanzamento della specifica fase.
### Modificare la Configurazione
Per modificare la configurazione delle fasi dovete premere i tre puntini in alto a destra, quindi il tasto *Modifica.*
Queste le operazioni che potete effettuare:
* **Ordinare le Fasi:** per riordinare le fasi è sufficiente effettuare una pressione prolungata sulla fase da spostare, quindi potete trascinarla dove desiderate.
* **Modificare il Nome:** cliccate direttamente sul testo.
* **Modificare la Durata:** cliccate direttamente sul valore.
Una volta completate le modifiche dovete premere nuovamente i tre puntini in alto a destra, quindi *Termina Modifica* (premete il tasto *Annulla* se desiderate scartarle)*.*
## Calendario
L'ideale è programmare un'esecuzione automatica del ciclo di irrigazione, mentre l'avvio o lo stop *manuale* sarà riservato a casi isolati.
Per configurare la programmazione dovete premere il pulsante con i tre puntini in alto a destra, quindi il tasto *Calendario*.
Una volta che avete aperto la pagina del calendario, premendo il tasto **+** in basso a destra potete procedere con la creazione di un evento; premendo i tre puntini in alto a destra è possibile attivare/disattivare tutti gli eventi configurati.
### Creazione Evento
La creazione di un evento è piuttosto semplice e vi permette di impostare un nome per l'evento (es. *Irrigazione Serale*), di definire l'orario di avvio del ciclo e i giorni della settimana per cui volete attivare tale configurazione.
{% hint style="info" %}
Se desiderate irrigare più di una volta al giorno dovete creare un numero equivalente di eventi.
{% endhint %}
{% hint style="info" %}
Per modificare un evento già creato è sufficiente cliccarci sopra.
{% endhint %}
# Programmazione Oraria
La programmazione oraria ti permette di eseguire una serie di operazioni all'orario e nei giorni della settimana desiderati, automatizzando così le tue *routine*.
Clicca sui tre puntini in alto a destra, quindi sul tasto *Programmazione*.
Per aggiungere nuovi eventi è sufficiente cliccare sul tasto **+** in basso a destra.
Potete definire l'orario di esecuzione e i giorni della settimana per i quali volete che sia valida la programmazione; cliccate su *Imposta Operazioni* per definire la lista di operazioni che desiderate (potete definirne quante ne volete).
# Automazioni
Grazie alle Automazioni, puoi rendere la tua casa più intelligente automatizzando le abitudini quotidiane e semplificando l'interazione con il tuo sistema.
{% hint style="info" %}
Esempio: se piove e tutti sono fuori casa, allora chiudi tutte le finestre.
{% endhint %}
## Se questo, allora quello
La configurazione delle automazioni è davvero facile, ogni comando e condizione configurata viene tradotta in semplice testo, così potete verificare di aver configurato correttamente le vostre regole.
Potete sempre verificare l'ultima esecuzione di ciascuna delle vostre automazioni e controllare quali condizioni sono verificate, così da poter testare la vostra configurazione. Inoltre ogni esecuzione viene registrata nello storico accessibile dall'app.
L'interfaccia utente permette di configurare automazioni semplici, senza il rischio di compromettere il sistema. Automazioni più avanzate sono possibili, ma richiedono l'intervento del tuo tecnico di fiducia.
## Esempio
Clicca sul tasto `+` in basso a destra.
Assegna un nome e una descrizione alla tua automazione per renderla facilmente riconoscibile.
Premi il pulsante **Imposta Condizioni** per definire le condizioni necessarie all'esecuzione dell'automazione.
Dopo aver configurato le condizioni, definisci le operazioni desiderate. Premi il tasto **Imposta Operazioni** per procedere.
## Verifica Aggiornamento
Questa funzionalità richiede che il sistema sia aggiornato almeno alla versione **24.09.24**. Se il tuo sistema non è aggiornato, richiedi al tuo tecnico l'aggiornamento gratuito.
{% hint style="warning" %}
Non tutti i sistemi sono attualmente compatibili. Se hai dubbi, contattaci direttamente.
{% endhint %}
# Configura Operazioni
La prima cosa da fare è scegliere l'elemento su cui verrà eseguita l'operazione.
Una volta definito l'elemento è possibile cliccare sul tasto **Scegli Funzione** e selezionare l'operazione da eseguire.
{% hint style="info" %}
Se desideri eseguire l'operazione con un ritardo, puoi definire un timer; questa configurazione è molto utile nel caso siano state configurate altre operazioni. Se ad esempio volete che una luce stia accesa per 30 secondi, potete configurare una prima operazione che accenda la luce in questione, ed una seconda operazione che la spenga con un ritardo di 30 secondi.
{% endhint %}
# Configura Condizione
La prima cosa da fare è scegliere l'elemento su cui verrà valutata la condizione.
Una volta definito l'elemento è possibile cliccare sul tasto **Scegli Funzione** e selezionare la funzione che deve essere verificata.
{% hint style="info" %}
Se desideri che la condizione venga soddisfatta solo se lo stato selezionato persiste per un tempo minimo, puoi configurare un timer.
{% endhint %}
# Scorciatoie
Le *Scorciatoie* sono una delle funzioni più utili, perché ti permettono di eseguire in un colpo solo numerose operazioni.
{% hint style="info" %}
Le Scorciatoie create dal tuo tecnico sono legate al sistema e quindi non possono essere modificate (puoi comunque nasconderle), ma accedendo alla pagina dedicata, puoi aggiungerne di nuove.
{% endhint %}
Clicca sul tasto con i tre puntini in alto a destra, quindi su *Modifica*.
Per aggiungere una nuova Scorciatoia è sufficiente cliccare sul tasto **+** in basso a destra.
Puoi personalizzare l'aspetto (colore e icona), assegnare un nome e una descrizione, definire le operazioni e l'eventuale stato di un elemento.
# Scorciatoie Condivise
Le Scorciatoie possono essere condivise facilmente anche con utenti che non possiedono l'applicazione, grazie alla generazione di un *link* personalizzato che può essere inviato tramite messaggio o e-mail.
Ecco un esempio di link generato dall'applicazione (cliccalo per visualizzarlo nel tuo browser):
Prima di tutto è necessario accedere alla pagina delle Scorciatoie cliccando sull'icona con la manina in alto a destra.
Per condividere una scorciatoia è sufficiente effettuare una pressione prolungata sulla Scorciatoia desiderata.
## Creazione Link
La finestra che si aprirà consente di creare il link e personalizzarne le impostazioni di utilizzo.
### Nome Collegamento
Rappresenta il nome identificativo del *link* condiviso, che faciliterà la gestione successiva. Questo nome verrà utilizzato per registrare gli utilizzi nello Storico del sistema e come titolo delle notifiche (se attivate).
{% hint style="success" %}
Le strutture ricettive possono utilizzare questo campo per impostare il nome degli ospiti, facilitando la gestione dei collegamenti.
{% endhint %}
### Validità
Consente di limitare la disponibilità del link nel tempo.
Impostando una data futura nel campo *Valido da*, il link sarà visualizzabile nel browser, ma la Scorciatoia non potrà essere eseguita fino alla data specificata. L'utente riceverà un messaggio informativo con l'indicazione della data di attivazione.
Il campo *Scadenza* permette di eliminare automaticamente il link alla data stabilita. Gli utenti che tenteranno di aprire il link dopo la scadenza visualizzeranno un messaggio di errore.
### Restrizioni
Questa funzione permette di restringere ulteriormente la validità del link, limitandola a specifici giorni della settimana e fasce orarie.
### Notifica
Compilando questo campo, riceverai una notifica ogni volta che la Scorciatoia Condivisa viene eseguita. Il titolo della notifica corrisponderà al nome del collegamento, mentre il contenuto sarà il testo personalizzato inserito.
### Password
Attivando questa opzione, l'utente dovrà inserire una password per poter eseguire la Scorciatoia, aggiungendo un livello di sicurezza aggiuntivo.
## Gestione Scorciatoie Condivise
Cliccando sui tre puntini in alto a destra nella schermata delle *Scorciatoie*, è possibile selezionare l'opzione *Scorciatoie Condivise*.
Da questa sezione è possibile eliminare i link esistenti (cliccando sul cestino) o modificarli (cliccandoci sopra).
{% hint style="success" %}
Le strutture ricettive possono modificare il campo *Validità* in base ai nuovi orari di check-in e check-out degli ospiti, mantenendo sempre aggiornate le autorizzazioni di accesso.
{% endhint %}
# Preferiti
Per aggiungere le scorciatoie più usate alla *Home* è sufficiente cliccare sui tre puntini in alto a destra, quindi **Imposta Preferiti**.
Si aprirà una pagina che ti permetterà di scegliere le Scorciatoie da aggiungere come preferiti, quindi clicca il tasto in basso a destra per confermare.
Di seguito un esempio di come vengono visualizzati i preferiti.
{% hint style="info" %}
Per riordinare i preferiti è sufficiente tenere premuto sull'elemento che desideri spostare.
{% endhint %}
# Meteo
Il sistema aggiorna frequentemente i dati sulle previsioni meteo correnti, permettendo di visualizzare numerose informazioni, tra cui:
* Temperatura
* Umidità
* Precipitazioni
* Vento
* Visibilità
* Qualità dell'Aria
* Alba/Tramonto
{% hint style="info" %}
Tali informazioni possono essere sfruttate nelle Automazioni, e quindi potete ad esempio accendere le luci esterne dopo il tramonto, o disattivare la VMC se l'umidità esterna è troppo elevata.
{% endhint %}
Per accedere alla pagina con tutte le informazioni dovete cliccare sulla casella del meteo nella schermata principale.
{% hint style="warning" %}
Alcune informazioni (es. qualità dell'aria) richiedono che il sistema sia aggiornato alle versioni più recenti.
{% endhint %}
# Multi Impianto
Può capitare di avere più sistemi (casa, ufficio, casa vacanze, ecc.) e quindi di voler accedere a ciascuno di essi rapidamente.\
Questa guida vi spiega come procedere.
Se avete effettuato l'accesso ad un solo impianto, dalla schermata principali dovete cliccare su •••, quindi sull'opzione **Sistemi**.
Nella pagina **Sistemi** cliccate su •••, quindi scegliete l'opzione **Aggiungi Sistema**.
Inserite le credenziali del nuovo sistema e premete **Accedi**.
L'app si collegherà in automatico al nuovo sistema. Per cambiare impianto è sufficiente cliccare sulla casella specifica.
Una volta che avete effettuato l'accesso a più di un sistema, l'icona di una casa vi comparirà in alto nella schermata principale, così da velocizzare la connessione ai vari impianti.
# Recupero Password
Nel caso non ricordassi più la password, puoi richiedere un ripristino accedendo alle impostazioni dell'app utente.
Clicca quindi sui tre puntini in alto a destra e seleziona la voce *Ripristina Password Utente*.
Verrà quindi inviata una email all'indirizzo associato al tuo account. Clicca quindi il pulsante *Recupera Password* sull'email ricevuta.
Si aprirà automaticamente una finestra sul tuo browser predefinito. Ti verrà quindi richiesto di scrivere due volte la nuova password (la seconda volta per conferma).
{% hint style="warning" %}
Il ripristino della password richiede che all'account sia stato associato un indirizzo email corretto. Se non ricevi il link di ripristino al tuo indirizzo email, è possibile che sia stato associato un indirizzo differente.
È possibile cambiare l'indirizzo email anche dall'app ma si deve essere in possesso della password. In caso contrario vi chiediamo di contattarci direttamente.
{% endhint %}
# Eliminazione Account
La procedura di eliminazione dell'account richiede particolare attenzione. Al fine di evitare eventuali errori da parte dell'utente, abbiamo istituito un processo che gestiamo internamente. *Prima di procedere, eseguiamo una verifica delle ragioni che hanno motivato tale decisione.*
{% hint style="danger" %}
Nel caso in cui l'account coincida con il proprietario del Sistema, la sua eliminazione corrisponde all'eliminazione del Sistema e di tutti i dati correlati.
{% endhint %}
{% hint style="info" %}
Se l'account in vostro possesso corrisponde ad un utente secondario, potete richiedere l'eliminazione al tecnico che ha configurato l'impianto.
{% endhint %}
## Richiedere l'eliminazione
La richiesta di eliminazione può essere inviata direttamente dall'app, ma è possibile contattare il supporto all'indirizzo .
Per inviare una richiesta di eliminazione è necessario accedere alle impostazioni dell'app, quindi cliccare i tre puntini in alto a destra e selezionare l'opzione *Elimina Account*.
Si aprirà una finestra in cui ti sarà chiesto di specificare le motivazioni della cancellazione.
Cliccando *Invia Richiesta* verrà avviato il processo di verifica.
# Guida iOS
Alcuni semplici suggerimenti per aiutarti ad interagire con l'app utente.
L'immagine sottostante mostra l'interfaccia dell'app una volta aperta.
I *Gruppi* non sono altro che un modo per organizzare il tuo sistema. In genere si fanno coincidere con le stanze (soggiorno, camera matrimoniale, ecc.) o con le zone (zona giorno, zona notte, esterno, ecc.).
La guida è suddivisa per argomento e vi consigliamo di procedere con l'ordine suggerito. Buona Lettura!
# Luci
Istruzioni per il controllo delle luci dimmerabili e RGB.
## Luci Relè
Le luci relè permettono la semplice accensione e spegnimento, ed è sufficiente un *tap* su di esse per cambiarle di stato.
{% hint style="info" %}
La regolazione della luminosità è possibile solo con le luci dimmerabili o RGB.
{% endhint %}
## Luci Dimmerabili
Sono dimmerabili tutte quelle luci che permettono di regolare la luminosità.
Per accendere e spegnere le luci dimmerabili è sufficiente un *tap*, al pari delle normali luci, mentre per impostare la luminosità (valore da 1 a 100%) è necessario un tocco prolungato sulla luce per aprire la schermata di regolazione.
La schermata sottostante mostra il cursore per la regolazione dell'intensità.
{% hint style="info" %}
La minima luminosità impostabile è pari all'1%, mentre per spegnere completamente la luce è necessario un *tap* su di essa, o sul tasto *power* nella schermata di regolazione. All'accensione la luce ripristinerà lo stato precedente.
{% endhint %}
## Luci RGB
Sono RGB tutte quelle luci che permettono di impostare un colore. Esistono anche luci RGBW, che presentano anche la regolazione del bianco, così da permettere colori più brillanti.
Come per le luci dimmerabili anche per quelle RGB è sufficiente un *tap* per accendere/spegnere la luce, mentre per la regolazione del colore è necessario un tocco prolungato, così da aprire la schermata dedicata.
Per cambiare colore devi trascinare il cursore sulla ruota dei colori o cliccare direttamente sul punto desiderato. Puoi anche definire l'intensità del colore, muovendo il cursore della barra sottostante.
Se la luce in questione presenta anche l'impostazione del bianco (nel caso di RGBW), puoi regolare il bianco nell'apposita sezione.
Per impostare la luminosità del bianco è sufficiente muovere il dito sul cursore dedicato, mentre per l'accensione/spegnimento del bianco è sufficiente un *tap* sul tasto a destra del cursore.
### Colori Preferiti
Cliccando il tasto `+` è possibile aggiungere il colore selezionato ai preferiti, così da crearsi una palette di colori accessibile rapidamente.
# Gestione Termostato e Umidostato
Guida che riassume le principali funzionalità del termostato; i passaggi descritti valgono per l'umidostato e in generale per la gestione di qualsiasi sensore per cui è stato attivato il controllo.
L’app permette di regolare la temperatura, di creare eventi settimanali (per una gestione automatica) e di riconoscere quando il carico associato (ad esempio un’elettrovalvola) è entrata in funzione. In questa breve guida mostreremo un semplice esempio.
{% hint style="success" %}
Una volta aperta l’app cliccare sulla stanza/gruppo di cui si vuole regolare la temperatura. Nell’esempio proposto modificheremo la regolazione della stanza *Camera*.
{% endhint %}
## Pagina Sensori
Selezionare la pagina dei Sensori (pulsante presente nella barra inferiore) per visualizzare termostati, umidostati, sensori (ecc.) presenti in quella stanza/gruppo.
Nell’immagine potete vedere un solo termostato; la grafica ci permette facilmente di capire l’attuale configurazione:
* la trasparenza e la scritta **`OFF`** ci indicano che è attualmente spento
* la temperatura misurata è di 28.9°C
{% hint style="success" %}
Clicchiamo quindi sul termostato per modificare le impostazioni.
{% endhint %}
## Attivazione e Regolazione
Una volta cliccato sul termostato ci ritroviamo la seguente pagina.
Per attivare il termostato dobbiamo cliccare sul pulsante *power* `⏻`.
Per regolare la temperatura possiamo usare i pulsanti **`-`** e **`+`** o cliccare sul valore per immettere direttamente il set. Nel caso in cui il termostato permetta di gestire sia il riscaldamento che il raffrescamento, è possibile definire la modalità nella sezione dedicata.
{% hint style="success" %}
Per ora ci limiteremo ad attivare il termostato e ad impostare la temperatura a 27°C. Quindi premiamo il pulsante Salva in alto a destra `✓`.
{% endhint %}
Una volta effettuato il salvataggio la grafica del termostato si presenterà come segue.
Dove prima compariva la scritta **`OFF`** ora appare il set di 27°C e il termostato non appare più in trasparenza.
Lo sfondo blu acceso, su cui compare il set, segnala la *chiamata freddo* del termostato, per cui i carichi ad esso associati (es. elettrovalvola) verranno attivati.
Nel caso in cui l'ambiente raggiunga la temperatura di set lo sfondo blu si presenterà meno intenso, come mostrato nell'immagine seguente.
## Calendario
Per attivare una gestione automatica del termostato è possibile configurare degli eventi nel calendario dedicato.
Per accedere al calendario è sufficiente cliccare sull'icona dedicata presente sul termostato.
Una volta aperta la pagina del calendario per creare un nuovo evento cliccare sul pulsante `+` in alto a destra, quindi si aprirà la seguente schermata.
Oltre a definire il nome dell’evento, è possibile selezionare i giorni della settimana e l’orario di inizio e fine evento. Inoltre è possibile definire il set desiderato e la modalità (caldo/freddo).
Di seguito le opzioni principali:
* possibilità di definire un nome
* selettore per attivare/disattivare l'evento
* selezione dei giorni della settimana
* orario di inizio e di fine evento
* impostazione del valore di set e della modalità
* se desiderate attivare o disattivare il termostato in quella fascia oraria
* opzione per disattivare il termostato a fine evento
{% hint style="danger" %}
L'opzione *Disattiva a fine evento* (attiva di default) permette di disattivare in automatico il termostato al termine della fascia oraria.
Spesso non si desidera spegnere completamente il termostato, ma piuttosto rimodulare il set con un valore più basso/alto (a seconda che parliamo di caldo o freddo); per fare ciò è necessario disattivare tale opzione e creare altri eventi con il set desiderato.
{% endhint %}
Se ci sono eventi attivi l'icona del calendario verrà visualizzata in blu.
{% hint style="info" %}
Gli eventi presentano di default una gestione impulsiva, quindi anche se vi trovate in una delle fasce orarie che avete configurato potete comunque ritoccare manualmente il set; tale impostazione temporanea verrà mantenuta fintanto che non verrà eseguito un nuovo evento.
{% endhint %}
### Esempio
Nell'evento sottostante abbiamo selezionato tutti i giorni e abbiamo definito la fascia oraria 19:00 - 23:00.
Andiamo quindi ad impostare un set di 26.5°C e scegliamo *Freddo* come modalità. Disattiviamo inoltre l'opzione *Disattiva a fine evento*, così evitiamo che il termostato venga disattivato al termine della fascia oraria.
{% hint style="success" %}
Premiamo quindi su *Salva* in alto a destra per confermare la nostra configurazione.
{% endhint %}
## Suggerimenti
Se tenete premuto sul termostato vi comparirà un'interfaccia più semplice, da cui potete rapidamente regolare il set.
Potete inoltre accedere rapidamente al termostato premendo sul valore di temperatura presente sulle stanze/gruppi della schermata principale; anche in questo caso, in seguito ad una lunga pressione, verrà visualizzata la schermata di set rapido.
# Sistema di Allarme
Tutto quello che ti serve sapere per gestire il tuo sistema di allarme.
L'app è stata progettata per permetterti di attivare e disattivare il Sistema di Allarme il più velocemente possibile, ecco perché nella schermata principale trovi bene in vista lo scudo che ti segnala se è attivo o meno.
{% hint style="info" %}
Lo scudo è presente sia nella barra in alto, sia nella sezione dedicata alle informazioni di stato del sistema.
{% endhint %}
Quando il sistema di allarme è attivo, lo scudo appare verde e con un segno di spunta `✔`, come mostrato nella foto seguente.
Nel caso in cui il sistema rilevi una presenza indesiderata o una manomissione, lo scudo verrà sostituito da una campanella rossa.
## Attivazione / Disattivazione
Per attivare o disattivare il Sistema di Allarme è sufficiente cliccare sullo scudo nella schermata principale.
Una volta cliccato il tasto con lo scudo si aprirà una finestra che permette di gestire il Sistema di Allarme.
{% hint style="warning" %}
Ogni operazione (attivazione/disattivazione/esclusione e accesso alle *Impostazioni Avanzate*) richiede l'inserimento della password.
{% endhint %}
## Face ID / Touch ID
Per velocizzare ulteriormente le operazioni sul sistema di allarme è possibile attivare il controllo biometrico (sia facciale che impronta), così da evitare l'immissione della password.
{% hint style="warning" %}
Per poter attivare la seguente funzione è necessario che il controllo biometrico sia stato attivato sul vostro dispositivo.
{% endhint %}
Per sfruttare il controllo biometrico dovete accedere alla schermata del Sistema di Allarme e scorrere verso il basso fino a trovare l'opzione dedicata.
Attivate l'opzione e inserite la password del sistema di allarme nella finestra che verrà visualizzata.
Una volta completata tale operazione, premete su **Salva** e l'opzione dovrebbe quindi apparire verde.
## Impostazioni Avanzate
Accedendo alle *Impostazioni Avanzate* avrete modo di gestire i sensori di allarme singolarmente, e nel caso in cui siano stati configurati più settori di allarme, avrete la possibilità di gestire le zone separatamente.
I 3 tasti in alto permettono di impostare rapidamente tutti i settori sulla medesima modalità.
Cliccando sul settore di allarme è possibile accedere alla lista dei sensori associati.
{% hint style="info" %}
Se è stato configurato un solo settore di allarme vedrete direttamente la lista dei sensori di allarme.
{% endhint %}
Premendo su una delle tre opzioni (disabilita, abilita o escludi) potete impostare la modalità di funzionamento di ogni singolo sensore. Per salvare premete la spunta in alto a destra.
Analogamente al caso dei settori, i tre tasti in alto permettono di impostare rapidamente tutti i sensori sulla medesima modalità.
## Cosa significa Esclusione?
Escludere un sensore di allarme permette di rimuoverlo temporaneamente dalla gestione del sistema di allarme, come se non esistesse, così da evitare che segnali ad esempio delle manomissioni (o tamper) nel caso di un guasto.
{% hint style="info" %}
Escludere tutti i sensori di allarme può essere utile nei casi in cui sia saltata la corrente, evento che viene rilevato come manomissione dell'impianto di allarme.
{% endhint %}
## Manomissione / Tamper
L'evento di manomissione (o tamper) può essere rilevato nei seguenti casi:
* Sensore di allarme guasto
* Mancata comunicazione tra sensori di allarme e sirena, a causa di problemi alla rete dati o nel caso in cui una scheda sia guasta o sia stata scollegata o appunto manomessa
* Mancanza di alimentazione
* Riavvio del Sistema Domotico
* Reale manomissione
* Modifiche alla configurazione da parte di un tecnico usando l'app **OHMe Tech**
{% hint style="warning" %}
È molto importante sottolineare che un Sistema di Allarme lavora con la **logica della prevenzione** e quindi è possibile che vengano segnalate delle manomissioni anche nel caso in cui la corrente sia mancata a causa del vostro gestore, o per sovraccarico, e quindi non a causa di malintenzionati.
Non essendoci modo di capire la causa dell'interruzione del servizio, il sistema rileva comunque la manomissione e la sirena suona.
Spesso i Sistemi di Allarme vengono dotati di una **chiave per escludere la sirena**, così da evitare che suoni quando sono previste interruzioni di corrente o interventi sull'impianto.
{% endhint %}
# Irrigazione
Le funzioni principali per la cura del tuo giardino, ovunque tu sia.
Per accedere al Sistema di Irrigazione è sufficiente premere i tre puntini in alto a destra, quindi l'opzione *Irrigazione*.
## Le Basi
Gestire l'irrigazione è un pò come ascoltare la musica, i pulsanti principali sono infatti i seguenti:
* **Avvia:** premi il tasto blu con il simbolo di un irrigatore per avviare il ciclo di irrigazione.
* **Pausa:** hai dimenticato di spostare qualcosa dal prato? Sospendi temporaneamente il ciclo premendo il tasto giallo. Premendo nuovamente il tasto *Avvia* il ciclo ripartirà da dove lo hai sospeso.
* **Stop:** con il tasto rosso puoi fermare completamente il ciclo. Premendo nuovamente il tasto *Avvia* il ciclo ripartirà dall'inizio.
* **Indietro / Avanti:** questi due tasti ti permettono di tornare alla fase precedente o di passare alla successiva.
{% hint style="info" %}
Abbiamo parlato di *ciclo di irrigazione*, poiché è essenziale suddividere il giardino in zone per garantire una pressione dell'impianto adeguata, assicurando così un corretto apporto di acqua. Ogni zona corrisponde a una fase specifica del ciclo.
{% endhint %}
Oltre ai pulsanti principali questi sono gli elementi che trovate nella pagina:
* **Previsioni Meteo:** se siete lontani da casa sono utili per evitare di irrigare quando piove.
* **Pluviometro:** se avete installato un sensore di pioggia potete conoscere lo stato del vostro prato; il sistema eviterà automaticamente di avviare il ciclo di irrigazione se il giardino risulterà sufficientemente umido.
* **Informazioni Ciclo di Irrigazione:** qui trovate un riassunto di quanto sta succedendo; se il ciclo è in esecuzione, la percentuale di completamento e qual è la fase (zona) irrigata in quel momento.
* **Zone / Fasi:** a seguire trovate le zone/fasi che sono state configurate e di cui potete modificare il tempo, l'ordinamento e il nome.
{% hint style="info" %}
È possibile legare l'irrigazione alle condizioni meteo, così da evitare automaticamente l'avvio del ciclo se è prevista pioggia; contattate il vostro tecnico per attivare questa opzione.
Ricordiamo che trattandosi di *previsioni* non è possibile ottenere le medesime prestazioni di un pluviometro.
{% endhint %}
## Zone / Fasi
Quando parliamo di *zone* o *fasi*, intendiamo fondamentalmente la stessa cosa. Ogni zona del giardino è associata a una specifica fase del ciclo di irrigazione. È sulle fasi che avete la possibilità di intervenire per gestire il sistema.
La casella che rappresenta la zona (o fase) è caratterizzata da:
* **Pulsante Avvia:** se desiderate irrigare una zona specifica potete premere il pulsante *Avvia* e scegliere se avviare solo quella fase o anche le successive.
* **Nome:** il nome vi permette di distinguere le diverse fasi e [potete modificarlo](#modificare-la-configurazione) a vostro piacimento.
* **Durata:** la durata della fase è espressa in minuti e potete modificarla premendo direttamente sul valore.
* **Percentuale di Completamento:** il valore percentuale indica lo stato di avanzamento della specifica fase.
### Modificare la Configurazione
Per modificare la configurazione delle fasi dovete premere il pulsante con l'icona di un pennino in alto a destra.
Queste le operazioni che potete effettuare:
* **Ordinare le Fasi:** per riordinare le fasi è sufficiente effettuare una pressione prolungata sulla fase da spostare, quindi potete trascinarla dove desiderate.
* **Modificare il Nome:** cliccate direttamente sul testo.
* **Modificare la Durata:** cliccate direttamente sul valore.
Una volta completate le modifiche dovete premere il pulsante Salva `✓`; per annullare le modifiche invece potete premere il pulsante Annulla `X`.
## Calendario
L'ideale è programmare un'esecuzione automatica del ciclo di irrigazione, mentre l'avvio o lo stop *manuale* sarà riservato a casi isolati.
Per configurare la programmazione dovete premere il pulsante *Calendario* in alto a destra.
Una volta che avete aperto la pagina del calendario, premendo i tre puntini in alto a destra, potete:
* **Attiva Tutti:** premendo questo tasto potete attivare tutti gli eventi configurati.
* **Disattiva Tutti:** premendo questo tasto potete disattivare tutti gli eventi configurati.
Per aggiungere un nuovo evento dovete premere il pulsante `+` in alto a destra.
### Creazione Evento
La creazione di un evento è piuttosto semplice e vi permette di impostare un nome per l'evento (es. *Mattina*), di definire l'orario di avvio del ciclo e i giorni della settimana in cui verrà eseguito.
{% hint style="info" %}
Se desiderate irrigare più di una volta al giorno dovete creare un numero equivalente di eventi.
{% endhint %}
{% hint style="info" %}
Per modificare un evento già creato è sufficiente cliccarci sopra.
{% endhint %}
# Programmazione Oraria
La programmazione oraria ti permette di eseguire una serie di operazioni all'orario e nei giorni della settimana desiderati, automatizzando così le tue *routine*.
Clicca sui tre puntini in alto a destra, quindi sull'opzione *Programmazione*.
Per aggiungere nuovi eventi è sufficiente cliccare sul pulsante `+` in alto a destra.
Ogni Evento permette di definire l'orario di esecuzione e i giorni della settimana per i quali verrà eseguito; cliccate su *Imposta Operazioni* per definire la lista di operazioni che desiderate (potete definirne quante ne volete).
## Impostazioni Avanzate
Di seguito le opzioni principali:
* *Esegui una volta, quindi eliminalo*: l'evento verrà eseguito una sola volta e successivamente eliminato.
* *Data*: selezionando l'opzione *Data* nella sezione *Quando* è possibile definire un giorno specifico per l'esecuzione dell'evento.
# Automazioni
Grazie alle Automazioni, puoi rendere la tua casa più intelligente automatizzando le abitudini quotidiane e semplificando l'interazione con il tuo sistema.
{% hint style="info" %}
Esempio: se piove e tutti sono fuori casa, allora chiudi tutte le finestre.
{% endhint %}
## Se questo, allora quello
La configurazione delle automazioni è davvero facile, ogni comando e condizione configurata viene tradotta in semplice testo, così potete verificare di aver configurato correttamente le vostre regole.
Potete sempre verificare l'ultima esecuzione di ciascuna delle vostre automazioni e controllare quali condizioni sono verificate, così da poter testare la vostra configurazione. Inoltre ogni esecuzione viene registrata nello storico accessibile dall'app.
L'interfaccia utente permette di configurare automazioni semplici, senza il rischio di compromettere il sistema. Automazioni più avanzate sono possibili, ma richiedono l'intervento del tuo tecnico di fiducia.
## Esempio
Clicca sul tasto `+` in alto a destra.
Assegna un nome e una descrizione alla tua automazione per renderla facilmente riconoscibile.
Premi il pulsante **Imposta Condizioni** per definire le condizioni necessarie all'esecuzione dell'automazione.
Dopo aver configurato le condizioni, definisci le operazioni desiderate. Premi il tasto **Imposta Operazioni** per procedere.
## Verifica Aggiornamento
Questa funzionalità richiede che il sistema sia aggiornato almeno alla versione **24.09.24**. Se il tuo sistema non è aggiornato, richiedi al tuo tecnico l'aggiornamento gratuito.
{% hint style="warning" %}
Non tutti i sistemi sono attualmente compatibili. Se hai dubbi, contattaci direttamente.
{% endhint %}
# Configurazione Operazione
La prima cosa da fare è scegliere l'elemento su cui verrà eseguita l'operazione.
Una volta definito l'elemento è possibile cliccare sul tasto **Scegli Funzione** e selezionare l'operazione da eseguire.
{% hint style="info" %}
Se desideri eseguire l'operazione con un ritardo, puoi definire un timer; questa configurazione è molto utile nel caso siano state configurate altre operazioni. Se ad esempio volete che una luce stia accesa per 30 secondi, potete configurare una prima operazione che accenda la luce in questione, ed una seconda operazione che la spenga con un ritardo di 30 secondi.
{% endhint %}
# Configura Condizione
La prima cosa da fare è scegliere l'elemento su cui verrà valutata la condizione.
Una volta definito l'elemento è possibile cliccare sul tasto **Scegli Funzione** e selezionare la funzione che deve essere verificata.
{% hint style="info" %}
Se desideri che la condizione venga soddisfatta solo se lo stato selezionato persiste per un tempo minimo, puoi configurare un timer.
{% endhint %}
# Scorciatoie
Le *Scorciatoie* sono una delle funzioni più utili, perché permettono di eseguire in un colpo solo numerose operazioni.
{% hint style="info" %}
Le Scorciatoie create dal tuo tecnico sono legate al sistema e quindi non possono essere modificate (puoi comunque nasconderle), ma accedendo alla pagina dedicata, puoi aggiungerne di nuove.
{% endhint %}
Clicca sul tasto con i tre puntini in alto a destra, quindi su *Modifica Configurazione*.
Per aggiungere una nuova Scorciatoia è sufficiente cliccare sul tasto **+** in basso a destra.
Puoi personalizzare l'aspetto (colore e icona), assegnare un nome e una descrizione, definire le operazioni e l'eventuale stato di un elemento.
# Scorciatoie Condivise
Le Scorciatoie possono essere condivise facilmente anche con utenti che non possiedono l'applicazione, grazie alla generazione di un *link* personalizzato che può essere inviato tramite messaggio o e-mail.
Ecco un esempio di link generato dall'applicazione (cliccalo per visualizzarlo nel tuo browser):
Prima di tutto è necessario accedere alla pagina delle Scorciatoie cliccando sull'icona con la manina in alto a sinistra.
Per condividere una scorciatoia è sufficiente effettuare una pressione prolungata sulla Scorciatoia desiderata.
## Creazione Link
La finestra che si aprirà consente di creare il link e personalizzarne le impostazioni di utilizzo.
### Nome Collegamento
Rappresenta il nome identificativo del *link* condiviso, che faciliterà la gestione successiva. Questo nome verrà utilizzato per registrare gli utilizzi nello Storico del sistema e come titolo delle notifiche (se attivate).
{% hint style="success" %}
Le strutture ricettive possono utilizzare questo campo per impostare il nome degli ospiti, facilitando la gestione dei collegamenti.
{% endhint %}
### Validità
Consente di limitare la disponibilità del link nel tempo.
Impostando una data futura nel campo *Valido da*, il link sarà visualizzabile nel browser, ma la Scorciatoia non potrà essere eseguita fino alla data specificata. L'utente riceverà un messaggio informativo con l'indicazione della data di attivazione.
Il campo *Scadenza* permette di eliminare automaticamente il link alla data stabilita. Gli utenti che tenteranno di aprire il link dopo la scadenza visualizzeranno un messaggio di errore.
### Restrizioni
Questa funzione permette di restringere ulteriormente la validità del link, limitandola a specifici giorni della settimana e fasce orarie.
### Notifica
Compilando questo campo, riceverai una notifica ogni volta che la Scorciatoia Condivisa viene eseguita. Il titolo della notifica corrisponderà al nome del collegamento, mentre il contenuto sarà il testo personalizzato inserito.
### Password
Attivando questa opzione, l'utente dovrà inserire una password per poter eseguire la Scorciatoia, aggiungendo un livello di sicurezza aggiuntivo.
## Gestione Scorciatoie Condivise
Cliccando sui tre puntini in alto a destra nella schermata delle *Scorciatoie*, è possibile selezionare l'opzione *Scorciatoie Condivise*.
Da questa sezione è possibile eliminare i link esistenti (tramite pressione prolungata) o modificarli (cliccandoci sopra).
{% hint style="success" %}
Le strutture ricettive possono modificare il campo *Validità* in base ai nuovi orari di check-in e check-out degli ospiti, mantenendo sempre aggiornate le autorizzazioni di accesso.
{% endhint %}
# Preferiti
Per aggiungere le scorciatoie più usate alla *Home* è sufficiente cliccare sui tre puntini in alto a destra, quindi **Imposta Preferiti**.
Si aprirà una pagina che ti permetterà di scegliere le Scorciatoie da aggiungere come preferiti, quindi clicca il tasto in basso a destra per confermare.
Di seguito un esempio di come vengono visualizzati i preferiti.
{% hint style="info" %}
Per riordinare i preferiti è sufficiente tenere premuto sull'elemento che desideri spostare.
{% endhint %}
{% hint style="warning" %}
Su **iPad** per riordinare gli elementi è necessario premere sui tre puntini in alto a destra, quindi sull'opzione **Riordina Preferiti**.
{% endhint %}
# Apple Watch
Gestione delle Scorciatoie da Apple Watch.
Per sincronizzare le Scorciatoie su Apple Watch devi accedere alle *Impostazioni* dell'app, quindi scorrere fino alla sezione *Apple Watch.*
Se sul tuo Apple Watch non vedi le Scorciatoie premi il tasto *Sincronizza*. Nel caso in cui volessi limitare il numero di scorciatoie mostrate puoi premere il tasto *Scegli Scorciatoie* e scegliere solo quelle che desideri visualizzare.
{% hint style="info" %}
Nel caso in cui avessi più di un sistema, le Scorciatoie su Apple Watch mostreranno il nome del sistema di appartenenza.
{% endhint %}
# Meteo
Il sistema aggiorna frequentemente i dati sulle previsioni meteo correnti, permettendo di visualizzare numerose informazioni, tra cui:
* Temperatura
* Umidità
* Precipitazioni
* Vento
* Visibilità
* Qualità dell'Aria
* Alba/Tramonto
{% hint style="info" %}
Tali informazioni possono essere sfruttate nelle Automazioni, e quindi potete ad esempio accendere le luci esterne dopo il tramonto, o disattivare la VMC se l'umidità esterna è troppo elevata.
{% endhint %}
Per accedere alla pagina con tutte le informazioni dovete cliccare sulla casella del meteo nella schermata principale.
{% hint style="warning" %}
Alcune informazioni (es. qualità dell'aria) richiedono che il sistema sia aggiornato alle versioni più recenti.
{% endhint %}
# Ricerca Universale
Cerca ed interagisci rapidamente con il tuo impianto.
## Cos’è la Ricerca Universale?
La ricerca universale di OHMe è uno strumento potente che vi permette di trovare e gestire qualsiasi elemento del vostro impianto domotico da una sola barra di ricerca. Non è più necessario esplorare menu complicati: tutto è accessibile in pochi secondi.
{% hint style="warning" %}
Devi aggiornare iOS alla versione 26 o successiva per utilizzare questa funzionalità.
{% endhint %}
***
### Come funziona
* Digitando una parola chiave, potete individuare rapidamente dispositivi come luci, termostati, sensori, il vostro impianto fotovoltaico e molto altro.
* Ad esempio, scrivendo “luci accese” vedrete subito quali luci sono rimaste attive e potrete spegnerle con un tap.
* Indicando una categoria (ad esempio “luci”, “termostati”, “sensori”), avrete una panoramica completa di tutti gli elementi di quel tipo.
***
### Azioni rapide
* Non solo ricerca e visualizzazione: potete interagire direttamente con ogni elemento.
* Accendete, spegnete o regolate dispositivi, impostate la temperatura dei termostati, controllate aperture di finestre o tende, avviate la musica, modificate gli eventi in calendario.
* OHMe vi suggerisce azioni rapide e intelligenti, permettendo la gestione avanzata senza dover navigare tra più menu.
***
### Vantaggi
* Tutto sotto controllo in modo semplice e intuitivo.
* Gestione centralizzata: risparmiate tempo e semplificate l’esperienza.
* Operazioni avanzate velocemente, senza passaggi inutili.
# Multi Impianto
Può capitare di avere più sistemi (casa, ufficio, casa vacanze, ecc.) e quindi di voler accedere a ciascuno di essi rapidamente.\
Questa guida vi spiega come procedere.
Se avete effettuato l'accesso ad un solo impianto, dalla schermata principali dovete cliccare su •••, quindi sull'opzione **Sistemi**.
Nella pagina **Sistemi** cliccate su •••, quindi scegliete l'opzione **Aggiungi Sistema**.
Inserite le credenziali del nuovo sistema e premete **Accedi**.
L'app si collegherà in automatico al nuovo sistema. Per cambiare impianto è sufficiente cliccare sulla casella specifica.
Una volta che avete effettuato l'accesso a più di un sistema, l'icona di una casa vi comparirà in alto a sinistra nella schermata principale, così da velocizzare la connessione ai vari impianti.
# Recupero Password
Se non ricordate più la password, potete avviare il ripristino accedendo alle Impostazioni dell'app e poi alla sezione *Account*.
Toccate la voce *Ripristina Password Utente* per avviare il processo di recupero.
Verrà inviata un'email all'indirizzo associato al vostro account. Nell'email ricevuta, toccate il pulsante *Recupera Password*.
Si aprirà automaticamente una finestra nel browser predefinito. Inserite due volte la nuova password (la seconda per conferma).
{% hint style="warning" %}
Il ripristino della password richiede che all'account sia associato un indirizzo email corretto. Se non ricevete il link di ripristino, è possibile che sia stato associato un indirizzo diverso.
Potete modificare l'indirizzo email anche dall'app, ma è necessario conoscere la password attuale. In caso contrario, contattateci direttamente.
{% endhint %}
# Eliminazione Account
La procedura di eliminazione dell'account richiede particolare attenzione. Per evitare errori, abbiamo introdotto un processo gestito internamente. *Prima di procedere, verifichiamo le motivazioni della richiesta.*
{% hint style="danger" %}
Se l'account appartiene al proprietario del Sistema, la sua eliminazione comporta anche l'eliminazione del Sistema e di tutti i dati correlati.
{% endhint %}
{% hint style="info" %}
Se l'account è di un utente secondario, potete richiederne l'eliminazione al tecnico che ha configurato l'impianto.
{% endhint %}
## Richiedere l'eliminazione
La richiesta di eliminazione può essere inviata direttamente dall'app. In alternativa, potete contattare il supporto all'indirizzo .
Per inviare una richiesta di eliminazione, accedete alle impostazioni dell'app e aprite la sezione *Account*.
Una volta nella sezione *Account*, scorrete fino all'opzione *Elimina Account*.
Si aprirà una finestra in cui vi verrà chiesto di indicare le motivazioni della richiesta.
Toccando *Invia Richiesta* verrà avviato il processo di verifica.
# Alexa
Amplia le modalità di interazione configurando il controllo vocale.
{% hint style="info" %}
Se hai già installato l'app *Alexa,* e sei già connesso con un account *Amazon,* puoi cliccare [qui](https://skills-store.amazon.it/deeplink/dp/B08BXLPC1H?deviceType=app\&share\&refSuffix=ss_copy) per configurare direttamente la *skill*.
{% endhint %}
{% embed url="" %}
Collegamento Skill Alexa
{% endembed %}
La connessione di Alexa al tuo sistema è piuttosto semplice e richiede di effettuare i seguenti passaggi:
* installa l'app **Alexa**
* crea un account Amazon o accedi se ne hai già creato uno
* dall’app Alexa vai su **Altro** e accedi alla sezione relativa a **Skill e Giochi**
* cerca la *skill* **OHMe - Domotica Chiarini**
* per configurare la skill devi accedere usando le credenziali del tuo sistema domotico
Una volta eseguiti tali passaggi verrà avviata la ricerca dei dispositivi; tale ricerca avviene attraverso il cloud, quindi puoi effettuare la configurazione da qualsiasi rete.
I dispositivi trovati verranno aggiunti in automatico.
{% hint style="info" %}
Per semplificare l'interazione ti consigliamo di creare *Gruppi* e *Routine*.
{% endhint %}
{% embed url="" %}
{% hint style="warning" %}
Se vengono effettuate modifiche alle Scorciatoie o ai dispositivi (es. nuovi elementi, cambio nome, ecc.) è necessario riavviare l'operazione di ricerca dicendo: *Alexa, trova dispositivi*.
{% endhint %}
# Google Assistant
{% hint style="info" %}
Se hai già l'app *Google Home* installata e sei già connesso con un account *Google* puoi cliccare [qui](https://madeby.google.com/home-app/?deeplink=setup/ha_linking?agent_id=chiarini-home) per configurare direttamente l'*action*.
{% endhint %}
{% embed url="" %}
Collegamento Action Google Assistant
{% endembed %}
La connessione di Google Assistant al tuo sistema è piuttosto semplice e richiede di effettuare i seguenti passaggi:
* installa l'app **Google Home**
* crea un account Google o accedi se ne hai già creato uno
* dall’app Google Home vai su **Impostazioni** e accedi alla sezione relativa a **Assistente Google**
* clicca su **Gestisci tutte le impostazioni dell'assistente**, quindi clicca su **Domotica**
* premi il tasto cerca e scrivi "Chiarini", quindi clicca sull'*action* trovata
* per configurare l'action devi accedere usando le credenziali del tuo sistema domotico
Una volta eseguiti tali passaggi verrà avviata la ricerca dei dispositivi; tale ricerca avviene attraverso il cloud, quindi puoi effettuare la configurazione da qualsiasi rete.
I dispositivi trovati verranno aggiunti in automatico.
{% hint style="info" %}
Per semplificare l'interazione ti consigliamo di creare *Stanze* e *Routine*.
{% endhint %}
{% embed url="" %}
{% hint style="warning" %}
Se vengono effettuate modifiche alle Scorciatoie o ai dispositivi (es. nuovi elementi, cambio nome, ecc.) è necessario riavviare l'operazione di ricerca dicendo: *Hey Google, sincronizza dispositivi*.
{% endhint %}
# Siri
Su iOS è possibile generare comandi vocali personalizzati per eseguire le *Scorciatoie*. È inoltre possibile combinare azioni di app e servizi differenti, così da creare delle routine più complesse.
Per configurare i comandi vocali con *Siri* è possibile procedere in due modi:
* dall'app [OHMe](https://apps.apple.com/it/app/ohme-domotica-chiarini/id1038355474)
* dall'app [Comandi](https://apps.apple.com/it/app/comandi/id1462947752)
### OHMe
Per generare dei comandi vocali dall'app *OHMe* è necessario accedere alla pagina delle *Scorciatoie*, quindi premere i tre puntini in alto a destra e cliccare su *Modifica Configurazione*.
Una volta attivata la modalità di configurazione è possibile cliccare sui tre puntini presenti sulla scorciatoia interessata, quindi su *Aggiungi a Siri*.
La schermata aperta permette la modifica del comando vocale, così da renderlo più facile e naturale nella pronuncia.
{% hint style="info" %}
I comandi generati saranno utilizzabili su tutti i dispositivi (iPhone, iPad, Mac, HomePod, ecc.) connessi al medesimo account Apple.
{% endhint %}
### Comandi
È possibile generare comandi vocali anche dall'app *Comandi*, e in questo caso è possibile aggiungere ulteriori azioni al comando, anche di app e servizi differenti.
{% embed url="" %}
Link App Comandi
{% endembed %}
{% embed url="" %}
Esempio di Comando
{% endembed %}
# ChatGPT
Se desiderate integrare il vostro sistema con ChatGPT potete accedere al GPT che abbiamo sviluppato ed effettuare il login con le vostre credenziali.
{% hint style="info" %}
Si tratta di un'anteprima, quindi è possibile che l'esperienza non sia ancora ottimale, ma si tratta sicuramente di una prima integrazione interessante.
\
Al momento è possibile ottenere la lista delle scorciatoie configurate e richiedere la loro esecuzione. Se le scorciatoie prevedono un parametro potete specificare il valore.
{% endhint %}
{% embed url="" %}
# Sonos
Questa breve guida spiega come connettere il tuo Sistema Domotico a Sonos.
{% embed url="" %}
Per connettere Sonos, accedi alle impostazioni dell'app OHMe, cerca *Sonos* e seleziona l'opzione dedicata.
{% hint style="info" %}
La seguente guida mostra i passaggi per i dispositivi iOS, ma ad esclusione di alcune differenze grafiche, la procedura è simile anche per i dispositivi Android.
{% endhint %}
Nella schermata successiva puoi collegare il tuo account Sonos. Clicca sul tasto *Connetti Sonos* per procedere.
Cliccando il tasto si aprirà la schermata seguente.
Clicca sul tasto *Continua*, quindi inserisci le credenziali del tuo account Sonos.
{% hint style="danger" %}
È necessario aver creato un account Sonos per procedere.
Per registrare un account accedi a [questa pagina](https://login.sonos.com/signin/register).
{% endhint %}
Dopo aver inserito le credenziali, premi *Accedi* e accetta le condizioni selezionando *Acconsento*.
{% hint style="info" %}
Così facendo autorizzerai OHMe a controllare il tuo Sistema Sonos.
{% endhint %}
Una volta completata la connessione, la pagina *Sonos* dovrebbe mostrare il pulsante *Disconnetti Sonos*.
Per accedere alle funzioni di Sonos, seleziona l'opzione *Sonos* dal menu principale.
Le funzioni disponibili sono più limitate rispetto all'app ufficiale, ma la connessione ti permette di creare scenari e automazioni che includono anche la musica.
Cliccando su un Gruppo si apre una pagina dedicata.
## Sintesi Vocale
Tra le funzioni integrate, la *Sintesi Vocale* merita una menzione particolare.
Per accedere a questa funzione, clicca sui tre puntini `⋯` nella pagina *Dispositivi Sonos*, quindi seleziona l'opzione *Sintesi Vocale*.
Grazie all'integrazione della sintesi vocale, puoi convertire messaggi di testo in messaggi vocali che verranno riprodotti dai *Player Sonos* selezionati.
Questa funzione può essere usata anche negli scenari, ad esempio per annunciare l'arrivo di qualcuno a casa.
È possibile riprodurre messaggi vocali anche in seguito a un evento, ad esempio:
* l'apertura di una porta
* quando l'allarme sta suonando
* quando qualcuno suona il campanello
* un pulsante è stato premuto
* e molti altri
# SolarEdge
Connetti il tuo Impianto Fotovoltaico al sistema.
{% embed url="" %}
Per connettere il tuo Impianto Fotovoltaico [SolarEdge](https://www.chiariniautomazioni.it/pv) al tuo Sistema Domotico devi contattare il tuo installatore e richiedere l'abilitazione dell'**Accesso API**.
Tale impostazione permette di generare una chiave alfanumerica che, in combinazione con l'**ID** del Sito, permette di stabilire la connessione.
Una volta ottenuti tali dati, devi contattare il tecnico che ti ha configurato l'Impianto Domotico, affinché ti configuri la connessione.
{% hint style="info" %}
Nel caso in cui ci fossero problemi durante la configurazione chiedi al tuo tecnico di contattarci.
{% endhint %}
# Chiamate Cloud
La licenza per le Chiamate Cloud permette di ricevere chiamate vocali automatiche, contenenti messaggi di avviso, in modo da non perdere informazioni importanti.
È sufficiente una connessione Internet per attivare il servizio.
{% hint style="success" %}
**Esempio con il Sistema di Allarme:**
Quando viene rilevata un'attività sospetta, le Chiamate Cloud inviano una chiamata per notificare l'evento.
{% endhint %}
{% hint style="info" %}
Non è necessario nessun intervento sul campo, l'attivazione della nuova funzionalità prevede un semplice aggiornamento da remoto.
{% endhint %}
## Messaggi Vocali
È possibile personalizzare le chiamate impostando un messaggio vocale, grazie all'integrazione del *Text to Speech*, che permette di convertire in voce qualsiasi testo.
Tale messaggio può contenere anche informazioni dinamiche, il valore di un sensore ad esempio.
> 💬 *La temperatura della cella frigo ha superato i 5°!*
## Risparmio e Sostenibilità
Il servizio in questione non permette solo di risparmiare denaro, ma di evitare l'installazione di hardware aggiuntivo, rendendo questa opzione più sostenibile a livello ambientale, oltre che economico.
## Contatto di Emergenza su iPhone
{% hint style="success" %}
Su iPhone è possibile abilitare l'opzione **Avviso Emergenze** così da ricevere le chiamate con vibrazione e suoneria anche quando il dispositivo è in modalità *Silenziosa* o *Full Immersion*.
{% endhint %}
Di seguito le istruzioni su come procedere:
1. Aggiungete il numero di telefono delle chiamate cloud tra i contatti della rubrica (in genere il numero da cui vi arriveranno le chiamate sarà: **`+39 045 4500804`**).
2. Scorrete fino all'opzione *Suoneria* e selezionatela.
3. Nella pagina *Suoneria* dovete abilitare l'opzione *Avviso Emergenze*, quindi potete scegliere una suoneria personalizzata.
4. Premete *Fine* e salvate il contatto.
## Prezzi
{% hint style="success" %}
Vi offriamo l'opportunità di provare il servizio gratuitamente per 1 mese.
{% endhint %}
Dopo il periodo di prova potete decidere di sottoscrivere un abbonamento.
{% hint style="info" %}
Abbiamo previsto tariffe decisamente convenienti e prima di raggiungere il costo previsto dall'installazione di un classico centralino, vi serviranno diversi anni di abbonamento!
{% endhint %}
Trattandosi di un abbonamento, al termine del periodo previsto dal contratto (minimo 1 anno), potete decidere di disdire senza costi aggiuntivi.
Contattaci a per richiedere maggiori informazioni.
# Monitoraggio Cloud
Il servizio di **Monitoraggio Cloud** consente di verificare in tempo reale la connessione del tuo Impianto, garantendo il corretto funzionamento e la continuità del sistema.
In caso di disconnessione o malfunzionamento, il servizio invia automaticamente notifiche, email e chiamate se il vostro sistema risulta disconnesso, ad esempio a causa di un blackout totale o di problemi alla rete internet.
{% hint style="info" %}
Per la ricezione della chiamata è necessario attivare la licenza di [Chiamate Cloud](/extra/cloud-call).
{% endhint %}
## Prezzi
{% hint style="warning" %}
Questo servizio richiede l'attivazione di una licenza.
{% endhint %}
Il costo della licenza base non supera quello di un caffè al mese, ma per maggiori dettagli sui prezzi vi invitiamo a contattarci a
# Funzionalità Sperimentale
Quando vedi l’icona di un’ampolla, significa che la funzionalità è sperimentale. Queste funzionalità sono ancora in fase di test e potrebbero non funzionare come previsto, quindi usale con cautela.
{% hint style="info" %}
Se riscontri problemi o desideri condividere la tua esperienza, non esitare a scrivere al nostro indirizzo email dedicato . Il tuo feedback è prezioso per aiutarci a migliorare!
{% endhint %}
---
[Next Page](/llms-full.txt/1)
