Manual W Sat Email Decoder v2 4 0
Manual W Sat Email Decoder v2 4 0
W-Sat-email-Decoder
V2.4.0
by WAVECOM ELEKTRONIK AG
PUBLISHED BY
WAVECOM ELEKTRONIK AG
Hammerstrasse 8
CH-8180 Buelach
Switzerland
Phone +41-44-872 70 60
Fax +41-44-872 70 66
Email: [email protected]
Internet: http://www.wavecom.ch
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.
Installation 4
Software Uninstall 6
Licensing 7
User Interface 9
Menu bar ..................................................................................................... 9
File Menu.......................................................................................... 9
Edit Menu ....................................................................................... 10
Tools Menu ..................................................................................... 10
Help Menu ...................................................................................... 10
Input File List ............................................................................................. 10
File Viewer ................................................................................................. 12
Decoded File List ........................................................................................ 12
Implemented Decoders 14
Reference 15
Input data format ....................................................................................... 15
INMARSAT-B, INMARSAT-M or INMARSAT-mM .................................... 15
INMARSAT-B-HSD ........................................................................... 15
Metadata output format ............................................................................... 15
Transmission section ........................................................................ 15
Mail section .................................................................................... 15
Attachment section .......................................................................... 16
External Applications 17
Status Messages 18
Cause for “Termination” ................................................................... 18
Mail System .................................................................................... 18
Status ............................................................................................ 19
License Terms 20
Address 21
Glossary of Terms 23
Revisions
Version Date Changes
Follow the instructions as they appear on the installation screens. You can use the Cancel button
throughout the installation process to cancel the process.
Click Next to continue the installation. Use Change to select another installation folder as the installation
folder.
Note: After installation, you can run the application if you are a member of the Administrators, Power Us-
ers or Users group.
VISTA, Windows 7 XP
Click on Start, go to the Control Panel menu Click on Start, go to the Settings menu and
and click Programs and Features open Control Panel
Select WAVECOM W-Sat-email-Decoder Select the Add/Remove Programs icon
from the list
Select Install/Uninstall
Click Uninstall
Choose WAVECOM W-Sat-email-Decoder
from the list
Click Add/Remove
The application has now been removed from the PC - it is however possible, that the icons may have to be
manually removed.
Downloaded files may contain viruses, spyware, Trojan horses and other malicious code, which may
gravely endanger your system. WAVECOM explicitly declines any liabilities for the use of this application,
and strongly advises users to ensure that an updated anti-virus and malware checking application is in-
stalled and enabled. The user may additionally consider physically disconnecting the system on which this
application is installed from a local network. If an alert or warning is received from your anti-virus applica-
tion, follow the instructions given to remove or neutralize the threat.
The W-Sat-email-Decoder takes as its input a session file and the corresponding text files, as produced by
a WAVECOM decoder, or any text file from an external source containing emails. Before beginning decod-
ing, it prescans the file to make sure that the input data is not corrupt. After prescan it does protocol de-
coding and possible decompression, the email(s) and possible attachment(s) are output as files (see the
message flow below).
The output files may themselves be encoded or compressed. In this case external applications must be
used to decode and/or decompress the files. This procedure is shown in the path diagram above in dashed
lines and grayed-out boxes. External processing may have to be repeated until legible output is produced.
The user should be aware that messages may be encoded using methods such as UUEncode, Base64 and
TNEF. Such messages must also be decoded by an external application.
The W-Sat-email-Decoder will decode the main message protocols encountered on satellite and other
communication links. These protocols reside on Layer 2, the data link layer.
8 How the Sat-email-Decoder Works WAVECOM Sat email Decoder W-Sat-email-Decoder V2.4.0
User Interface
The W-Sat-email-Decoder consists of a menu bar a window with three panes,
Input File List
File Viewer
Decoded File List
The Input File List displays a record of information for each of the files(s) loaded using the File Menu.
File View displays a hex and text dump of the file selected in the Input File List.
The Decoded File List contains a list of decoded files.
Menu bar
The main menu bar contains four menus.
File Menu
Click Open file… to load a single file into the Input File List.
Click Open directory… to load a complete directory containing an optional session file produced by a
WAVECOM decoder.
Click Save as … to save one or more files.
Click Exit to exit the W-Sat-email-Decoder. When attempting to close the ED, the user is asked
Click Select All to select all files in the Input File List.
Click Decode to decode all selected files.
Tools Menu
Preferences
Data sources (auto mode) define folders which will be used as a data source for automatic decoding if
Auto Mode is enabled.
Output folder decoded data are placed in this folder.
Clean up output folder on exit. The defined output folder is cleaned up on program exit.
Help Menu
Through the help menu a help file and information on W-Sat-email-Decoder is accessible.
If an input file is selected clicking Save as… in the File Menu opens a file browser, allowing the user to
save the selected files under another name and path.
Right-clicking one or more selected files displays an option Open output folder… Left-clicking this item,
allows the user to open the directory where the decoded and decompressed output files for the selected
input file are saved. In the example below the file described earlier, has been decompressed and its com-
ponents separated into individual files:
- A decoded and decompressed mail message file (Mail_1.txt)
- A decoded and decompressed attachment (4th Quarter CORINTH Stores.zip)
- A text file containing all mail messages (0000001800000018_Pass1.txt)
- A binary file containing the captured, 7z-compressed file without protocol and packet overhead
(headers, CRC etc.) (0000001800000018_Pass1.7z)
- A MetaData.xml file containing various additional information.
WARNING: Depending on your anti-virus application, during decoding of an input file a warning message
like this may be displayed by your anti-virus and malware protection application.
Output files are saved in sub-folders in the selected data folder. The sub-folder names are constructed as
<decoder_serial_number>_<yyyymmdd>_<hhmmss>.
The decoded files are saved in a number of ways depending on the email system:
If the decoded mail system transmits messages and attachments as individual messages, the out-
put files are saved under their original names with a preceding number, e.g. 01_255996071.txt
starting with 01 for the first decoded file
If the decoded mail system transmits messages and attachments consolidated into one file, the
application will attempt to decompress the file and to save the individual messages and attach-
ments under their original file names, otherwise a generic name, Mail_<number>.txt is used
The Input File List is divided into a number of columns,
Termination A description of cause for the termination of the session (see below “Status Messages”,
“Cause for “Termination””).
Mail System The mail system determined for this input file (see below “Status Messages”, “Mail Sys-
tem”).
File Viewer
The File Viewer will display a selected input or output file in a hexadecimal file viewer. The leftmost col-
umn is a hexadecimal byte counter, the center column displays the file in hexadecimal notation, and the
rightmost column displays the file contents in printable ASCII. The viewer does not allow the user to edit
the file.
Clicking Show will display the file in File Viewer and if the file type is unsupported by the decoder an at-
tempt to open the file with a corresponding application will be undertaken.
Clicking Show as text will display the file in text format in File Viewer.
Clicking Show as hexadecimal will display the file in hexadecimal format in File Viewer.
Clicking Open containing folder … will open the file browser in the folder containing the selected file.
Clicking Open with external application … will attempt to open the file with the appropriate external
application.
Clicking Open with an external application… allows the user to apply an external decoder or de-
compressor. When attempting to open a file a warning may be displayed.
If a file shown in the list is not present on the disk, the entry is marked in red color.
AMOS
Dualog
GlobeWireless
GTMail
PPP
Rydex
se@COMM IRIDIUM
SkyFile THURAYA
UUCP
UUPlus IRIDIUM
Xdatos IRIDIUM
ZModem
INMARSAT-B-HSD
Use this for ISDN data (SAT-B-HSD). The format consists of the raw contents of the data frames, without
signaling units.
Transmission section
The “Transmission” part is only written by the GUI. It is omitted when the DLL is used directly.
Mail section
This part contains information about mails.
Subject Subject
From Sender
To Receiver
Cc Cc
Bcc Bcc
Priority Priority
Filename Name of the file saved by the decoder (AMOS and GTMail)
Attachment section
This part contains information about attachments. It always is embedded into a mail section.
Tag name (key) Value
Name Filename
Mail System
The names given are not necessarily the proper system names. Some systems are not decoded in the cur-
rent version of W-Sat-email-Decoder and are marked as such.
Mail systems which are recognized,
Message Description Decoded
AMOS Yes
Blast No
Dualog Yes
GlobeWireless Yes
GTMail Yes
Rydex Yes
se@COMM Partially
SkyFile Yes
UUPlus Yes
Xdatos Partially
Unknown The mail system was not recognized (also shown before decoding is attempted)
Corrupt Data The data structure is corrupted. This could be caused by a transmission error or
an unknown format was encountered.
[Name] not implemented yet. The system can be recognized, but there is no decoder available.
AF-IN
The AF input has a range of 0 – 16.000 Hz. This input should be used when the source is an AF output
(line or speaker) or a 12.0 or 12.5 kHz IF output used in professional digital recorders.
alert
A warning or notice of an error in the form of a message, a sound from the computer's speaker, or both.
AMBE
Advanced Multi-Band Excitation speech coding.
ANSI
An acronym for the American National Standards Institute, an organization that sets standards for a varie-
ty of programming languages and systems.
AOR
Atlantic Ocean Region.
APC
Adaptive Predictive Coding.
ARQ
Automatic repeat request (ARQ) (or automatic repeat-query) is an error-control method for data transmis-
sion which uses acknowledgements and requests to achieve reliable data transmission over an unreliable
service. An acknowledgement is a message sent by the receiver to the transmitter to indicate that it has
correctly received a data frame or packet. A request is a message sent by the receiver to the transmitter
to indicate that the sender has to re-transmit the frame/packet; if the sender does not receive an
acknowledgement before a timeout, it usually re-transmits the frame/packet until it receives an acknowl-
edgement or exceeds a predefined number of re-transmissions.
ASCII
An acronym for American Standard Code for Information Interchange, pronounced "ASK-ee." It is a code
in which the numbers from 0 to 127 stand for letters, numbers, punctuation marks and other characters.
ASCII code is standardized to facilitate transmitting text between computers or between a computer and a
peripheral device.
Baud Rate
The speed in a 2FSK transmission. The duration of a bit is 1/Baud. At 50 Baud a bit is 20ms long.
Broadcast
Public or private radio station transmitting music, news...
Buffer
A temporary holding area in the computer's memory where information can be stored. In editing, it is an
area in memory where cut or copied data is held, sometimes called the clipboard. See also: clipboard and
type-ahead buffer.
Clipboard
The holding place for what you last cut or copied; a buffer area in memory. Information contained on the
clipboard can be inserted (pasted) into other documents and other WINDOWS applications.
Context sensitive
Able to perceive the situation in which an event occurs. For example, context sensitive help presents in-
formation specific to the particular task you are performing, rather than presenting just a general list of
commands.
Control key
A specific key, usually abbreviated as "Ctrl", that produces control characters when used in combination
with character keys.
CRC
A cyclic redundancy check (CRC) is an error-detecting code designed to detect accidental changes to raw
data, and is commonly used in digital data transfer and storage. A CRC-enabled protocol calculates a
short, fixed-length binary sequence, known as the check value or improperly the CRC, for each block of
data to be sent or stored and appends it to the data, forming a codeword. When a codeword is received or
read, the device either compares its check value with one freshly calculated from the data block, or equiv-
alently, performs a CRC on the whole codeword and compares the resulting check value with an expected
residue constant. If the check values do not match, then the block contains a data error and the device
may take corrective action such as requesting the block be sent again, otherwise the data is assumed to
be error-free (though, with some small probability, it may contain undetected errors; this is the funda-
mental nature of error-checking).
CRCs are so called because the check (data verification) code is a redundancy (it adds zero information to
the message) and the algorithm is based on cyclic codes. CRCs are popular because they are simple to
implement in binary hardware, are easy to analyze mathematically, and are particularly good at detecting
common errors caused by noise in transmission channels. As the check value has a fixed length, the func-
tion that generates it is occasionally used as a hash function.
Default button
The push button with a bold border in dialogues. The default button often has a dotted-line border around
the button name. The default button is chosen when you press "Enter" (or Ctrl+Enter depending on your
configuration).
DIS
The DIS input (Discriminator) has a range of 0 – 20 kHz. This input is supported by a few VHF-UHF re-
ceivers and facilitates the reception of ”Direct FSK” signals like POCSAG or PACKET-9600. The advantage
of this input is the easy handling. Only the gain has to be adjusted. There is no need for an adjustment of
the center or the translation frequency. DIS is only released for ”Direct FSK” modes.
Disable
To make an item unavailable for use. Disabled items reflect the WINDOWS color settings for disabled
commands, and generally appear dimmed and cannot be chosen.
EOD
End-Of-Data.
Error message
A message displayed to tell the user about an error or problem in the execution of a program or in the us-
er's communication with the system. An error message is often accompanied by a beep.
EXT-DEM-IN
The EXT-DEM-IN input must be used if an external demodulator is to be connected. The minimum input
level is TTL level (LO = 0 V, HI = +5 V) and the maximum is RS-232C level (LO = -12 V, HI = +12 V).
Note that utilizing this facility will disable certain W51PC functions. Thus this input should be employed for
special purposes only.
FDX
Full duplex.
FEC
Forward error correction (FEC) is error control methode for data transmission, whereby the sender adds
redundant data to its messages, also known as an error-correction code. This allows the receiver to detect
and correct errors (within some bound) without the need to ask the sender for additional data. The ad-
vantages of forward error correction are that a back-channel is not required and retransmission of data
can often be avoided (at the cost of higher bandwidth requirements, on average). FEC is therefore applied
in situations where retransmissions are impossible (traffic lists, broadcasts).
FFSK
Fast Frequency Shift Keying.
FFT
Fast Fourier Transform.
File type
The categories of files specified by file extensions: APP, DBF, PRG, CDX, FRX, and so on.
GUI
Graphical User Interface.
HDX
Half duplex.
Hot key
An underlined letter in a menu or dialogue that you can type to immediately choose an item.
IF-IN-10.7
The IF-IN-10.7 input has a range of 10.685–10.715 MHz (or 21.385 – 21.415 MHz). This IF is common for
VHF-UHF receivers.
IF-IN-21.4
The IF-IN-21.4 input has a range of 21.385–21.415 MHz. This IF is common for VHF-UHF receivers.
IF-IN-VAR
The IF-IN-VAR has a range of 14 kHz–1.5 MHz. Most receiver IF’s are within this range.
IMBE
Improved Multi-Band Excitation speech coding.
Insert mode
The default text-editing mode in which any character you type is inserted at the cursor position and the
text to the right of the cursor is shifted to the right.
IOR
Indian Ocean Region.
IQ
In-phase Quadrature. Used to denote the complex format on which the RF data is processed and stored.
The IQ demodulation is also sometimes named Base-band demodulation, Quadrature demodulation, Com-
plex demodulation etc.
Keyboard shortcuts
The keystroke combinations that you can use to choose menu options instead of using the mouse.
LAN
Local Area Network.
LNA
Low Noise Amplifier.
Loop
A section of a program that executes repeatedly until a limit or condition is met, such as a variable reach-
ing a specified ending value.
Mark
Application Condition Condition
MATLAB
MATLAB® is a high-performance language for technical computing. It integrates computation, visualiza-
tion, and programming in an easy-to-use environment where problems and solutions are expressed in fa-
miliar mathematical notation. This collection includes the following topics.
Menu bar
A horizontal strip that appears at the top of the screen and contains menu pads.
Menu name
A word, phrase or icon on the menu bar that designates one menu. Selecting the menu pad highlights the
name and causes the menu options to appear.
Menu options
Commands, found on menus, that perform specific actions. When you choose a menu option, you are tell-
ing the program what action to take.
Menu pads
The menu names found on the menu bar.
Menu system
The combination of the menu bar, menu pads, menus and menu options.
MES
Mobile Earth Station.
Minimize
The act of causing a window to become an icon that includes the title of the window.
Modal
Describes the state of a window or dialogue when it does not allow another window or dialogue to be
brought in front of it until that window or dialogue is dismissed, e.g., the Expression Builder dialogue.
MPDS
Mobile Packet Data System.
NA
Not Available.
NCSC
Network Control Station Channel.
Network
A collection of interconnected, individually controlled computers, together with the hardware and software
used to connect them. A network allows users to share data and peripheral devices (such as printers and
storage media), to exchange electronic mail, etc.
Non-modal
A window or dialogue that allows another window or dialogue in front of it while it is open, for example,
the Command window.
On-line help
A reference guide, accessible while using the software, that provides additional information about com-
mands, functions, and the interface.
Option
Different additional options are available from WAVECOM.
In the manual, options are marked with (Option).
OSI-Layer
OSI (Open Systems Interconnection) is a standard description or "reference model" for how messages
should be transmitted between any two points in a telecommunication network.
Paste
To place the contents of the clipboard at the insertion point.
PB
Passband.
PC
Personal Computer.
Pointer
A small solid box or arrow on the screen that follows the movement of the mouse and shows where your
next action will take place.
POR
Pacific Ocean Region.
PSTN
Public Switched Telephone Network.
RHCP
Right Hand Circular Polarization.
Right-clicking
Clicking with the pointing devices right button.
Scroll
To move through the contents of a window or so that a different part becomes visible.
Scroll bars
The controls that are used to view text that extends beyond the edge of a window. A window can have
vertical and/or horizontal scroll bars.
SELCAL
Selective call systems are an efficient supplement to voice traffic. One method was the so-called single-
tone-mode using five different tone frequencies, another one the two-tone-modes, where the call number
is transmitted as frequency combinations.
Developments led to the five-tone-sequence systems. The five digits are often divided into two groups.
The first digits work as radio net flags, the last three digits are user call numbers.
Server
See file server.
Shift
The difference between two tones in a FSK transmission.
Size control
A screen element found on WINDOWS that allows you to change the window size.
SNAC
Single Network Access Code.
SNR
Signal-to-Noise.
Space
Application Condition Condition
Spinner
A control that allows you to increment or decrement numbers either by typing the numbers or clicking the
UP and DOWN arrow keys.
String
An item of information consisting of a sequence of text characters.
SW
Software.
TDMA
Time Division Multiple Access.
Text editor
The part of the software that allows you to modify text files.
Text file
A file which contains information expressed in text form and whose contents are interpreted as characters
encoded using the ASCII format.
Thumb
A gray box in the scroll bar that indicates the relative position in the text. If you want to move through the
text rapidly you can drag the thumb up and down.
Unicode Font
The Unicode standard is intended to provide a 'unique, universal, and uniform' encoding for each character
in all living languages (plus a few dead ones). One font (WAVECOM Unicode) is automatically installed on
your computer. Other Unicode fonts with are available on the market.
unlock
To remove the restriction on the use of a disk or a file so that it can be changed, deleted or renamed. See
also: lock.
Utility
Transmission in RTTY or FAX.
W-[XX]
Stands for a WAVECOM product code like W-PCI, W-PCIe, W-CODE, W61PC or W-51PC.
Wildcard
A character that may be used to represent a sequence of characters in a path name. A common wildcard
character is the asterisk (*). As an example, if you request a listing of *.TXT files in a particular applica-
tion, you would see a list of all files ending with the extension TXT.
WINDOWS
Microsoft WINDOWS™ Operating System.
Index R
Recommended WAVECOM Products and Services
3
A Reference 15
Revisions 2
Address 21
Attachment section 16
S
C Software Uninstall 6
Status 19
Cause for "Termination" 18
Status Messages 18
D
T
Decoded File List 12
Tools Menu 10
Transmission section 15
E
Edit Menu 10 U
External Applications 17
User Interface 9
F
W
File Menu 9
W-BV BitView Tool 3
File Viewer 12
Welcome 2
G
General Information 2
Glossary of Terms 23
H
Help Menu 10
How the Sat-email-Decoder Works 8
I
Implemented Decoders 14
INMARSAT-B, INMARSAT-M or INMARSAT-mM 15
INMARSAT-B-HSD 15
Input data format 15
Input File List 10
Installation 4
L
License Terms 20
Licensing 7
M
Mail section 15
Mail System 18
Menu bar 9
Metadata output format 15