DECDOLBYPARAMS DDP D2

Description:

  Display or Modify the current Dolby Digital AC3 parameter/metadata settings
  for AC3 decoding.

Form:

  Command Handler: DCMD
  DECDOLBYPARAMS|DDP|D2 [ARG0] [ARG1] [ARG2]... [ARG27]
  Argument List:
    0-  CHANNELID-  0=  1st audio engine
                    1=  2nd audio engine
                    2=  3rd audio engine
                    3=  4th audio engine
                    4=  5th audio engine
                    5=  6th audio engine
                    6=  7th audio engine
                    7=  8th audio engine
    1-  Output Format - read/write
            0= COMPRESSED, [passthru] (default)
            1= MONO,       [1/0]
            2= STEREO,     [2/0]
            3= LCR,        [3/0]
            4= LRS,        [2/1]
            5= LCRS,       [3/1]
            6= LRLSRS,     [2/2]
            7= LCRLSRS,    [3/2]
            8= DIRECTMAP,  [OUT=IN]
        NOTE- If not set to COMPRESSED or DIRECTMAP, if the output mode does not
              equal the bitstream audio coding mode (acmod), then the decoder
              will perform downmixing or fill channels with zero values to meet
              the desired output configuration. The WebUI/Front Panel displays
              'PASSTHRU' (instead of COMPRESSED) and 'DECODE - STEREO'
              (instead of STEREO).
    2-  Output LFE On - read/write
            0= LFE channel not included in the output PCM data (default)
            1= the LFE channel is included in the output PCM data if it exists
               in the bitstream.
    3-  Compression Mode - read/write
            0= Custom mode (no digital dialogue normalization)
            1= 2/0 Dolby Surround mode
            2= Line out mode (default)
            3= RF mode
    4-  Stereo Output Mode - read/write
        This parameter specifies the reproduction mode associated with stereo output
        (output mode = 2/0).
            0= Auto-detects stereo mode based on the bit stream (default)
            1= 2/0 Dolby Surround compatible (Lt/Rt)
            2= 2/0 Stereo (Lo/Ro)
            3= Reserved
    5-  Dual Mono Mode (when 'acmod' = 1/1), read/write
            0= Stereo (default)
            1= Left mono
            2= Right mono
            3= Mixed mono
    6-  Dynamic Range Scale Factor, High Level, read/write
        Fractional number between 0.0 and 1.0.
            0.0= high-level signal compression disabled
            0.1= scale to 1/10
              .
              .
              .
            1.0= full scale (default)
        NOTE- This parameter is ignored if the compression mode is set to RF mode.
    7-  Dynamic Range Scale Factor, Low Level - read/write
        Fractional number between 0.0 and 1.0.
            0.0= low-level signal compression disabled
            0.1= scale to 1/10
              .
              .
              .
            1.0= full scale (default)
        NOTE- This parameter is ignored if the compression mode is set to RF mode.
    8-  Output PCM Scale Factor - read/write
        Fractional number between 0.0 and 1.0.
            0.0= mutes PCM output
            0.1= scale to 1/10
              .
              .
              .
            1.0= full scale (default)
    9-  Error Concealment Enable Flag - read/write
            0= error concealment disabled
            1= error concealment enabled
    10- Error Max Block Repeats - read/write
        Integer between 0 and 255.  The maximum number of consecutive block repeats
        that should be allowed before the output channels are automatically muted.
        If this parameter is zero, then block repeats continue indefinitely.
        Default is 255.
    11- Substream ID - read only
        Value from 0 to 7 indicating which of 8 possible streams the current frame
        belongs to.
    12- Dialog Normalization - read only
        Valid from 1 to 31, interpreted as 1 = -1dB, 2 = -2dB, ..., 31 = -31dB
    13- Dialog Normalization - read only
        Valid from 1 to 31, interpreted as 1 = -1dB, 2 = -2dB, ..., 31 = -31dB
    14- Audio Coding Mode - read only
            0= dual mono [1+1]         4= L,R,S [2/1]
            1= mono, [1/0]             5= L,C,R,S [3/1]
            2= L,R, aka stereo [2/0]   6= L,R,Ls,Rs [2/2]
            3= L,C,R [3/0]             7= L,C,R,Ls,Rs [3/2]
    15- Bitstream Mode - read only
            0= Main Service-Complete Main
            1= Main Service-Dialogue
            2= Associated Service-Visually Impaired
            3= Associated Service-Hearing Impaired
            4= Associated Service-Dialog
            5= Associated Service-Commentary
            6= Associated Service-Emergency Flash
            7= Associated Service-VoiceOver (acmod = '1')
            7= Main-Karaoke (acmod > '1')
    16- Bitstream ID - read only
            0= standard ATSC A/52 bitstream
            1= annex D bitstream
            2= annex E bitstream
    17- Stream Type - read only
            0= independent
            1= dependent
            2= transcoded
            3= reserved
    18- Audio Production Info Exists - read only
            0= 'mixlevel' or 'roomtyp' fields are not present in stream
            1= 'mixlevel' or 'roomtyp' fields are present in stream
    19- Audio Production Info Exists - read only
            0= 'mixlevel' or 'roomtyp' fields are not present in stream
            1= 'mixlevel' or 'roomtyp' fields are present in stream
    20- Mix Level0 - read only
            Range is 0 to 31.  The peak mixing level is 80 plus the value of
            mixlev dB SPL, or 80 to 111 dB SPL.
    21- Mix Level1 - read only
            Range is 0 to 31.  The peak mixing level is 80 plus the value of
            mixlev dB SPL, or 80 to 111 dB SPL.
    22- Room Type0 - read only
            0= Not Indicated
            1= Large Room, X curve monitor
            2= Small Room, flat monitor
            3= Reserved
    23- Room Type1 - read only
            0= Not Indicated
            1= Large Room, X curve monitor
            2= Small Room, flat monitor
            3= Reserved
    24- Copyright - read only
            0 = bitstream not indicated as copyright protected
            1 = bitstream is copyright protected
    25- Original Bitstream - read only
            0 = copy of another bitstream
            1 = bitstream is original
    26- Dolby Surround Mode - read only
            0= not indicated
            1= not Dolby Surround encoded
            2= Dolby Surround encoded
            3= reserved
    27- Dolby Surround Ex Mode - read only
            0= not indicated
            1= not Dolby Surround Ex encoded
            2= Dolby Surround encoded
    28- A/D Converter Type - read only
            0= standard
            1= HDCD
    29- Time Code 1st/2nd Halves Exists - read only
            0= not present
            1= first half (14 bits) present
            2= second half (14 bits) present
            3= both halves (28 bits) present
    30- Time Code 1st Half - read only
        The first 5 bits of this 14-bit field represent the time in hours, with valid
        values of 0–23. The next 6 bits represent the time in minutes, with valid values
        of 0–59. The final 3 bits represents the time in 8 second increments, with valid
        values of 0–7 (representing 0, 8, 16, ... 56 seconds).
    31- Time Code 2nd Half - read only
        The first 3 bits of this 14-bit field represent the time in seconds, with valid
        values from 0–7 (representing 0–7 seconds). The next 5 bits represents the time
        in frames, with valid values from 0–29. The final 6 bits represents fractions of
        1/64 of a frame, with valid values from 0–63.

Response:

  DECDOLBYPARAMS 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)

Examples:

  Verbose command to retrieve current parameters from audio engine 3:
  *.DCMD DECDOLBYPARAMS 3 <enter>
     Response is: OK\r\n
                  Dolby Params Engine 3
                  OutFormat= STEREO
                  LEFOn= OFF
                  CompMode= LINEOUT
                  StereoOutMode= AUTO
                  DualMonoMode= STEREO
                  DRScaleHi= 1.0
                  DRScaleLo= 1.0
                  PCMScale= 1.0
                  ErrConceal= ENABLED
                  ErrBlkRpt= 255
                  SubstrmID= 0
                  DialNorm0= 1
                  DialNorm1= 1
                  ACMode= LR
                  BsMode= COMPLETE_MAIN
                  BsID= STANDARD
                  StrmType= INDEPENDENT
                  AudProdInfo0= 1
                  AudProdInfo1= 1
                  MixLevel0= 0
                  MixLevel1= 0
                  RoomType0= NOTINDICATED
                  RoomType1= NOTINDICATED
                  Copyright= 0
                  OrigBs= 1
                  DSurrMode= NOTINDICATED
                  DSurrExMode= NOTINDICATED
                  ADConvType= STANDARD
                  TimeCodeExists= 0
                  TimeCode= 00:00:00:00.00

  Verbose command to change output format and dual mono mode for channel 2:
  *.DCMD DECDOLBYPARAMS 2 DIRECTMAP , , , LEFT <enter>
     Response is: OK\r\n

Notes:

  - During set mode, args can be skipped with a comma placeholder.
  - During set mode, you only have to specify the arguments (or a placeholder)
    for params leading up to param that will be set.
Created By: Adtec Digital