SYMBOLIC PLC NAMES | HEIDENHAIN

For controllers starting with TNC 320 up to TNC 7 Heidenhain uses the concept of access to Programmable Logic Controller (PLC) addresses by symbolic names. As the same name may lead to different numeric addresses on every single machines PLC data mandatorily has to be read and written by usage of symbolic names.

CNCnetPDM fully supports reading from and writing to symbolic TNC PLC address names without the need for additional COM(DCOM) server components at your PC that only work for controllers with Option 18 (DNC).

TECHNICAL BACKGROUND | PLC DATA STRUCTURE | EXAMPLES (PLC ADDRESSES) | EXAMPLES (PLC STRING TABLE) | EXTRACT SYMBOLIC NAME DEFINITIONS

TECHNICAL BACKGROUND

For Heidenhain iTNC 530 and older controls it was possible to access data for specific items at the machine’s PLC by using fixed numeric addresses f.i. DWord 360 for ‘Programmed feed rate’.

FIG 1: PLC address of programmed feed rate Heidenhain iTNC 530

Starting with TNC 320 this technique changed to symbolic names that point to numeric addresses in specific areas (Marker, Byte, Word, DWord) of the PLC. Although many symbolic names are standardized like NN_CHNPROGFEEDMINUTE for ‘Programmed feed rate per minute’ they usually lead to different PLC addresses on every single machine f.i. DWord 4420 in a basic PLC program but DWord 5020 on a GF Mikron S 600 milling machine.

PLC address of programmed feed rate Heidenhain TNC 640

FIG 2: PLC address of programmed feed rate Heidenhain TNC 640

As machine manufacturer specific extensions or additions like bar feeders or handling robots are also added to the machine’s PLC program and get their own names the number accessible items highly differ on every machine, from 10,000 in a basic program up to 39,000 on specific GF milling machines.

A major benefit of this concept is that there is no need to know the data type and numeric address of a specific item as the symbolic name automatically points to its correct location.

PLC Data Structure

PLC data on Heidenhain TNC 320 -> TNC 7 controls is organized in a group structure. Top group ‘Global’ is available on all models. Items in this group can either be accessed directly f.i. NN_DG_TOOL_NUMBER for actual tool number or by a prefixed subgroup f.i. APICHN[0].NN_CHNPROGFEEDMINUTE for programmed feed rate per minute of channel 1.

These subgroups can be unique like APIGEN for general data or have an index appended e.g. APISPIN[0] for the first spindle. The following subgroups under ‘Global’ should be present on every controller:

Name	Description
APIGEN	General data
APIOMG[0]	Operating modes [number of operating mode group]
APICHN[0]	Machining channels [channel number]
APIAXIS[0]	Axes [axis number]
APISPIN[0]	Spindles [spindle number]

FIG 3: Default PLC data subgroups under group ‘Global’

The number of operating mode groups, channels, axes and spindles configured for a specific machine can be queried by reading following symbolic PLC names:

Name	Description
`APIGEN.NN_GENOMGCOUNT`	Number of configured operating mode groups
`APIGEN.NN_GENCHNCOUNT`	Number of configured machining channels
`APIGEN.NN_GENAXCOUNT`	Number of configured logical axes including spindles
`APIGEN.NN_GENSPICOUNT`	Number of configured spindles

FIG 4: Commands to read number of operating mode groups, channels, axes and spindles

Below you can find examples for symbolic PLC address names that should be readable from all controllers:

Symbolic PLC Address	Description
`APICHN[0].NN_CHNPROGFEEDMINUTE`	Programmed feed rate per minute [mm/min] machining channel 1
`APICHN[0].NN_CHNPROGFEEDREVOLUTION`	Programmed feed rate per revolution [mm/rev] machining channel 1
`APICHN[0].NN_CHNPROGFEEDTHREAD`	Programmed feed rate per thread [mm/rev] machining channel 1
`APICHN[0].NN_CHNCONTOURFEED`	Current contouring feed rate [mm/min] machining channel 1
`APICHN[0].PP_CHNCONTOURFEEDMAX`	Max. feed rate from PLC [mm/min] machining channel 1
`APISPIN[0].PP_SPISPEEDMAX`	Maximum spindle speed spindle 1
`APISPIN[0].NN_SPIOVERRIDEINPUT`	Speed override set [%] spindle 1
`APISPIN[0].PP_SPIOVERRIDE`	Speed override entered by the PLC [%] spindle 1
`APICHN[0].NN_CHNFEEDOVERRIDEINPUT`	Feed-rate override set [%] machining channel 1
`APICHN[0].PP_CHNFEEDOVERRIDE`	Feed-rate override entered by the PLC [%] machining channel 1
`APICHN[0].NN_CHNRAPIDFEEDOVERRIDEINPUT`	Rapid traverse override set [%] machining channel 1
`APICHN[0].PP_CHNRAPIDFEEDOVERRIDE`	Rapid traverse override entered by the PLC machining channel 1
`APICHN[0].PP_CHNCONFIGOVERRIDE`	Configurable override (e.g. rapid traverse) machining channel 1
`APIAXIS[0].PP_AXMANUALFEEDMAX`	Maximum axis feed rate in all operating modes [mm/rev] SW < 597110-06 axis 1
`APIAXIS[0].PP_AXFEEDMAX`	Maximum axis feed rate in all operating modes [mm/rev] SW >= 597110-06 axis 1

FIG 5: Examples of symbolic PLC address names

Examples of symbolic PLC string table address names (Note):

Name	Description
`SG_AXIS_NAME`	Name of current axis
`SG_AXIS_PARAMETER_SET`	Current axis parameter set
`SG_DIAGRAM_ACTUAL_RPM`	Actual RPM
`SG_DIAGRAM_FMAX_OVERRIDE`	Maximum feed override
`SG_DIAGRAM_F_OVERRIDE`	Current feed override
`SG_DIAGRAM_S_OVERRIDE`	Current speed override
`SG_DIAGRAM_UTILIZATION`	Current utilization
`SG_DISPLAYED_PROGRAM`	Displayed NC Program
`SG_EXECUTED_PROGRAM`	Executed NC Program
`SG_IDENT_AXES[x]`	Ident name axis [x]
`SG_IDENT_SPINDLE[x]`	Ident name spindle [x]
`SG_KEYNAME_AXIS[x]`	Key name axis [x]
`SG_LIMIT_TABLE`	Limit table
`SG_MAIN_PROGRAM`	Main NC Program
`SG_MODULE_ERROR_STATUS`	Module error status
`SG_PALLETE_NAME`	Pallete name
`SG_REFERENCE_AXIS`	Reference axis
`SG_SPINDLE_NAME`	Current spindle name
`SG_SPINDLE_PARAMETER_SET`	Current spindle parameter set
`SG_TC_STANDBY_POCKET_TOOL`	Current standby pocket tool
`SG_TM_ACTUAL_MAGAZINE`	Current time actual magazine
`SG_TOOL_IN_SPINDLE`	Current tool in spindle
`SG_TOOL_MAGAZINE_NUMBER`	Current tool magazine number
`SG_TOOL_POCKET_NUMBER`	Current tool pocket number
`SG_TOUCH_PROBE_NUMBER`	Current touch probe number
`SG_TOUCH_PROBE_TYPE`	Current touch probe type
`SG_T_MAGAZINE_ACTUAL_POCKET`	Current tool magazine actual pocket
`SG_T_NUMBER_PRE_SELECTION`	Current tool number pre selection

FIG 6: Examples of symbolic PLC string table names

Note: String table names from Basic PLC program, names may be different on your controller, see HeidenhainPlcData for details.

EXTRACT SYMBOLIC NAME DEFINITIONS

To be able to read and write from/to symbolic addresses CNCnetPDM has to know the symbolic names defined for your machine. Definitions can be read from a service file generated by the controller.

Connect to the machine with TNC Remo click [Extras] (1) and select [Create Service File] (2). The controller generates a service file in ZIP format and stores it in TNC folder \service (3). Select the file and transmit it to a directory on your PC (4). After transmission it is save to delete the service file at the controller.

Create service file with TNC Remo

FIG 7: Create service file with TNC Remo

On your PC open the ZIP file, navigate to folder \SYS_\runtime\ and only extract file ‘PlcDataMarker.txt’ to subfolder \plcdatamarker\ of the directory where CNCnetPDM is installed.

Note: If you have multiple machines with Heidenhain TNC controllers rename file ‘PlcDataMarker.txt’ to be able to identify each machine e.g. ‘PlcDataMarker_Cheto.txt’.
All done, now you’re ready to read and write Heidenhain PLC data with CNCnetPDM by using symbolic names.