Release Notes
211-065-04
September 2007


              HDLC development information


Introduction
==========================================================================

These Release Notes provide information for developers wishing to use
Eiconcard(r) products and the HDLC protocol.

These Release Notes are organized as follows:

o Operating Systems
o Specs/Ref
o Configuration
o Samples


Operating Systems
==========================================================================

The Eiconcard products and services offer support for the HDLC
protocol on the following operating systems:

-Windows  (Windows(r) 2000 , XP/2003 (32 and 64 bit) )
-Linux (See supported distributions in the Connections for Linux package)


Specs/Ref
==========================================================================

To be able to write an HDLC application to interface to the Eiconcard(r)
the following Eiconcard documents are needed:

-HDLC Interface Software	204-001
-Using the NCB Interface	204-014

The HDLC Interface software can be found in the \Specs directory of the
HDLC section of the Eiconcard Development Suite CD.

NOTE:	Contact the Eiconcard Developer Support Group to be able to get the
        "Using the NCB Interface" documentation. At that time a
        Non-Disclosure Agreement form will be sent. The form will have to
        be completed and send back to the Developer Support Group. The
        document will only be sent if and when the Non-Disclosure
        Agreement Form is completed.

		Eicon Developer Support Group
		Email: devsup@dialogic.com

*** IMPORTANT DEVELOPMENT INFORMATION ***
When developing an application using the NCB interface, the project needs
to include the proper header file and link to the corresponding library
file (please refer to the samples).

NCB Header and Library files:

Windows: ecncb.h and ecncb.lib or ecncb_64.lib

Linux: ncb_unix.h and libEec.a
       (libEec.a is installed on the system when installing
       Eiconcard Connections for Linux)



Configuration
==========================================================================

To be able to use the HDLC protocol and interface with the Eiconcard, the
Eiconcard needs to be configured with the help of the configuration
program that comes with the gateway. Select the HDLC protocol and also set
the Auto activate port to NO (or uncheck the Auto activate box in the
ports section of the card's configuration).



Samples
==========================================================================

Included in the HDLC section of the Eiconcard Development Suite are some
sample applications that show the usage of the NCB and HDLC interface for
the Linux and Windows platforms.

These sample applications are for testing purposes only and
should not be used in a production environment.

-- It is strongly recommended to look
at the sample source code and read the comments before using them. --




Linux: The name of the sample is Hdlcchat. It is a simple chat program
       that uses HDLC frames to connect, send, and receive messages. WAIT
       mode is used as a completion method; it's a blocking mode that
       waits for the request to be completed.

       When using this sample, it is important to make sure that the DTE
       side is the one that initiates/submits the first disconnect. If the
       DTE is the last to submit the disconnect, then the application will
       block untill N2*T1 expires (N2 and T1 are set and defined in the
       HDLC configuration of the Eiconcard).

       To be able to compile and test this sample, the corresponding
       directory and its contents need to be copied on the system. It is
       also necessary that Eiconcard Connections for Linux be installed
       on the system. This will make sure that the needed library file is
       present on the system.
       The included makefile is formatted in such a way that it will find
       and use the proper source code, header, and library files.
       
       Untar hdlc.tar in the root directory (/) of your system to ensure
       the header files and samples are placed in their default locations.
       The hdlc.tar file contains only relative paths.  If you prefer,
       it may be extracted in a subdirectory of your choice.
       In this case you will have to modify the makefile include and library
       paths in order to compile the samples.

Windows: The name of the sample is HDLCchat. It is a chat program that uses
       HDLC frames to connect, send, and receive messages. NOWAIT mode
       with manual polling is used as a completion method.

       To be able to compile and test the HDLCchat sample, the Hdlc\Win32
       directory needs to be copied, in its entirety, on the system. The
       sample was written and built using Microsoft Visual C++ 6.0
       (Microsoft Developer Studio Project - *.dsp). The project
       settings are defined to use relative paths as formatted by the
       Hdlc\Win32 directory structure.
       
       For example, if using a working directory named HDLC_Dev, the resulting
       directory layout should be the following:
              
       \HDLC_Dev\Common
       \HDLC_Dev\Hdlc\Win32
              
       Specific project files for 64-bit environments are not provided.  In order
       to compile the samples for a 64-bit environment, in addition to the above,
       complete the following steps:
              
       Open the project file and modify the project settings to create a new 64 bit
       configuration and select the 64-bit platform.  
              
       Remove the ecncb.lib library from the project and add the ecncb_64.lib library.



############## End of 211-065-04 #########################################

Copyright (c) 1998-2007 Dialogic Corporation