The Rest Device Adapter package provides functionality to remotely manage devices that are connected to the Remote Manager via Reset API call invocations.


In a nutshell, there is custom device management protocol based on Rest API defined and supported by this package.

Via using Rest Calls, devices can:

  • provide their monitoring data;

  • obtain control commands;

  • confirm their executions.

The Rest Device Adapter allows wide possibilities to introduce remotely managed devices – from very simple devices. like sensors sending just current values, to sophisticated “rich” devices that accept configurations, support synchronization sessions, dynamically generate types of monitored resources and so on.

Functionalities

The Rest Device Adapter package provides the following functionalities:

  • supports different scenarios for registration of Rest API provided devices;

  • supports different scenarios of device authentication;

  • supports sending monitoring data from the device to the Remote Manager;

  • supports synchronization sessions for optimizing the data transfer volume;

  • supports sending control commands from the Remote Manager to the device;

  • defines concept for dynamic configuring of the data transfer;

  • statically and dynamically defines the types of monitored device resources.


Package Dependencies

The Rest Device Adapter package requires the following packages for its proper operation:

  • System Package – comprises the core of the entire RM system.

  • Generic Device Management Package – delivers the general model, called "Control Unit" model, for managing various type of devices and/or other manageable resources in a common way.

Directory Structure

Directory

Sub-Directory

Description

initial_config

/<device-type>

This sub-folder holds the predefined metadata of devices connected to the RM via REST API Device Adapter protocol..

packages

/restcu

Contains the bundles for managing REST devices, installed on the backend.

These are binaries, which are not supposed to be accessed by the user.


The Remote Manager does not come with a ready-to-use device-side client. Instead, it specifies the protocol that is supported on the server-side and it is responsibility to the Rest-API provided devices to integrate implementation of the client-side of the protocol.