DigiNet can generate e-mails in response to events on its inputs. It uses SMTP protocol with "plain auth login". This means that DigiNet will supply a user name and password to the e-mail server.
Most of this information is the same as you would use to set up an account on a PC. The main difference is that the e-mail server will use a URL. DigiNet does not have the ability to resolve URLs so it will be necessary to look it up. There are look up services on the web that can do this.
Triggers
Emails can be triggered from any of the digital or analogue inputs or from serial port messages. Digital inputs can trigger e-mails when they go high or low. These are selected by checking the associated boxes in the "Trigger Low on Inputs" and "Trigger High on Inputs" sections. There is no limit on the combinations of high or low triggers.
Analogue inputs can trigger e-mails when their values exceeds a preset level and / or falls below a preset level. Each input can have different values for above and below levels. So for example if the above level was set to 600 and the below level was set to 500 an e-mail would be generated when the input level reached 600 or when it fell below 500.
In order to prevent multiple e-mails being generated from analogue inputs a hysteresis value can be specified. For "above" values, after an e-mail is generated, the input level would need to fall below the "above" level minus the hysteresis value and then back to the "above" level again before a second e-mail is sent.
Thus taking the value of 600 (above) with a hysteresis value of 10 an e-mail would be generated when the input value reached 600. If the input value fell to say 595 and then returned to 600 a second e-mail would not be generated. The level would have to reach 590 before returning to 600 before another e-mail is generated. Similarly with "below" levels the hysteresis value would be added to the "below" value. If you do not want to generate e-mails from these inputs then the "above" level should be set to 1024 and the "below" level should be set to 0. Emails can also be triggered from the serial port. Each time a serial port message is received e-mail is generated.
The subject and message body of the e-mail can be customised using dynamic web page files. These have fixed names: for the subject "esub.cgi" and for the body "email.cgi". These files can use any of the scripts used in the standard web page files. DigiNet will process the dynamic web page files after connection to the e-mail server has been established. Normally this will happen within 1 or 2 seconds but there are times when this period may be extended to several seconds if there are connection problems. Therefore if the triggering mechanism is transitory it may have reverted to its normal condition before the e-mail is actually sent. In the event of a problem in sending an e-mail, DigiNet will wait approximately 10 seconds and re-try. If there are further problems DigiNet will continue re-trying for a total of 10 attempts. If there has been no success at this point no further attempts will be made until another e-mail is generated.