# MTConnect

The EMQX Neuron MTConnect driver accesses devices installed with MTConnect Agent through the HTTP protocol.

MTConnect is a read-only collection protocol: an MTConnect Agent exposes an HTTP read interface only, so this driver does not support writing back to the device.

For the generic steps, see [Create a Southbound Driver](../south-devices.md) and [Groups and Tags](../../groups-tags/groups-tags.md).

## Parameter Configuration

| Parameter | Description                      |
| --------- | -------------------------------- |
| host      | Target Device IP address         |
| port      | Target Device port, default 5000 |
| ns_prefix | namespace prefix                 |
| ns_uri    | namespace uri                    |

## Support Data Type

* uint8
* int8
* uint16
* int16
* uint32
* int32
* uint64
* int64
* float
* double
* bool
* string

## MTConnect Agent 
For detailed information on the installation and usage of MTConnect Agent, please visit this link [cppagent](https://github.com/mtconnect/cppagent).

## ADDRESS
The driver address is in the form of XML XPATH.

### node-name: Prefix

For self-closing tags where the value is represented by the element name (e.g., CONDITION-type data items), prepend `node-name:` to the address. When this prefix is used and the matched element has no child content, the driver extracts the element's tag name instead of its text content.

| Address Prefix | Behavior |
| -------------- | ---------------------------------------------------------- |
| `node-name:` | Extract element tag name from self-closing tags. |
| (no prefix) | Extract element text content (default). |

## Address Examples

| Address                                                                                                                            | Type   | Des                                     |
| ---------------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------------- |
| //m:Angle[@dataItemId='Babs']                                                                                                      | float  | Absolute angle of rotation axis B       |
| //m:DeviceStream[@uuid='Mazak']/m:ComponentStream[@componentId='LYI1']/m:Samples/m:Position[@dataItemId='LYI1actm']                | double | Mechanical coordinates of linear axis Y |
| //m:DeviceStream[@uuid='Mazak']/m:ComponentStream[@componentId='Lct1']/m:Events/m:InputOutputSignal[@dataItemId='LPlcMonitorIO_1'] | bit    | IO signal                               |
| node-name://m:*[@dataItemId='DMGlogic1']                                                                                            | string | Element name of self-closing tag (e.g., Normal, Warning, Fault)  |