Ayyeka Wavelet User manual

Rev. 1.5 September 2017

www.ayyeka.com | [phone] |[email protected] 2
Contents
Notices.................................................................................................................................................................. 7
TrademarkAcknowledgments.......................................................................................................................... 7
FCC Notice ........................................................................................................................................................ 7
Compliance Information................................................................................................................................... 7
Glossary ................................................................................................................................................................ 8
Introduction.......................................................................................................................................................... 9
Scope ................................................................................................................................................................ 9
Related Documentation ................................................................................................................................... 9
Product Overview............................................................................................................................................... 10
Wavelet Kits.................................................................................................................................................... 11
Wavelet Device............................................................................................................................................... 11
Sensor Integration .......................................................................................................................................... 11
User Interface................................................................................................................................................. 12
Installing the Wavelet Kit ................................................................................................................................... 13
Assembling the Wavelet Kit............................................................................................................................ 13
Connecting to an External Power Source....................................................................................................... 13
Turning the Wavelet On ................................................................................................................................. 14
Ayyeka Web-based Data Management System ................................................................................................. 15
Accessing the Data Management System ...................................................................................................... 15
Understanding Sites’ Hierarchy...................................................................................................................... 15
Understanding User Roles.............................................................................................................................. 17
Account roles.............................................................................................................................................. 17
Organization roles ...................................................................................................................................... 17
Getting Started ............................................................................................................................................... 17
Using the Ayyeka Visualization window............................................................................................................. 19
Viewing Site Information................................................................................................................................ 21
Understanding the Data Stream Chart........................................................................................................... 23
Setting the Time Range............................................................................................................................... 23
Setting the Time Frame .............................................................................................................................. 23
Using the Zoom and View tools.................................................................................................................. 24
Comparing Data Streams................................................................................................................................ 24

www.ayyeka.com | [phone] |[email protected] 3
Generating Reports ............................................................................................................................................ 26
Stream History Report.................................................................................................................................... 26
Aggregation Report ........................................................................................................................................ 28
Custom Stream History Report ...................................................................................................................... 31
Managing Sites ................................................................................................................................................... 34
Viewing a Site ................................................................................................................................................. 34
Editing a Site ................................................................................................................................................... 35
Changing the Site Name and Organization................................................................................................. 35
Changing the Site Location ......................................................................................................................... 37
Managing Devices............................................................................................................................................... 38
Managing Device Configuration..................................................................................................................... 39
Setting the Device Transmission Intervals.................................................................................................. 39
Setting the Device Sampling Interval.......................................................................................................... 42
Viewing the Files Sent and Received by the Device....................................................................................... 42
Viewing the Device Event Log ........................................................................................................................ 42
Viewing the Commands Sent to the Device................................................................................................... 43
Viewing the Health of the Device................................................................................................................... 44
Viewing Device Cellular Information.............................................................................................................. 45
Managing Device Technical Alerts.................................................................................................................. 45
Viewing the List of Technical Alerts............................................................................................................ 46
Adding a Technical Alert............................................................................................................................. 47
Editing, Deactivating, Reactivating or Deleting a Technical Alert .............................................................. 49
Setting the Device Reporting Profile .............................................................................................................. 50
Setting Up Live Notifications .......................................................................................................................... 52
Cancelling Live Notifications....................................................................................................................... 53
Managing Data Streams ..................................................................................................................................... 55
Viewing a Data Stream ................................................................................................................................... 55
Editing a Data Stream..................................................................................................................................... 56
Hiding a Data Stream...................................................................................................................................... 58
Viewing and Filtering Samples ....................................................................................................................... 60
Sorting the Samples table........................................................................................................................... 60
Hiding Samples in the Samples table ......................................................................................................... 61

www.ayyeka.com | [phone] |[email protected] 4
Filtering the Samples table ......................................................................................................................... 61
Configuring Data Stream Thresholds ............................................................................................................. 62
Accessing the threshold view ..................................................................................................................... 62
Changing threshold settings ....................................................................................................................... 64
Adding a new threshold.............................................................................................................................. 67
Setting Threshold Actions........................................................................................................................... 68
Viewing and Editing the Treatment of Raw Data........................................................................................... 75
Hiding Bad Samples of Raw Data................................................................................................................ 76
Changing the Conversion Formula ............................................................................................................. 77
Limiting Display of Engineering Values....................................................................................................... 80
Managing a Stream’s Sampling Interval......................................................................................................... 81
Discovering a Stream’s Sampling Interval Value ........................................................................................ 81
Discovering a Stream’s Association with a Sample Group ......................................................................... 83
Changing a Stream’s Association with the Sample Groups........................................................................ 84
Setting the Sampling Interval Value of a Sample Group ............................................................................ 86
Setting a Stream’s Custom Sampling Interval Value .................................................................................. 88
Managing Organizations..................................................................................................................................... 89
Adding an Organization.................................................................................................................................. 89
Editing an Organization .................................................................................................................................. 91
Managing Users.................................................................................................................................................. 92
Viewing the List of Users ................................................................................................................................ 92
Inviting a New User ........................................................................................................................................ 93
Editing, Disabling or Deleting a User .............................................................................................................. 98
Adding Existing Users to Organization(s) ....................................................................................................... 99
Managing User Groups..................................................................................................................................... 101
Adding a User Group .................................................................................................................................... 102
Assigning a User to a Group ......................................................................................................................... 104
Removing a User from a Group.................................................................................................................... 105
Editing a Group............................................................................................................................................. 105
Sharing Sites and accounts ............................................................................................................................... 106
Sharing Sites with Any User.......................................................................................................................... 106
Sharing an Account with any Ayyeka User................................................................................................... 108

www.ayyeka.com | [phone] |[email protected] 5
Setting Personal Preferences ........................................................................................................................... 110
Setting Your Own User Details ..................................................................................................................... 110
Changing your own password .................................................................................................................. 112
Forgot password ....................................................................................................................................... 113
Sending a Test Email and SMS.................................................................................................................. 114
Customizing your User Interface Display ..................................................................................................... 115
Using the Ayyeka API........................................................................................................................................ 117
Using the Ayyeka REST API ........................................................................................................................... 117
Gaining Access to Ayyeka Data via the REST API...................................................................................... 117
Using the Ayyeka REST API Methods........................................................................................................ 121
Using the Ayyeka SOAP API .......................................................................................................................... 122
Gaining Access to Ayyeka Data via the SOAP API..................................................................................... 122
Using the Ayyeka SOAP API Methods....................................................................................................... 123
Maintenance..................................................................................................................................................... 124
Wavelet Battery Replacement ..................................................................................................................... 124
Battery Replacement Instructions............................................................................................................ 124
Troubleshooting ............................................................................................................................................... 126
Wavelet device does not turn on ................................................................................................................. 126
LED Light Status Indicators ........................................................................................................................... 127
LEDs Status Indications............................................................................................................................. 127
Accessing the Interface Board LEDs ......................................................................................................... 128
Technical Support –Contact Information .................................................................................................... 129
FAQ ................................................................................................................................................................... 130
Is the wavelet activator unique per device? ................................................................................................ 130
Why are updated GPS coordinates not appearing in the UI? ...................................................................... 130
What is the recommended range for the device cellular signal? ................................................................ 130
How can I change the destination server address? ..................................................................................... 131
Why are device configuration changes not taking effect?........................................................................... 132
Rebooting a Device................................................................................................................................... 132
Specifications.................................................................................................................................................... 133
Wavelet Specifications ................................................................................................................................. 133
Wavelet Mechanical Drawings..................................................................................................................... 136

www.ayyeka.com | [phone] |[email protected] 6
Appendix A: Connector 42-00009 datasheet ................................................................................................... 137
Ayyeka Warranty .............................................................................................................................................. 138
Revision History................................................................................................................................................ 143

www.ayyeka.com | [phone] |[email protected] 7
NOTICES
© Copyright 2017 Ayyeka Technologies Ltd.
Trademark Acknowledgments
Ayyeka® is a registered trademark of Ayyeka Technologies Ltd. WaveletTM is a trademark of Ayyeka Technologies
Ltd.
All other trademarks are property of their respective owners.
FCC Notice
Contains FCC ID: QIPPXS8
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.
Compliance Information
The Wavelet device complies with the following radiated emission standards:
ETSI EN 301 489-1/-17 Class B
CFR 47 FCC Part 15 Subpart B Class B
The Wavelet device complies with Immunity per ETSI EN 301 .

www.ayyeka.com | [phone] |[email protected] 8
GLOSSARY
Term
Explanation
API
Application Programming Interface.
A set of routines, protocols, and tools for building software and
applications
Cloud computing
Internet-based computing, providing shared resources, data and
information to computers and other devices on-demand.
SCADA
Supervisory Control and Data Acquisition.
A system for remote monitoring and control.
UI
User Interface

www.ayyeka.com | [phone] |[email protected] 9
INTRODUCTION
Scope
This document is intended for users, installers and integrators of Wavelet Kits.
Related Documentation
Ayyeka Knowledge Base
Wavelet Kits Quick Start Guides
Wavelet Datasheet
Sensor Documentation
API Web API Guide
Ayyeka DNP3 Outstation Installation Guide

www.ayyeka.com | [phone] |[email protected] 10
PRODUCT OVERVIEW
Ayyeka’s Wavelet™ is a remote infrastructure monitoring tool that delivers field data to decision makers. It is an
all-inclusive, plug-and-play system, including batteries, SIM card, sensors, and installation hardware.
After learning your specific needs, Ayyeka pre-integrates the appropriate sensors with the Wavelet data collection,
storage and communication device which is then installed onto existing infrastructure.
The data collected from the sensors is stored on Ayyeka’s secure private cloud server, and/or can be integrated
directly into your on-premises servers.
An Ayyeka web-based data management system enables you to configure the device over-the-air and program
various parameter threshold levels for email and/or SMS alerts, visualize data in real-time, and produce reports
for presentation and analysis. Using Ayyeka’s API, data can be integrated directly into your SCADA systems,
business intelligence or other analytic software.
Figure 1: Ayyeka Wavelet system

www.ayyeka.com | [phone] |[email protected] 11
Wavelet Kits
Each Wavelet Kit, composed of a Wavelet device and smart sensors, is targeted at a specific need in the
infrastructure sector. The intended usage dictates the type of sensors included in the kit. Ayyeka offers various kits
in each of the following categories:
Water
Wastewater
Environmental
Oil & Gas
Industrial
Wavelet Device
The Wavelet device periodically samples the connected sensors and transmits the data to the Ayyeka cloud or to
your on-premises server. The device supports 2G, 3G, LTE (4G), CDMA, LPWAN, Satellite, and Bluetooth low-energy
networks, and can interchangeably use the strongest available cellular signal.
The Wavelet device is powered by a field-replaceable internal battery that provides
3,500+ transmissions. Alternatively, the device can be connected to an external battery,
solar panel or permanent power source.
The Wavelet device can be mounted in various ways, including:
Affixed to a pipe, using the supplied zip ties
Affixed to a wall, using the supplied four screws and anchors
Hung on a wall, using one of the supplied screws and anchors
Sensor Integration
Each Wavelet device has three sensor connector ports and supports any combination of the following types of
sensors:
Serial
Analog
Discrete
The specific types of sensors and sensor connectors in a kit depend on the kit type.

www.ayyeka.com | [phone] |[email protected] 12
User Interface
The data collected by the Wavelet device and transmitted to the Ayyeka cloud can be viewed in the Ayyeka
web-based data management system. This system enables:
Visualizing data in real-time
Generating reports for presentation and analysis
Defining threshold levels for email and/or SMS alerts for various parameters
Over-the-air remote device configuration
Receiving battery level notifications for predictive maintenance scheduling
Figure 2: Ayyeka web-based data management system

www.ayyeka.com | [phone] |[email protected] 13
INSTALLING THE WAVELET KIT
Assembling the Wavelet Kit
The assembly instructions depend on the type of Wavelet Kit. Refer to the Quick Start Guide corresponding to your
kit type.
Connecting to an External Power Source
If you wish to connect the Wavelet device to an external power source, follow these guidelines:
Use a 42-00009 (SAL - 8 - RSC3-S) CONEC connector (refer to Appendix A: Connector 42-00009 datasheet).
Perform power connector assembly as illustrated in Figure 3.
Figure 3: Power connector assembly instructions
Use a cable with a round and even cross-section having the following specifications:
Cable wire cross section surface area: 0.14-0.5 mm2
Wire gauge: AWG 26-20
Cable diameter Ø: 4-5.5 mm

www.ayyeka.com | [phone] |[email protected] 14
Turning the Wavelet On
The Wavelet device is delivered in hibernation mode. To turn it on, press the magnetic activator, provided in the
Wavelet Kit, onto the Ayyeka logo appearing on the Wavelet device.
The Wavelet device turns on and performs a 10-minute calibration process, after which it starts operating in
normal mode.
Note: Every time you press on the Ayyeka logo with the magnetic activator, the device
performs a calibration process.
Figure 4: Turning Wavelet device on

www.ayyeka.com | [phone] |[email protected] 15
AYYEKA WEB-BASED DATA MANAGEMENT SYSTEM
The Ayyeka data management system provides the following:
Visualization window –enables viewing your site deployment from the macro to the micro level
Reports window –enables generating reports and exporting them for viewing and sharing
Devices window –enables you to view and manage all your Sites, Devices and Data Stream configurations.
Previously, this was part of the Management tab
Account window –enables you to manage all Organizations, Users and User Groups. Previously, this
functionality was provided in the Management tab
API window –enables access to the Ayyeka REST API and SOAP API, which provide programmatic access
to your Wavelets' information
Accessing the Data Management System
To access the Ayyeka data management system:
Navigate to home.ayyeka.com and enter your Ayyeka credentials. The Initial Visualization window
appears.
Understanding Sites’ Hierarchy
Your system (also called an account) is organized hierarchically as follows:
Account
Organization(s)
Site(s)
Device(s)
Data streams(s)

www.ayyeka.com | [phone] |[email protected] 16
Figure 5: Account hierarchy
In the example shown above, the AYYEKA TRAINING account consists of two organizations, Environmental and
Wastewater Utility. Environmental manages two sites. A site is a representation of a physical location. Typically, each
site includes one device. In some instances, multiple devices might be assigned to a single site. Each device
generates and subsequently transmits data streams (time-stamped data) from one or more sensors (such
as pressure, turbidity, conductivity, etc.) integrated with the device.
Every account’s hierarchy is pre-defined to match the actual deployment of its devices and their sensors. The only
hierarchy changes an account owner can make is to add organizations, and unassign/assign sites to organizations.
Note: The Organization level is optional. If no organizations are defined, all sites are
grouped directly under the Account level. This is common in small accounts.

www.ayyeka.com | [phone] |[email protected] 17
Understanding User Roles
The system supports two sets of roles: Account roles and Organization roles.
Account roles give permissions with regards to all account assets.
Organization roles give permissions with regards to a specific organization’s assets.
Account roles
Each role level is given the permissions given to lower-level roles, plus some additional permissions. The roles,
from lowest to highest, include:
No Access - Alerts Only –Can only receive threshold alerts from account devices.
Account Operator –Can also view sites and streams of this account.
Account Analyst –Can also generate reports.
Account Engineer –Can also manage all sites and streams of this account.
Account Administrator –Can also set device configuration for all devices in this account.
Account Owner –Can also manage all users, groups and organizations of this account.
Organization roles
Each role level is given the permissions given to lower-level roles, plus some additional permissions. The roles,
from lowest to highest, include:
No Access - Alerts Only –Can only receive threshold alerts from organization devices.
Organization Operator –Can also view sites and streams of this organization.
Organization Analyst –Can also generate reports.
Organization Engineer –Can also manage all sites and streams of this organization.
Organization Administrator –Can also set device configuration for all devices in this organization.
Organization Owner –Can also manage all users and groups of this organization.
Getting Started
After becoming acquainted with the Sites’ Hierarchy and the available User Roles, it is recommended to perform the
following to set up your account:
1. If you are an account owner you may wish to create or edit organizations. Refer to Managing
Organizations.
2. Create or edit users, giving them the necessary permissions. Refer to Managing Users.
3. Create user groups, which define who receives alerts when data thresholds are exceeded. Refer to
Managing User Groups.
4. View your sites (groups of Wavelet devices), and edit their settings if necessary. Refer to Managing Sites.

www.ayyeka.com | [phone] |[email protected] 18
5. Manage the various data streams received from each specific sensor:
Trim the raw data; then view the formula for converting raw data into engineering units, and edit if
necessary. Refer to Viewing and Editing the Treatment of Raw Data.
View the samples table, and hide values that are not real values. Refer to Viewing and Filtering
Samples.
Set thresholds. When a threshold is exceeded, an alert is sent to the corresponding user group, and
certain data stream actions can be taken. Refer to Configuring Data Stream Thresholds.
View and optionally change a stream’s sampling interval; this is the rate at which the Wavelet
samples the relevant sensor for data. Refer to Managing a Stream’s Sampling Interval.
6. View the settings of your Wavelet devices, and modify if necessary. Refer to Managing Devices.

www.ayyeka.com | [phone] |[email protected] 19
USING THE AYYEKA VISUALIZATION WINDOW
Click the Visualization tab to display the initial Visualization window.
Figure 6: Initial Visualization window

www.ayyeka.com | [phone] |[email protected] 20
The Visualization window is composed of a sidebar, Sites Tree pane and a right pane.
Side bar –links to the 5 main views: Visualization, Reports, Devices, Account, API. The available views
depend on your permissions (role).
Sites Tree pane –lists all Wavelet sites and their data streams:
The Sites Tree pane includes also a search box, which you can use to search for your sites.
If there are more than 5 search results, the results will not be displayed. In that case you need to refine
your search criteria.
Right pane - shows a zoomed-out map displaying clusters of data streams.
Using the zoom controls, you can zoom in for greater detail, down to an individual site and its data
streams.