mtecconnect3dcp Python Library

This library provides a simple interface to connect and control m-tec machines via OPC UA and Modbus. It supports different machine types such as Mixingpump (duo-mix 3DCP (+), SMP 3DCP), Printhead (flow-matic PX), Dosingpump (flow-matic) via OPC-UA, and Pumps (P20, P50) via Modbus.

Developer Friendliness & IDE Support

This library uses comprehensive Python docstrings and type annotations. As a result, modern IDEs such as Visual Studio Code provide automatic tooltips, autocompletion, and inline help (IntelliSense). This gives you immediate guidance on parameters, return values, and usage of functions and classes while coding.

Note: For the best experience, it is recommended to use VS Code or another IDE with Python IntelliSense support.

Installation

Install this library:

pip install mtecconnect3dcp

Example

See /Python/example.py for an example of a print process. Below is a minimal usage guide:

from mtecconnect3dcp import Printhead, Dosingpump, Pump, Duomix, DuomixPlus, Smp

# Connect to a m-tec connect duo-mix 3DCP
mp = Duomix()
mp.connect("10.129.4.73") # 10.129.4.73 is the default ip
mp.speed = 50  # Set speed to 50Hz (20-50Hz range)
mp.run = True  # Start the mixingpump

# Connect to a Pump (P20/P50 via Modbus)
pump = Pump()
pump.connect(port="COM7")
pump.speed = 25  # Set speed to 25Hz
pump.run = True  # Start the pump

Supported Properties and Functions by Machine

Control

Function/Property	Get	Set	Type	Description	Pump (P20 & P50)	duo-mix 3DCP	duo-mix 3DCP+	SMP 3DCP	SMP 3DCP+	Dosingpump (flow-matic PX)	Printhead (flow-matic PX)
run	✅	✅	bool	Start/stop machine	✅	✅	✅	✅	✅	✅	✅
reverse	✅	✅	bool	Set/Get running reverse	✅	❌	❌	❌	❌	❌	❌
emergcency_stop()	❌	✅	function	Execute Emergency Stop	✅	❌	❌	❌	❌	❌	❌
speed	✅	✅	float/int	Set/Get speed	✅	✅	✅	✅	✅	✅	✅
dosingpump	✅	✅	bool	Start/stop dosingpump	❌	❌	✅	❌	✅	❌	❌
dosingspeed	✅	✅	float	Set dosingpump speed	❌	❌	✅	❌	✅	❌	❌
water	✅	✅	float	Set water flow (l/h)	❌	❌	✅	❌	✅	❌	❌
cleaning	✅	✅	bool	Start/stop cleaning water	❌	❌	❌	❌	❌	✅	❌
setDigital(pin, value)	❌	✅	function	Set digital output	❌	✅	✅	✅	✅	❌	❌
setAnalog(pin, value)	❌	✅	function	Set analog output	❌	✅	✅	✅	✅	❌	❌

Measure (GET)

Function/Property	Type	Description	Unit	Pump (P20 & P50)	duo-mix 3DCP	duo-mix 3DCP+	SMP 3DCP	SMP 3DCP+	Dosingpump (flow-matic PX)	Printhead (flow-matic PX)
m_speed	float	speed		✅	✅	✅	✅	✅	✅	✅
m_dosingspeed	float	speed of pump	%	❌	❌	❌	❌	✅	✅	❌
m_pressure	float	pressure	bar	❌	❌	✅	❌	✅	✅	✅ (optional)
m_water	float	water flow	l/h	❌	❌	✅	❌	✅	❌	❌
m_water_temperature	float	water temperature	°C	❌	❌	✅	❌	✅	❌	❌
m_temperature	float	mortar temperature	°C	❌	❌	✅	❌	✅	❌	❌
m_valve	float	valve position	%	❌	❌	✅	❌	✅	❌	❌
m_silolevel	float	Silo level	%	❌	❌	❌	✅	✅	❌	❌
m_voltage	bool	Voltage		✅	❌	❌	❌	❌	❌	❌
m_current	bool	Current		✅	❌	❌	❌	❌	❌	❌
m_torque	bool	Torque		✅	❌	❌	❌	❌	❌	❌
getDigital(pin)	function	Digital input	bool	❌	✅	✅	✅	✅	❌	❌
getAnalog(pin)	function	Analog input	0 - 65535	❌	✅	✅	✅	✅	❌	❌

Status (GET)

Function/Property	Type	Description	Pump (P20 & P50)	duo-mix 3DCP	duo-mix 3DCP+	SMP 3DCP	SMP 3DCP+	Dosingpump (flow-matic PX)	Printhead (flow-matic PX)
s_error	bool	error state	❌	✅	✅	✅	✅	✅	✅
s_error_no	int	error number	❌	✅	✅	✅	✅	✅	✅
s_ready	bool	Ready for operation	✅	✅	✅	✅	✅	✅	✅
s_mixing	bool	mixing	❌	✅	✅	✅	✅	❌	❌
s_pumping	bool	pumping	✅	✅	✅	✅	✅	❌	❌
s_pumping_forward	bool	pumping forward	✅	❌	✅	❌	✅	❌	❌
s_pumping_reverse	bool	pumping reverse	✅	❌	❔	❌	❔	❌	❌
s_pumping_net	bool	pumping via net	❌	✅	✅	✅	✅	❌	❌
s_pumping_fc	bool	pumping via FC	❌	✅	✅	✅	✅	❌	❌
s_remote	bool	hardware remote connected	❌	✅	✅	✅	✅	✅	✅
s_solenoidvalve	bool	solenoid valve open	❌	✅	✅	✅	✅	❌	❌
s_waterpump	bool	pumping waterpump running	❌	✅	✅	✅	✅	❌	❌
s_emergency_stop	bool	emergency stop ok	❌	❌	✅	❌	✅	✅	✅
s_on	bool	machine powered on	❌	❌	✅	❌	✅	✅	✅
s_safety_mp	bool	mixingpump safety ok	❌	❌	✅	❌	✅	❌	❌
s_safety_mixer	bool	mixer safety ok	❌	❌	✅	❌	✅	❌	❌
s_circuitbreaker_fc	bool	Frequency Converter circuit breaker ok	❌	❌	✅	❌	✅	❌	❌
s_circuitbreaker	bool	other circuit breaker ok	❌	❌	✅	❌	✅	❌	❌
s_fc	bool	frequency converter ok	❌	❌	✅	❌	✅	✅	✅
s_operating_pressure	bool	pressure ok	❌	❌	❌	❌	❌	✅	✅
s_water_pressure	bool	water pressure ok	❌	❌	✅	❌	✅	❌	❌
s_hopper_wet	bool	wet material hopper ok	❌	❌	✅	❌	✅	❌	❌
s_hopper_dry	bool	dry material hopper ok	❌	❌	✅	❌	✅	❌	❌
s_running	bool	Machine running	❌	❌	❌	❌	❌	✅	✅
s_airpressure	bool	airpressure ready	❌	❌	✅	❌	✅	❌	❌
s_phase_reversed	bool	phase reversed	❌	❌	✅	❌	✅	❌	❌
s_rotaryvalve	bool	rotary valve running	❌	❌	❌	✅	✅	❌	❌
s_compressor	bool	compressor running	❌	❌	❌	✅	✅	❌	❌
s_vibrator_1	bool	vibrator 1 running	❌	❌	❌	✅	✅	❌	❌
s_vibrator_2	bool	vibrator 2 running	❌	❌	❌	✅	✅	❌	❌

Subscriptions

Description	Pump (P20 & P50)	duo-mix 3DCP	duo-mix 3DCP+	SMP 3DCP	SMP 3DCP+	Dosingpump (flow-matic PX)	Printhead (flow-matic PX)
Subscribe to variable changes	❌	✅	✅	✅	✅	❌	❌

You can subscribe to OPC UA variables for real-time updates:

def callback(value, parameter, subscription): # value and parameter (origial OPC-UA variable name) are optional
    print(f"{parameter} changed to {value}")
    if value:
        print("we are ready to go")
        subscription.delete()
mp = Duomix()
mp.connect("10.129.4.73")
mp.s_ready = callback # set a variable to you callback to subscribe

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3

Metadata

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3

Release files for mtecconnect3dcp 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mtecconnect3dcp 2.1.0
File	Size	Uploaded
mtecconnect3dcp-2.1.0.tar.gz	16.3 kB	Oct 8, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for mtecconnect3dcp 2.1.0
File	Interpreter	ABI	Platform	Reset
mtecconnect3dcp-2.1.0-py3-none-any.whl 18.4 kB Oct 8, 2025	Python 3	none	any	Details

Total release size: 34.7 kB

Release files / mtecconnect3dcp-2.1.0.tar.gz

Download URL	mtecconnect3dcp-2.1.0.tar.gz
Size	16.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`4751351da3fd8132e2e3c5e7253fc549c725b73ada55202dd918501d40b948d1`
BLAKE2b-256 checksum How to use checksums	`3a6283788d56a2c5d322a0b1b841c389d88b04e8ad4890a457b2c5810da7c6fb`
Upload date	Oct 8, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/m-tec-com/mtecconnect3dcp
Publishing commit: github.com/m-tec-com/mtecconnect3dcp/tree/6599928e21ce7ec290371553f450bc65c563fe4a

Workflow

Publishing configuration: github.com/m-tec-com/mtecconnect3dcp/blob/6599928e21ce7ec290371553f450bc65c563fe4a/.github/workflows/publish-to-pypi.yml
Publishing logs: github.com/m-tec-com/mtecconnect3dcp/actions/runs/18346824682/attempts/1

Artifact

Subject: mtecconnect3dcp-2.1.0.tar.gz
SHA-256 checksum: 4751351da3fd8132e2e3c5e7253fc549c725b73ada55202dd918501d40b948d1 Verifying attestations

Release files / mtecconnect3dcp-2.1.0-py3-none-any.whl

Download URL	mtecconnect3dcp-2.1.0-py3-none-any.whl
Size	18.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`7ce008c18a41cb59aefdab743dfd125f0ea309caa16d9071516f9f99733aede1`
BLAKE2b-256 checksum How to use checksums	`0ba09821af50df20bf2ce98f93e855c0c6403b9aa9f4d9dec3998d3b03145402`
Upload date	Oct 8, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/m-tec-com/mtecconnect3dcp
Publishing commit: github.com/m-tec-com/mtecconnect3dcp/tree/6599928e21ce7ec290371553f450bc65c563fe4a

Workflow

Publishing configuration: github.com/m-tec-com/mtecconnect3dcp/blob/6599928e21ce7ec290371553f450bc65c563fe4a/.github/workflows/publish-to-pypi.yml
Publishing logs: github.com/m-tec-com/mtecconnect3dcp/actions/runs/18346824682/attempts/1

Artifact

Subject: mtecconnect3dcp-2.1.0-py3-none-any.whl
SHA-256 checksum: 7ce008c18a41cb59aefdab743dfd125f0ea309caa16d9071516f9f99733aede1 Verifying attestations