Controller · LinuxCNC
Connect LinuxCNC
LinuxCNC has an official mtconnect-agent HAL component: an embedded HTTP agent on port 5000 (bound to 127.0.0.1 unless HTTP_BIND=0.0.0.0), optional MQTT and SHDR on 7878, endpoints /probe, /current, /sample and /assets, validated against MTConnect 1.7 schemas.
At a glance
| Native protocol | MTConnect (mtconnect-agent component) |
|---|
| Port | 5000 HTTP; 7878 SHDR |
|---|
| MQTT | Optional (python3-paho-mqtt) |
|---|
Connection paths
mtconnect-agentRecommended
loadusr -W mtconnect-agent
Ports
| Port | Protocol | Note |
|---|
5000 | HTTP | Agent |
7878 | TCP | SHDR |
Software versions
- Documented in the LinuxCNC development manual (Oct 2026)
Data you can read
- HAL pins mapped with HAL_ITEM entries; device model from the INI file
Setting it up
- Load the componentloadusr -W mtconnect-agent in the HAL file.
- Expose itSet HTTP_BIND=0.0.0.0 to reach it from the network.
- Map itemsAdd HAL_ITEM entries for the pins you need.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|
| Agent unreachable from the network | Bound to localhost | Set HTTP_BIND=0.0.0.0. |
| Product | Vendor | Type | Outputs |
|---|
| MTConnect cppagent | MTConnect Institute (Apache-2.0) | Open source | MTConnect REST, MQTT |
CNC connector directory →
Sources
Facts on this page come from these documents, opened on 27 October 2026.
- LinuxCNC — mtconnect-agent
Last verified 27 October 2026 against vendor documentation. OPC UA Connect is an educational resource published by TEEPTRAK; it is not affiliated with the OPC Foundation, the MTConnect Institute or any control maker.