Getting started
Install the TSOP SDK
The following sections explain how to install the SDK on Windows and Linux.
Windows installation
To install on a Windows workstation, follow these steps:
-
Ensure you have uninstalled any previously installed version of the SDK.
-
Insert the SDK disk (named
TSOP-SDK-x.xx.xx
, where x.xx.xx represents the disk’s version number) into your CD/DVD drive. -
Run the executable file
win\setup.msi
, and follow the onscreen instructions.
Linux installation
The SDK is distributed as two compressed .tar
files.
To install on a Linux workstation, follow these steps:
-
Ensure you have uninstalled any previously installed version of the SDK.
-
Unpack the files from the root directory using the following commands:
-
For C:
tar -xvf TSOP-SDK-x.xx.xx/linux/c/devel.tar
-
For Java:
tar -xvf TSOP-SDK-x.xx.xx/linux/java/devel.tar
-
In these commands, x.xx.xx represents the disk’s version number.
Locations of the installed software and examples
On Windows, the Java and C versions of the SDK software are installed, respectively, in:
-
%NFAST_HOME%\java\dsesdk
-
%NFAST_HOME%\c\dsesdk
On Linux, the Java and C versions of the SDK software are installed, respectively, in:
-
/opt/nfast/java/dsesdk
-
/opt/nfast/c/dsesdk
Java examples
The following example Java applications are supplied on each operating system:
Example applications | Use |
---|---|
|
These applications get a time-stamp from a server and print information from the time-stamp to the screen.
|
|
These applications provide information on:
|
The contents of the java/dsesdk/
directory tree is the same for all operating systems (the path descriptions here use Unix-style directory separators, but you can substitute Windows-style directory separators as appropriate).
File / directory | Description |
---|---|
|
This file is the |
|
This is an internal support library for |
|
This directory contains the Javadoc documentation for the SDK Java classes. |
|
This directory contains example applications:
|
|
This directory does not contain example applications but rather a collection of example classes, in the form of sample code that you can use and modify. |
|
This directory contains Javadoc documentation generated from the source example classes in the |
|
This file is the compiled |
See the example help message for details of parameters that can be varied. |
C examples
The following sections discuss the C application examples available for Windows and Linux.
See the example help message for details of parameters that can be varied. |
C examples for Windows
The contents of %NFAST_HOME%\c\dsesdk\
provide the source and compiled binaries for two sample applications:
Example applications | Use |
---|---|
|
This application uses the TCP/318 socket-based protocol to get the time-stamp from the server and then prints the information from the time-stamp to the screen. |
|
This application (IP Time-Stamp Demo), is a Windows GUI time-stamp application. There is no version of IP Time-Stamp Demo for Linux. |
In %NFAST_HOME%\c\dsesdk\
you will find:
File / directory | Description |
---|---|
|
These directories contain the DLL, LIB, and PDB files for the SDK, for 32-bit and 64-bit respectively. |
|
These directories contain the header files for the SDK, for 32-bit and 64-bit respectively. |
|
This directory includes prebuilt versions of the example applications |
|
This is the output directory for the example projects that Visual Studio builds. It also contains prebuilt versions. |
|
This directory contains the source for the |
|
This directory contains the source for IP Time-Stamp Demo, |
C examples for Linux
Linux installations provide the source, compiled binaries, and Makefiles for the example C application ttitest
.
Example application | Use |
---|---|
|
This application uses the TCP/318 socket-based protocol to get the time-stamp from the server and then prints the information from the time-stamp to the screen. |
On Linux, the /opt/nfast/c/dsesdk
directory contains:
File / directory | Description |
---|---|
|
This directory contains header files for the SDK. |
|
This is the library file for the SDK. |
|
This directory contains the compiled binary executables, source code, and Makefiles for the |