TrakHound MTConnect.NET
Run an Agent, or Build MTConnect into Your Own Application

Get Started

Install the Agent to connect machines and serve their data, or use the NuGet packages to build Agents, Adapters, and Clients of your own. Everything is free and open source under the MIT License.

Install on Windows
Run the installer, then add your Devices and Modules to the Agent's configuration. The Agent runs as a Windows Service and serves data on port 5000.
Download Agent
Run in Docker
Run the Agent on Linux or Windows with Docker, including ARM devices. Mount your own configuration and Devices with -v.
docker run -p 5000:5000 trakhound/mtconnect.net-agent
Docker Hub
Embed an Agent
Create an Agent application of your own, with your code reading the machine and the Agent in the same process.
dotnet new install MTConnect.NET-Agent-Template
dotnet new mtconnect.net-agent
Getting Started
Read from an Agent
Add the client libraries to a .NET application to read Devices and data from any MTConnect Agent.
dotnet add package MTConnect.NET
Client Libraries
A .NET Native MTConnect Agent

MTConnect Agent

A complete MTConnect Agent that reads data from machines, adapters, and other Agents, and serves it to any MTConnect client. Install it on Windows, run it on Linux, or start it in Docker, then choose what it does by adding Modules to its configuration file.

  • Supports MTConnect versions up to 2.7, and answers each client in the version it asks for
  • Input Modules read from SHDR Adapters, MQTT brokers, other Agents, and Fanuc, Haas, and Tormach controls
  • Output Modules serve Probe, Current, Sample, and Assets over HTTP, and publish to MQTT, in XML or JSON, with HTTPS and TLS
  • A Web UI for browsing Devices, current values, and Assets, and for editing the configuration
  • A durable buffer that keeps the Agent's data through restarts
  • Python Processors that transform data as it arrives
  • Validates Devices and data against the MTConnect Standard
  • Devices in a single devices.xml file, or a folder with a file for each Device
  • Restarts itself when its configuration changes
  • Runs as a Windows Service or a console application, with logging through NLog
Connect Fanuc, Haas, and Tormach Machines Without a Separate Adapter

Built-In Machine Support

The Agent includes Modules that read data directly from Fanuc, Haas, and Tormach CNC controls. Add a Module to the Agent's configuration with the machine's address, and the Agent creates the Device and starts reporting MTConnect data, with no separate adapter to install or maintain.

Fanuc
FOCAS over Ethernet
Reads Fanuc Series 0i, 16i, 18i, 21i, 30i, 31i, 32i, and 35i controls. Paths, axes, and spindles are read from the CNC when it connects, and the Device is built to match.
Data Read from the Control
AvailabilityEmergency StopMode & ExecutionProgram & LinePart CountTool NumberFeedrate & OverridesAlarmsSpindle Speed & LoadAxis Positions & LoadsTimersWork Offset
Configuration
modules:
  - fanuc-adapter:
      deviceKey: M1
      server: 192.168.1.70
      port: 8193
Requires the Fanuc FOCAS2 libraries (available from Fanuc) and FOCAS enabled on the CNC's Ethernet port.
Setup Guide
Haas
Ethernet or RS-232
Reads Haas controls, including the Next Generation Control, using Haas Machine Data Collection. Supports up to five axes, with machine and work positions.
Data Read from the Control
AvailabilityMode & ExecutionProgramPart CountsTool NumberAlarmsSpindle Speed & LoadAxis PositionsTimers & Cycle TimesWork OffsetCoolant LevelSoftware Version
Configuration
modules:
  - haas-adapter:
      deviceKey: VF2
      server: 192.168.1.60
      port: 5051
Enable Machine Data Collection on the control by setting Setting 143 to the TCP port to use.
Setup Guide
Tormach
PathPilot over Ethernet
Reads Tormach machines running PathPilot. A small status server included with the Agent runs on the controller and sends the machine's status to the Agent. It only reads status, and never sends commands to the machine.
Data Read from the Control
AvailabilityEmergency StopMode & ExecutionProgram & LineTool NumberWork OffsetOptional StopFeedrate & OverridesSpindle Speed & OverrideAxis Positions
Configuration
modules:
  - tormach-adapter:
      deviceKey: PCNC1100
      server: 192.168.1.80
      port: 7890
Copy the PathPilot status server to the controller and start it. PathPilot doesn't report alarms or part counts.
Setup Guide
Send Data from PLCs and Other Equipment to an Agent

MTConnect Adapter Framework

For equipment without built-in support, write a Data Source that reads the PLC or controller, and the Adapter Framework sends its data to any MTConnect Agent. You write the code that reads the machine, and the framework does the rest.

  • Data Source Modules read the equipment, and Output Modules send the data
  • The SHDR Module sends data to an MTConnect Agent over TCP
  • The MQTT Module publishes data to an MQTT broker for an Agent to read
  • Runs as a Windows Service, and restarts when its configuration file changes
  • Updated through NuGet, so new versions don't mean copying source code
  • Or skip the Adapter and embed an Agent in your application with the mtconnect.net-agent template
Read MTConnect Data in Your .NET Applications

MTConnect Client Libraries

NuGet libraries for reading data from any MTConnect Agent, from a single Current request to a long-running stream, in applications that target .NET Framework 4.6.1 through .NET 10.

  • Probe, Current, Sample, and Assets requests
  • HTTP and MQTT clients, reading XML or JSON
  • Streams Sample data, with compression, and reconnects when the connection drops
  • HTTPS and TLS
  • Typed Response Documents and entities, the same whatever the protocol or format
  • IntelliSense documentation from the MTConnect Standard, generated from the MTConnect SysML model
  • Converts units automatically
var client = new MTConnectHttpClient("localhost", 5000);
client.ObservationReceived += (s, observation) =>
{
    var value = observation.GetValue(ValueKeys.Result);
    Console.WriteLine($"{observation.DataItemId} = {value}");
};
client.Start();
Feel free to reach out to learn more

Contact Us