SuperCom ActiveX
ActiveX API for
Windows 7, Vista, Windows Server 2008, Windows XP, Windows Server 2003, Windows 2000, Windows NT, Windows ME/98/95
Serial Communication ActiveX Control
The SuperCom ActiveX (OLE/COM Control) for serial communications is a professional serial communication ActiveX that can be used to develop serial communication applications to control serial connections and attached serial devices (RS-232, RS-422, RS-485).
The SuperCom ActiveX for serial communications supports common Windows development environment (IDE, Compiler) and provides the programmer with properties, methods and the events in order to develop serial data communication applications.
The SuperCom ActiveX is also downwards compatible with the MSComm and compatible to PDQComm control and thus very easy to integrate into existing applications (see below how to replace MSComm, PDQComm or SaxComm with ease).
Using the SuperCom ActiveX for serial communications you easily write applications to control serial ports, Modem, Barcode Scanner, Scales, PLC, GPS receiver, POS, serial medical devices, serial printer etc. Develop file transfer and file server application.
Time is valuable. Developing communication software with the SuperCom serial communication ActiveX is extremely easy and starts by placing the ActiveX icon on a Windows Form.
The SuperCom ActiveX also provides intelligent functions that considerably speed-up the development process and produce fast, reliable solutions avoiding delaying or blocking of your application.
Communications Events
Applications using the SuperCom ActiveX can work event driven. The SuperCom ActiveX reports the events OnComm, OnDataPacket, OnConnect and OnFileInfo. The reported events enable the application to manage other tasks simultaneously while communications or file transfer last.
Events
- The OnComm event reports when characters received, when communication errors occur, status lines e.g. CTS, DSR or RING change state, etc.
- The OnConnect event provides information during the setup of a connection (e.g. modem dialup).
- The OnDataPacket event informs about the status of observed data packets for instance if an observed data packet is received.
- The OnFileInfo event provides status information during the file transfer. A progress dialog and/or file transfer statistics can be updated.
- The OnPlug event observes PnP (Plug And Play) serial devices and the TCP/IP network. Based on the used SuperCom software, it reports when serial devices plugged in or get unplugged, a network failure (e.g. cable, hardware or software failure).
Enhanced Communications Events
The SuperCom Communications ActiveX reports more than 35 different communications events. The enhanced event reporting mechanism in SuperCom ActiveX enables you to receive events on any defined character (e.g. EOF(26), STX, ACK, NAK, etc).
Polling Mode
The SuperCom ActiveX also supports the polling mode of operation. This means to obtain with methods and properties the state of the status lines and to check the data flow for communication errors without the need to react on events.
No matter which mode of operation the application is using, SuperCom will always perform serial data communication on multiple ports or connections simultaneously and in background.
File Transfer
High speed file transfers tasks are very easy to accomplish. The following widely used standard protocols ZMODEM, YMODEM/BATCH, YMODEM, YMODEM-G, XMODEM-1K, XMODEM/CRC, XMODEM, KERMIT and ASCII are included. The SuperCom ZMODEM protocol includes important features like "crash recovery", 32bit CRC and "batch file transfer". In fact, these protocols are running very stable since 1991.
ActiveX Technology - ActiveX API
It's the same ActiveX control shipped with other SuperCom packages too, like SuperCom for TCP/IP, SuperCom for ISDN, SuperCom 3964 Engine, SuperCom Suite, etc. The runtime license, included with each packet, enables to control to perform serial port connections, TCP/IP, ISDN using one and the same component. One library, one API! Read More.
MSComm Compatible
The SuperCom for Serial Communication ActiveX is compatible with the MSComm control and thus it's very easy to update existing applications using it. Replacing MSComm with SuperCom ActiveX is a fast and smooth operation.
Summary
Using the SuperCom ActiveX up to 255 ports / connections can be opened simultaneously within the same application.
Start as many instances of your application - no limit set.
Lengthy functions like file transfer, connecting or observing the data stream for special data packets or strings are working in background while your application is performing other tasks. Your application does not "freeze" waiting on a lengthy function to complete.
Example 1
(The following briefly shows a simple example of the control operation using Visual Basic)
Visual Basic Sample
Sub Form_Load()
' Select COM2
SCom.CommPort = 2
' is it available ?
If SCom.PortPresent(SCom.CommID) <> SCOM_PORT_AVAILABLE_READY Then
Exit Sub ' COM2 not available
End If
' set comm params
SCom.Settings = "115200,N,8,1"
' activate comm port
SCom.PortOpen = True
' send data
SCom.Output = "Hello World"
' receive data
s = SCom.Input
:
' close comm port
SCom.PortOpen = False
End Sub
Private Sub SCom_OnComm() 'Event function
Dim scEvent As Integer
' get the event code
scEvent = SCom.CommEvent()
If scEvent = SCOMM_EV_SEND Then ' or comEvSend
' all data sent, buffer is empty
End If
If scEvent = SCOMM_EV_RECEIVE Then ' or comEvReceive
' call SCom.Input to collect the received data,...
Call ReadChars
End If
If scEvent = SCOMM_EV_CHAR Then
' User defined special char received e.g. EOF (26), NAK, STX
Call HandleSpecialData
End If
:
:
End Sub
Private Sub SCom_OnDataPacket(Action, Data)
' The parameter Action informs about the current status.
' The parameter Data delivers the captured data packet
' OK, data available
If Action = SCOMM_DATAPACKET_OK Then sAction = "DATAPACKET OK"
' failed but some captured data may be available
If Action = SCOMM_DATAPACKET_NOK Then sAction = "DATAPACKET NOK"
' error e.g. some property values provided was wrong
' check values of used "DP..." properties
If Action = SCOMM_DATAPACKET_ERR Then sAction = "DATAPACKET ERR"
:
:
End Sub
Private Sub SCom_OnFileInfo(Action, Data)
Select Case Action
Case SCOM_RXING
S1 = "RXING"
Case SCOM_TXING
S1 = "TXING"
Case SCOM_RXFIN
S1 = "RXFIN"
Case SCOM_TXFIN
S1 = "TXFIN"
Case SCOM_QUEUEFIN
:
:
End Select
End Sub
Private Sub SCom_OnConnect(Action, TimeLeft)
If Action = SCOM_CONNECT_FAILED Then
Debug.Print "CONNECT_FAILED"
End If
' successfully
If Action = SCOM_CONNECT_OK Then
Debug.Print "CONNECTED ";
End If
' progress...
If Action = SCOM_CONNECT_INFO Then
Debug.Print ".";
End If
:
:
End Sub
|
Example 2
(Setup connection)
ActiveX: Client Connection - OnConnect
Visual Basic Sample
Private Sub SCom1_OnConnect(ByVal Action As Integer, ByVal TimeLeft As Long)
If Action = SCOM_CONNECT_FAILED Then
Form4.CTL_INFO.Text = "CONNECT FAILED"
End If
' successfully
If Action = SCOM_CONNECT_OK Then
Form4.CTL_INFO.Text = "CONNECTED"
End If
' progress...
If Action = SCOM_CONNECT_INFO Then
Form4.CTL_INFO.Text = "CONNECT INFO ..."
End If
End Sub
:
:
SCom1.PortOpen=True ' setup a link
SCom1.ConnectAddress="555-1234"
SCom1.Connect=True ' now connect
:
|
See the same for TCP/IP or ISDN.
The connection setup runs completely in background. The application receives events about the progress. It does not matter which communication link it uses (Serial, TCP/IP or ISDN) it will require one common SuperCom API to use. The learning curve is extremely low with SuperCom!
SuperCom ActiveX API - Features List
Common Features List (valid for Serial, TCP/IP and ISDN )
New and intelligent features in SuperCom 7 for Windows
SuperCom provides intelligent functions that considerably speed-up the development process and produce reliable solutions. More...
- DataPacket - Receive complete data packets based on some definitions. More...
- Trigger - Trigger events when custom data packets or strings received. More...
- DataFilter - Low level data filtering functions e.g. define ready made data filter or inspect and change data while received or transmited with custom functions. More...
- Data Monitoring1 - Low level data monitoring functions, Integrated Debugging Library
- Event Reporting - Thread-safe event reporting and synchronization with Windows controls or runtime library.
- Threaded File Queue - File transmission using queues, working completely in background!
- Connecting in background - The connection attempt is working completely in background. The application does not freeze!
- Extended XMODEM protocol. XMODEM compatible incl. ZMODEM like features. The Extended XMODEM protocol offers buffers up to 64K for high speed file transfers, File Options (transmit file names, request a file from the sender, copare date, size etc.).

- ZMODEM File Options - Instructions for the file receiver.
- ZMODEM/8k block option and the powerful ADONTEC extension ZMODEM/32k (ZMODEM/64k shipped on request). More...
- KERMIT Protocol
- Integrated TAPI support.
- Very Large Rx and Tx Buffers - Overcome known limitations.
- Sharing Connections (e.g. TCP/IP or Serial) with a third party library is usually possible.
... and many other functions and protocol extensions.
____
1 Requires a SuperCom DUAL API package (see also Software and Features)
|
Especially for RS-232, RS-422, RS-485
- Up to 255 serial ports opened simultaneously (e.g. COM1 to COM255) and/or up to 255 connections simultaneously
- Supports the MSComm compatible methods and properties. More...
- FIFO Chip Support (e.g. UART 16550/16650/16750/16950)
- Control lines DTR, RTS
- Powerful flow control (RTS/CTS, DTR/DSR, XON/FOFF, etc.)
- Any baud rates supported by the hardware e.g. up to 921600 Baud (921,6 Kbps)
 SuperCom accepts any baudrate supported by your hardware. The Windows dialog 'control panel/hardware' may not always provide accurate information on this. Please consult the hardware manual.
Often used standard PC bit-rates e.g. 5, 50, 110, 150, 300, 600, 1200, 4800, 7200, 9600, 12800, 14400, 19200, 23040, 38400, 57600, 115200 bps and through add-on serial cards 230400, 460800 and 921600 bps. Other serial hardware may support additional bit rates.
- List installed serial ports, availability status, name and type
- Dial-up connections using Modem (Hayes compatible)
- Dial-up connections using TAPI (Windows Telephony API)
- Dial-up connections using USB Modem
- Establish connections using GSM / GPRS Modem. More...
- Modem-Sharing: Sharing a Modem connection with other applications is usually possible.
- Supports USB to RS-232 / RS-485 adapters / converters
- Using serial ports redirected through the Windows Remote Desktop Protocol (RDP)
 Serial ports located on a remote computer.
- SuperCom can use Virtual Serial Ports e.g. COMM ports routed to an Ethernet PortServer/CommServer.
- PnP Serial Port devices. SuperCom reports the OnPlug event whenever a PnP serial port is attached to or removed.
- Sharing Serial Ports with a third party library is usually possible.
|
|
A short summary of the DLL API
can be found here.
Some SuperCom ActiveX - Properties

ComTypes
Content of "627, SuperCom Serial ActiveX"
- ActiveX control incl. runtime DLLs for serial communication (RS-232/422/485 and TAPI)
- Samples and Documentation
See also the the available product range for more available packages and details.
Compatibility
The SuperCom ActiveX can be used with any Windows 32 Bit ActiveX enabled development environment including C#, Visual C++, C++ Builder, Delphi incl. CodeGear, Embarcadero RAD Studio, FoxPro, LabVIEW, MS Office (Visual Basic for Applications, VBA, e.g. Excel, Access, Word), MS .NET, PowerBuilder, Visual Basic, Visual Basic .net etc.
Embed into HTML pages and use with Internet Explorer (event driven sample available).
For real Windows 64 Bit development a 64-Bit Version (x64) also offered.
Regular updates ensure compatibility with upcoming Windows versions.
Sample Applications
Complete sample applications written for C/C++, C#, C++ Builder, Delphi incl. CodeGear, Embarcadero RAD Studio, Internet Explorer, FoxPro, LabView, PowerBuilder, Visual C++, Visual Basic, VBA (e.g. Excel), Visual Basic .net, etc. are included in full source code.
Executables developed using the SuperCom ActiveX can be distributed royalty free.
System requirements
Windows 7, Windows Server 2008, Vista, Windows XP, Windows Server 2003, Windows 2000, Windows NT, Windows 95/98, Windows Me.
A proven alternative to MSComm, PDQComm, SaxComm and other
One question we often get: "Is it only Visual Basic 6 that can use the SuperCom ActiveX to replace MSComm?". And the answer is: "You can use the SuperCom ActiveX to replace the MSComm control under any compiler or development environment you are using it".
Steps to safely replace MSComm with SuperCom ActiveX
Replacing the MSComm32 control
- Remove the MSComm32 icon from the form or dialog it was placed on
- Drag and Drop the SuperCom ActiveX icon to the form or dialog
- Update the Name property of the SuperCom ActiveX from SCom1 to reflect the name used with the MSComm e.g. MSComm1
- Compile the application
How to replace PDQComm and SaxComm control
Is it possible to replace
PDQComm or
SaxComm also ?
In most cases it's the same procedure as with the
MSComm.
PDQComm and SaxComm controls contains more functions than the
MSComm. Some functions may be named differently in
SuperCom or use a different number of parameters. Thus a small rework may be needed to complete.
PDQComm or
SaxComm may also include functions or protocols that may not be included in
SuperCom ActiveX. Even if you don't use them a detail check helps to better estimate the amount of rework required.
Replacing the PDQComm or SaxComm control
- Remove the PDQComm / SaxComm icon from the form or dialog it was placed on
- Drag and Drop the SuperCom ActiveX icon to the form or dialog
- Update the Name property of the SuperCom ActiveX from SCom1 to reflect the name used with the PDQComm / SaxComm e.g. Comm1
- Compile the application and locate what's missing
- If required, change function name or constant names
- If required, replace function, ..., Compile, ....
Frequently Asked Questions about MSComm and related issues. More ...