Wolf-App — Rule Library
Ready-made Lua rules to upload to a Wolf Controller, with their settings explained.
A rule is a small Lua program that runs on the controller. The rules on this page are exported from a Wolf Controller, so they carry their script, their settings form and their description in one file. Upload the file and the rule appears in the Rules page exactly as it left our bench.
How to install a rule
- Download the file below to your computer.
- In Wolf-App open Rules and click Upload rule. Choose the file.
- Open the rule, check the settings, and click Save.
- Restart the application from System. A rule only starts to run after that.
The script is visible under every rule. Change it if you want, and export your version from the same page.
Emergency lighting with DALI DT1
Two rules work together. The tester runs the tests and writes the archive. The watcher reads that archive, watches every luminaire, and sends the emails. Both draw the Emergency lighting page in the menu. Install both, because neither one is complete alone. After the restart, anyone who is logged in has to log out and back in once to see the new page.
| Rule | Version | Format | Size |
|---|---|---|---|
| DT1 watcher | 1.0.0 | JSON ↓ | 40 KB |
| DT1 tester | 1.0.0 | JSON ↓ | 52 KB |
The rules need the Wolf-2DALI card, commissioned DT1 luminaires, and working email settings under System. The whole setup is shown in the DALI Emergency Lighting Demo.
Empty fields use the default value. All hours are UTC.
DT1 watcher
Monitors every DT1 luminaire on the bus. Sends alarm emails, a monthly status report with a CSV file, heartbeat emails, and logbook exports for a selected period. It never sends a command to a luminaire.
Settings · 9
| Setting | Default | What it does |
|---|---|---|
| Alarm recipients | controller default | Addresses that receive alarms, the heartbeat and test result emails. Separate several with commas. |
| Report recipients | same as alarm recipients | Addresses that receive the monthly status report and logbook exports. |
| Offline after | 15 min | How long a luminaire may stop responding before it is reported offline. No offline alarm is sent while the DALI channel is down. |
| Collect events for | 60 s | Events within this time are combined into one email. |
| Max alarm emails per hour | 6 | Extra alarms wait, and are skipped if they clear before they can be sent. |
| Exclude | none | Addresses that are not monitored, for example ch2/9, ch2/12. |
| Heartbeat hour | 5 | Hour when the heartbeat email is sent. |
| Heartbeat days | daily | Every day, once a week on a chosen weekday, or never. The heartbeat proves the watcher itself is alive. |
| Monthly report | on | Send the monthly status report with CSV. The Send report now button works even when this is off. |
DT1 tester
Runs the monthly function test and the yearly duration test on every DT1 luminaire, one group at a time, and writes every result to the test archive. It sends no email. The watcher reports what this rule records.
Settings · 10
| Setting | Default | What it does |
|---|---|---|
| Test hour | 1 | Hour when both test rounds run. The standard's first choice is an empty building. |
| Function test from day | 1 | Day of the month the function test round starts. From that day it runs once a day until every luminaire has been tested that month. |
| Duration test from month | 1 | Month the duration test campaign starts, 1 is January. From that month it runs every day until every luminaire has been tested that year. |
| Pause between function test groups | 10 min | Wait between one group finishing and the next starting, so tested batteries top up while their neighbours are tested. |
| Duration test timeout | 4 h | How long a running duration test may take. Set it above the rated duration of the luminaires, usually 1 h or 3 h, with margin. A test that has not concluded in time is stopped and recorded as a timeout. |
| Pause between duration test groups | 20 h | Wait between one duration test group concluding and the next starting. 20 gives about one group a day. 0 chains the groups back to back. |
| Watch a postponed test for | 24 h | Extra time to keep watching a duration test the luminaire postponed because its battery was not full. A postponed test that never began is retried the next day. |
| Function test round | on | The scheduled monthly round. The buttons on the dashboard work even when this is off. |
| Duration test round | on | The scheduled yearly round. The buttons on the dashboard work even when this is off. |
| Exclude | none | Addresses that are not tested. An excluded luminaire keeps its archive entries and its test group. |
Tests run group by group, never all luminaires at once, so the batteries are never all empty at the same time. Put luminaires that are next to each other in different groups. The group of each luminaire is set on the Emergency lighting page.