Models in the App's menu is a library of saved MTConnect Device models. A saved model can be used to serve a Device from an SHDR Adapter, to change the model an Agent reports (ex. to leave out DataItems or add others), or downloaded as a Device file to use with an MTConnect Agent.
The list shows each model's Device, MTConnect version, number of Components and DataItems, the Devices that use it (Used by), its source, and when it was updated. A model whose source Agent now reports something different is marked Changed.
Create a Model
Click New Model and choose where it starts from:
- From an Agent - Copy a Device from an MTConnect Agent's probe. The Agent is kept as the model's source, so later changes can be reviewed.
- From XML - Upload or paste a Devices document or a
Deviceelement. When it has several Devices, choose one. - From scratch - Choose an MTConnect Version, and start with the DataItems every Device needs.
An SHDR Device's model can also be saved to Models with Save to Models when adding it, so it can be edited and other Devices can use it.
Edit a Model
A model is edited as a tree of Components, Compositions, and DataItems, with the MTConnect Standard's definitions shown as help text for each Type.
- Add Component, Add DataItem, and Add Composition add elements, with each DataItem's Category, Type, and Sub Type.
- Move elements by drag and drop, or with Move To.., and Duplicate or Delete them.
- Add Configuration edits a Component's Specifications, Coordinate Systems, Motion, Solid Model, Sensor Configuration, Relationships, Image Files, and Power Sources.
- Validate checks the model the same way as the Device Validation Tool. The page notes when the model has changed since it was validated.
- Download XML saves the model as a Device file.
- Save Changes saves the model, and restarts the Devices that use it.
Changes in the Source
Check Source reads the model's source Agent again. When the Agent reports a different model, Review Changes lists the Components, Compositions, and DataItems that were added, removed, or changed. Select the changes to apply to the saved model, or Replace with Source to replace the whole model with the Agent's.
Use a Model for a Device
Choose the model in the Device Model of a Device's Configuration tab:
| Device Source | What the Model Does |
|---|---|
| SHDR Adapter | Describes the Device. The Adapter's keys are matched to the model's DataItems by ID and Name. |
| MTConnect Agent | The Agent Hub serves the model in place of the one the Agent reports. The Agent's values are matched to its DataItems by ID, so values for DataItems that aren't in the model are left out. |
Collection reads a Device with a saved model through the Agent Hub, so the edited model is also the one that's collected and stored.