Rules UI - Almond+ 2014

From SecuriWiki
Revision as of 13:56, 12 January 2015 by Lars (Talk | contribs)

Jump to: navigation, search

As of firmware R069cb BETA, Rules for home automation was included. The following section will help explain how to use the Rules UI and it includes examples of a couple of simple rules.
Note that the last two sections haven't been updated to reflect the UI changes made in R069cb compared to the older beta firmware that these instructions were originally written for.

Getting started

Once you've updated to the new firmware, you might have to do a page refresh to get the rules tab to load properly. What you should see is in the below screenshot.

Rules main.png

To create your first rule, simply click on the magic wand (Click to add a new rule). You should now see a screen similar to the one below.

Rules 1.png


The IF part of the rule starts automatically or is caused by an action and it's known as a trigger. The trigger is the condition that has to be met before a an action can happen.

The first thing you want to do is to pick one or more triggers. In this first example, we picked a door/window sensors. When the door is opened, something should happen. Note that boxes highlighted in blue are the ones you've selected.

Rules 2.png
Rules 3.png

To save the trigger, simply click on Confirm Selection as highlighted in the picture below.

Rules 4.png

You should now see something like the following screen, which means that you've successfully set up the trigger part of the rule.

Rules 5.png


The second part to a rule is THEN, i.e. what will happen once the IF condition(s) is/are meet. This will cause something to happen at the end.


The Rules UI has an option to put in a delay before something should be triggered. The Wait time can be set to seconds or minutes and the maximum delay is 5 minutes.

Rules 7.png

In this case we've put in a Wait of 5 seconds.

Rules 8.png


Now it's time to pick an "action" i.e. what's going to happen once the trigger is triggered. In this cease, we're turning on a binary switch. Simply click on "ON" icon for the binary switch and the action will be saved.

Rules 9.png

Once the action has been saved, you should see it appear under THEN. You can add multiple actions to the same "THEN" statement.

Rules 10.png

Saving a rule

Now it's time to save the rule. Simply type in the name you want for the rule in the "Enter Rule Name" field provided at the top and bottom of the rules UI. We'd suggest using a descriptive rule name, so you know what the rule actually does. Finally click on Save Rule (highlighted below) to save the rule.

Rules 11.png

Verifying a rule

If the rule was successfully created, you should now see it as a rule in the Rules tab in the main NutsOS UI. Note that as long as you see the Please wait... box at the top of the page, the rule is still being saved.

Rules 12.png

You can click on the ... symbol to see the triggers and actions performed by the rule. Note that currently this is only displaying true/false rather than say open/closed or on/off, but this will be addressed in a future firmware update.

Rules 13.png

Deleting a rule

Clicking on the cross at the far right end of a rule will delete it.

Rules 12.png

A simple time based rule

This is where things becomes a little bit more complex. First if all you have to into OpenWRT and set the time of your Almond+ correctly. If this isn't done, then your time based triggers won't be triggered when you expect them to. We're working on getting the time related issues fixed in a future firmware, but we're also preparing the Almond+ for the weather and time apps, so they'll tie in to the time fixes we're working on and as such this will take a little bit of time until it's done. For now, simply go into OpenWRT via the Advanced settings in NutsOS, select System, System from the menu, select the correct time zone and then click on "Sync with browser" to sync the time. Note: If you run the diagnostics app, the time will end up wrong again, this will also be fixed in a future firmware update.

The first step is to select a time when you want something to happen. Simply enter the time into the UI using either the up/down arrows, or by clicking on the numbers and typing it in.

Rules timer 1.png

You can also select the days of the week you want a time based trigger to happen, in this case, we've picked Monday through to Friday.

Rules timer 2.png

You can also put in a condition into time based triggers, in this case, only if the binary switch is on at the specified time, then something will happen.

Rules timer 3.png

Next create an action as per above. Once you're finished, you should see something like the screenshot below, before you name and save your rule.

Rules timer 4.png

Complex timer rule

This example will show you how to set up a more complex rule based on multiple conditions, including a time window. In the previous example we only used the AT option in the time based part of the trigger, this time we'll use the TILL part as well. This allows us to set a time window in which something should take place.

Complex timer 1.png

In this example, we've selected that if two conditions/triggers are meet between 3pm and 4pm, then something should happen.

Complex timer 2.png

The conditions/triggers we set are if the binary switch is on and if the door is closed and the time is between 3pm and 4pm as per the above screenshot, then something should happen.

Complex timer 3.png

In this case the THEN action is to wait five seconds and then turn off the binary switch. This can for example be useful to turn off a light in a room when the door is closed during a certain time of the day.

Complex timer 4.png

You can of course use longer periods of time in this case and you can of course combine this with the day of the week as well.