The following example assumes that you’ve successfully established a connection to the Decoder. You can establish a connection either with your own software or, for testing purposes, using a Telnet client like the one that Windows offers or PuTTY.  For the remainder of the document, the following symbols are used:

← denotes commands that you send
→ responses from the decoder.
<CrLf> are the carriage return and line feed characters which needs to be added after every command. (Note: A telnet client will do this automatically when you press the enter key.)

For a complete description of a specific command refer to its individual section.

First set the protocol version to the latest version available at the time you are doing your implementation. That way you can use all available features. The newest protocol version might not be available if the decoder’s firmware is not up to date. Note: Newer (upcoming) firmware versions will always support older protocol versions.

← SETPROTOCOL;2.0<CrLf>
→ SETPROTOCOL;2.0<CrLf>

After start up, the decoder is in Test Mode and will not store passings. To switch to operation mode:

← STARTOPERATION<CrLf>
→ STARTOPERATION;OK;0000-00-00;00:00:00.000<CrLf>

Now passings are saved and the time is running on the decoder. You can query the current time using:

← GETTIME<CrLf>
→ GETTIME;0000-00-00;00:02:12.942<CrLf>

 
To check the current number of passings:

← PASSINGS<CrLf>
→ PASSINGS;1<CrLf>

This assumes that you have generated a passing on the decoder using a transponder or a marker detection.
To fetch that passing, simply send the number 1:

← 1<CrLf>
→ 1;592;0000-00-00;12:30:12.322;888;4;-52.778000;38cd1c;0;;;;;;;;D-4476<CrLf>
  <CrLf>

Note: You can query multiple passings by calling X:C where X is the first passing that should be returned and C is the max. number of passings that the call will return.

Instead of only querying the current time, you can request extended status information:

← GETSTATUS<CrLf>
→ GETSTATUS;0000-00-00;00:02:39.942;1;11111111;1;50;1;49.721,8.254939;1;0;;;;;;;1;0<CrLf>

You will most probably call the PASSINGS, GETTIME and GETSTATUS periodically and fetch new passings as soon as PASSINGS reports them. After your event has finished you can stop the operation mode so no new passings will be saved when the decoder detects transponders:

← STOPOPERATION<CrLf>
→ STOPOPERATION;OK<CrLf>