Wavecom PXGF streaming format User Manual

Interface Requirement Specification for PXGF Streaming and File Format

The content of this document is restricted and intended for reading only by the addressee. All rights including Intellectual Property Rights flowing from, incidental to or contained in this document irrevocably vest in Grintek Ewation (Pty) Ltd (GEW) unless otherwise agreed to in writing.

Produ cts

2009-01-13 RESTRICTED Page i Issue 1.24

GSY-0D8-SE RESTRICTED Interface Requirement Specification for PXGF Streaming and File Format

TABLE OF CONTENTS

1 SCOPE................................................................................................................................................6

1.1 IDENTIFICATION......................................................................................................................6

1.2 OVERVIEW...............................................................................................................................6

1.3 DOCUMENT OVERVIEW.........................................................................................................6

2 REFERENCED DOCUMENTS............................................................................................................7

3 PXGF DESCRIPTION.........................................................................................................................8

3.1 BACKGROUND........................................................................................................................8

3.2 THE PXGF CHUNK STRUCTURE...........................................................................................8

3.3 APPLICATION NOTES.............................................................................................................9

3.4 DEFINITION OF CHUNKS......................................................................................................10

3.4.1 Single channel Short IQ time data – SSIQ chunk......................................................10

3.4.2 Single channel IQ Packing – SIQP chunk..................................................................10

3.4.3 Sample Rate – SR__ chunk.......................................................................................11

3.4.4 BandWidth – BW__ chunk.........................................................................................11

3.4.5 BandWidth Offset Frequency – BWOF chunk............................................................11

3.4.6 Centre Frequency – CF__ chunk...............................................................................11

3.4.7 dB Full Scale – dBFS chunk......................................................................................11

3.4.8 dBTotal Gain – dBTG chunk......................................................................................12

3.4.9 IQ DisContinuity – IQDC chunk.................................................................................12

3.4.10 Single channel Short Real data - SSR_ chunk.........................................................12

3.4.11 Group Short IQ time data – GSIQ chunk..................................................................12

3.4.12 Group IQ Packing - GIQP chunk.............................................................................13

3.4.13 Group Channel BandWidth – GCBW chunk.............................................................14

3.4.14 Group Centre Frequencies – GCF_ chunk...............................................................14

3.4.15 Start Of File Header – SOFH chunk.........................................................................14

3.4.16 End Of File Header – EOFH chunk..........................................................................14

3.4.17 TEXT string – TEXT chunk......................................................................................14

3.5 PROPOSED EXTENSIONS....................................................................................................15

3.5.1 UTF-8 string – UTF8 chunk........................................................................................15

3.5.2 IF frequency – IF__ chunk........................................................................................15

3.5.3 Proposed text chunks.................................................................................................15

3.5.4 Direction data chunk..................................................................................................15

3.6 DEPRECATED CHUNK TYPES.............................................................................................15

3.6.1 Start Of Header – SOF_ chunk. Use SOFH chunk instead........................................15

3.6.2 End Of Header – EOH_ chunk. Use EOFH instead...................................................16

3.7 SYNCHRONISATION.............................................................................................................16

4 ABBREVIATIONS..............................................................................................................................17

Produ cts

2009-01-13 RESTRICTED Page 1 Issue 1.24

GSY-0D8-SE RESTRICTED Interface Requirement Specification for PXGF Streaming and File Format

LIST OF TABLES

TABLE 3.1: STRUCTURE OF PXGF CHUNKS.....................................................................................8

TABLE 3.2: THE SSIQ CHUNK............................................................................................................10

TABLE 3.3: THE SIQP CHUNK............................................................................................................10

TABLE 3.4: THE SR__ CHUNK............................................................................................................11

TABLE 3.5: THE BW__ CHUNK...........................................................................................................11

TABLE 3.6: THE BWOF CHUNK..........................................................................................................11

TABLE 3.7: THE CF__ CHUNK............................................................................................................11

TABLE 3.8: THE DBFS CHUNK...........................................................................................................11

TABLE 3.9: THE DBFS CHUNK...........................................................................................................12

TABLE 3.10: THE IQDC CHUNK..........................................................................................................12

TABLE 3.11: THE SSR_ CHUNK.........................................................................................................12

TABLE 3.12: THE GIQP CHUNK..........................................................................................................13

TABLE 3.13: THE GIQP CHUNK..........................................................................................................13

TABLE 3.14: THE GCBW CHUNK.......................................................................................................14

TABLE 3.15: THE GCF_ CHUNK.........................................................................................................14

TABLE 3.16: THE SOFH CHUNK.........................................................................................................14

TABLE 3.17: THE EOFH CHUNK.........................................................................................................14

TABLE 3.18: THE TEXT CHUNK.........................................................................................................15

TABLE 3.19: PROPOSED UTF8 CHUNK............................................................................................15

TABLE 3.20: PROPOSED IF__ CHUNK..............................................................................................15

TABLE 3.21: DEPRECATED SOF_ CHUNK........................................................................................16

TABLE 3.22: DEPRECATED EOH_ CHUNK.......................................................................................16

Produ cts

2009-01-13 RESTRICTED Page 2 Issue 1.24

GSY-0D8-SE RESTRICTED Interface Requirement Specification for PXGF Streaming and File Format

LIST OF FIGURES

FIGURE 1: EXAMPLE CHUNK USAGE IN A PXGF STREAM..............................................................9

Produ cts

2009-01-13 RESTRICTED Page 3 Issue 1.24

GSY-0D8-SE RESTRICTED Interface Requirement Specification for PXGF Streaming and File Format

AMENDMENT RECORD

ISSUE DESCRIPTION DATE NAME

0.01 Initial version 2005-02-11 Robert Crida

0.02 Update after first value management meeting with Trevor, Adrian, Michael and Francois

2005-02-18 Robert Crida

0.03 Added chunk types after discussion with Trevor, Michael, Francois and Richard - channels of int16 IQ

2005-02-18 Robert Crida

0.04 Refined chunk types to support single and multichannel and added type names

2005-02-24 Robert Crida,

Michael McGrath

0.05 Revised all bandwidths to micro Hz using int64 2005-02-25 Robert Crida, Michael McGrath

0.06 Added Group Descriptor chunks 2005-03-01 Michael McGrath

0.07 Changed Names of some chunks, changed some types to allow Java compliance

2005-03-02 Michael McGrath

0.08 Changed Names of some chunks, changed definition and name of GIQP chunk

2005-03-03 Robert Crida,

Michael McGrath

0.09 Added chunk for bandwidths with frequency offsets. BWOF chunk

2005-03-16 Michael McGrath

0.10 Added "TEXT" chunk, moved "UTF8" and "IF__" chunks to the proposed chunk section.

2005-03-22 Michael McGrath

0.11 Added Purpose of Document header 2005-04-09 Richard Sharrock

0.12 Clarification of Timestamping, and added Use Of Format section

2005-06-21 Richard Sharrock

0.13 SOH_ chunk renamed to SOFH and EOH_ chunk renamed to EOFH to match software library.

2005-06-22 Michael McGrath

0.14 The Type of each header is stored as an int32 rather than a char[4] array, this change affects how the endian swapping is performed.

2005-06-22 Michael McGrath

0.15 SOH_ and EOH_ chunks deprecated, use SOHF and EOHF instead.

2005-06-22 Michael McGrath

0.16 Reformatted document into report format. 2005-10-10 Michael McGrath

0.17 Added chunk usage illustration. 2005-10-10 Richard Sharrock

0.18 Minor formatting changes 2005-10-14 Michael McGrath

0.19 Added real data chunk 2005-10-20 Michael McGrath,

Richard Sharrock

0.20 Modified real data chunk 2005-10-20 Michael McGrath

0.21 Clarification of the dBFS value. 2005-12-07 Mark Cammidge

0.22 Changed title and doc number as per GEW request 2007-07-13 David Durrett

1.23 Changed the document number again to a more generic value. Changed the document file name. Changed the document issue number to be based at 1 and not 0.

2007-07-27 Trevor Bartleet

1.24 Updated table of contents and list of tables 2009-01-13 Philip Bliss

SOURCE DOCUMENT

Produ cts

2009-01-13 RESTRICTED Page 4 Issue 1.24

GSY-0D8-SE RESTRICTED Interface Requirement Specification for PXGF Streaming and File Format

ISSUE FILE NAME

0.00 FileFormat_SPEQ.html

0.16 PXGF-Streaming Format.odt

1.23 svn://iserver.ct/raid/SVN/repos/EWDev/trunk/com/peralex/Framework/pxgf/documents/ design/GSY-0D8-SE_IRS-PXGF-Streaming-Format.odt

1.24 svn://iserver.ct/raid/SVN/repos/EWDev/trunk/com/peralex/Framework/pxgf/documents/ design/GSY-0D8-SE_IRS-PXGF-Streaming-Format.odt SVN 36470

Produ cts

2009-01-13 RESTRICTED Page 5 Issue 1.24

+ 12 hidden pages

Wavecom PXGF streaming format User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

SOURCE DOCUMENT