SuperCom Heidenhain Communication Library

---

for Windows and Linux

Control Heidenhain TNC through the serial port or Ethernet (TCP/IP)

Introduction

The SuperCom Heidenhain Library enables fast and accurate data acquisition of machine and process data from Heidenhain controlled machines.

The SuperCom Heidenhain Library contains functions to build stable and fast data connections to one or more Heidenhain TNC controllers. The connection may be serial, that is to say via serial interfaces or via the TCP / IP protocol stack (Ethernet connection). The connection can be made locally within the factory or over a large distance via Modem, Internet or ISDN connection (see also SuperCom Suite).

The functions contained in the SuperCom Heidenhain Library support data communication to different Heidenhain TNC which should have a serial line or TCP/IP protocol (Ethernet connection).

Acquire and monitor Heidenhain TNC machine status data, machine states or process data. Several functions enable fast data acquisition of the machine data. Collect data from the Heidenhain TNC machines (data collection software) or monitor the machine status (Machine Monitoring Software) of multiple machines simultaneously.

The SuperCom Heidenhain Library almost hides the complexity of the data communication to a Heidenhain TNC and provides functions that perform the most wanted tasks by using simple function calls. SuperCom establishes the connection to the Heidenhain TNC directly via the serial port or the TCP/IP protocol stack. The whole data communication is running transparently using high-speed functions achieving rapid results.

Controlling many connections concurrently is supported and that is common to SuperCom.

SuperCom's Event-Driven file transfer functions enable accurate monitoring of the file transfer progress, providing continuously status information to the application, if needed.

The library includes high-speed functions for event-driven file transfer to and from the Heidenhain TNC (send files, receive files), list directories, create or delete directories, rename or delete files, read TNC configuration data, retrieve machine status, machine data, process data, read and write memory etc.

The library includes Direct Memory Access enabling to retrieve data directly from the PLC memory. Getting rare information is easily possible.

The SuperCom Heidenhain Library implements the protocol functions using a SuperCom communication library (serial or TCP/IP) and the SuperCom LSV/2 protocol module* that provides a stable data communication link.

The SuperCom library provides fast and rock solid functions to extract information and control one or more TNC machines. It enables the software developer to control many connections to different TNC machines simultaneously. It enables to query information by different ways thus increasing the amount of information to extract. Also, the amount of information supported and returned by the different TNC machines differs.

There is only one API to learn! The same functions and parameters used with serial, TCP/IP or ISDN type of connections.

      
*Included with this library.

A short list of functions: 

HN_SetConfig	Configure the SuperCom software and/or the remote TNC
HN_GetCurrentDir	Retrieve the information about the TNC's current directory
HN_ChangeDir	Change the TNC's current directory
HN_MakeDir	Create a directory under the current directory
HN_RemoveDir	Removes a directory
HN_FileExists	Check if a specific file name exists on the TNC
HN_CopyFile	Create a copy of a specific file on the TNC
HN_DeleteFile	Delete a specific file on the TNC
HN_RenameFile	RenameFile a specific file on the TNC
HN_ReceiveFile	Retrieve a file from the TNC (Download, incl. Events and Progress-Information)
HN_SendFile	Transmit a local file to the TNC (Upload, incl. Events and Progress-Information)
HN_ChangeFileAttr	Changes a files attributes on the TNC
HN_SetFileTime	Changes a files time stamp on the TNC
HN_GetTNCDateTime	Retrieve the date & time information of the TNC
HN_SetTNCDateTime	Set the date & time information of the TNC
HN_ReadMemory	Access memory area to read information of the TNC
HN_WriteMemory	Access memory area to alter information on the TNC
HN_GetSystemParam	Retrieve the TNC configuration
HN_ActivateAndRun	Activate and run the specific program file
HN_GetRunInfoEx	Provides DNC state information
HN_GetMachineParameters	Retrieves maschine parameter (e.g. MP1234)
HN_SetMachineParameters	Changes maschine parameter
HN_GetLog	Retrieves the log file
: :	: :

What to order?
The SuperCom Heidenhain Library needs a SuperCom communication layer for the data transfer (Serial and/or TCP) e.g. SuperCom Serial for Windows, SuperCom Suite for Windows. The SuperCom communication layer is responsible for establishing connections and low level data transfer.
* The SuperCom LSV2 Protocol Module is included with the SuperCom Heidenhain Library.

Favorable combinations

Hardware requirements
Heidenhain TNC with a serial port interface (serial LSV/2 protocol link) or Ethernet (TCP/IP) interface.
Heidenhain TNC 320, TNC 360, TNC 426, TNC 430, iTNC 530, TNC 620, TNC 640, MANUALplus, DataPilot CP 620, DataPilot CP 640, DataPilot MP 620, DataPilot 4110, DataPilot 4290 and more.
An Option 18 is not required/used.

License Information
Executables developed using the SuperCom library can be distributed royalty free. More..

Supported compilers
C#, C/C++, C++ Builder, Delphi, Visual C++, Visual Basic, Visual Basic NET, VBA, LabView, FoxPro, PowerBuilder and other Windows programming tools (MS .NET ?).

Extensive collection of samples for C#, C/C++, Delphi, Visual C++, Visual Basic (VB6), Visual Basic NET are included. More..

A flexibel and portabel library for use in Windows or Linux application*.

* Please select the specific Windows or Linux products codes.