Wavecom W51PC User Manual

User Manual

W51PC DCOM Interface

V1.1

By WAVECOM ELEKTRONIK AG

PUBLISHED BY
WAVECOM ELEKTRONIK AG
Hammerstrasse 8
CH-8180 Buelach
Switzerland

Phone [phone]
Fax [phone]
Email: [e-mail]
Internet: http://www.wavecom.ch

© by WAVECOM ELEKTRONIK AG. All rights reserved.

Reproduction in whole or in part in any form is prohibited without written
consent of the copyright owner.

The publication of information in this document does not imply freedom
from patent or other protective rights of WAVECOM ELEKTRONIK AG or
others.

All brand names in this document are trademarks or registered trade­marks of their owners.

Specifications are subject to change without further notice

Printed: Wednesday, January 30, 2008, 12:51:15

Contents

Welcome 1

Professional Version 1
Options 1
Training 1
Source Code 1
Company Profile 1
Revisions 2

Introduction 2

Remote Control Interface 4

Class W51Server 4

Iw51System 4
Iw51System Methods 5
Iw51DataSink 8
Iw51DataSink Methods 9
RawData format for FAX 10

Class W51Param 10

ICW51Param 10
ICW51Param Methods 10

List of Parameters 11

List of parameters supported by W51System class 11

Programming Examples 18

Visual FoxPro 18
Visual Basic 19
MATLAB 20
Microsoft C 20

Glossary of Terms 21

Index 25

User Manual W51PC DCOM Interface V1.1 Contents • iii

Welcome

Congratulations on your purchase of a WAVECOM decoder. The product
that you bought incorporates the latest technology in data decoding to­gether with the latest software release available at the time of shipment.

Please, check our website http://www.wavecom.ch for software updates.
Always check the latest documentation on the installation CD or on our

website.
We thank you for choosing a WAVECOM decoder and look forward to

work with you in the future.
This chapter introduces WAVECOM, the field of activity of the company,

and how you may benefit from the expertise of WAVECOM.

Professional Version

This documentation is only available in the professional version of the
WAVECOM decoder software.

Professional versions are only available to government bodies.

WAVECOM maintains a mailing list of our professional customers. For
registration details, see Appendix at the end of this manual.

Options

Training

Source Code

Company Profile

Different additional options are available from WAVECOM.

In the manual, options are marked with (Option).
Options are only available to government bodies.

Please, note that when required WAVECOM is able to provide training on
the WAVECOM XML interface. Training can be ordered to take place at
the customer location or at our offices in Switzerland.

Source code is available for professional users. Please, inquire to receive
an offer from WAVECOM if you plan to add your own modes.

WAVECOM ELEKTRONIK GmbH was founded in 1985 in Hohentengen,
Germany, close to the Swiss border. In 1991 the company moved to
Switzerland and established itself as WAVECOM ELEKTRONIK AG.
Now located in Buelach it is within close vicinity of Zuerich airport.

User Manual W51PC DCOM Interface V1.1 Welcome • 1

Revisions

The company has focused on decoding and analysis systems for wire­less data transmissions. The wide product range spans from profession­al, high performance systems to devices for private and amateur radio
use.

The very high quality standards combined with high system performance
are appreciated by all customers worldwide. A global network of autho­rized sales partners ensures that local assistance and basic level support
can be provided in most places. More than 95% of all units sold are ex­ported. The majority of the customers are government agencies, defense
organizations and the telecommunication industry.

About 40% of the turnover is invested in research and development. The
employees at WAVECOM ELEKTRONIK AG are mainly engineers wi th
experience in DSP technology, computer and RF hardware development,
software engineering and radio data transmission. Access to external
know-how and human resources enlarges the capabilities for realizing
projects. Manufacturing is outsourced to specialized companies within
Switzerland which can handle today's needs for processing surface
mount components and fine-pitch structures.

WAVECOM ELEKTRONIK AG does not have any juridical or financial
links or connections to other companies or official bodies and is com­pletely owned by its general manager, Mr. Christian Kesselring.

Version Date Changes

1.0 28.Aug 2006 Removed from the W 51 Manual and put in a sepa-

1.1 30.Jan 2008 HRESULT GetTextData([out] BSTR *Data) ex-

Introduction

DCOM is no longer supported in future WAVECOM products. It still exists
in the W4oPC, W41PC and W51PC. Please convert your existing
W51PC software to the XML interface

The WAVECOM program consists of two parts. The first part is called the
WAVECOM Client and contains the user interface, menus, dialogs and
graphics. The second part, called the WAVECOM Server, contains the in­terface to the decoder card. The WAVECOM Server communicates with
the decoder card and it always run on the machine containing the DSP
card. Client applications use DCOM to connect to the WAVECOM Server
from anywhere on the network.

rate document.

tended for codes that have more than one channel.

2 • Introduction User Manual W51PC DCOM Interface V1.1

Computer

Computer

Client Application

Computer

SERVER

Wavecom Cards

Computer

SERVER

Wavecom Cards

The WAVECOM Server provides two interfaces. The first is a compre­hensive interface providing all the functionality required by the
WAVECOM Client application. The second interface is a simplified inter­face providing only the functions required for an external application. This
interface is compatible with the OLE automation standard to allow appli­cations written in various programming languages to interface to the
WAVECOM Server.

User Manual W51PC DCOM Interface V1.1 Introduction • 3

Remote Control Interface

IWxxParam

1

2

3

4

4

signal output appear on

3

2

1

Client Application

IWxxSystem

Interface diagram

IWxxDataSink

WxxServer

Class

WxxPC Cards

WxxParam

Class

WxxPC

Class W51Server

W51Server is implemented as an out-of-process server. It can either be
used as a Local Server (on the same machine) or a Remote Server (on
another machine). The W51Server program supports the Iw51System in­terface for use by any client application.

Iw51System

Decoder

User Interface

User locate and start
decoding a signal

Similarly, the client application can set the state of the decoder card.

Decoder

User Interface

User see parameters
changing. Decoded

the screen.

Card communicate
parameters to server

Wxx PC Server

Server communicate
parameters to decoder
Card

Wxx PC Server

Client

Application

Client Application
retrieve parameters
from server using
the Iwxx System
interface

Client

Application

Client Application
set parameters in
server using the

Iwxx System

interface

Client Application
save parameters in
database

Client Application
retrieve parameters
from database

The Iw51System interface is used to set or retrieve state and decoded
data from the W51PC card. The state consists of parameters such as de-

4 • Remote Control Interface User Manual W51PC DCOM Interface V1.1

coder mode, baud rate, frequency shift, etc. The client application can at
any time retrieve the state of the decoder card as it was set up using the
decoder user interface and the decoder user interface can retrieve the
state as it was set up using the client application. This is because the de­coder user interface and the client application share the same
W51Server.

The list of parameters that make up the state of the decoder varies from
mode to mode and is also changed from time to time as new modes and
functionality are added to the decoder. To isolate the client application
from these changes, the state of the decoder is stored as a “blob” of data.
This is simply a variable length array of bytes. It is the responsibility of
the W51Server to create this blob when sending it to the client application
and to interpret the blob when it is received from the client application. All
that the client application has to do is to ensure that it sends the blob
back to the W51Server exactly the same way it was received. To allow
the client application to interpret the parameters that are inside the “blob”
a W51Param utility class is provided.

Iw51System Methods

Shown below is the IDL definition of the Iw51System interface. Each of
the functions (or methods) will be described.

interface IW51System : IDispatch
{

HRESULT Connect([in] BSTR CardName);
HRESULT ConnectByNumber([in] long lCardNumber);
HRESULT ActivateW51PC([in] BSTR ComputerName);
HRESULT SetParam([in] BSTR Blob);
HRESULT GetParam([out] BSTR* Blob);
HRESULT GetSystemStatus([out] BOOL*Idle,

HRESULT SetUpdateRate([in] long lUpdateRate);
HRESULT GetTextData([out] BSTR *Data);
HRESULT GetRawData( [in] long cMax,

HRESULT EnableCallBackText([in] BOOL Enable);
HRESULT EnableCallBackRaw([in] BOOL Enable);
HRESULT EnableCallBackStatus([in] BOOL Enable);
HRESULT GetCardStatus([out] long *Status);
HRESULT RawDataAsText([in] BOOL Enable);
HRESULT SystemIsReadyForParamChange([out] BOOL *IsReady);
HRESULT Reset();
HRESULT Resync();

};

[out]BOOL*Traffic,
[out] BOOL*Error,
[out] BOOL*RQ,
[out] BOOL*Auto,
[out] BOOL*Sync,
[out] BOOL*Phasing)
[out] long*Level);

[out] long*pcActual,
[out size_is(cMax),length_is(*pcActual)] BYTE Data);

Description of methods in Iw51System:

HRESULT Connect([in] BSTR CardName);

The card name is provided as a BSTR. These card names can be
changed using the Server Control application. This function initializes the
card by downloading code to the card. This function has to be called be­fore the card can be used. Calling connect with another card name will
disconnect the current card and connect to the new card.

HRESULT ConnectByNumber([in] long lCardNumber);

User Manual W51PC DCOM Interface V1.1 Class W51Server • 5