MTConnect® Http REST Clients

These client classes use the Http REST Api that is described in Part 1 : Section 5.4 & Section 8 of the MTConnect Standard.

MTConnectClient

The MTConnectClient class is the primary class to use when wanting to implement the full MTConnect protocol. This class handles an initial Probe request to gather capabilities of the Agent, a Current request to read the initial values, and a Sample request (at the specified Interval) to read successive values.

Class Initialization

Class initialization is straightforward in that specifiying the BaseUrl (the URL of the Agent) is all that is required. Then call the Start() method to start the request sequence.

No Device Name (Get All Devices)

using MTConnect.Clients.Rest; var baseUrl = "localhost:5006"; var client = new MTConnectClient(baseUrl); client.Interval = 500; client.Start();

Get Specific Device by Name

using MTConnect.Clients.Rest; var deviceName = "OKUMA.Lathe"; var baseUrl = "localhost:5000"; var client = new MTConnectClient(baseUrl, deviceName); client.Interval = 500; client.Start();

Handle Probe Received Event

(MTConnectDevices Response Document received from a Probe Request)

var client = new MTConnectClient(baseUrl, deviceName); client.OnProbeReceived += (sender, document) => { foreach (var device in document.Devices) { // Device Console.WriteLine(device.Id); // DataItems foreach (var dataItem in device.DataItems) { Console.WriteLine(dataItem.Id); } // Components foreach (var component in device.Components) { Console.WriteLine(component.Id); } } }; client.Start();

Handle Current Received Event

(MTConnectStreams Response Document received from a Current Request)

var client = new MTConnectClient(baseUrl, deviceName); client.OnCurrentReceived += (sender, document) => { foreach (var deviceStream in document.Streams) { // DeviceStream Console.WriteLine(deviceStream.Name); // Component Streams foreach (var componentStream in deviceStream.ComponentStreams) { Console.WriteLine(componentStream.Name); // DataItems (Samples, Events, and Conditions) foreach (var dataItem in componentStream.DataItems) { Console.WriteLine(dataItem.DataItemId); } } } }; client.Start();