3 IAP Standard Web Services for the IIoT · §Pre-installed field protocol support Communications support for LON, BACnet, and Modbus §Pre-installed services for automation and controls

3600 Peterson Way • Santa Clara, California 95054www.adestotech.com

IAP Standard Web Services for the IIoTRich Blomseth, Product Management DirectorMarch 13, 2019

http://www.adestotech.com/

Adesto View on Smart Buildings MarketExisting BAC Systems Smart Buildings

Commission & AuditAutomation

ControlsEnergy Management

Preventative Maintenance

Enterprise data sharingPersonalization

Cloud managementUtilization optimizationPredictive maintenance

§ IoT use cases for smart buildings are growing rapidly

§ IoT use cases driven by sensors, cloud applications and services

§ Any IoT solution must build on existing building automation and control systems for greater value –cannot rip and replace existing BAC systems

§ Existing BAC systems serve their purpose but do not easily extend to IoT

Copyright © 2019 Adesto

Today’s Solutions and LimitationsMajor Limitations:

Hierarchical management – closed to remote applications and cloud servicesLack of interoperability between networks and field protocolsLimited device profiles and applications are supported (e.g. BACnet)Expansion of new device types or media is not practicalManual installation and commissioning

Auto

mat

ion

Leve

lFi

eld

Leve

lM

anag

emen

t Le

vel


Fiel

dAu

tom

atio

n

§ “Not easily able to share data with enterprise and cloud systems”

§ “Disparate software suite for device management, controls and analytics”

§ “Securing networks and end points is time consuming and painful”

§ “Error prone installation and provisioning”§ “Not capturing IoT devices and sensors” § “Multiple SKUs and management

strategies for field devices”

Building Automation Integration Pain Points

Multi-protocol edge devices

Open north and south bound interfaces

Services and data abstraction layer for IoT

Standardized network services for discovery and provisioning

Extensible APIs to web based management systems

Open web services APIs

Solutions

End-to-end security framework

Mgm

t.

Pain Points


§ Stands for “IoT Access Protocol”§ Protocol agnostic web services APIs for IoT

and building/industrial applications

§ Interoperability layer for industrial protocols§ APIs facilitate device management, data

access, and controls apps

§ Common API for all protocols simplifies app development

§ APIs run on top of standard hardware architectures

§ APIs are available in JSON/MQTT or REST Copyright © 2019 Adesto

Why do we need IAP?

Web Services APIs

Edge

Pla

tform

IAP

CMSProtoco

l Engine

s

Services

Custom Apps, Web

Pages, &

Protocol Engines

Edge Server Framework at a Glance§ Connection agent for cloud and local services

Pub-sub broker connecting data to services running locally or remote

§ Pre-installed field protocol supportCommunications support for LON, BACnet, and Modbus

§ Pre-installed services for automation and controlsAlarming, logging, routing, provisioning…

§ Centralized management systemCustomizable web-based UI

§ Support for custom protocol enginesDriver template and installation support

§ Open freely available IAP APIsCreate and run device management and services

CMSProtoco

l Engine

s

Services

IAPCustom Apps, Web

Pages, &

Protocol Engines

CMS


§ IAP based APIs enable developers to create applications that:• Access data in edge devices• Provision and maintain devices• Monitor and manage alarms• Set and manage schedules

§ Applications using the APIs can run in a variety of places:• Remote browsers for a custom web UI• Remote servers for analytics, AI, and other types of applications• Locally hosted on the SmartServer IoT

§ Two IAP APIs are available• IAP/REST – for remote web pages• IPA/MQ – for local and remote applications

IAP BasicsRich Web Services Layer for Edge and Cloud Apps

2018 Echelon Corporation Confidential

§ Set the setpoint to 20° for temperature controller DID:

§ Subscribe to light level updates from lux sensor DID:


IAP/MQ Examples

let topic = 'glp/0/' + SID + '/rq/dev/lon/' + DID + ‘/if/TempController/0';

mqttClient.publish (topic, '{ "SP": { "value": 20 }}');

let topic = 'glp/0/' + SID + '/fb/dev/lon/' + DID + '/if/LightSensor/0';

mqttClient.subscribe (topic);

§ Set lighting controller 17q2d95.4 to on:

§ Get all level 1 logged datapoints named nvoEnergy from device 17q2d95.4:


IAP/REST Example Requests

PUT /iap/devs/17q2d95.4/if/Lamp/0/nviValue/value {"value":100,"state":1}

GET /iap/devs/17q2d95.4/if/*/*/*+name==nvoEnergy&tag==log_level_1/logs/value/*

§ Datapoint log response for a logged Lamp nviValue datapoint:


IAP/REST Example Response

[ {

"id" : 19,

"local" : "2017-08-23 11:34:22.123 BST",

"utc" : "2017-08-23 10:34:22.123 UTC",

"deviceId" : 17q2d95.4,

"blockName" : "Lamp",

"blockIndex" : "0",

"datapointName" : "nviValue",

"deviceState" : "provisioned"

"deviceHealth" : "normal",

"value" : {

"state" : 1,

"value" : 100

}

"tags":[

{"tag1": “log_level_1"}]

} ]

§ To learn more about IAP, visit www.echelon.com/docs/iot


IAP Web Services Documentation

http://www.echelon.com/docs/iot

§ Partial list, full list available at www.echelon.com/docs/iot


IAP/MQ Reference


§ Partial list, full list available at www.echelon.com/docs/iot


IAP/REST Reference


Convergence of IoT and Building Automation

Data sharing with enterprise Systems

ERP

Local secure error free provisioning

New device types and applications support by BAC systems

Single software suite for installation, management and analytics

Integration to Smart City and Grid

Predictive energy and space utilization


Documents

3 IAP Standard Web Services for the IIoT · §Pre-installed field protocol support Communications support for LON, BACnet, and Modbus §Pre-installed services for automation and controls