Data source configuration settings
- Last UpdatedJan 24, 2023
- 4 minute read
Each data source (CNC machine) can be added to the connector by providing the following parameters:
|
Parameter |
Description |
|---|---|
|
Name (Required) |
The name of the data source. Duplicate names are allowed. |
|
Description (Optional) |
The description of the data source. |
|
Machine IP Address (Required) |
The IP address that hosts the CNC machine being added as a data source. Only IPV4 address format is supported: x.x.x.x. Host name or URL is not supported. |
|
Machine Port (Required) Default: 8193 |
The port number that hosts the CNC machine being added as a data source. Default port number is 8193, per the FANUC Focas standard. The port number is an unsigned 16-bit integer value. |
|
Device ID (Optional) |
The unique identifier of the CNC machine being added as a data source. The Device ID must be unique among data sources. The Device ID is the root element name of the PI AF hierarchy for the data source, and its value must be a valid element name for PI Asset Framework. If not specified the Device ID defaults to <Remote IP Address>.<Port>. |
|
Measurement Configuration File |
The location to upload the measurement configuration file. The file must have comma separated value (CSV) format. The maximum file size is 20MB. |
|
Static Attribute Update Rate (Required) Default: 8 |
The scan rate of all static attributes in hours; the value can be any integer between 4 and 48. The default value is 8 hours. |
|
Alarm Message Channels (Required) Default: channel 0 |
The list of channels from which to collect alarm messages. Multiple channels are supported if separated by a comma (,). A channel can have any integer value between 0 and 10. Duplicate channel numbers are not allowed. |
|
Alarm Message Scan Rates (Required) Default: 1000 |
The scan rate in milliseconds of alarm messages on different channels. The scan rate can be any integer value between 100 and 10000. Multiple scan rate values are supported if separated by commas (,). If multiple scan rate values are configured, the number of scan rates must match the number of alarm message channels. If a single scan rate value is configured, it is applied to all channels. |
|
Operator Message Channels (Required) Default: channel 0 |
The list of channels from which to collect operator messages. Multiple channels are supported if separated by a comma (,). A channel can have any integer value between 0 and 10. Duplicate channel numbers are not allowed. |
|
Operator Message Scan Rates (Required) Default: 1000 |
The scan rate in milliseconds of operator messages on different channels. The scan rate can be any integer value between 100 and 10000. Multiple scan rate values are supported if separated by commas (,). If multiple scan rate values are configured, the number of scan rates must match the number of operator message channels. If a single scan rate value is configured, it is applied to all channels. |
|
Communication Timeout (Required) Default: 5 |
The number of seconds the connector waits for responses from the CNC machine before it gives up and turns to timeout condition handling. This timeout can have any integer value between 1 and 30. |
|
Reconnection Interval (Required) Default: 10 |
The number of seconds the connector waits before trying another connection request, if the connector loses its connection to the data source. This interval can have any integer value between 0 and 30. |
|
Request Retry Count (Required) Default: 3 |
The number of request retries the connector performs after one failed request (error code received). This count can have any integer value between 0 and 20. |
|
Delay Time Between Requests (Required) Default: 0 (no waiting) |
The number of milliseconds the connector waits between sending two consecutive requests. This delay can have any integer value between 0 and 30000. |
|
Enable Validation on Function Type Support |
If enabled, the connector will verify with the data source whether the CNC machine supports each measurement defined in the file. All non-supported measurements will be filtered out during asset creation. If disabled, the connector will create all assets based on the definitions in the file, but some assets may not have data available if the target CNC machine does not support the functions. |
|
Write Bad Quality to Value Streams on Data Collection Start and Stop |
If checked, the connector will:
|
|
Enable Debug Logging Default: Disabled |
The option to enable or disable additional debug trace logging in the message log. If enabled, more detail messages at the warning level and prefixed with "[DEBUG]" will be available in the connector message log. Note: This feature has negative impact on the performance of the connector, so by default it is disabled. |
|
Log Alarm Messages to Files Default: Disabled |
The option to enable or disable logging of all alarm messages to a text file. If enabled, an alarm message text file will be created for each data source under the directory: <Folder for Buffer Files>\Alarm Message Log Files. Note: This feature is disk I/O intensive and has negative impact on the performance of the connector, so by default it is disabled. |
Note: The data source name can be used as the point source for the PI points created. To enable this feature, update the PI Connector Relay to version 2.4 or later. If you do not upgrade to a compatible PI Connector Relay, the data flow will not be interrupted, however, you might see some errors under Relay diagnostics and the point source will display the point name.