com.prosyst.mprm.admin.devices (Bosch IoT Remote Manager 7.1 Generic Device Management Package API)

Interface Summary
Interface	Description
DeviceAttributes	Defines constants of attributes of device node properties as well as device properties that could be used for specifying script filters used for searching and execution of conditional management commands.
DeviceCapability	Represents characteristic of the device profile, such as device `CPU`, `Java Platform`, supported `OSGi Specification Version`, etc.
DeviceControlUnit	The Control Unit representation in mPRM.
DeviceGroup	Represents a logical group of devices in the mPRM Management Tree.
DeviceManager	Represents interface for remote management of devices in mPRM.
DeviceNode	Represents a device root control unit in the mPRM as a part of the management tree.
DynamicDeviceGroup
InheritableProperty	Represents information about the generic property assigned explicitly with a tree node object or inherited from some of its parent nodes.
Node	Represents node of the devices tree hierarchy.
NodeOperations	Operations that can be executed over a Node or Group.

Class Summary
Class	Description
ControlUnitID	Represents control unit id.
DeviceCapabilities	Represents a set of name-value properties characterizing the different aspects of the hardware and system software of a device registered in the mPRM.

Package com.prosyst.mprm.admin.devices Description

Provides API for Device Management in mPRM.

The API's basic interface is DeviceManager and it can be accessed in two ways:

as a service on the backend framework and it is accessible to the other bundles through methods defined by the OSGi Framework specification.

Example :

import com.prosyst.mprm.admin.devices.DeviceManager;
import org.osgi.framework.BundleContext;
import org.osgi.framework.ServiceReference;

.....

  public DeviceManager getDeviceManager(BundleContext context) {
    DeviceManager deviceManager = null;
    ServiceReference dmRef = context.getServiceReference("com.prosyst.mprm.admin.devices.DeviceManager");
    if (dmRef != null) {
      deviceManager = (DeviceManager)context.getService(dmRef);
    }
    return deviceManager;
  }

.....

as a stand-alone application, not depending on OSGi Framework, by using com.prosyst.mprm.rac.RemoteAccessClient. An external stand-alone application can use this package by including system-rac.jar and gdm-rac.jar in its classpath.

Example :

import com.prosyst.mprm.admin.devices.DeviceManager;
import com.prosyst.mprm.rac.RemoteAccessClient;
import java.util.Hashtable;

.....

  public DeviceManager getDeviceManager(RemoteAccessClient rac) {
    DeviceManager deviceManager = null;
    if (rac != null) {
      deviceManager = (DeviceManager)rac.getService("com.prosyst.mprm.admin.devices.DeviceManager");
    }
    return deviceManager;
  }

.....

  public static void main(String[] args) {

    //Open session using the system account.
    Hashtable credentials = new Hashtable();
    credentials.put(RemoteAccessClient.USER_PASSWORD, "system");
    RemoteAccessClient rac = RemoteAccessClient.connect("socket://mprm.acme.com:11449", "system", credentials, null);
    ...

    //Now the application can access DeviceManager service
    DeviceManager deviceManager = getDeviceManager(rac);

    ...
    //closing session
    rac.close();
  }

.....