TSReader XML Export Information

Updated September 15, 2003

Introduction

The -x option (or clicking the Export to XML button) tells TSReader to generate an XML file with data decoded from the stream. This XML file can then be parsed by external applications. Data exported from TSReader is all in the MPEG-TABLES section.

TSREADER Section

This section tells you about the version and edition of TSReader that generated the XML file.

VERSION The major, minor and edit version of TSReader
EDITION The edition of TSReader: Twinhan, Linear Systems, or File Mode

Sample:

<TSREADER>
 <VERSION>1.0.9</VERSION>
 <EDITION>Twinhan</EDITION>
</TSREADER>

TUNED-MULTIPLEX Section

This section contains the command-line parameters used to setup the tuner on the Twinhan card. This section is only written by the Twinhan version of TSReader.

TONE-ENABLED Reflects the 22KHz option on the command line
DISEQC-INPUT Reflects the DiSEqC option on the command line
LNB-FREQUENCY Reflects the LNB frequency option on the command line
FREQUENCY Reflects the frequency option on the command line
SYMBOL-RATE Reflects the symbol rate option on the command line
POLARITY Reflects the polarity option on the command line

Sample:

<TUNED-MULTIPLEX>
 <TONE-ENABLED>0</TONE-ENABLED>
 <DISEQC-INPUT>0</DISEQC-INPUT>
 <LNB-FREQUENCY>11250</LNB-FREQUENCY>
 <FREQUENCY>12282</FREQUENCY>
 <SYMBOL-RATE>20000</SYMBOL-RATE>
 <POLARITY>0</POLARITY>
</TUNED-MULTIPLEX>

PAT Section

This section parameters dealing with the Program Association Table carried on the mux. If this section is missing, most likely you've pointed TSReader at a mux that contains data.

VERSION The version of the PAT carried on the mux.
TRANSPORT-STREAM-ID The ID of the transport stream for this mux.
SERVICE-NUMBERS The numbers of the programs carried in the mux. Detailed of each service are carried in the PMT section

Sample:

<PAT>
 <VERSION>1</VERSION>
 <TRANSPORT-STREAM-ID>5</TRANSPORT-STREAM-ID>
 <SERVICE-NUMBERS>150,152,157,159,161,382,384,412,415,418,491,702,707,709,723,725</SERVICE-NUMBERS>
</PAT>

CAT Section

This contains parameters dealing with the Conditional Access Table carried on the mux:

CAT-ENTRY Since the CAT can carry multiple entries, there is a CAT-ENTRY section for each table sent
INDEX The index of this CAT-ENTRY
NAME The decoded name of the CA system

Sample:

<CAT>
 <CAT-ENTRY>
  <INDEX>1</INDEX>
  <NAME>Nagra (Echostar version)</NAME>
 </CAT-ENTRY>
 <CAT-ENTRY>
  <INDEX>2</INDEX>
  <NAME>Nagra</NAME>
 </CAT-ENTRY>
</CAT>

NIT Section

This section lists the multiplexes that make up a network.

NIT-ENTRY
One NIT-ENTRY section for each transponder
INDEX The index of this NIT-ENTRY
NETWORK-ID The ID number of the network
TRANSPORT-STREAM-ID The ID of the transport stream
ORIGINAL-NETWORK-ID The ID of the original network carried in the NIT
FREQUENCY The downlink frequency of the signal in MHz.
ORBITAL-POSITION The orbital position where the mux can be found
POLARITY The polarity of the mux
MODULATION The modulation scheme used. TSReader currently decodes QPSK and 8PSK modes.
SYMBOL-RATE The symbol rate of the mux in K-symbols per second
CODE-RATE The inner-coding rate of the mux
THIS-NETWORK-INDICATOR Set to 1 if the network entry is part of the current network.
NETWORK-NAME The name of the network defined in the NIT.

Sample:

<NIT>
 <NIT-ENTRY>
  <INDEX>1</INDEX>
  <NETWORK-ID>256</NETWORK-ID>
  <TRANSPORT-STREAM-ID>31</TRANSPORT-STREAM-ID>
  <ORIGINAL-NETWORK-ID>256</ORIGINAL-NETWORK-ID>
  <FREQUENCY>12661.40</FREQUENCY>
  <ORBITAL-POSITION>91.0 E</ORBITAL-POSITION>
  <POLARITY>RHCP</POLARITY>
  <MODULATION>Not defined</MODULATION>
  <SYMBOL-RATE>20000</SYMBOL-RATE>
  <CODE-RATE>7/8</CODE-RATE>
  <THIS-NETWORK-INDICATOR>1</THIS-NETWORK-INDICATOR>
  <NETWORK-NAME>Bell ExpressVu 91 W</NETWORK-NAME>
 </NIT-ENTRY>
<NIT>

PMTs/ELEMENTARY-STREAM Section

This section (and the CHANNEL sub-sections) are written for each program defined in the PAT.

CHANNEL One CHANNEL section exists for each channel/service defined by the PAT
SERVICE-NUMBER The service/program number of this service
PMT-PID The PID carrying the PMT for this program
PCR-PID The PID carrying the PCR for the video/audio sync
SHORT-NAME The short name of the progam defined in the SDT
LONG-NAME The long name of the program defined in the SDT

One or more ELEMENTARY-STREAM sections exists for each CHANNEL section. Elementary streams usually the video and audio streams that make up a channel.

INDEX The index of this ELEMENTARY-STREAM
SCRAMBLED Set to 1 if the PID carrying this elementary stream is scrambled by a conditional access system
STREAM-TYPE Type of the elementary stream - VIDEO, AUDIO, TELETEXT or a number are valid values. If a number, this is the type field from the PMT.
AUDIO-LANGUAGE If an audio stream this field may convey the lanuage of the audio track
AC3-AUDIO If an audio stream is using Dolby Digital (AC3) audio encoding, this value is set to 1
PID The number of the PID carrying this elementary stream

Sample:

<PMTs>
 <CHANNEL>
  <SERVICE-NUMBER>150</SERVICE-NUMBER>
  <PMT-PID>32</PMT-PID>
  <PCR-PID>5666</PCR-PID>
  <SHORT-NAME>VuFr</SHORT-NAME>
  <LONG-NAME>VuFr</LONG-NAME>
  <ELEMENTARY-STREAM>
   <INDEX>1</INDEX>
   <SCRAMBLED>1</SCRAMBLED>
   <STREAM-TYPE>VIDEO</STREAM-TYPE>
   <PID>5666</PID>
  </ELEMENTARY-STREAM>
  <ELEMENTARY-STREAM>
   <INDEX>2</INDEX>
   <SCRAMBLED>1</SCRAMBLED>
   <STREAM-TYPE>AUDIO</STREAM-TYPE>
   <AUDIO-LANGUAGE>eng</AUDIO-LANGUAGE>
   <AC3-AUDIO>0</AC3-AUDIO>
   <PID>5669</PID>
  </ELEMENTARY-STREAM>
 </CHANNEL>
</PMTs>

EIT/EVENT/DESCRIPTOR Sections

These section contains program guide data decoded from the stream. TSReader can decode standard DVB EIT tables and the special compressed version used by Echostar on the Dish Network DBS system.

CHANNEL One CHANNEL section exists for each channel/service carried in the EIT
SERVICE-NUMBER The service (or channel number) of this channel
SHORT-NAME Short name of the channel - "CNN" for example
LONG-NAME Log name of the channel - "Cable News Network" for example
TRANSPORT-STREAM-ID The number of the transport stream that carries this channel/service

One or more EVENT sections exists for each channel. One EVENT indicates one programme that is/will be carried on this service/channel.

START-UTC-DATE The starting date in UTC (also know as GMT or Greenwich Mean Time) of the event. The format used is YYYY-MM-DD
START-UTC-TIME The starting time in UTC. Format is HH:MM:SS
DURATION The length of the event in HH:MM:SS format
NAME The name of the event
DESCRIPTION Description of the event

Each EVENT may also contain one or more DESCRIPTOR section if these are carried in the EIT. These descriptors are used to convey additional information to the receiver - for example the program rating. Complete documentation is in the ETSI document EN 300 468. Unlike all other sections in TSReader generated XML files, the data in the DESCRIPTOR sections is in ASCII-HEX.

TAG The HEX-ASCII tag number for this descriptor. Tag 54 for example is defined in EN 300 468 as "content_descriptor"
DATA The HEX-ASCII data for this descriptor. For example F1 FF means "user private"

Sample:

<CHANNEL>
 <SERVICE-NUMBER>161</SERVICE-NUMBER>
 <SHORT-NAME>VuF11</SHORT-NAME>
 <LONG-NAME>VuF11</LONG-NAME>
 <TRANSPORT-STREAM-ID>5</TRANSPORT-STREAM-ID>
 <EVENT>
  <START-UTC-DATE>2003-09-15</START-UTC-DATE>
  <START-UTC-TIME>20:00:00</START-UTC-TIME>
  <DURATION>02:30:00</DURATION>
  <NAME>Arrête-moi si tu peux</NAME>
  <DESCRIPTION>Leonardo DiCaprio et Tom Hanks. (2002) Inspiré de l'histoire vécue d'un jeune fraudeur qui se fait passer pour un pilote d'avion, un médecin et un avocat. Réal. par Spielberg.(26642) (Stereo)</DESCRIPTION>
  <DESCRIPTOR>
   <TAG>54</TAG>
   <DATA>f1 ff</DATA>
  </DESCRIPTOR>
 </EVENT>
 <EVENT>
  <START-UTC-DATE>2003-09-15</START-UTC-DATE>
  <START-UTC-TIME>22:30:00</START-UTC-TIME>
  <DURATION>02:30:00</DURATION>
  <NAME>Arrête-moi si tu peux</NAME>
  <DESCRIPTION>Leonardo DiCaprio et Tom Hanks. (2002) Inspiré de l'histoire vécue d'un jeune fraudeur qui se fait passer pour un pilote d'avion, un médecin et un avocat. Réal. par Spielberg.(26643) (Stereo)</DESCRIPTION>
  <DESCRIPTOR>
   <TAG>54</TAG>
   <DATA>f1 ff</DATA>
  </DESCRIPTOR>
 </EVENT>
</CHANNEL>