X.25 Developers Toolkit and APIs

FarSync X.25 products

Developers Toolkit

X.25 Developers Toolkit: A comprehensive Developers Toolkit for development using APIs to X.25, XOT and ISO Transport on Linux and Windows, it includes:

  • Documented working sample programs for Linux and Windows, including in C, Java, Visual Basic and Delphi. Source code from these samples can be used to fast-track your development process
  • Comprehensive set of API manuals with function call definitions and helpful advice on the best way to utilise the various interfaces
  • Source code for the Linux drivers and API libraries
  • Multi-port Line Monitor and a Line Statistics application
  • Free email and telephone assistance to the application developer using the APIs

Download the X.25 Developers Toolkit.


Overview of the APIs for Application Development

Application developers have a choice of APIs for X.25, ISO Transport and accessing HDLC (LAPB). An API selector guide is provided to assist the developer in choosing the most appropriate interface for the requirement.

Sockets API - X.25, XOT - Supported on Windows and Linux

The Sockets API is extremely popular as a simple, easy to use API to access TCP/IP communications networks. The Sockets support for the FarSync X.25 adapters retains this ease of use and also allows the special features of X.25, XOT and ISO Transport classes 0 to 3 to be accessed. The Sockets API is available on both Windows and Linux for 32 and 64 bit applications.

Sockets on Windows: The FarSync Windows Sockets interface is WinSock2 compliant, it supports standard AF_ISO / ISOPROTO_X25 sockets used by a number of applications, such as MS-Exchange. It also supports an alternative address family, AF_X25, to allow easy porting of applications between Windows and Linux.

Access to XOT, X.25 and ISO Transport is available from this API.

The FarSync Sockets API is compatible with the Microsoft defined X.25 Sockets API. Applications written to use the Microsoft X.25 Sockets API will work with the FarSync product.

Applications developed in most programming languages including Visual Basic, Delphi, C++ and .NET applications can use the Sockets API to the FarSync X.25 adapters and FarSync XOT Runtime software.

Sockets on Linux: The FarSync Sockets implementation is compatible with the BSD Sockets interface.

It is easy to convert applications written for TCP/IP to instead use X.25 as the transport mechanism. In many cases the only change required is to the parameters provided when the socket is created to reference the X.25 address family and protocol. Multi-threaded applications are supported.

Access to X.25 and XOT is available from this API.

More details on the X.25 Sockets API.

Java API - X.25, XOT- Supported on Windows and Linux

The Java API allows applications written in Core Java Software (J2SE) and Enterprise Java Software (J2EE) easy access to the functions and features of X.25 offered by the FarSync X.25 adapters.. Full documentation and sample applications are provided.

NCB API - X.25 and ISO Transport - Supported on Windows and Linux

A legacy API is supplied to maintain compliance with older X.25 cards, access to ISO Transport and X.25 is provided from Windows and Linux. Not recommended for new applications.


Line Monitor and Network Statistics Utilities

The product includes a multi-port line monitor on Windows and Linux, an invaluable tool when testing new applications and commissioning new systems. Line traces can be displayed in real time, recorded (including in pcap format) and reviewed with full protocol decoding, comments can even be inserted in the trace to assist later analysis. See the sample screens below.

Wireshark can also be used to trace X.25 line activity in real time.

A connection status and statistics utility is also provided. It's functions include the display of the channel connection status and statistics of user data, packet and frame types passed over the X.25 lines.

FarSync Line Monitor display
Sample Windows FSMON line monitor screen showing an X.25 call request and call accept followed by data transfer

FSMON showing X.25 call and call accept on Linux

Sample Linux FSMON line monitor output showing an X.25 call request and call accept followed by data transfer

X.25 Developers Toolkit Summary
X.25 / XOT APIs on Linux Sockets API, easy to use, provides access to X.25 and XOT features, recommended for most developments, applications can be 32 or 64 bit.
Java API, for X.25 and XOT specially developed for Java applications (J2SE, J2EE), quick and easy to use.
NCB API A legacy API to maintain compliance with older products only.
X.25 / XOT APIs on Windows

Sockets API, easy to use, provides access to XOT and X.25 features, recommended for most developments applications can be 32 or 64 bit.
Java API, for X.25 and XOT, specially developed for Java applications (J2SE, J2EE), quick and easy to use.
NCB API A legacy API to maintain compliance with older products only.

ISO Transport API on Linux

NCB based API, providing access to all the features of the ISO Transport support. Can operate simultaneously with access to X.25.

ISO Transport API on Windows Sockets API, providing access to all the features of the ISO Transport support. Can operate simultaneously with access to the X.25.
NCB based API, legacy API providing access to all the features of the ISO Transport support. Can operate simultaneously with access to X.25.
API reference manuals X.25 Sockets API manuals, Java API documentation, ISO Transport API manuals, NCB API manuals
Sample programs Included, large number of example applications are available for driving the various APIs, including SVC and PVC operation.
Source code Included for Linux drivers, the Linux API libraries and sample C and Java applications

02-Mar-2015