Skip to main content

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.

Write the old settings down first

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 driverYou'll need it for
Email: the SMTP server, port, username and passwordThe email account on the Email and Pushover tab
Pushover: the application keyApplication token on the Email and Pushover tab
The users: each name, email address and Pushover keyPeople on the Who gets what tab
The alerts you use: title, message, link and link title, and which users get each oneTemplates
Pushover: each alert's sound and priorityThe 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 settingWhere it goes
SMTP server, port, username, passwordEmail 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 keyEmail and Pushover → Pushover → Application token
Users, up to six per driverWho 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 10Templates, 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 alertThe template's Who gets it
Alert link and link titleThe template's Link and Link text. It must start with http:// or https://.
Pushover sound and priorityThe template's Pushover priority and sound
Enable Global NotificationsSend 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 actionNew 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 GlobalenableNotifications. 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.