Agent SDK

Agent SDK is a Java library that allows to implement Agent in the form of a Java application running on a PC or mobile device. That application mimics Agent based on a hardware controller by connecting to Iotellect Server via a secure network connection and providing a number of settings (variables), operations (functions), and events.

In contrast to a Java application that uses Iotellect Server API, an application written using Agent SDK connects to Iotellect Server in "device mode". It emulates or implements a hardware device connected to Iotellect.

Agent can be also implemented using .NET API.

Java-based Agents are ideal for connecting PC-based equipment to Iotellect for monitoring and management. Some examples of devices that can run PC-based Agent:

• Vending Machines

• Self Service Kiosks

• ATMs

• Remote Data Collection Stations

• etc.

Device Server SDK bundle includes an open-source example of Java-based Agent. It is a runnable Java class DemoAgent located in examples.agent package. To try the demo agent, change server address/port/login/password in the constructor of RemoteServer class run DemoAgent class. It should connect to the server and auto-register a new Device account.

Technically, a Java-based Agent is a Java application or part of an application that:

• Creates an instance of Agent class

• Retrieves the implementation of the Agent's Context using Agent.getContext() method

• Configures the context by adding definitions of variables, functions, and events. These are settings, operations, and events "provided by the hardware device" in terms of Iotellect.

• Provides custom VariableGetter and VariableSetter for every Agent setting. These classes implement custom logic of reading and writing setting values.

• Provides custom FunctionImplementation for every Agent operation. These classes implement the logic of operations, i.e. processing the input and generating the output.

• Connects to the Iotellect Server on startup or at any desired time and starts processing server commands. These commands will trigger variable reads/writes and function execution.

• Asynchronously fires events in the Agent context using Context.fireEvent() method after the server connection has been established.

Was this page helpful?

Tell us more

Send

Thank you!