TRACKSELECT TSN TN

Description:

  Select the audio track to be decoded and output.  The 'track' is defined as the first, 
  second, etc audio track as found in the transport PGM pid (transport streams), or as the 
  n'th audio stream found in a program stream.  If TSN is set to 0, then the system will use 
  the AUI or IAT settings to determine which track to decode.  If none of these options are 
  set, then the system will decode the 'first' audio stream that is found.  If the TRACKSELECT 
  option has been set to a non-default value, it will override the AUI setting and the IAT 
  setting.<p>

Form:

  Command Handler: DCMD
  TRACKSELECT|TSN|TN [VALUE]
  Value List:
  Terse    Verbose      Description
      0       none      TRACKSELECT is inactive
      1       none      First defined audio stream is played
    ... 
      n       none      Nth defined audio stream is played

Response:

  MODIFY TRACKSELECT RESPONSE
    Verbose- "OK\r\n" to acknowledge receipt of command, or
             "ERROR- [Description]\r\n" if error, ending command
    Terse-   "0\r\n" to acknowledge receipt of command, or
             "[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
    "\r\n" concludes modify responses (empty line)
  DISPLAY TRACKSELECT RESPONSE
    Verbose- "OK\r\n" to acknowledge receipt of command, followed by the list of audio
              tracks and the seleted track of the form:
             "[TRACK#]- CODEC= [CODEC NAME], PID= [PIDVALUE], SID= [SIDVALUE],
                 SSID= [SSIDVALUE], BitRate= [BITRATE], SamplingFreq= [SAMPLINGFREQ],
                 LangCode= [LANGCODE NAME]\r\n" 
             "TRACKSELECT= [SELECTED TRACK VALUE]\r\n", or
             "ERROR- [Description]\r\n" if error, ending command
    Terse-   "0\r\n" to acknowledge receipt of command, followed by the list of audio
              tracks and the selected track of the form:
             "[TRACK#] [CODEC ENUM] [PIDVALUE] [SIDVALUE] [SSIDVALUE] [BITRATE]
                 [SAMPLINGFREQ] [LANGCODE NAME]\r\n"
             "[SELECTED TRACK VALUE]\r\n", or
             "[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
    "\r\n" concludes display responses (empty line)

Examples:

  Verbose command to retrieve current setting:
  *.DCMD TRACKSELECT <enter>
     Response is: OK\r\n
                  1- CODEC= AC3_20, PID= 0x01e2, SID= 0xbd, SSID= 0x80, BitRate= 192000, SamplingFreq= 48000, LangCode= eng"
                  2- CODEC= MPEG2_L2, PID= 0x01e3, SID= 0xc0, SSID= 0x00, BitRate= 192000, SamplingFreq= 48000, LangCode= eng"
                  TRACKSELECT= 01\r\n

  Terse command to retrieve current setting:
  *.DCMD TN <enter>
     Response is: 0\r\n
                  1 1 0x01e2 0xbd 0x80 192000 48000 eng
                  2 3 0x01e3 0xc0 0x00 192000 48000 eng
                  1\r\n

  Verbose command to change setting:
  *.DCMD TRACKSELECT 0 <enter>
     Response is: OK\r\n

  Terse command to change setting:
  *.DCMD TN 0 <enter>
     Response is: 0\r\n

Notes:

  If an audio track is set that does not exist in the stream, the setting is ignored
  and the first valid track is played.

  The audio track can be switched on-the-fly for transport streams only.
  
  The audio track list can only be displayed while playback is active, otherwise
  only the selected track is returned for a display response.
  
  If playback is active, the audio track actually being played is shown.  Otherwise,
  the configured track is displayed.
  
Created By: Adtec Digital