Moving from the Email and Pushover drivers
LCD Notifications replaces the LCD Email driver (CHEMAIL) and the LCD Pushover driver (CHPUSH). It does both jobs in one driver, so a site that ran both now needs one.
It's a new driver, so there's no in-place upgrade. Crestron Home keeps the old drivers' settings where a new driver can't read them, so nothing is copied across: you set the new driver up by hand and re-point the programming. On a typical site that's a short job, and this page lists everything to bring over.
Do this before you remove the old driver. Once it's removed, its settings are gone.
1. Write down the old settings​
Open the old driver's tile and note:
| On the old driver | You'll need it for |
|---|---|
| Email: the SMTP server, port, username and password | The email account on the Email and Pushover tab |
| Pushover: the application key | Application token on the Email and Pushover tab |
| The users: each name, email address and Pushover key | People on the Who gets what tab |
| The alerts you use: title, message, link and link title, and which users get each one | Templates |
| Pushover: each alert's sound and priority | The template's Pushover settings |
Note too which alerts the programming triggers, and from where.
2. Add LCD Notifications​
Install the new driver and enter its licence key. See Installing and commissioning. The old and new drivers can run side by side while you move over.
3. Enter the settings​
| Old setting | Where it goes |
|---|---|
| SMTP server, port, username, password | Email and Pushover → Email: SMTP server. The old driver always used SSL; choose STARTTLS. |
| (none) | From address and From name. The old driver sent from the username. If the username isn't an email address, as with SendGrid's apikey, the From address is required. |
| Pushover application key | Email and Pushover → Pushover → Application token |
| Users, up to six per driver | Who gets what → People, up to 20. One person can have an email address and a Pushover key, so a site that ran both drivers gets both from one message. |
| Alerts 1 to 10 | Templates, up to 50. The alert's title is the template's Subject. Give each template a Name too: that's what programming uses. |
| Which users get each alert | The template's Who gets it |
| Alert link and link title | The template's Link and Link text. It must start with http:// or https://. |
| Pushover sound and priority | The template's Pushover priority and sound |
| Enable Global Notifications | Send notifications, on the Email and Pushover tab |
Choose a Level for each template too. The old drivers had no levels, so start with warning for anything that should get attention and info for the rest.
Save, and use Send a test on each template to check it reaches the right people.
4. Re-point the programming​
Programming that used the old driver points at the old driver, so it has to be changed by hand. Replace each old action with the new one:
| Old action | New action |
|---|---|
| Trigger Alert (number) | Send followed by the template's name, for example Send Garage open |
| Custom Alert All Users (title, message) | sendMessage (subject, body, level). It goes to everyone whose level it reaches. |
| Enable Alert / Disable Alert (number) | enableTemplate / disableTemplate (template name). The change is now saved and survives a restart. |
| Enable Alerts Global | enableNotifications. There's also disableNotifications now. |
The new driver also has events that the old ones didn't, such as Critical message acknowledged in Pushover. See Programming.
5. Remove the old driver​
When every message arrives from the new driver, remove the old Email and Pushover drivers from Crestron Home.
What's different​
- Pushover priorities. The old Pushover driver sent its "Normal" priority as Pushover's lowest priority, which makes no sound. The new driver sends normal messages with sound.
- Critical messages repeat on the phone until someone acknowledges them, and Crestron Home is told when they do.
- Messages go out in the background. A slow mail server no longer holds up the rest of the program, and a failed send is tried again.
- The inbox tile keeps the messages on the touch panel, which the old drivers didn't do.
- Passwords and keys are no longer shown once they're saved.