WAVECOM EasySatSystem Software W61 v1.1 User Manual by WAVECOM ELEKTRONIK AG PUBLISHED BY WAVECOM ELEKTRONIK AG Hammerstrasse 8 CH-8180 Buelach Switzerland Phone Fax Email: Internet: +41-44-872 70 60 +41-44-872 70 66 info@wavecom.ch 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 trademarks of their owners. Specifications are subject to change without further notice Printed: Wednesday, March 26, 2008, 17:04:46 Contents Welcome 1 Introduction ............................................................................................. 1 Professional Version ................................................................................... 1 Training ................................................................................................... 1 Source Code ............................................................................................. 1 Company Profile ........................................................................................ 1 Revisions ................................................................................................. 2 References ............................................................................................... 2 Software 2 Installation ............................................................................................... 2 Setup ...................................................................................................... 3 Operation ................................................................................................. 6 Error Handling .......................................................................................... 7 Source ..................................................................................................... 7 Hardware Recommendations 7 Overview ................................................................................................. 7 General Description of the components ......................................................... 7 Antenna ........................................................................................ 7 Downconverter ............................................................................... 8 PC with W61PC(s) ........................................................................... 8 Proven Components ................................................................................... 8 Antenna ........................................................................................ 8 Downconverter ............................................................................... 8 PC ................................................................................................ 8 Glossary of Terms Index 9 29 WAVECOM EasySatSystem Software W61 v1.1 User Manual Contents v Welcome Congratulations on your purchase of a WAVECOM decoder. The product that you bought incorporates the latest technology in data decoding together 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 ELEKTRONIK AG, the field of activity of the company, and how you may benefit from the expertise of WAVECOM ELEKTRONIK AG. This document describes the 'EasySatSystem' software of WAVECOM ELEKTRONIK AG; this product is sometimes also called 'SAT-Coordination'. Introduction 'EasySatSystem' controls the satellite-modes running on a system of up to 10 W61PC cards such to prevent that more than one W61PC card monitors the same satellite communications session, identified by a specific satellite-mode (INMARSAT-B, INMARSAT-M, and INMARSAT-mini-M), a service (data, fax, ISDN, etc.), and mobile earth station identification number (termed MES Id in the following). The monitoring system configuration is specified in a text file using a very simple syntax. For logging purposes, statistical data concerning the monitored sessions can be collected. 'EasySatSystem' has 3 kinds of user interfaces: the operational status display of the coordinated cards, i.e., the `EasySatSystem' graphical user interface (GUI); the configuration interface, i.e., the text file EasySATSystem.ini, stored in some predefined directory; the MS-DOS command line with parameters. 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. Training 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 Source code is available for professional users. To obtain the Source Code please contact WAVECOM, at www.wavecom.ch. Company Profile WAVECOM EasySatSystem Software W61 v1.1 User Manual Welcome 1 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. The company has focused on decoding and analysis systems for wireless data transmissions. The wide product range spans from professional, 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 authorized sales partners ensures that local assistance and basic level support can be provided in most places. More than 95% of all units sold are exported. 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 with 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 completely owned by its general manager, Mr. Christian Kesselring. Revisions Version 0.1 0.2 Date 16-01-2006 26-01-2006 Author Hgr Hgr Changes Initial draft Corrections after comments from RH Install, Setup, Error handling, Source chapters added; .Ini file description adapted to new format; Corrections after review MO, RH Addition of Command Line parameter /A: Reviewed version, Glossary added optional argument /L changed New directories for config and data, under : documents and settings\All users\documents\ wavecom \easysat\config and ...\data 1.0 1.001 1.002 1.003 1.1.000 13-02-2006 29-03-2006 25-10-2006 03-11-2006 10-03-2008 Hgr Hgr Hgr Hgr Hgr References [1] WAVECOM ELEKTRONIK AG, EasySatSystem Specification, V 0.2 Software Installation During the installation of the product `EasySatSystem' by means of the provided setup program, the directory into which the software shall be installed is specified. Hereafter, this directory is denoted as . The following files can be found in : EasySatSystem.exe (the main and only executable) XMLRCICPP.dll (a required DLL) EasySATSystemUserManual.pdf (this document) 2 Software WAVECOM EasySatSystem Software W61 v1.1 User Manual FileHandler.exe (a program solely needed during the installation of `EasySatSystem') WAVECOM_Decoder.chm, the Helpfile Administrator privileges are required to modify the contents of the directory The Config file is stored in the directory (referred to as ): C:\Documents and Settings\All Users\Documents\WAVECOM \EasySat System\Config. This directory contains the files: EasySatSystem.ini Template-EasySatSystem.ini. By default, after start of EasySATSystem.exe, the program looks in this directory for the required configuration file EasySATSystem.ini. However, a different directory can be specified by setting the environment variable EASYSATSYSTEM_CONFIG_DIR accordingly. The collected data will be stored in the directory (referred to as ): C:\Documents and Settings\All Users\Documents\WAVECOM \EasySatSystem\Data. By default, the directory will be used to store statistical data files (if logging has been enabled; see below). Again, a different directory can be specified by setting the environment variable EASYSATSYSTEM_DATA_DIR accordingly. User privileges are sufficient to modify (i.e., also delete) the subdirectories \Config and \Data as well as their respective contents. In order to have `EasySatSystem' working properly, the 'XML Remote Control Interface' port has to be opened on each personal computer (PC) hosting W61PC cards to be coordinated. This is done as follows: 1. Open 'Control Panel'; 2. Open 'Windows Firewall'; 3. If the 'On' button is set, then clear the 'Don't allow exceptions' checkbox; 4. Select the 'Exceptions' tab; 5. Click on 'Add Port...' and give a name and set the port number to the default value of 33234, or to the value you have specified in the tab `Networking Information' of the W61PC WavecomServerControl GUI; 6. For test purposes, it might also be necessary to open the port for the GUI of W61PC (default value of 33233). Furthermore, on each PC hosting W61PC cards to be coordinated, the respective WavecomService must be running and allow remote connections. In order to allow remote connections to a WavecomService, check the box `Allow Remote Connections' in the tab `Networking Information' of the respective W61PC WavecomServerControl GUI. Setup 'EasySatSystem' can run on any PC under the Microsoft Windows XP or Vista operating system. If cards on more than one PC must be coordinated, then the PCs must be connected via a network. 'EasySatSystem' must be told somehow which PCs with which W61PC cards it must coordinate. This is done with the configuration file EasySATSystem.ini, which, by default, needs to be located in the directory . An alternative location can be specified by means of the environment variable EASYSATSYSTEM_CONFIG_DIR. In the EasySATSystem.ini file, one can also specify the sessions to exclusively be watched by listing the respective MES Ids; if no MES Id is specified, then all sessions will be watched. It is also possible to specify the duration (in seconds) of the automatic level setting (ALS) performed at mode start-up. Only the first valid value specified will be used, if several are given in EasySATSystem.ini. If desired, `EasySatSystem' collects statistical data concerning the monitored sessions. In such a case, when exiting `EasySatSystem', a respective text file is stored in the directory or in the directory specified by the environment variable EASYSATSYSTEM_DATA_DIR if it is set. The name of such a file is `Stat.txt', where denotes the date and time (including seconds) of the log-file creation, which occurs at the end of a monitoring session with `EasySatSystem'. Be aware that such a file may become quite large. To enable statistical logging, a sampling interval (in seconds) greater than 0 has to be specified in EasySATSystem.ini. Only the first valid value specified will be used, if several are given in EasySATSystem.ini. The name of the configuration file must be 'EasySATSystem.ini' (case-insensitive). WAVECOM EasySatSystem Software W61 v1.1 User Manual Software 3 Below, the syntax of the configuration file is specified, for which the following rules apply: Whitespace (blanks, tabs) can be expanded to any length; EOL means end-of-line; * means repetition 0 or more times; Single superscript (e.g., xyz10) means repetition exactly the given number of times; Range superscript (e.g., xyz1-9) means repetition with minimum and maximum bounds; Bold words must appear exactly as shown; | means alternative; Terms in <...> are expanded;

...