The SuperCom DUAL API

*Application Programing Interface (API)

Toolkit for Serial Communication, TCP/IP and ISDN

Q: ActiveX or ActiveX API: What is the difference ?
A: ActiveX refers to the SuperCom ActiveX control (OLE / COM control). ActiveX API refers to a special object oriented API introduced with the SuperCom ActiveX control and is currently offered via the SuperCom ActiveX control or the SuperCom .NET Class Library (class TSCom). Similar high level class are also offered among others for C++, Pascal / Delphi und Java .

Example

  SCom.PortOpen = True
  SCom.Output = "Hello"

Q: What is the SuperCom DUAL API ?
A: The SuperCom DUAL API consists of the DLL API and the ActiveX API.
ActiveX API: The ActiveX API consists of Properties, Methods and Events provided by one ActiveX control (OLE / COM Control) or the SuperCom .NET Class Library.
The ActiveX API was implemented above the SuperCom DLL API.
DLL API: The DLL API is the combination of one or more runtime files (.DLL or .so) and the corresponding import library (.LIB, .BAS, .PAS, .TPU etc.). The import library is inserted into the applications project and compiled. This way the application gains access to the functions located inside the DLL. The DLL is an external shared library of functions that is loaded when needed. A DLL takes code out of the executable, makes it smaller, it loads faster and it can be shared by many executables the same time. The operating system (e.g. Windows, Linux, OS/2) automatically loads the DLL when the application calls for it. Modern operating system consist in big parts of dynamic libraries / shared libraries (e.g. Windows API). Thus the SuperCom DLL API fits excellent into the modularity concept of Windows, Linux, OS/2 and using it is very easy.

With DUAL API you can choose to use one API or even both API's as it fits best.

DLL API

ActiveX API

Features List

Features List

Functions

Properties

The Chart of Software and Features shows which SuperCom product supports a specific API. A DUAL API product supports both (ActiveX API and DLL API).

Q: What is the SuperCom DLL API ?
A: The DLL API is the combination of one or more runtime files (.DLL) and the corresponding import library (.LIB, .BAS, .PAS, .TPU etc.). The import library is inserted into the applications project and compiled. This way the application gains access to the functions located inside the DLL.

The DLL API is functional grouped into two categories: a) the Low Level functions operating close to the underlying hardware and each name starts with Com... (e.g. ComInit) and b) the High Level functions operating above the low level functions, not bound to a specific hardware and each name starts with RS... (e.g. RS_TXPInTime).

Example

  ComInit(COM_1)
  ComSetState(COM_1, 9600,,,)
  ComWriteEx(COM_1, "Hello", strlen("Hello"))

DLL: A DLL is an external shared library of functions that is loaded when needed. A DLL takes code out of the executable, makes it smaller, it loads faster and it can be shared by many executables the same time. Windows automatically loads the DLL when the application calls for it. The most part of the Windows operating system consist of DLLs (Windows API). DLL's are maybe the most useful feature ever added to Windows and is the abutment of the Windows modularity concept. Thus the SuperCom DLL API fits excellent into the Windows modularity concept and using it is very easy.

Features List

Functions


The Chart of Software and Features shows which SuperCom product supports a specific API.

Q: What is the SuperCom ActiveX API ?
A: The ActiveX API consists of Properties and Methods provided by one ActiveX control or the SuperCom .NET Class Library. The ActiveX API is available automatically after installation within the development environment e.g. Visual Basic, VBA, Visual C++, C++ Builder, C#, VB .net, Delphi etc.

Features List

Properties


The Chart of Software and Features shows which SuperCom product supports a specific API.

Q: Do I have to choose an API in advance ?
A: Users of a SuperCom DUAL API software package are in position to select the most suitable API or they can use the ActiveX properties and methods and also call DLL functions. By combining both APIs a very big function set is available to the application. It opens unforeseen potentialities. For instance while the application administrates the data link using the high level ActiveX properties it can call DLL functions to perform low level tasks. Using low level DLL functions it's even possible to enhance or change the behavior of the event reporting mechanism within the ActiveX. Additionaly, SuperCom includes flexible class libraries (e.g. for C++, C#, Delphi, Java, Pascal, VB net, ...) that directly "speak" to the DLL API. The DLL API also includes intelligent high level functions which may run faster or offer more possibilities that the corresponding ActiveX property or method.

Q: What to use in a NET development environment ?
A: Using SuperCom in Microsoft .NET Framework (e.g. C#, VB Net) offers nothing less than the known DLL API and Activex API. Both API are compatible to the well known but the new class library offers a lot more. Developers can now use the DLL API and the ActiveX API via the SuperCom .NET Class Library and even combine both API as needed since the class library includes both. Thus the SuperCom ActiveX is not needed in order to use the ActiveX API. Naturally, the SuperCom ActiveX control can still be used within .NET, if required.

The SuperCom .NET Class Library is included in every DLL API and DUAL API SuperCom completely with its C# source code and can be used with NET aware compilers like C#, VB Net and C++. The SuperCom .NET Class Library is available in 32 bit and 64 bit SuperCom packages. where is the SuperCom NET class included?

   .NET code snippets      FAQ      List of available NET sample programs

Q: Can I use SuperCom functions and protocols in combination with a third-party communication toolkit ?
A: SuperCom provides functions to integrate or share connections and/or links established by a third-party toolkit. For instance an application uses a third party TCP/IP component to connect to a server but need to use the SuperCom ZMODEM protocol. Several samples available.
NOTE: Since not all configurations are possible and not all third party components are providing the expected functionality, we suggest you to contact our technical support and discuss the matter.

Q: Do I have any influence on the reported events ?
A: Yes, both API (ActiveX API and the DLL API) offer properties and functions to suppress unwanted events.

Q: Is it possible to monitor an adjust events on low level ?
A: A rather rare application but it is possible. The DLL API can install a user function within the event reporting chain in order to monitor, filter, adjust events on the way to the application.
See the following C/C++ sample.

Event function filtering communications events: Sample

The above samples are easily adopted to other development environments like Visual Basic, Delphi, C#, VB Net. Most of this code can also be located within the included samples. SuperCom does also include support functions to overcome some compiler limitations regarding pointer and address calling functions.

 

[ Chart of Software and Features ]


Home    Back
Modified at:

ADONTEC