Tells the project whether today is a holiday, a working day or a non working day, for programming and for ZOOM Universal Scheduler to skip holidays.
Brazilian national holidays included, calculated for each year, also Carnival (Monday and Tuesday), Good Friday and Corpus Christi. No internet or setup needed.
State holidays: pick the state and enter a free token from invertexto.com.
City or home holidays: type them in the Local Holidays property.
Configurable working and non working weekdays.
Prerequisites
Control4 controller with OS 3.0.0 or later and correct date and time.
Internet only for the license and state holidays.
Installation
Add the ZOOM - Calendário de Feriados driver to the project.
With ZOOM Universal Scheduler in the project, the Scheduler connection binds by itself (check the Connections tab). With a licensed Scheduler, the calendar needs no license.
Without the Scheduler, enter the key in License Key (30-day trial).
For state holidays, pick State and fill in Token.
Add city holidays in Local Holidays.
With ZOOM Universal Scheduler
Connected to the Scheduler, the calendar sends this year's and next year's holidays. Schedules marked Skip on holidays then also skip state and city holidays. The list is sent again whenever it changes.
Properties
Property
Description
License Key / License Status
ZOOM license (see Licensing).
Driver Information
Today's status and next holiday.
Last Update / Day Mode
Last update and day mode: Holiday, Non working day or Working day.
State / Token
State and free invertexto.com token for state holidays. National ones don't need it.
Local Holidays
City or home holidays, separated by semicolons: DD/MM Name (every year) or DD/MM/YYYY Name (that year only). E.g. 02/02 Navegantes; 20/09 Revolução Farroupilha.
Monday … Sunday
Working day (Working Day) or not (Non Working Day).
Log Level / Log Mode / ZOOMDH Debug
Logging and support.
Composer Actions
Action
What it does
List Holidays
Prints this year's and next year's holidays in the Lua tab, with the type (national, state, city).
Update Now
Fetches state holidays again and updates today.
Programming
Events
Holiday Started / Holiday Ended.
Non-Working-Day Started / Non-Working-Day Ended: a holiday or non working day started or ended.
Day Mode Changed.
Variables
IS_HOLIDAY, IS_WORKING_DAY, IS_NON_WORKING_DAY, TODAY_HOLIDAY_NAME, TODAY_HOLIDAY_TYPE, NEXT_HOLIDAY, NEXT_HOLIDAY_DATE. E.g. only open the shades at 7 am if IS_WORKING_DAY is true.
Connections
Scheduler: connect to the Holidays connection of ZOOM Universal Scheduler.
Troubleshooting
Symptom
What to check
"Licença inválida" in Driver Information
Connect the Scheduler connection to a licensed ZOOM Universal Scheduler or enter the License Key.
State holiday missing
Check State and Token and use Update Now; see the log with Log Level at Info.
City holiday missing
Check the format in Local Holidays (DD/MM Name) and use List Holidays.
Wrong day
Check the controller date, time and time zone.
Licensing
Free when connected to a licensed ZOOM Universal Scheduler.
On its own: 720-hour (30-day) trial; then enter the key in License Key. Existing licenses of this driver keep working.
The controller needs internet to activate and recheck the license.
National holidays calculated by the driver itself (Carnival, Good Friday and Corpus Christi included), no token needed. City holidays typed in Composer. Connection to ZOOM Universal Scheduler, which unlocks the driver without its own license. Next holiday in the variables, new documentation and ZOOM name.
302
04/21/2025
National and state holidays through invertexto.com, configurable working days, variables and events.