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
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
Connections and installation
Things to consider before installing the ezeio™
The ezeio™ is designed for indoor use and should be installed in a dry and
clean location Do not expose the ezeio™ to rain or water, and avoid extreme
temperatures See the technical specifications for acceptable ranges
The ezeio™ is a low voltage device Never connect high voltage to the inputs
or outputs, and only use the supplied AC adapter to power the ezeio™
Do not run wires that connects to the ezeio™ (Inputs / outputs / MicroLAN /
Ethernet / Modbus / power or antenna) together with high voltage wiring
Use separate conduits whenever possible, and avoid environments with
excessive RF or magnetic radiation as this may interfere or even destroy the
ezeio™
Take necessary precautions to avoid large static discharges to the ezeio™
connections
Micro AN: Never use connectors or wires designed for phone
networks to connect Micro AN devices. Phone connectors
usually alter the polarity, and will permanently damage Micro AN
devices, voiding the warranty.
Page 11 of 121
ezeio™ overview
Page 12 of 121
ezeio™ external connectors
Internal features
(SIM and antenna connectors only on GSM model)
Basic communication setup
(Antennas only on GSM model)
Power connection
Use the included AC adapter to connect to mains power
The ezeio™ does not have an on/off switch, so as soon as the AC adapter is
connected, the ezeio™ will operate
Typical power consumption is very low (<2W), and the ezeio™ is designed to
be always on
Network connection
The ezeio™ has a standard TP 10/100 Ethernet connection Use the included
network cable to connect to a nearby Ethernet hub/switch/router that
provides a link to the public Internet If you use your own Ethernet cable,
ensure the length does not exceed 30m (100ft)
There are two jacks on the ezeio™ where an Ethernet cable fits. Take
care connecting your Ethernet cable to the one with a metal frame,
marked “Ethernet” (NOT the Modbus jack).
All communication parameters are pre-programmed in the ezeio™, so there is
nothing to set up The ezeio™ will automatically contact the servers
The ezeio™ automatically establishes IP information through DHCP.
Ensure your network connection supports DHCP and that the DHCP
server provides valid gateway and DNS information.
For static IP setup see page 14
The green LED on the Ethernet jack lights up as soon as there is a physical
connection available
Check the SERVER LED on the ezeio™ front for connection status:
Blink pattern Meaning
5 blinks ooking for DHCP address information
4 blinks IP address established
Querying DNS server for server IP
3 blinks Server address established
Attempting to make contact with server
2 blinks Communicating with server
1 blink Server connection established and idle
Page 13 of 121
Setting a static (fixed/manual) IP
The ezeio™ by default expect a DHCP service to provide the correct network
settings for the device when it is connected to the network
In some installations, it is required to supply specific network settings
manually to each device to allow it to communicate on the network
However this change can only be made from the system settings on
ezecontrol.com Thus, the ezeio™ needs to be connected to a network that
supports DHCP temporarily
To apply manual network settings, navigate
to the Configure → System screen and enter
IP addresses in the Ethernet settings section
(see example to the right)
Please make sure all settings are correct
before applying them Incorrect settings will
cause communication to fail As soon as the settings are synced the ezeio™
will loose contact with the servers via the DHCP network It can now be
moved to the network that requires fixed IP
Restoring DHCP functionality
To restore DHCP support, first remove the fixed IP settings on the server by
blanking out the IP field and click Save Changes If the ezeio™ is still
communicating via fixed IP, the settings will be automatically synced and
applied after the next reset of the ezeio™
If the ezeio™ is not communicating, the reset procedure is as follows:
1) Remove power from the ezeio
2) Open the enclosure and locate the holes
marked HALT (see picture to the right)
) Apply a jumper between the two holes and
make sure it stays in place, connecting the holes
4) Connect power to the ezeio keeping the
jumper in place
The LED's will blink very fast, and the ezeio™
will attempt to use DHCP to connect to the servers
Verify that the ezeio™ connects by checking the status on ezecontrol.com
When the “spinner” indicator stops and shows a green dot, the new
configuration is saved Power down and remove the jumper
The ezeio™ is now back in default DHCP mode
Page 14 of 121
General purpose inputs
The ezeio™ has four general purpose inputs Each input may be configured
individually in one of four ways described here:
Jumper
setting
Description
The factory default setting is Contact, Pulse or
Resistive (0-50kOhm).
An internal 10k resistor will hold the input to 5V.
See pg. 16
0-5VDC
Input impedance is >70kOhm.
Raw reading is about 10000 at 5.0V (0.5mV per count) See pg. 17
0-10VDC
Input impedance is >70kOhm.
Raw reading is about 10000 at 10.0V (1mV per count)
0-30mA (suitable for 4-20mA transducers)
An internal 100 Ohm resistor connects the input terminal
to Common.
Raw reading is about 10000 at 30mA (3uA per count)
See pg. 18
To access the input jumper settings, open the ezeio™ by removing the four
black screws
Page 15 of 121
Inputs – Pulse, switch or resistive sensors
Jumper
setting
Description
Contact, Pulse or Resistive (0-50kOhm).
An internal 10k resistor will hold the input to 5V.
This is the factory default setting.
The default input configuration is suitable for connecting passive sensors,
such as a switch, pulse meter or resistor
With the jumper settings configured to Pulse/resist, (as shown above), the
input has a 10kΩ pull-up resistor to +5V, allowing for variable-resistance
devices or switches to be connected directly to the “C” (0 volt) terminal and
one of the four input terminals like this:
If connecting to a pulse meter output, please make sure the polarity matches
the meter's The C terminal on the ezeio™ should be connected to the meter's
minus (-) or ground
Three wire KYZ sensors (Form C) are read as two wire sensors (Form A);
connect K to the ezeio’s C-terminal, and Y to one of the ezeio™ inputs
The ezeio™ input will detect pulses as short as 1ms Some pulse outputs may
have contact bounce, and requires a special setting in the software to ignore
pulses that are too short See System Settings
Page 16 of 121
( )
( )
0-10V / 4-20mA
Relays
Inputs
Max 50V, 2A
Server
GSM/GPRS
1 2 3 4
+
1 B A
+
2 . . . .
ModBus
N NO N NO
Pulse Resistor Switch
Common ◀
C = 0 volts
Inputs – External voltage sources
Jumper
setting
Description
0-5VDC
Input impedance is >70kOhm.
Raw reading is about 10000 at 5.0V (0.5mV per count)
0-10VDC
Input impedance is >70kOhm.
Raw reading is about 10000 at 10.0V (1mV per count)
The 0-10V and 0-5V input settings are suitable for sensors with output
voltage in that respective range Simply connect the sensor to the input
between the “C” (0 volt) terminal and the input as shown here:
The ezeio™ is designed for low voltage connections. Never connect high
voltage to the ezeio™ inputs.
A series resistor can be added to increase the range of an input Use a
100kOhm resistor to allow measuring up to 20V Use a 390kOhm resistor to
allow measuring up to 50V Contact eze System if you need to measure
higher voltage than 50V
Page 17 of 121
0-10V / 4-20mA
Relays
Inputs
Max 50V, 2A
Server
GSM/GPRS
123 4
+
1 B A
+
2. . . .
ModBus
N NO N NO
Inputs 1 - 4 ▶
0-10V
Source
Common ◀
C = 0 volts
Inputs – Current sensors
Jumper
setting
Description
0-30mA (suitable for 4-20mA transducers)
An internal 100 Ohm resistor connects the input terminal to Common.
Raw reading is about 10000 at 30mA (3uA per count)
To use 0-30mA (or 4-20mA) sensors, after setting the input jumper as
explained above, connect the current loop sensor between the +DC output
terminal and the input, like this:
The +DC output provides nominally 1V less than the voltage on the DC
input The standard DC adapter shipped with the ezeio™ outputs just over
12V If a higher voltage is required for the current loop sensor, either use a
different adapter for the ezeio™, or feed the current loop from an external
source, like this:
The internal current sense resistor in the ezeio™ is 100Ω, so the loop voltage
drop at 20mA will be 2V ( U = R · I )
Check the data sheet for your current sensor and make sure the voltage
source is at least 2V higher than the minimum voltage for your sensor
Page 18 of 121
0-10V / 4-20mA
Relays
Inputs
Max 50V, 2A
Server
GSM/GPRS
1 2 3 4
+
1 B A
+
2 . . . .
ModBus
N NO N NO
Inputs 1 - 4 ▶
Current loop
using DC rom
eze io
+ DC◀
0-10V / 4-20mA
Relays
Inputs
Max 50V, 2A
Server
GSM/GPRS
1 2 3 4
+
1 B A
+
2 . . . .
ModBus
N NO N NO
Inputs 1 - 4 ▶
Current loop
using external
DC source
Common ◀
C = 0 volts
Relay outputs
There are two relay outputs on the ezeio™ Each output has three screw
terminals;
NC (Normally Closed)
RE (center)
NO (Normally Open)
The RE terminal is connected to NC when the relay is not energized, and to
NO when the relay is energized
Examples of how to connect a load (here shown as a light bulb):
The relays are rated 50V and 2A. Higher voltage or current can
cause permanent damage to the relays.
The relay outputs are dry contacts. If the load is inductive, please apply
appropriate protection such as spark inhibitor and/or flyback diode.
+ DC output terminal
The + output terminal can be used to power external sensors or relays The
voltage on this terminal is nominally 1V lower than the input voltage on the
DC input jack The + DC output can supply up to 200mA
Page 19 of 121
0-10V / 4-20mA
Relays
Inputs
Max 50V, 2A
Server
GSM/GPRS
1234
+
1 B A
+
2 . . . .
ModBus
N NO N NO
GSM/GPRS
0-10V / 4-20mA
Relays
Inputs
Max 50V, 2A
Server
123 4
+
1 B A
+
2. . . .
ModBus
N NO N NO
V
Using power
from the ezeio
External
power source
icroLAN
MicroLAN allows you to connect temperature and RH sensors to the ezeio™
The system automatically detects the type of sensor connected, and adds it to
the configuration
The ezeio™ supports up to 20 devices connected to the MicroLan connector
Only Micro AN devices supplied by eze System will work with the
ezeio™. Supported sensors are automatically detected and added to the
configuration.
icroLAN indicator
The MicroLan LED indicates the status of the MicroLan device
communications according to this table:
Blink pattern Meaning
off No devices detected and no devices expected
on Initializing
fast flash Searching for new devices
slow flash Devices configured/expected, but none
communicating
2-flash Communicating, but at least one device missing
1-flash Communicating with all devices
Connecting a icroLAN device
To add a MicroLan device to the ezeio™, remove power from the ezeio™,
connect the new sensor and power up the unit The ezeio™ will automatically
detect the type of sensor and add it to configuration
See ezeio™ Configuration on page 37 for more information
To connect multiple MicroLAN devices, use MicroLAN splitters and
extension cables as illustrated below
Do not exceed 150ft (50m) total wire length on the MicroLAN network
Page 20 of 121
This manual suits for next models
1
Table of contents
