Setup IPC-CFX#
Overview#
This feature is responsible for handling the connection setup between our Automation and the Equipment.
How To Configure#
To configure the connection between our Automation Driver and the Broker a set of keys must be set in the IoTMetadataDefinition Smart Table.
Relevant Artifacts#
The table below describes the properties for this entity type:
| Name | Type | Is Mandatory | Data Type | Description |
|---|---|---|---|---|
| IoTMetadataDefinition | SmartTable | Yes | Metadata configuration for equipment integration |
IoTMetadataDefinition Resource Level Configuration#
At the Resource level, there are several configuration we can make to set our connection with the AMQP broker and with the Equipment.
| Resource | Resource Type | Area | Name | Value | Description |
|---|---|---|---|---|---|
| MES IPC-CFX Resource | automationnetworkhandle | Network handler identifier | Identifier for the automation network handler | ||
| MES IPC-CFX Resource | automationnetworkaddress | Network address | Address for the automation network | ||
| MES IPC-CFX Resource | automationnetworkdriveraddress | Driver address | Address for the network driver | ||
| MES IPC-CFX Resource | automationbrokernetworkaddress | Broker address | Address of the message broker | ||
| MES IPC-CFX Resource | automationbrokernetworkexchange | Broker exchange path | Exchange path used by the broker | ||
| MES IPC-CFX Resource | automationtargetnetworkhandle | Target handler identifier | Identifier for the target network handler | ||
| MES IPC-CFX Resource | automationtargetnetworkaddress | Target network address | Address of the target automation network | ||
| MES IPC-CFX Resource | automationtargetnetworkexchange | Target exchange path | Exchange used by the target network | ||
| MES IPC-CFX Resource | username | Authentication username | Username for authentication | ||
| MES IPC-CFX Resource | password | Authentication password | Password for authentication | ||
| MES IPC-CFX Resource | certificatesrootfolder | Certificates folder path | Root folder for certificates | ||
| MES IPC-CFX Resource | certificate | Certificate file | Certificate used for secure communication | ||
| MES IPC-CFX Resource | privatekey | Private key file | Private key for encryption/authentication | ||
| MES IPC-CFX Resource | connectionreconnectinterval | Reconnect interval | Interval for reconnecting after disconnection | ||
| MES IPC-CFX Resource | connectionrequesttimeout | Request timeout | Timeout for connection requests | ||
| MES IPC-CFX Resource | uselowlevellogging | Logging flag | Enable detailed low-level logging | ||
| MES IPC-CFX Resource | eventsexpiration | Event expiration time | Expiration time for stored events | ||
| MES IPC-CFX Resource | onrequestreceivedtimeoutreply | Timeout reply behavior | Reply behavior when request times out | ||
| MES IPC-CFX Resource | logmessagesfromothersources | External logging flag | Log messages from external sources | ||
| MES IPC-CFX Resource | messagestoignore | Ignored messages list | Messages to be ignored during processing | ||
| MES IPC-CFX Resource | netsdkversion | .NET SDK version | Version of the .NET SDK being used | ||
| MES IPC-CFX Resource | durablequeue | Durable queue flag | Whether to use a durable message queue |
Configuration Example
With this configuration we can receive messages published in the broker, send commands to the equipment and receive requests from equipment:
| Resource | ResourceType | Area | Name | Value |
|---|---|---|---|---|
| MES IPC-CFX Resource | automationnetworkhandle | CMF.SPI.MachineHandler | ||
| MES IPC-CFX Resource | automationnetworkaddress | amqp://127.0.0.1:5674 | ||
| MES IPC-CFX Resource | automationnetworkdriveraddress | /CMF/driverExchange | ||
| MES IPC-CFX Resource | automationbrokernetworkaddress | amqp://127.0.0.1:5672 | ||
| MES IPC-CFX Resource | automationbrokernetworkexchange | /exchange/testExchange | ||
| MES IPC-CFX Resource | automationtargetnetworkhandle | SMTA.SPI.MachineHandler | ||
| MES IPC-CFX Resource | automationtargetnetworkaddress | amqp://127.0.0.1:5673 | ||
| MES IPC-CFX Resource | automationtargetnetworkexchange | /SMTA/machineExchange | ||
| MES IPC-CFX Resource | durablequeue | FALSE |
How To Use#
On Automation startup we will retrieve the information on IoTMetadataDefinition related to the linked Resource and set the retrieved configuration parameters as connection values.
Every time you change this values you must restart the Automation Manager.
Implementation Details#
During Equipment Setup we will resolve IoTMetadataDefinition and check which parameters we should configure.
The Resource Name and State model will be stored in persistency for use in the other workflows.