The MachineModuleSetupType ObjectType contains the value of all the settings (including mechanical adjustments) required to run production as well as affordances to validate and load settings for the machine module.
This MachineModuleSetupType is formally defined in the table below.
Table 44– MachineModuleSetupType Definition
Attribute |
Value |
||||
BrowseName |
MachineModuleSetupType |
||||
IsAbstract |
False |
||||
References |
Node Class |
BrowseName |
DataType |
TypeDefinition |
Other |
Subtype of the BaseObjectType defined in OPC 10000-5 - Part 5: Information Model, i.e. inheriting the Instance Declarations of that Node. |
|||||
0:HasProperty |
Variable |
DataSet |
DataSetType |
0:PropertyType |
M, RW |
0:HasComponent |
Method |
LoadDataSet |
See below. |
O |
|
0:HasComponent |
Method |
LoadMaterialList |
See below. |
O |
|
0:HasProperty |
Variable |
MaterialList |
MaterialListType |
0:PropertyType |
M, RO |
0:HasComponent |
Object |
MechanicalAdjustments |
|
0:FolderType |
M |
0:HasComponent |
Object |
DataSetFolder |
|
0:FolderType |
M |
0:HasComponent |
Method |
ValidateDataSet |
See below. |
O |
|
0:HasComponent |
Method |
ValidateMaterialList |
See below. |
O |
|
0:GeneratesEvent |
ObjectType |
DataSetChangeLogType |
|
|
M |
Conformance Units |
|||||
TMC Single PO Production |
|||||
TMC Advanced Setup |
The components of the MachineModuleSetupTypeare further described below.
BrowseName |
Description |
DataSet |
DataSet contains all the digital settings (other than the mechanical settings stored in the folder MechanicalAdjustments) required by the machine module. |
MaterialList |
MaterialList contains the list of materials that are going to be used for the production of the current production order. |
MechanicalAdjustments |
The MechanicalAdjustments folder contains the non-digital settings required to setup the machine e.g. mechanical adjustments. |
DataSetFolder |
The DataSetFolder contains the DataSet including values and descriptions. It contains the same information as DataSet but in a way that is friendlier to simple clients. |
The components of the MachineModuleSetupType have additional subcomponents which are defined in the table below.
Table 45– MachineModuleSetupType Additional Subcomponents
BrowsePath |
References |
NodeClass |
BrowseName |
DataType |
TypeDefinition |
Others |
MechanicalAdjustments |
0:HasProperty |
Variable |
<DocumentName> |
0:ByteString |
0:PropertyType |
OP, RO |
DataSetFolder |
0:HasComponent |
Variable |
DataSetID |
0:String |
0:DataItemType |
M, RW |
DataSetFolder |
0:HasComponent |
Variable |
DataSetDescription |
0:LocalizedText |
0:DataItemType |
M, RW |
DataSetFolder |
0:HasComponent |
Variable |
<DataSetValue> |
0:BaseDataType |
0:DataItemType |
OP, RW |
The DataSetIDVariable subcomponent is the IDof the DataSet, the DataSetDescriptionVariable subcomponent is the Descriptionof the DataSetwhich contains many values represented by <DataSetValue>.
The mapping between the DataSet and <DataSetValue> in DataSetFolder shall be as follows:
- The BrowseNameof each <DataSetValue> shall be the IDof the corresponding Definitionin the DataSetListand DataSet.
- The DataTypeof each <DataSetValue> shall be equal to the DataTypeof the corresponding Definitionin the DataSetList.
- If the <DataSetValue> is numeric, its type definition shall be 0:AnalogUnitRangeTypewhich includes EURangeand EngineeringUnits.
- EURangeshall be equal to the ControlRangeof the corresponding definition in the DataSetList.
- EngineeringUnits shall be equal to EngineeringUnits of the corresponding definition in the DataSetList.
The LoadDataSet Method loads the dataset to the underlying system after having validated that (a) the dataset is complete when IsCompleteDataset is True and (b) the dataset is valid.
When the validation is not passed, then the data set is not loaded to the underlying system rolling back any data change and a specific message shall be returned via ExecutionFeedback.
For detailed validation diagnostics, the Method ValidateDataSet shall be invoked.
The signature of this Methodis specified below. Table 46specifies the Argumentsrepresentation.
Signature
LoadDataSet (
[in] DataSetType DataSet,
[in] Boolean IsCompleteDataSet,
[out] MethodExecutionFeedbackType ExecutionFeedback);
Table 46– LoadDataSet Method Arguments
Argument |
Description |
DataSet |
The dataset to be transferred to the underlying system. |
IsCompleteDataSet |
When true, the DataSet argument is a complete dataset, meaning all DataSet entries are included. |
ExecutionFeedback |
The extended feedback returning a detailed message in case of execution failure. |
The LoadMaterialList Method loads the material list to the underlying system after having validated that (a) the material list is complete and (b) the material list is valid.
When the validation is not passed, then the material list is not loaded to the underlying system rolling back any data change and a specific message shall be returned via ExecutionFeedback.
For detailed validation diagnostics, the Method ValidateMaterialList shall be invoked.
The signature of this Methodis specified below. Table 47specifies the Argumentsrepresentation.
Signature
LoadDataSet (
[in] MaterialListType MaterialList,
[out] MethodExecutionFeedbackType ExecutionFeedback);
Table 47– LoadMaterialList Method Arguments
Argument |
Description |
MaterialList |
The material list to be transferred to the underlying system. |
ExecutionFeedback |
The extended feedback returning a detailed message in case of execution failure. |
The ValidateDataSet Method transfers a dataset, complete when IsCompleteDataSet is True, to the underlying system and returns the result of the validation, i.e. verifying that the dataset is complete and can run in production.
When the ValidateDataSetMethod is executed, the DataSet variable is not affected. If the validation is not passed, the identifiers of the datapoints that did not pass are provided with the ExecutionFeedback.
The validation of the DataSetnormally occurs before the DataSetis required, i.e. while production is running and using a different dataset. As a matter of fact, the ValidateDataSet Methodis used to validate a DataSetbeforehand giving time to the higher-level systems in charge to correct mistakes. Thus the underlying system is required to provide all affordances to perform the validation without disrupting running production orders.
The signature of this Methodis specified below. Table 48specifies the Argumentsrepresentation.
Signature
ValidateDataSet (
[in] DataSetType DataSet,
[in] Boolean IsCompleteDataSet,
[out] DataSetEntryType[] FailedValidationEntries,
[out] MessageType[] FailedValidationMessages,
[out] MethodExecutionFeedbackTypeExecutionFeedback);
Table 48– ValidateDataSet Method Arguments
Argument |
Description |
DataSet |
The dataset to be validated by the underlying system. |
IsCompleteDataSet |
When true, the DataSet argument is a complete dataset, meaning all DataSet entries are included. |
FailedValidationEntries |
The dataset items that failed the validation. |
FailedValidationMessages |
The detailed reasons the validation failed. |
ExecutionFeedback |
The extended feedback returning a detailed message in case of execution failure. |
The ValidateMaterialList Method transfers a material list to the underlying system and returns the result of the validation, i.e. verifying that the material list is complete and can run in production.
When the ValidateMaterialListis executed, the MaterialListvariable is not affected. If the validation is not passed, the identifiers of the materials that did not pass are provided with the ExecutionFeedback.
The validation of the MaterialListnormally occurs before the MaterialListis required, i.e. while production is running and using a different material list. As a matter of fact, the ValidateMaterialList Methodis used to validate a MaterialListbeforehand giving time to the higher-level systems in charge to correct mistakes. Thus the underlying system is required to provide all affordances to perform the validation without disrupting running production orders.
The signature of this Methodis specified below. Table 49specifies the Argumentsrepresentation.
Signature
ValidateMaterialList (
[in] MaterialListType MaterialList,
[out] MaterialListItemType[] FailedValidationEntries,
[out] MessageType[] FailedValidationMessages,
[out] MethodExecutionFeedbackTypeExecutionFeedback);
Table 49– ValidateMaterialList Method Arguments
Argument |
Description |
MaterialList |
The material list to be validated by the underlying system. |
FailedValidationEntries |
The material list items that failed the validation. |
FailedValidationMessages |
The detailed reasons the validation failed. |
ExecutionFeedback |
The extended feedback returning a detailed message in case of execution failure. |