Readme 211-157-02 September 2007 SDLC Development Information Introduction ========================================================================== This Readme provides information for developers wishing to use Eiconcard(r) products and the SDLC protocol. These Release Notes are organized as follows: o Operating Systems o Specs/Ref o Installation o Configuration o Samples Operating Systems ========================================================================== The Eiconcard products and services offer support for the SDLC protocol on the following operating systems: -Windows 2000 , XP/2003 (32 and 64 bit) -Linux Red Hat(r) and SuSe(r) Specs/Ref ========================================================================== To be able to write an SDLC application to interface to the Eiconcard(r) the following Eiconcard documents are needed: -SDLC Interface Software 204-004 -Using the NCB Interface 204-014 NOTE: Contact 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 Dialogic Corporation. The document will only be sent if and when the Non-Disclosure Agreement Form is completed. Eiconcard 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 ecnecb.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) Installation ========================================================================== Windows ------- The SDLC Interface software is copied manually by following the steps below: 1. From the root of your hard disk create the new folder stucture \Eiconcards\Devtools\Sdlc. 2. From the Eiconcard Development Suite CD, copy the Sdlc\Win32 folder to the folder created in Step 1. The subdirectory structure should not be modified. If changes are made, the samples may not build correctly. 3. From the Eiconcard Development Suite CD, copy the Common folder to the \Eiconcards\Devtools folder. The resulting structure should look like the following: \Eiconcards\Devtools\Sdlc\Win32 \Eiconcards\Devtools\Common 4. The SDLC Interface Specification (Sdlc\sdlc.pdf) can also be copied to the folder created in step 1. Linux ---------- Depending on the installed Operating System, the corresponding directory is to be used as the source directory from the Eiconcard Development Suite CD. Linux : Use the Sdlc\Linux directory Copy the sdlc.tar file from the Sdlc\Linux directory to the / directory and from that directory, extract the files with the following command : tar xvf sdlc.tar Files will be extracted and copied to : /opt/dialogic/c4l/devtools/sdlc /usr/include/eicon The sdlc.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 path in order to compile the samples. Configuration ========================================================================== To be able to use the SDLC 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 SDLC 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 SDLC section of the Eiconcard Development Suite are some sample applications that show the usage of the NCB and SDLC 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 Sdlcchat. It is a simple chat program that uses SDLC 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. To be able to compile and test this sample, the above installation guidelines should be followed. It is also necessary that Eiconcard Connections for Linux pacakge 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. Windows: The name of the sample is Sdlcchat. It is a chat program that uses SDLC 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 Sdlcchat sample, the above installation guidelines should be followed. 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 Samples directory structure. 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-157-02 ######################################### Copyright (c) 1998-2007 Dialolgic Corporation