Heidenhain TNC Connectivity
- Overview
- Applicable Controls
- Prerequisites
- Network Configuration
- MachineMetrics Connector Setup
- Part Counting Configuration
- Troubleshooting
- Additional Resources
- Getting Help
Overview

Heidenhain TNC control panel. Heidenhain controls (iTNC 530, TNC 640, TNC 730) connect via proprietary Ethernet protocol or OPC-UA (Option 56), providing real-time machine status and PLC data access for part counting.
MachineMetrics connects to Heidenhain TNC controls using a proprietary connector that communicates directly with the control over Ethernet. This native integration provides real-time machine data including status, programs, tools, and part counts.
Key Features:
- Direct Ethernet communication with TNC controls
- Real-time machine status and production data
- PLC data table access for part counting
- Support for iTNC 530 / TNC 530, TNC 640, and TNC 730 controls
- Alternative OPC-UA connectivity available (Option 56) for TNC 640 / TNC 730
- No additional hardware required (Ethernet connection only)
Applicable Controls
This guide covers connectivity for the following Heidenhain controls:
Supported Controls:
- iTNC 530 / TNC 530 - All versions
- TNC 640 - Requires connectivity option (see below)
- TNC 730 - Requires connectivity option (see below)
Recommended Connectivity Options for TNC 640 / TNC 730
For TNC 640 and TNC 730 controls, we recommend:
✅ Recommended: OPC-UA Option 56
Option 56 provides better data quality, more comprehensive data access, and easier part counting configuration compared to Option 18. If you need to purchase a connectivity option, choose Option 56 instead of Option 18.
Available Options:
| Option | Description | Recommendation | Data Quality | Part Counting |
|---|---|---|---|---|
| Option 56 (OPC-UA) | OPC-UA server connectivity | ✅ Recommended | Better data access and quality | Easier configuration |
| Option 18 | Proprietary Ethernet protocol | ⚠️ Alternative if Option 56 unavailable | Standard data access | Requires PLC WORD mapping |
90-Day Free Trial:
Customers can try OPC-UA Option 56 for free for 90 days. Contact Heidenhain directly (not MachineMetrics) to request the trial license.
iTNC 530 / TNC 530:
The iTNC 530 / TNC 530 does not require any additional options for connectivity.
Alternative Connectivity for TNC 640 / TNC 730:
If neither option is available, you can use the proprietary Heidenhain connector (this guide). However, we strongly recommend upgrading to Option 56 for better data quality.
Checking Installed Options (SIK Page):
To verify which options are installed on your control:
For iTNC 530 / TNC 530:
- Power on the control and let it boot fully
- Press MOD (Manual Operation)
- Press MOD again → Machine parameters / Diagnosis (menu wording varies)
- Choose Option management or Software options
- Cursor into the input field and type SIK on the keyboard
- Press ENT
For TNC 640 / TNC 730:
- Power on the control and let it boot fully
- Press MOD (Manual Operation)
- Press MOD again → Machine parameters / Diagnosis (menu wording varies)
- Choose Option management or Software options
- Cursor into the input field and type SIK on the keyboard
- Press ENT
You'll see the SIK page listing installed options and license status (Option 18, Option 56, etc.).
What to Look For:
- Option 56 (OPC-UA) - ✅ Recommended for TNC 640/730 (better data quality)
- Option 18 - ⚠️ Alternative connectivity option
- Check the license status shows as active/enabled
Notes:
- You typically need service-level access or higher to enter or change SIK codes; viewing may be allowed at lower access levels
- On some builds, step 3 is labeled Diagnosis → Software options instead of machine parameters
- If typing SIK does nothing, you're either in the wrong menu depth or logged in with insufficient access rights
- A keyboard is required - softkeys alone won't expose the SIK field
Prerequisites
Before beginning setup, ensure you have:
Hardware Requirements:
- Heidenhain iTNC 530 / TNC 530, TNC 640, or TNC 730 control
- Ethernet port on the control:
- iTNC 530 / TNC 530: Standard (no option required)
- TNC 640 / TNC 730: Requires connectivity option
- Recommended: OPC-UA Option 56 (better data quality)
- Alternative: Option 18 (if Option 56 unavailable)
- Network cable (Cat5e or Cat6)
- MachineMetrics Edge device on the same network
💡 Tip: For TNC 640/730, request a 90-day free trial of Option 56 from Heidenhain before purchasing.
Network Requirements:
- Available IP address on company network (static or DHCP)
- Network switch or router with available port
- Access to control's network configuration menu
- Ping access between Edge device and machine
Access Requirements:
- Physical access to the machine control
- Knowledge of machine's network configuration (if applicable)
- Administrator or operator password (if password protection enabled)
Network Configuration
Connecting to Company Network
The Heidenhain control must be connected to your company network to communicate with the MachineMetrics Edge device.
Step 1: Physical Connection
- Locate the Ethernet port on the Heidenhain control
- iTNC 530 / TNC 530: Typically on rear of control panel
- TNC 640 / TNC 730: On control panel or machine electrical cabinet
- Connect network cable from control to network switch/router
- Verify link lights on Ethernet port are active
Step 2: Access Network Settings
For iTNC 530 / TNC 530:
- Press the MOD key
- Enter password NET123 to access the network settings menu
- Navigate to Network or Ethernet Settings
For TNC 640 / TNC 730:
- Press the Heidenhain button (logo button) to bring up the Linux menu
- Navigate to Network Settings or Ethernet Settings
Configuring Network Settings
For Static IP Address (Recommended):
- In Network Settings, select Manual or Static IP
- Enter the following network information:
- IP Address: (e.g., 192.168.1.100)
- Subnet Mask: (e.g., 255.255.255.0)
- Gateway: (e.g., 192.168.1.1)
- DNS Server: (optional, e.g., 192.168.1.1 or 8.8.8.8)
- Save settings and reboot control if prompted
For DHCP (Dynamic IP):
- In Network Settings, select DHCP or Automatic
- Control will automatically obtain IP address from network
- Note the assigned IP address for later use
- Recommended: Reserve this IP in your DHCP server to prevent changes
Important Network Configuration Notes:
- Use static IP or reserved DHCP to ensure consistent connectivity
- Ensure IP address is on same subnet as Edge device
- Document the IP address for MachineMetrics configuration
- Verify no IP conflicts exist on the network
Testing Network Connection
Step 1: Verify IP Configuration
On the Heidenhain control:
- Navigate to Network Settings
- Verify IP address is displayed and valid
- Check connection status shows "Connected" or "Active"
Step 2: Test from Control (if available)
Some Heidenhain controls have built-in network diagnostics:
- Access Network Settings → Diagnostics (if available)
- Try pinging the Edge device IP address
- Verify successful response
Step 3: Test from Edge Device
From the Edge device or another computer on the network:
ping [MACHINE-IP-ADDRESS]
Example:
ping 192.168.1.100
Expected Result: Continuous successful ping responses with low latency (< 10ms typical)
MachineMetrics Connector Setup
Adding Machine in MachineMetrics
Step 1: Create Machine Record
- Log into MachineMetrics at app.machinemetrics.com
- Navigate to Assets → Machines
- Click Add Machine
- Enter machine details:
- Machine Name: (e.g., "Hermle-C40U-01")
- Machine Type: (Mill, Machining Center, etc.)
- Make: (e.g., Hermle, DMG Mori, Starrag)
- Model: (e.g., C40 U, DMU 50, etc.)
- Serial Number: (optional but recommended)
- Click Next
Step 2: Select Edge Device
- Choose the Edge device that will connect to this machine
- Ensure Edge device is on same network as the Heidenhain control
- Click Next
Heidenhain Connector Configuration
Step 1: Select Connection Method
- In Data Collection Method, select Heidenhain
- If "Heidenhain" is not visible in the dropdown, contact MachineMetrics support
Step 2: Enter Machine IP Address
- Enter the Heidenhain control's IP address (e.g., 192.168.1.100)
- The connector will automatically detect the control type and available data
Step 3: Save Configuration
- Review the IP address for accuracy
- Click Test Connection to verify connectivity
- If successful, click Save
Note: The Heidenhain connector automatically discovers available data items from the control. No manual configuration of data items is required.
Testing Connection
Step 1: Verify Adapter Status
- Navigate to machine page in MachineMetrics
- Check connection status indicator:
- Green: Connected and receiving data
- Yellow: Connecting or intermittent
- Red: Connection failed
Step 2: Check Data Items
- Go to Diagnostics tab on machine page
- Verify data items are populating:
execution- Should show current machine stateprogram- Should show active program namespindle_speed- Should show real-time spindle RPMtool_number- Should show current tool
Step 3: Verify in Machine View
- Navigate to Machines → Select your Heidenhain machine
- Verify machine status displays correctly:
- Status (In Cycle, Idle, etc.)
- Current program
- Spindle speed
- Tool information
Part Counting Configuration
💡 Note for TNC 640 / TNC 730: If you're using OPC-UA Option 56, part counting is much easier and typically works automatically without manual PLC WORD configuration. The instructions below are primarily for machines using Option 18 or the proprietary Heidenhain connector.
Understanding PLC WORD Table
Heidenhain machines often do not have a dedicated, standard part counter location that MachineMetrics can read directly. Instead, part count data is typically stored in the PLC WORD table, which is a memory area within the control that stores various machine variables.
What is the PLC WORD Table?
The PLC WORD table is a data structure in the Heidenhain control that contains:
- Machine status flags
- Counters (including part counts)
- Process variables
- Custom user data
Why Different Locations?
Part counter addresses vary by:
- Control model (iTNC 530 vs TNC 640)
- Machine builder customization
- Auxiliary equipment (pallet changers, multi-spindle setups)
- Custom macros or programs
Finding Part Counter Location
To identify where the part counter is stored in the PLC WORD table, you need to search for specific terms related to part counting.
Step 1: Access PLC WORD Table
On the Heidenhain control:
- Press PLC or access Diagnostics menu
- Navigate to PLC → PLC Data
- Select WORD Table or WORD Memory
- View the list of WORD locations and their labels
Step 2: Search for Part Counter Terms
Look for labels containing the following terms (in English or German):
English Terms:
workorworkpiecepiece counterorpart counterparts madeorparts countcounterorcountproduction counter
German Terms:
werkstück zähler(workpiece counter)teilezähler(parts counter)arbeitszähler(work counter)zähler(counter)stückzahl(piece count)
Step 3: Note the WORD Address
Once you locate the part counter:
- Note the WORD address number (e.g., WORD 20, WORD 10, WORD 19944)
- Verify the value increments when parts are completed
- Document this address for MachineMetrics configuration
Common Part Counter Locations:
| Control Type | Typical Address | Notes |
|---|---|---|
| iTNC 530 | WORD 20 | Most common default location |
| TNC 640 | WORD 10 or WORD 19944 | Varies by machine builder |
| With Pallet Changer | Custom location | Often non-standard address |
| Multi-Spindle | Multiple addresses | Separate counter per spindle |
If Part Counter Not Found:
If you cannot locate a part counter in the PLC WORD table:
- Check machine documentation from manufacturer
- Contact machine builder for PLC WORD map
- Ask machine operator if custom macros track parts
- Consider implementing M-code based counting (see below)
Configuring Part Count Address
Once you've identified the PLC WORD address for the part counter, configure it in MachineMetrics.
Step 1: Add Part Counting Configuration
In the MachineMetrics machine configuration, add the part counting JSON configuration:
For iTNC 530 / TNC 530 (WORD 20):
{
"partcounting": {
"plcPartCountMemAddressTNC640": "20"
}
}
For TNC 640 / TNC 730 (WORD 10):
{
"partcounting": {
"plcPartCountMemAddressTNC640": "10"
}
}
For TNC 640 / TNC 730 (WORD 19944 - Alternative):
{
"partcounting": {
"plcPartCountMemAddressTNC640": "19944"
}
}
Note: Despite the parameter name referencing "TNC640", this configuration works for all Heidenhain controls (iTNC 530, TNC 530, TNC 640, TNC 730). Simply change the address value to match your control's part counter location.
Step 2: Configure Data Mapping
- Go to Machine Settings → Data Mapping tab
- Locate the
part_countdata item - Map it to:
- Type: EVENT
- Subtype: PART_COUNT
- Component: Machine or Controller
- Click Save
Step 3: Configure Data Rules
- Go to Machine Settings → Data Rules tab
- Locate Part Counting section
- Set Part Count Source to
part_count - Configure reset behavior:
- Reset on Program Start: Optional (depends on your process)
- Reset on Shift: Optional
- Click Save
Verifying Part Count
Step 1: Run a Test Part
- Load a program on the machine
- Run the program to completion
- Verify part counter increments on the control display
Step 2: Check MachineMetrics Data
- Go to machine page in MachineMetrics
- Navigate to Parts tab
- Verify part count matches control display
- Check that timestamp is accurate
Step 3: Check Diagnostics
- Go to Diagnostics tab
- Locate
part_countdata item - Verify value updates when part completes
- Check for consistent updates (no missed counts)
Step 4: Monitor Over Time
- Run multiple parts
- Verify count increments correctly
- Check for reset behavior (if configured)
- Confirm data is flowing to MachineMetrics Cloud
Troubleshooting Part Count Issues:
If parts are not counting correctly:
- Verify PLC WORD address is correct (double-check on control)
- Check M-code execution (review program for M53/M54)
- Verify Data Mapping settings in MachineMetrics
- Check adapter logs for errors or warnings
- Confirm part counter is enabled on the control
- Test manual increment on control (if possible)
Troubleshooting
Connection Issues
Problem: Cannot Connect to Control
Possible causes:
- Incorrect IP address
- Network connectivity issue
- Firewall blocking communication
- No connectivity option installed (TNC 640/730 requires Option 56 or Option 18)
- Control not powered on or Ethernet disabled
Solutions:
- Verify IP address is correct and control is reachable (ping test)
- Check physical Ethernet cable connection
- Verify connectivity option is installed:
- TNC 640/730: Requires Option 56 (recommended) or Option 18
- Check SIK page to confirm option is active
- Check network settings on control (IP, subnet mask, gateway)
- Verify firewall rules allow port 19090 communication
- Restart control and Edge device
Problem: Intermittent Connection
Possible causes:
- Network instability
- DHCP IP address changing
- Control restarting during production
- High network traffic or latency
Solutions:
- Use static IP address instead of DHCP
- Check network switch/router for errors
- Verify network cable quality (replace if old/damaged)
- Monitor network latency with continuous ping
- Check for IP conflicts on network
Data Collection Issues
Problem: No Data Items Populating
Possible causes:
- Adapter configuration incorrect
- Control not exposing data
- Polling interval too high
- Data mapping not configured
Solutions:
- Review adapter configuration for typos or errors
- Verify control type matches configuration (TNC530 vs TNC640)
- Check Data Mapping settings in MachineMetrics
- Review adapter logs for specific errors
- Reduce poll_interval to 1000ms (1 second)
Problem: Specific Data Items Missing
Possible causes:
- Control does not support specific data type
- Data item not configured in adapter
- PLC data not exposed
Solutions:
- Verify control model supports requested data
- Check adapter configuration includes all desired data items
- Review Heidenhain control capabilities documentation
- Contact MachineMetrics support for control-specific limitations
Part Counting Issues
Problem: Part Count Not Incrementing
Possible causes:
- Incorrect PLC WORD address
- Part counter disabled on control
- M-code not executing
- Data mapping not configured
Solutions:
- Verify PLC WORD address is correct (check on control)
- Ensure part counter is enabled in control settings
- Check CNC program includes M53 (or appropriate M-code)
- Verify Data Mapping and Data Rules are configured
- Review adapter logs for part count events
- Test manual increment on control
Problem: Part Count Incorrect or Resetting Unexpectedly
Possible causes:
- Reading wrong PLC WORD address
- Multiple counters in use (pallet changer, etc.)
- Data Rules reset behavior misconfigured
- Control resetting counter on program start
Solutions:
- Verify correct PLC WORD address with machine documentation
- Check for multiple part counters (select appropriate one)
- Review Data Rules reset configuration
- Disable automatic reset if not desired
- Consult machine operator on expected behavior
Problem: Cannot Find Part Counter in PLC WORD Table
Possible causes:
- Part counter stored in different location
- Custom machine configuration
- No native part counter implemented
Solutions:
- Review complete PLC WORD table for any counter-like variables
- Contact machine builder for PLC WORD documentation
- Check for M-code based counting instead (M53/M54)
- Consider implementing custom macro for part counting
- Contact MachineMetrics support for alternative methods
Network Configuration Issues
Problem: Control Not Obtaining IP Address (DHCP)
Possible causes:
- DHCP server not responding
- Network cable issue
- Control Ethernet settings incorrect
Solutions:
- Check physical cable connection
- Verify DHCP server is functioning (check other devices)
- Try static IP configuration instead
- Restart control and network switch
- Check control Ethernet settings are set to DHCP/Automatic
Problem: Cannot Ping Control from Edge Device
Possible causes:
- Different subnets
- Firewall blocking ICMP
- Incorrect IP configuration
- Network routing issue
Solutions:
- Verify Edge and control are on same subnet
- Check firewall settings (disable temporarily to test)
- Verify IP address, subnet mask, and gateway settings
- Test with another device on same network
- Check network switch configuration
Additional Resources
MachineMetrics Resources:
- Machine Settings Guide - Configure machine settings and data mapping
- Connectivity Overview - Compare connectivity methods
- Network Requirements - Firewall and network configuration
Heidenhain Resources:
- Heidenhain TNC User Manual (consult your specific control model)
- Heidenhain PLC Programming Manual
- Machine builder documentation (Hermle, DMG Mori, etc.)
Related Guides:
- Edge Device Setup - Configure MachineMetrics Edge
- Transform Adapter Scripts - Advanced data transformation
Getting Help
MachineMetrics Support:
- Email: support@machinemetrics.com
- Phone: 844-822-0664
- Support Portal: https://support.machinemetrics.com
Before Contacting Support:
- Note the Heidenhain control type and model (iTNC 530, TNC 640, or TNC 730)
- Verify connectivity option is installed:
- TNC 640/730: Check for Option 56 (recommended) or Option 18
- iTNC 530: No option required
- Document IP address and network configuration
- Note PLC WORD address used for part counting (if applicable)
- Capture screenshots of configuration screens
- Document any error messages from control or MachineMetrics
Information to Provide:
- Machine make, model, and control type (iTNC 530 or TNC 640)
- Network configuration (IP address, subnet, gateway)
- PLC WORD address for part counter (if known)
- Adapter configuration (YAML)
- Description of issue and troubleshooting steps already taken
- Screenshots of error messages or configuration screens
For Part Counting Issues:
- Provide PLC WORD table screenshot showing counter location
- Note M-codes used in programs (if applicable)
- Describe expected vs actual part counting behavior
- Include machine builder name (Hermle, DMG Mori, etc.)