Jump to content

Welcome to Smart Home Forum by FIBARO

Dear Guest,

 

as you can notice parts of Smart Home Forum by FIBARO is not available for you. You have to register in order to view all content and post in our community. Don't worry! Registration is a simple free process that requires minimal information for you to sign up. Become a part of of Smart Home Forum by FIBARO by creating an account.

 

As a member you can:

  •     Start new topics and reply to others
  •     Follow topics and users to get email updates
  •     Get your own profile page and make new friends
  •     Send personal messages
  •     ... and learn a lot about our system!

 

Regards,

Smart Home Forum by FIBARO Team


jgab

Scheduling scenes. The missing %% time trigger...

Recommended Posts

Edit: Sept.7. Updated to v1.1 - thanks to @10der for finding bugs and suggesting improvements.

Edit: Sept.7. Updated to v1.2 - bug fixes and support for catchup

Edit: Sept.7. Updated to v1.3 - tabs in time rules changed to space

Edit: Sept.7. Updated to v1.4 - more bug fixes, thanks @10der

Edit: Sept.8. Updated to v1.5 - support for "long date" formats and day numbers

Edit: Sept.8. Updated to v1.6 - Dang. Cut and paste error in v1.5. fixed.

Edit: Sept.9. Updated to v1.7 Beta - Code restructuring, faster conditions, sunset/sunrise implementation to fix midnight "bug". Support for dawn and dusk.

Edit: Sep.14. Updated to v1.8B - Fix split and tabs bugs

Edit: Sep.15. Updated to v1.9B - sunset calculations broken - fixed

 

Scenes can trigger on devices changing status (%% properties), when globals change values (%% globals) and events (%% events) etc.

However, there is no trigger for time or timers - to allow a scene to be started at a specified time.

Well, here is a fix for that... and it makes it very easy to start scenes at specified times of day including sunrise/sunset, at regular intervals, at specified weekdays, and at specified months...

 

The scene below watches other scenes and allows them to declare "%% time" headers that they will be triggered on

Timer scene v1.6:

Please login or register to see this attachment.

,  v1.8Beta:

Please login or register to see this attachment.

 

When the Timer.lua scene is installed and started (no configuration needed) we should be able to forget about it and turn our attention to scenes that we want to be triggered at given times.

It's a perfect "tool" to have running on the HC2 as it makes it really easy to add a scene and schedule it to run at a given time. A simple added header to the scene is all that is needed:

Please login or register to see this code.

This scene will be run at 15:00 every day. To stop it from being scheduled, just remove the "%% time" lines from the header and save the scene again.

 

A more extensive example with a scene declaring multiple triggers and retrieving the trigger when the scene gets invoked;

Please login or register to see this code.

In the scene we redefine fibaro:getSourceTrigger() to return our timer as an "standard" source trigger. It's not strictly necessary as time triggers are of type 'other' with the arguments coming from fibaro:args(). However, this makes it more streamlined and plays well with standard fibaro source triggers. The timer scene is "drift free" so if you declare a timer on the hour you will be called exactly on the hour, and not slowly start to drift as is very common in many home made Lua timer loops.

Standard 'time' triggers look like

Please login or register to see this code.

tag=<tag> is the (optional) word provided last in the time rule and helps us to identify what time rule triggered our scene.

time=<str> is the time the rule is invoked (in HH:MM format)

 

Here we also add the keyword 'log' under "%% time" to instruct the time scene to send us log statements.

Log statements come in two versions

Please login or register to see this code.

Standard log messages are sent at startup and at midnight with the log msg containing information about the time rules scheduled. It's usually nice to get some feedback that the Timer scene has scheduled our scene and for what times.

Please login or register to see this code.

Error messages are always sent (even without the 'log' keyword). Usually due to time rules being faulty.

 

When you enable log messages your scene will also be triggered by log messages and not only timers. You need to tell them apart. A good way to test for a time trigger that is not a log message is to test if there is a .time field in the source trigger

Please login or register to see this code.

IN that case we know that it is a proper time trigger and not a log message, as they lack the .time field.

 

Ok, the time rules in the example are

Please login or register to see this code.

This means that the scene is called 15:00 every day, with the identifier tag "bar"

In the scene we get an sourceTrigger at 15:00 of type

Please login or register to see this code.

In the above example we just print out the tag.

Please login or register to see this code.

creates a repeating timer that triggers the scene every 15 minutes, and with the tag "test". We get a sourceTrigger of type

Please login or register to see this code.

 

The generic version of a time description looks like

Please login or register to see this code.

Examples

  • 15:00,17:00 test
    creates two timers at 15 and 17 with the same tag "test".
  • sunrise test
    'sunrise' is a valid time descriptor and evaluates to todays sunrise hour.  'sunset', "dawn", and "dusk" are available too.
  • sunrise-00:10 test
    We can do simple arithmetic on times (+/-) to create offsets.
  • 15:00 wednesday test
    timers at 15 but only on wednesday, tag "test".
  • 15:00 wed test
    days can be shortened
  • 15:00 wed,fri test
    or listed.
  • 15:00 wed..fri test
    or intervals.
  • 15:00 1..7 test
    interval with first to seventh day of the month
  • 15:00 lastday test
    Only on the last day of the month
  • 15:00 lastweek test
    only in the last week of the month (number_of_days_in_month-6..number_of_days_in_month)
  • 15:00 monday lastweek test
    conditions can be combined. True for Monday of the last week
  • 15:00 monday lastweek may..aug test
    month conditions also available.
  • *00:15 test
    interval, every 15min starting immediately (when the script starts). Ex. 12:08:33, 12:23:33, 12:38:33 ...
  • +00:15 test
    interval, every 15min, starting on next even 15min interval. Ex. 12:15:00, 12:30:00, 12:45:00 ...
  • +00:15 weekends 10:00..15:00 test
    combined with weekend test (sat..sun) and time interval (10:00 to 15:00)
  • +01:00 sunrise..sunset may..sep water
    every hour between sunrise and sunset and between May and September call scene with tag 'water'
  • 20:30 2020/05/28,2021/05/27,2022/05/26 earth_hour
    "long date" format
  • +01:00 oct/28/10:00..dec/30/07:00 tag
    Long date intervals. Year can be excluded and month can be the name of the month, and time can optionally be added at the end (not sunrise/sunset)

 

The <time list> should be seen as the times we want to schedule and the <conditions> as filters, excluding some times from the <time list>

The other way to look at the list of <conditions> is that the spaces are ANDs and commas are ORs. Ex."10:00 thu,sat lasweek tag" is "10:00 ((thu OR sat) AND lastweek), tag"

 

The complete set of conditions are:

  • <time>..<time>, time interval in HH:MM or HH:MM:SS (but also 'sunset' and 'sunrise')
  • <week day>..<week day>, day interval. mon..wed,  Thursday..Saturday
  • <day number>..<day number> - 1..7, first to second day in current month
  • <month>..<month>, month interval
  • <time>,<time> -- One or more time specifiers. Ex. 10:00,11:00
  • <week day>,<week day> -- One or more day specifiers. Ex. monday
  • <day number>,<day number> -- Ex. 1,8,15,22
  • <month>,<month> -- One or more month specifiers. Ex. june,july,august
  • <long date>..<long date> - YYYY/MM/DD/HH:MM. Year cane be left out and time part is optional
  • <long date>,<long date> - 2020/may/11/10:00, may/11/10:00, may/11
  • alldays - same as mon..sun
  • weekends - same as sat..sun
  • weekdays - same as mon..sun
  • lastday - true if last day of the month
  • lastweek - true if last week in the month
  • true - always return true. See example below using fibaro global to disable rules
  • false - always return false. Effectively disabling the rule.

...and they can be combined.

 

It's allowed to end a time rule with a comment '--'. It's just removed before parsing the rule. (Wouldn't it be nice to be able to add comments to all headers?)

Ex.

Please login or register to see this code.

 

A simple example turning on a lamp (with deviceID 55) at sunset-10min and turning off the lamp at sunrise+10min on weekdays

Please login or register to see this code.

 

The tag is useful to identify what timer you get so you don't have to test against time again (or you can use it as in the example above, as an argument to a function, fibaro:call in the above case).

We can also let the tag be the name of a function called in our scene at that time. .

Please login or register to see this code.

 

A more advanced feature is that time rules allows for substituting in values from fibaro globals.

Ex.

Please login or register to see this code.

This will fetch the value from the the fibaro global "myTime" and insert whatever value it has instead of <myTest>. If the value was "10:00" the rule would be

Please login or register to see this code.

The substitution can be anywhere in the rule and contain anything so be careful.

We also watch if the value of "myTime" changes and if it does it will update the timers for the scene.

One way to use this is to have a global, ex "Stop" that is set to "true" or "false". If we include that in a rule

Please login or register to see this code.

We can easily enable/disable the rule depending on what we set "Stop" to.

 

The scene could be improved and I'm open for suggestions. (and of course there are most likely bugs to be fixed...)

Edited by jgab
  • Thanks 1

Share this post


Link to post
Share on other sites
  • Topic Author
  • Here is a bonus hack.

    We know that Lua variables are not preserved between invocations of scene instances and if we need to save a value we use fibaro globals.

     

    The function "globals" defined in the scene below list the Lua globals we want to have preserved between scene invocations (and does the saving to a fibaro global automatically)

    Example (using the "%% time" trigger mechanism in the scene above}

    Please login or register to see this code.

    Here we keep the state of two Lua globals, 'counter' and 'lastTrigger' between invocations. We could have used a table and stored/restored ala "HomeTable", but this looks nicer :-) 

    This works with "simple" scenes that triggers and terminates.

    Edited by jgab

    Share this post


    Link to post
    Share on other sites
  • Topic Author
  • I was just informed that the included code for the Time scene didn't works. It seems like some brackets got lost when pasted into the "spoiler" field.

    I have attached a file in the original post with the scene code now - that should work better.

     

    Edited by jgab

    Share this post


    Link to post
    Share on other sites
  • Topic Author
  • New version 1.1

    -Improved log handling - I think...

    -Time rules can end with comments

    -Fibaro globals can be used to substitute in values in time rules. 

    -A bit better documentation in the first post...

    • Thanks 1

    Share this post


    Link to post
    Share on other sites
  • Topic Author
  • Use case. Simple TimeOfDay scene that sets a couple of fibaro globals to time of day.

    The fibaro global 'TOD' will be set to 'Morning','Day' etc

    The fibaro global 'TIME' will be set to 'Sunrise','Sunset' and 'Hour' on even hours

    The fibaro global 'SEASON' will be set to 'Summer','Winter' etc

    Please login or register to see this code.

    Here we use the tag field to tell us what global should be updated to what value. However, you are free to use the tag field in any way you want and invent your own format to tell you what the script should do.

     

    In this example we also introduce catchup logic.

    Each time rule can optionally be assigned a "catchup group" with catch:<N>.

    The latest rule within a catch group that was not scheduled bacuse time had passed will be executed anyway.

     

    I do realise it would be nice with complex time expression like max(sunrise,07:00)... maybe next version

    Edited by jgab
    • Like 1

    Share this post


    Link to post
    Share on other sites
  • Topic Author
  • On 9/7/2019 at 7:34 AM, jgab said:

    New version 1.1

    -Improved log handling - I think...

    -Time rules can end with comments

    -Fibaro globals can be used to substitute in values in time rules. 

    -A bit better documentation in the first post...

     

    New version 1.5

    - Catchup support for rules. See

    Please login or register to see this link.

    - Long date format. Ex. 2020/may/15/10:00 or may/12, april/4/07:00 (most useful for intervals, but also list of specific dates like the Earth Hour example in the previous post)

    - Day numbers. Ex. 1..7 to test for the first seventh days of the month.

    -Bug fixes.

    The scene has only been around for 2 days but v1.4 has been ticking on my HC2 delivering triggers on the second for 12+ hours now :-) 

    Edited by jgab
    • Thanks 1

    Share this post


    Link to post
    Share on other sites
  • Topic Author
  • On 9/8/2019 at 10:13 AM, jgab said:

     

    New version 1.5

    - Catchup support for rules. See

    Please login or register to see this link.

    - Long date format. Ex. 2020/may/15/10:00 or may/12, april/4/07:00 (most useful for intervals, but also list of specific dates like the Earth Hour example in the previous post)

    - Day numbers. Ex. 1..7 to test for the first seventh days of the month.

    -Bug fixes.

    The scene has only been around for 2 days but v1.4 has been ticking on my HC2 delivering triggers on the second for 12+ hours now :-) 

     

    New version 1.7B (Beta as it is not very well tested yet)

    - More efficient scheduling engine - conditions are much faster to execute (they were fast before, but now even more so...)

    - The condition parser is better structured so new condition types should be easier to add in the future

    - Support for 'dawn' and 'dusk' - like 'sunset' and 'sunrise' just a little before and after :-) 

    - Own sunset calculation to avoid midnight bug <

    Please login or register to see this link.

    >. This was an issue as times were scheduled at midnight.

    - 'lastday' can be used in day intervals. Ex. 20..lastday

     

    Edited by jgab
    • Thanks 1

    Share this post


    Link to post
    Share on other sites

    Jan, can u add macros for global vars like 

    $dark where dark is 18:58 in global parameters 

    Or $night is global value what I can setup as 23:00

     

    sorry, I am in work trip just now and may pass your description for new features, please skip my comments  if this already implemented 

     

    thanks 

    Share this post


    Link to post
    Share on other sites
  • Topic Author
  • 5 minutes ago, 10der said:

    Jan, can u add macros for global vars like 

    $dark where dark is 18:58 in global parameters 

    Or $night is global value what I can setup as 23:00

     

    sorry, I am in work trip just now and may pass your description for new features, please skip my comments  if this already implemented 

     

    thanks 

    It's supported but the syntax is <varName>

    Ex.

    Please login or register to see this code.

    If global 'dark' is "18:58" and global 'specialDay' is "friday" it will be translated to

    Please login or register to see this code.

    ...and I watch the globals so if they change value  the scene will be rescheduled with the new values.

    Edited by jgab
    • Thanks 1

    Share this post


    Link to post
    Share on other sites

    Join the conversation

    You can post now and register later. If you have an account, sign in now to post with your account.

    Guest
    Reply to this topic...

    ×   Pasted as rich text.   Paste as plain text instead

      Only 75 emoji are allowed.

    ×   Your link has been automatically embedded.   Display as a link instead

    ×   Your previous content has been restored.   Clear editor

    ×   You cannot paste images directly. Upload or insert images from URL.


    ×
    ×
    • Create New...