DOLBYSDILINE DLN D3

Description:

This is used to configure Dolby E placement in the SDI output and is
configurable per audio engine. When set to AUTO (-1), the default
configuration, the Dolby E line is placed within the valid line number range
for the video resolution.  The Dolby E line may be manually configured to a
value within range.  Valid ranges for Dolby E line placement are resolution
and frame rate dependent.  If the configured value is not valid, the system
will use the valid line used by the 'AUTO' mode.  The Dolby E line status
information can be used to see the actual Dolby E line placement.

Form:

  Command Handler: DCMD
  DOLBYSDILINE|DLN|D3 [INDEX] [LINE]

   [INDEX]: This is the audio engine you wish the dolby line number to apply to

       0= AUDIO ENGINE 0
       1= AUDIO ENGINE 1
       .
       .
       .
       7 = AUDIO ENGINE 7

   [LINE]: The dolby line number to use for the specified index. You can also use -1
           to allow the decoder to use the AUTO setting for the resolution and frame rate.

       LINE = 1-4096
       AUTO = -1

Response:

  DOLBYSDILINE 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:
Get current Dolby E line settings for SDI and SDIALT
*.DCMD DLN
OK
Engine 0=56
Engine 1=56
Engine 2=56
Engine 3=56
Engine 4=56
Engine 5=56
Engine 6=56
Engine 7=56

Get current Dolby E line setting for SDI
*.DCMD DLN 0
OK
56

Set Dolby E line setting to line 87 for audio engine 0
*.DCMD DLN 0 87
OK

Terse:
Get current Dolby E line settings for all audio engines
*.DCMD D3
0
87 56 56 56 56 56 56 56

Get current current Dolby E line settings for audio engine 0
*.DCMD D3 0
0
56

Set current Dolby E line settings for audio engine 5 to 46
*.DCMD D3 5 46
0

Notes:

1) If the configured line is not within the range specified by Dolby Labs
   for the current decode resolution the line will be inserted at the default
   AUTO line number.

2) Scaling is not implemented for Dolby E, the Dolby E line check will be based on the
   native resolution, not the scaled resolution.

3) All line settings will have an SDI insert accuracy of +/- 2 lines.

4) The user will not get direct feedback on the placement of the line number,
   but can see the valid configured line number in API DUS PASSTHRU in
   "PASSTHRU_CURR_LINE=xx" field.

5) Actual line settings can be seen in logs.

                           |////////////////////////////Dolby Labs Specified Line Settings//////////////////////|
                           --------------------------------------------------------------------------------------
                           |625 25 | 1080i50 | 1080p50 | 720p50 | 525 29.97 | 1080i59.94 | 1080p59 | 720p59.94  |
                           --------------------------------------------------------------------------------------
Earliest valid DE position |   8   |    13   |    26   |   17   |    12     |     18     |    35   |     23     |
                           --------------------------------------------------------------------------------------
               Ideal -80us |   11  |    19   |    37   |   25   |    13     |     21     |    42   |     28     |
                           --------------------------------------------------------------------------------------
              Ideal +-80us |   12  |    21   |    42   |   28   |    14     |     24     |    47   |     32     |
                           --------------------------------------------------------------------------------------
               Ideal +80us |   13  |    23   |   103   |   31   |    16     |     26     |    52   |     35     |
                           --------------------------------------------------------------------------------------
  Latest valid DE position |   30  |    53   |   105   |   70   |    26     |     48     |    95   |     63     |
                           --------------------------------------------------------------------------------------
              Adtec  Auto  |   19  |    30   |    42   |   35   |    19     |     30     |    47   |     40     |
                           --------------------------------------------------------------------------------------
Created By: Adtec Digital