Ezeio AAC User manual

ezeio™ user manual
Manual version 170314
ezeio™ models AAC – AAF
Page 1 of 121

Important information
WARNINGS
To reduce risk of fire or electric shock, do not expose this product to
rain or moisture. This product is designed for use indoors and only
with the supplied AC adapter.
Unplug the AC adapter before opening the cover.
The ezeio™ is a low voltage device.
Never connect high voltage to the inputs or outputs.
Micro AN: Never use connectors or wires designed phone
networks to connect Micro AN devises.
Phone connectors usually alter the polarity, and will permanently
damage MicroLAN devices, voiding the warranty.
SIM Card & Cellular Antenna: Always disconnect the power
adapter from the ezeio when installing or removing the SIM
card or antennas.
Page 2 of 121

Registration
This product is identified by a unique serial number and a registration code
on the front of the unit
You will need this information to communicate with the product
When activating the unit, you will also be assigned an account number
Make a note of this important information below
Account Number:
Serial Number:
Registration code:
Support contact information
Go to www.ezecontrol.com for support and contact information
Page 3 of 121

Table of Contents
ezeio user manual
Important information
WARNINGS 2
Registration 3
Support contact information 3
Introduction
What is the ezeio™ ? 7
Model information 8
Creating accounts and users
Overview 9
Creating a new account 9
Add an ezeio to an existing account 10
Adding users to an existing account 10
Moving or removing an ezeio from an account 10
Connections and installation
Things to consider before installing the ezeio™11
ezeio™ overview 12
Power connection 13
Network connection 13
General purpose inputs 15
Inputs – Pulse, switch or resistive sensors 16
Inputs – External voltage sources 17
Inputs – Current sensors 18
Relay outputs 19
+ DC output terminal 19
MicroLAN 20
Modbus / serial port 22
GSM/3G/GPS module (select models only) 25
Web interface overview
Logging in 29
Dashboard screen
Dashboards 31
Status screen
Live input status 33
Output status and control 33
Thermostat status 34
Event log 34
Downloading log data 34
Viewing graph of log data 35
Configure screen
ezeio™ Configuration 37
Resource tree 37
Page 4 of 121

Inputs 38
Calibrating analog inputs 44
Alarm settings 46
Actions 47
Conditions 48
Outputs 49
Schedules 50
Timers 50
Thermostats / Thermostat schedules 51
Devices 52
Script (premium feature) 54
System 55
Actions
Action: Send message 60
Action: Log event 66
Action: Set output 66
Action: Set counter 66
Action: Increment counter 66
Action: Decrement counter 66
Action: Control thermostat 66
Action: ModBus coil control 67
Action: ModBus write register 67
Account screen
Account 68
Personal 68
Users 69
Sending control commands
Email 70
Control via SMS (cellphone texting) 70
Control Commands 71
Server API
API access and security 73
Live status in JSON format via REST API 75
Historical data access in JSON format via REST API 75
Controlling the ezeio™ via REST API 76
Spreadsheet integration 81
Automatic export (push) 83
Script language
Script introduction 88
Script function library
Configuration interface functions 92
Calendar and time functions 96
Mathematical functions 98
Language functions 102
String functions 103
Page 5 of 121

Communication functions 108
Library functions 111
System events 114
Specifications
ezeio™117
Configuration and programming 118
Server Communication 118
Warranty
Manufacturers warranty statement 119
Liability disclaimer 119
Standards compliance
Applicable standards 120
Page 6 of 121

Introduction
Thank you for purchasing the ezeio™!
What is the ezeio™ ?
The ezeio™ is a complete solution for monitoring, alarming, control and
automation of commercial and industrial equipment
The ezeio™ hardware connects to sensors, meters, thermostats, VFD’s and
other control devices locally via a number of industry standard interfaces
It connects securely and seamlessly via the Internet (Ethernet or Cellular) to
the ezecontrol.com cloud application, where the user can access all data in
real time as well as historical
All configuration settings and programming is done via the cloud interface,
allowing multiple concurrent users, automatic synchronization and secure
access from anywhere without any special software or setup
Common applications include:
+ Monitoring energy meters (electrical, water, gas)
+ M&V applications (energy saving, improvements)
+ Monitoring refrigeration systems (temperature, pressure)
+ Controlling & monitoring HVAC systems (thermostats, room sensors)
+ Construction site monitoring (cement curing, heating/cooling, alarms)
+ Automating thermal energy storage systems (*TES)
+ Technical alarm systems (fan monitors, temperature, tank levels)
+ Lighting control, monitoring and scheduling/automation
+ Sprinkler control, monitoring and scheduling/automation
+ Battery / EV charging, monitoring and control
+ Vehicle tracking, monitoring (GPS)
The ezeio™ system is designed for easy deployment in geographically spread
out, multi-dicipline applications where traditionally several single-purpose
systems were needed
The ability to support different kinds of sensors, meters, actuators and
applications within a single, low cost yet complete and secure system makes
the ezeio™ system unique
Page 7 of 121

odel information
The ezeio™ is available in the following configurations:
Part Number Model Wireless
sensors
Cellular
GSM/3G/GPS
Cellular
Compatibility
111-0010-3 ezeio-Ethernet ---
111-0020-3 ezeio-Wireless YES --
111-0011-3 ezeio-Cellular -YES US
112-0011-3 EU/AU
111-0021-3 ezeio-Wireless &
Cellular YES YES US
112-0021-3 EU/AU
Base model
The ezeio™ connects to the Internet via standard 10/100 Ethernet and uses
wired peripherals via Modbus, MicroLAN and general purpose in/outputs
Wireless sensors
ezeio™ models equipped with a wireless transceiver module allow for
communication with wireless sensors and expansion units The wireless
protocol is encrypted and only wireless devices from eze System can
communicate with the ezeio™ over this network Typical indoor range is
about 50m (160ft) but depends on wall material and other environmental
factors
GS /3G/GPS
When configured with a built-in GSM Cellular modem, the ezeio™ can
communicate with the Internet via cell service This requires service from a
local cell provider and only GSM systems are supported The ezeio™ will
use the physical Ethernet path if it is available, but automatically switches to
GSM if it can't communicate over Ethernet
The GSM modem also supports GPS, so with the addition of an external
antenna, the ezeio™ will have access to its position in real time
Common features
All versions run the same software and all other features are the same
Some features depend on the service level All versions come with four (4)
months of Basic Service, which allows for logging data from five inputs See
our web page at www.ezesys.com for all the details about service levels and
the monthly cost
Script support (page 88) can be added to any ezeio™
Please contact eze System for more information
Page 8 of 121

Creating accounts and users
Overview
To configure your ezeio™, you need to create an account on the server and
associate the ezeio™ with that account
This is important to understand to effectively manage your systems:
(!!) Each ezeio™ is associated with a single account.
(!!) Each user is associated with a single account.
(!!) An account may have any number of ezeio™ units and any number of
users associated with it.
Note that you can register several ezeio™ units under the same account This
allows you to access all of them from a single login See Add an ezeio to an
existing account, page 10
All users on the same account will have access to all the ezeio units on that
account If you prefer to separate user access, simply create unique accounts
for each ezeio There is no per-account cost, but having a lot of accounts
may become difficult to manage
Creating a new account
Go to www.ezecontrol.com → Click Create a new account
Step 1:
The system will ask you for the ezeio serial number, and the
registration code These are printed on a sticker located on the
front of your ezeio
Enter them exactly as they show on the sticker
Step 2:
Enter your user info:
Name, Email, Phone & Company or Account Name
Step 3:
Enter a User Name & Password
Click to send the verification email
Step 4:
Open the email, click the link, and enter your password You're done!
In addition to your login name and password, the system assigns you an
account ID. You will need the account ID every time you log in. Make
sure to take a note of it. It is also included in the confirmation email.
Page 9 of 121

Add an ezeio to an existing account
Log in to your account and click the Configure tab
In the Account section in the left column, click the Add controller button
and enter the serial number and registration code
The ezeio™ will be immediately added to your account
If you receive an error, the ezeio™ may already be assigned to a different
account See below for how to remove or move an ezeio™
Adding users to an existing account
To minimize the workload on the account owner, users register themselves
You (the administrator or “admin”) need to provide each new user with the
serial number and the registration code to one of the ezeios on your account
It doesn't matter which ezeio you use The information is just used to link the
user to the correct account
Instruct the new user to go to the web page and click the Create a new
account link Then enter the ezeio serial number and registration code
Then follow the rest of the sign-up instructions
The process is basically the same as creating a new account See page 9
This will automatically link the new user with your existing account, and
you will receive an email informing you that a new user has been added
By default, new users have minimal privileges You can log in and change
the privileges for each user by going to Account → Users and click on the
user in the list
oving or removing an ezeio from an account
As mentioned above, an ezeio can only be added to an account if it is not
already assigned to an account To remove an ezeio from an account, go to
Configure → System and click Delete Controller
This will remove the association with the account The configuration of the
ezeio is not changed, and any data stored with the ezeio is kept
Creating the account and adding users does not require the ezeio to be
connected to the network.
Configuration can also be done with the ezeio offline. See page 36.
Page 10 of 121