EasyIO Email Service v2.

EasyIO FG Series and FS Series

Email User Guide
EasyIO Email Service v2.1

Document Change Log

17thAugust 2015
Document created.

19thJanuary 2017
SSL SMTP email servers supported.

th
17 Dec 2018
Updated disclaimer and support channel emails addresses
Updated images to reflex CPT Tools
EasyIO Email Service v2.1

Disclaimer

Confidentiality Notice
The information contained in this document is confidential information of EasyIO Holdings Pte Ltd. Such
information and the software described herein, is furnished under a license agreement and may be used
only in accordance with that agreement.
The information contained in this document is provided solely for use by EasyIO Holdings Pte Ltd
employees, licensees, and system owners; and, except as permitted under the below copyright notice, is
not to be released to, or reproduced for, anyone else.
While every effort has been made to assure the accuracy of this document, EasyIO Holdings Pte Ltd is not
responsible for damages of any kind, including without limitation consequential damages, arising from
the application of the information contained herein. Information and specifications published here are
current as of the date of this publication and are subject to change without notice. The latest product
specifications can be found by contacting our corporate headquarters or support channel.

Trademark Notice

EasyIO logo are registered trademarks of EasyIO Holdings Pte Ltd.

CPT Tool is by Online Tools Inc.

BACnet and ASHRAE are registered trademarks of American Society of Heating, Refrigerating and Air-
Conditioning Engineers. All other product names and services, mentioned in this publication, that are
known to be trademarks, registered trademarks, or service marks are the property of their respective
owners.

Copyright and Patent Notice

This document may not, in whole or in part, be copied, photocopied, reproduced, translated, or reduced
to any electronic medium or machine-readable form without prior written consent from EasyIO Holdings
Pte Ltd

Copyright © 2017 EasyIO Holdings Pte Ltd. All rights reserved

Disclaimer
The material in this manual is for information purposes only. The contents and the product it
describes are subject to change without notice. EasyIO Holdings Pte Ltd makes no
representations or warranties with respect to this manual. In no event shall EasyIO Holdings Pte Ltd be
liable for any damages, direct or incidental, arising out of or related to the use of this manual.

EasyIO Holdings Pte Ltd

101, Cecil Street #09-07
Tong Eng Building
Singapore 069533

Worldwide and Asia Pacific Support : support@easyio.com

Americas Support : support@easyio.pro
Europe Support : support@easyio.eu
EasyIO Email Service v2.1

Federal Communication Commission Interference Statement

This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant
to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful
interference in a residential installation. This equipment generates, uses, and can radiate radio frequency
energy and, if not installed and used in accordance with the instructions, may cause harmful interference
to radio communications. However, there is no guarantee that interference will not occur in a particular
installation. If this equipment does cause harmful interference to radio or television reception, which can
be determined by turning the equipment off and on, the user is encouraged to try to correct the
interference by one or more of the following measures:
• Reorient or relocate the receiving antenna.
• Increase the separation between the equipment and receiver.
• Connect the equipment into an outlet on a circuit different from that to which the receiver is
connected.
• Consult the dealer or an experienced radio/TV technician for help.
Caution: Any changes or modifications not expressly approved by the party responsible for compliance
could void the user's authority to operate this equipment.

FCC Caution
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions:
(1) This device may not cause harmful interference, and (2) this device must accept any interference
received, including interference that may cause undesired operation.

FCC Radiation Exposure Statement

This equipment complies with FCC radiation exposure limits set forth for an uncontrolled environment.
This equipment should be installed and operated with minimum distance 20cm between the radiator &
your body.
RF Exposure: A distance of 20 cm shall be maintained between the antenna and users, and the
transmitter module may not be co-located with any other transmitter or antenna.
EasyIO Email Service v2.1

Contents
Introduction ....................................................................................................................................................6
Prerequisites ...................................................................................................................................................6
Configure email service (SMTP service). .........................................................................................................7
SSL SMTP servers configurations. ...............................................................................................................9
NON SSL SMTP servers configurations. ......................................................................................................9
Configure email service (points). ..................................................................................................................10
Troubleshooting ............................................................................................................................................12
Unable to connect to email server .............................................................. Error! Bookmark not defined.
Unable to resolve mail DNS server ...........................................................................................................13
Technical Support .........................................................................................................................................14
EasyIO Email Service v2.1

Introduction
EasyIO FG Series and FS Series has the ability to send alarm notifications via emails.
Boolean and Float points are supported.
However, in order to use this feature the controller must have an internet connection or a valid
connection to any SMTP server.

Prerequisites
1. CPT Tool dated 27th June 2014 or later.
2. FG Series firmware version v1.5b50 or later (EasyIO FG) and v2.0b50 or later for (EasyIO FG+) is
required for best performance.
3. For FS Series, firmware has to be V3.0b50 or later.
4. For SSL SMTP email servers, minimum firmware requirement is v1.5b46 or v2.0b46.
If non SSL SMTP email server is being used, refer to prerequisites number 2 above.
EasyIO Email Service v2.1

Configure email service (SMTP service).

**Note**
In order to configure the email service kits need to be installed. These kits are included in the release
package. Installation of the kits is shown in the following steps

1. easyioFGMail

Step 1
Connect to the controller with CPT Tool.
Default login credentials are as below;
IP address : 192.168.10.11
Username : admin
Password :<no password>

Add the kits to the controller by navigating to manage kits and install easyioFGEmail.

Step 2
Choose easyioFGMail from the Sedona palette.
Drag and drop the DnsServ into the service folder.
The DnsService object can be place anywhere within the apps. It is recommended to drop it into the
service folder for easier management.
This DnsService object is used to resolve the email server to a valid IP address.

There are cases where the DNS fail to resolve the SMTP server IP address correctly. If this happen, the
preferDns property (default is 8.8.8.8) might need to be reference to the network gateway IP address.
EasyIO Email Service v2.1

Step 5
Drag and drop SmtpServ into your App.
Drag and drop the SmtpServ into the service folder.
The SmtpService object can be place anywhere within the apps. It is recommended to drop it into the
service folder for easier management.

Step 6
Double click on the SmtpServ object to get into the Sedona Property sheet.
Configure the SMTP service according to the mail provider.
EasyIO Email Service v2.1

There are a few free non-SSL email services available.

To name a few www.gmx.com and www.aol.com.

Below are some examples of setting up the NON SSL SMTP service settings.
Below properties are valid properties, user can use the below account to test the email service.

SSL SMTP servers configurations.

Email Properties Gmail Yahoo Mail
Smtp server smtp.gmail.com smtp.mail.yahoo.com

Outgoing mail port 465 465

Email Account Username easyio.corp@gmail.com
Email Account Password Aa80637571!
From easyio.corp@gmail.com
Recipient skfoo@easyio.com or your email
address
Reply To easyio.corp@gmail.com
Secure Connection Property true
easyio.corp@yahoo.com
Aa80637571!
easyio.corp@yahoo.com
skfoo@easyio.com or your email
addres
easyio.corp@yahoo.com
true

Email Properties GMX mail AOL mail

Smtp server mail.gmx.com smtp.aol.com
Outgoing mail port 465 465
Email Account Username easyio.corp@gmx.com easyio.corp@aol.com
Email Account Password Aa80637571! Aa80637571!
From easyio.corp@gmx.com easyio.corp@aol.com
Recipient skfoo@easyio.com or your email skfoo@easyio.com or your email
address addres
Reply To easyio.corp@gmx.com easyio.corp@aol.com
Secure Connection Property true true

NON SSL SMTP servers configurations.

GMX mail service no longer support NON-SSL SMTP server.
AOL mail service no longer support NON-SSL SMTP server.
Both email service require SSL authentication in order to send an email.

Email Properties GMX mail AOL mail

Smtp server mail.gmx.com smtp.aol.com
Outgoing mail port 587 587
Email Account Username easyio.corp@gmx.com easyio.corp@aol.com
Email Account Password Aa80637571! Aa80637571!
From easyio.corp@gmx.com easyio.corp@aol.com
Recipient skfoo@easyio.com or your email skfoo@easyio.com or your email
address addres
Reply To easyio.corp@gmx.com easyio.corp@aol.com
EasyIO Email Service v2.1

Configure email service (points).

Make sure SMTP service is configured correctly. Email service support 2 data types; Boolean and Float.

Below are the steps to configure a Boolean point to send an email if any alarm occurred.
The exercise below is a simulation with a Boolean writable object to trigger an alarm.

Step 1
Choose easyioFGEmail from Sedona Palette
Drag & drop BoolAlarm object into your App. The BoolAlarm object can be anywhere within the Sedona
app.
A valid link is required to BoolAlarm object in order to generate an email alarm.

Step 2
Double click the BoolAlarm object into Sedona Property Sheet.
Configure the Alarm Message Text and all others necessary.
All properties must have valid value or else the email will not get triggered.
EasyIO Email Service v2.1

Step 3
Repeat step 1 to step 2 for a FloatAlarm.
Configure the FloatAlarm Sedona property sheet for float value properties.
All properties must have valid value or else the email will not get triggered.

Step 4
An email sending will get triggered if the value or state matches the alarm object configuration.

To verify if the email is queue for sending, refer to the SMTP service
In the example below, 2 emails is pending to be sent.

Successful email sending is display at the email sent property.

Please check spam folder in case email is not received.
EasyIO Email Service v2.1

Troubleshooting

Service Unavailable error 503

In some cases you might receive an error saying the service is unavailable.
Please verify if the email service supports non secure or secure.
If the email service ONLY supports secure connection such as SSL change the Secure Connection property
to true.

Unable to connect to email server

In some cases you might have trouble sending email via secured SSL SMTP server such as Yahoo Mail and
Google Mail.
The reason for this is that by default these email servers block unsecure Apps access for security purpose.
You can turn OFF the blocked by singing in to your email account and go to the link below.

A help guide is embedded in the controller which can be access via the link below.
http://IP_address/sdcard/cpt/app/mail/mail_controller.php where IP_address is your controller IP
address.

Optionally you can visit the link below according to your email service provider.
Please allow some time for the email service to take your new changes.

Google Mail
Google Control access to less secure apps : https://support.google.com/a/answer/6260879?hl=en
Make sure “Allow less secure apps” is ON.
Settings might take some time to be effective. Please try again in 10mins.

Yahoo Mail
Yahoo Control access to less secure apps : https://help.yahoo.com/kb/SLN27791.html
Make sure “Allow less secure apps” is ON.
Settings might take some time to be effective. Please try again in 10mins.
EasyIO Email Service v2.1

Unable to resolve mail DNS server

This usually happen if the DNS service object primaryDns property is not configured correctly and the
controller could not reach to the internet and could not connect to the SMTP server.
In most cases, the router or network do not forward the request out if the DNS is not configured
correctly.

To avoid this, try to use the network gateway as the primaryDns.

Perform a reboot of the controller once this settings is changed.

Always perform DNS query via the DNS service object and verify the IP address of the SMTP server
against command prompt ping IP address.

Service Unavailable – Access Control – Allow Credentials

In some cases especially with Google Mail security , Google will block your login from unknown device or
unfamiliar location.

You should received an email from Google Mail saying that the account has been blocked due to
unrecognized access.

You will have to approved or let Google know that it is really you login from that device or location.
EasyIO Email Service v2.1

Technical Support

For technical issue, please contact respective region support channel.

Worldwide and Asia Pacific Support : support@easyio.com

Americas Support : support@easyio.pro
Europe Support : support@easyio.eu