umatiConnect - Bidirectional data bridge between umati OPC UA for Machine Tools (UA4MT) and MTConnect. https://umati.org/umaticonnect
  • C# 66.7%
  • Python 27.8%
  • Dockerfile 4.3%
  • Shell 1.2%
Repository files (latest commit first)
Filename Latest commit message Latest commit date
umati-bot d0c4773b19
All checks were successful
Lint / Lint (push) Successful in 25s
chore(deps): update dotnet monorepo (#29)
This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
| [mcr.microsoft.com/dotnet/aspnet](https://github.com/dotnet/aspnetcore) | final | digest | `7644f99` → `f1126d4` |
| [mcr.microsoft.com/dotnet/sdk](https://github.com/dotnet/sdk) | stage | digest | `ea8bde3` → `72dd743` |

---

### Configuration

📅 **Schedule**: (UTC)

- Branch creation
  - Between 12:00 AM and 03:59 AM (`* 0-3 * * *`)
- Automerge
  - At any time (no schedule defined)

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

👻 **Immortal**: This PR will be recreated if closed unmerged. Get [config help](https://github.com/renovatebot/renovate/discussions) if that's undesired.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box

---

This PR has been generated by [Mend Renovate](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My4yNTUuMiIsInVwZGF0ZWRJblZlciI6IjQzLjI4Ni4wIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6W119-->

Reviewed-on: #29
2026-08-06 08:34:01 +02:00
.github chore(deps): update actions/checkout action to v7.0.1 (#28) 2026-08-05 13:20:59 +02:00
documentation fix: run ci on codeberg 2026-06-10 13:55:34 +02:00
mapping extract MTC Mazak compliance in seperate branch 2025-09-02 17:42:58 +02:00
mtc2umati chore(deps): update dotnet monorepo (#29) 2026-08-06 08:34:01 +02:00
tools refactor: fix documentation and license information 2025-09-02 17:42:58 +02:00
umati2mtc chore(deps): update python:3.14-slim docker digest to cea0e60 (#27) 2026-08-05 11:25:31 +02:00
.gitattributes refactor, mtc2umati docker support 2025-07-28 17:16:30 +02:00
.gitignore refactor: linting 2025-09-02 17:42:24 +02:00
LICENSE feat: Initial commit 2025-02-10 13:47:04 +01:00
README.md Release v1.0.0 2025-10-01 10:09:19 +02:00
renovate.json fix: lint renovate config 2026-06-09 14:46:43 +02:00

umatiConnect

License: Apache-2.0 .NET Python

Bidirectional data bridge between umati OPC UA for Machine Tools (UA4MT) and MTConnect.

This is the result of a research project between the VDW-Forschungsinstitute and the Institute of Production Engineering and MachineTools at the Leibniz University Hannover.

Research Report

Architecture

This project provides two software adapters:

  • mtc2umati (.NET 9.0): Sets up an UA4MT OPC UA Server, reads MTConnect XML data streams and writes to the corresponding OPC UA nodes
  • umati2mtc (Python 3.11): Translates UA4MT OPC UA data provided by the umatiGateway to MTConnect SHDR format and sends it to an MTConnect Agent.

Both components support Excel-based mapping configurations and containerized deployment.

Quick Start

MTConnect → OPC UA4MT (C#/.NET)

cd mtc2umati
docker compose up --build -d
  • Connects to public Mazak MTConnect Server at http://mtconnect.mazakcorp.com:5610/current (check if online).
  • New server can be added or configured in the config.json file.
  • The umati OPC UA Server will be available at opc.tcp://localhost:5440.

OPC UA4MT → MTConnect (Python)

cd umati2mtc
docker compose up --build -d
  • Simulates incoming data from an umatiGateway, sent to an MQTT broker at mqtt://localhost:1883.
  • Builds an SHDR Server at http://localhost:7878.
  • Parses the data and writes it to an MTConnect Agent using SHDR format.
  • Uses Mazak's Device.xml information model for MTConnect as found in the public servers at http://mtconnect.mazakcorp.com.
  • The MTConnect Agent dashboard will be available at http://localhost:5000.

Configuration

Mapping configurations are stored in the Excel file (mapping/mapping.xlsx) allowing data transformations between protocols without code changes.

Standards Compliance

  • UA4MT: OPC UA Companion Specification for Machine Tools (OPC 40501-1 v1.02)
  • MTConnect: MTConnect Standard Part 2 & 3 (v2.2.0)
  • OPC UA: Core specifications with security profiles

For details see Specs

Limitations

Currently this project is limited to OPC UA for Machine Tools and the corresponding variables in MTConnect.

License

This implementation is licensed under the Apache License v2.0.

Trademarks

umati is a registered trademark of VDW - German Machine Tool builders' association.

MTConnect® is a registered trademark of AMT - The Association for Manufacturing Technology.