Definition of attribute names for each element, functions and scan rates
- Last UpdatedFeb 23, 2023
- 2 minute read
A Microsoft Excel representation of Table 2 in the measurement configuration file

Constructing the table
The header row of the table must contain columns with the explicit text as follows in order to be valid:
|
[Element Path] |
[Attribute Name] |
[Function*] |
[Scan Rate] |
There are four columns in this table:
-
[Element Path]
The path to each element.
-
[Attribute Name]
Each attribute belonging to the leaf element of the path.
Note: Attribute name field is not effective for hieratical structure assets. Therefore, there is no need to specify an attribute name for those measurement definitions.
-
[Function*]
The function, path (channel), and parameter information for the attribute.
Note: The "*" sign after the header content means this column is mandatory and cannot be left empty.
-
[Scan Rate]
The scan rate of the measurement in milliseconds.
Column name
Rules
[Element Path]
-
Each entry must be defined in Table 1.
-
All rules for [Element Path] in Table 1 apply.
[Attribute Name]
-
Only effective for single attribute measurements
-
Must be unique for the same element.
-
Must be a valid attribute name for PI Asset Framework.
-
Optional: If not configured for single attribute measurements, the connector uses [Function*] entry if [Attribute Name] is left empty.
[Function*]
-
The following functions can be defined in Table 2 in the CSV file:
-
cnc_sysinfo
-
cnc_statinfo
-
cnc_alarm
-
cnc_exeprgname
-
cnc_rdmacro
-
cnc_rdprgnum
-
cnc_rdpmcrng
-
cnc_modal
-
cnc_rdaxisdata
-
cnc_rdspmeter
-
cnc_acts
-
cnc_rdsvmeter
-
cnc_actf
-
cnc_absolute
-
cnc_machine
-
cnc_relative
-
cnc_distance
-
cnc_rdseqnum
-
cnc_rdpm_item
-
cnc_rdspeed
-
cnc_ rdopnlsgn1
-
cnc_ exeprgname2
-
cnc_gettimer
-
-
Format: <Function Name>.<Channel>.<Parameter>, such as: cnc_rdmacro.0.#123; cnc_sysinfo.0.mt_type.
-
All function components must be supported by the connector and the CNC machine.
-
Must be unique in the CSV file.
[Scan Rate]
-
If defined, value must be between 100 and 10000. The attribute will be created as real-time data.
-
Optional for functions that return a single attribute; the connector will treat the attribute as a static attribute if it is left empty.
-
Required for functions that return hierarchical structures. All dynamic attributes in the hierarchical structure will update at the specified rate.
-
Note that a value for Scan Rate must be specified for:
-
cnc_rdaxisdata
-
cnc_rdsvmeter
-
cnc_rdspmeter
-
-
Text example of Table 2 in a measurement configuration file
# Table 2: Measurements:,,,
"# Definition of attribute names ,",,,
"# functions, and scan rates",,,
# for each element,,,
,,,
[Element Path],[Attribute Name],[Function*],[Scan Rate]
cnc_alarm,0.number,cnc_alarm.0,1000
cnc_exeprgname,0.number,cnc_exeprgname.0.number,1000
cnc_exeprgname,0.name,cnc_exeprgname.0.name,1000
cnc_rdmacro,0.#785,cnc_rdmacro.0.#785,1000
cnc_rdprgnum,0.main,cnc_rdprgnum.0.main,1000
cnc_rdprgnum,0.running,cnc_rdprgnum.0.running,1000
cnc_statinfo,0.aut,cnc_statinfo.0.aut,1000
cnc_statinfo,0.run,cnc_statinfo.0.run,1000
cnc_statinfo,0.mstb,cnc_statinfo.0.mstb,1000
cnc_statinfo,0.emergency,cnc_statinfo.0.emergency,1000
cnc_statinfo,0.alarm,cnc_statinfo.0.alarm,1000
cnc_statinfo,0.edit,cnc_statinfo.0.edit,1000
cnc_sysinfo,0.mt_type,cnc_sysinfo.0.mt_type,
cnc_sysinfo,0.series,cnc_sysinfo.0.series,
cnc_sysinfo,0.version,cnc_sysinfo.0.version,
cnc_sysinfo,0.max_axis,cnc_sysinfo.0.max_axis,
cnc_sysinfo,0.axes,cnc_sysinfo.0.axes,
pmc_rdpmcrng,0.R00381.4,pmc_rdpmcrng.0.R00381.4,1000
cnc_modal,0.M.0,cnc_modal.0.M.0,1000
cnc\cnc_acts,Actual Speed,cnc_acts.0,2000
cnc\cnc_actf,Actual Feed,cnc_actf.0,2000
cnc\cnc_rdseqnum,Sequence Number,cnc_rdseqnum.0,2000
cnc\cnc_absolute,Axis 1,cnc_absolute.0.1,2000
cnc\cnc_machine,Axis 2,cnc_machine.0.2,2000
cnc\cnc_relative,Axis 3,cnc_relative.0.3,2000
cnc\cnc_distance,Axis 4,cnc_distance.0.4,2000
cnc\cnc_rdsvmeter,,cnc_rdsvmeter.1,2000
cnc\cnc_rdspmeter,,cnc_rdspmeter.0,2000
cnc\cnc_rdaxisdata,,cnc_rdaxisdata.0.2.0.8,2000