Adtec API Help

# Release Notes
    Updated:  October 16, 2009
    Products: Edje 5110

    Copyright Adtec Digital, Inc. 2009, All rights reserved.
    http://www.adtecinc.com/

    PLEASE NOTE:

    Should support be needed, it can be reached by the following methods:

    1. Fill out the on-line support request at http://adtecinc.com/supportrequest/.
    2. Print out the Service Request and fax it to 615-256-6593.
    3. Email support@adtecinc.com
    4. Call 615-256-6619, Ext. 166
       (Monday through Friday 9:00am to 5:00pm Central Time)

    --------------------------------------------------------------------------------
    Known Issues for 1.00.34, October 16, 2009. AHP
    --------------------------------------------------------------------------------

       FRONT PANEL: Some front panel menu options are not limited to valid ranges.
       The result allows users to enter invalid options. Refer to API and manual
       documentation for valid ranges.

       ENCODER: Capture to file is only supported up to a transport mux rate (TMR)
       of 40Mbps. At higher rates, capture will not be active.

       ENCODER: Dolby E passthru 16-bit mode is not supported.

       WEB USER INTERFACE: When encoding at the highest Trans Mux Rate possible for
       the encoder, the web user interface is designed to become less responsive
       freeing up resources to maintain a quality transmission.

    --------------------------------------------------------------------------------
    Version 1.00.34 SERIES -- INTERNAL BUILDS --  AHP
    --------------------------------------------------------------------------------

    --------------------------------------------------------------------------------
    Version 1.00.33, September 28, 2009, AHP
    --------------------------------------------------------------------------------

    WEB USER INTERFACE:

    1)  AUDIO 1 TAB: Corrected issue when selecting SDI Passthru for Audio 1. In
        previous versions, this tab had an incorrect rate validation set and would
        error out.

    --------------------------------------------------------------------------------
    Version 1.00.32, September 23, 2009, AHP
    --------------------------------------------------------------------------------

    FRONT PANEL:
    1)  Extended IP Destination options (previously labeled MULTICAST) to support
        new 4X Send capability. Each SEND functions independently and has unique
        FEC, RTP, TOS, TTL, IPA and PORT configurations.

    2)  Added VBI Source selection to Tables menu where additional VBI data is
        managed.

    ENCODER:

    3)  Corrected potential audio drift issue when encoding Dolby from AES input.

    4)  Corrected error causing EIT events to show an incorrect start time of
        "6 Jan 1980".

    5)  Added ATSC AC-3 descriptor to PMT when in ATSC tables mode. Added ATSC
        AC-3 descriptor to EIT tables when Dolby encoding (not passthru).

    SYSTEM:

    6)  Added functionality to print the Transport Status TRA to the logs at the
        rate of once a minute.

    7)  Corrected issue with ftp that would cause pure-ftp to stop functioning
        after 55 unique transfer sessions.

    WEB USER INTERFACE:

    8)  GENERAL: Added EXPIRES directives to web application. This prevents browser
        caching of stale data, and eliminates the need for users to clear browser
        cache when upgrading.

    9)  AUDIO TAB > AUDIO 1: Re-added SDI Passthru as an option for Audio 1.

    --------------------------------------------------------------------------------
    Version 1.00.31, September 11, 2009, AHP
    --------------------------------------------------------------------------------

    ENCODER:

    1) Added support for unicast routing of FEC.

    2) Corrected issue found with Composite PAL video when teletext extraction was
       disabled. In previous versions, this would produce a green line visible in
       the video.

    --------------------------------------------------------------------------------
    Version 1.00.30, September 9, 2009, AHP
    --------------------------------------------------------------------------------

    FRONT PANEL:

    1) TABLES MENU: Re-added Closed Caption (CLC) option DVS157 to the Tables
       Menu > Closed Caption Sub Menu.

    ENCODER:

    2) Added logic that prevents the initialization of the confidence decoder
       via encoder command when BISS encryption is enabled. Since the confidence
       decoder is not capable of decryption, preventing this initialization
       prevents thrashing of the decoder.

    3) Enabled Closed Caption option DVS157 for concurrent ATSC carriage.

    4) Corrected PMT tables to reflect only valid and enabled audio streams.

    5) Fixed condition where encoder could become bound when switching to or from
       SDI audio passhthru.

    6) Change the default setting for the Dolby Output (DOU) command to MUX. The
       previous default setting "MUX+AES" could result in Dolby audio drift over
       time.

    7) Added internal switch to adjust aspect ratio when encoding High Definition
       resolutions to 16 X 9.

    8) Corrected issue with SDI receivers detecting an unknown video type by
       forcing the encoder to maintain the last known good video type. In
       previous versions, the encoder would falsely cycle when it was detected.

    9) Added autoscan capability on SDI input source for VANC 708 VBI data. The
       limits are from line 8 to 25.

    SYSTEM:

    10) Added default store log limitation (3 days) to drive-less systems.

    11) Added debug capability to the myles communication system used with the web
        application. Hardened messaging handling to and from myles to prevent
        segmentation faults.

    12) Fixed MIB formatting for better compatibility with 3rd party software.

    13) Added functionality to pass the tail end of the current log to the web
        application for debugging purposes.

    14) Added file registration process to allow the use of .DVC files. Files are
        only registered at boot time.

    WEB USER INTERFACE:

    15) SERVICES TAB: Expanded IP Transport Sub Tab to include configuration
        options for all four possible multicast or unicast streams.

    16) AUDIO TAB: Removed SDI as a selectable option for Passthru as logic
        currently imposes incorrect variables on the encoder. It is still a valid
        option selectable via the front panel and will return to the web
        application once logic is corrected.

    17) VBI TAB: Re-added Closed Caption (CLC) option DVS157 Captions Sub Menu.

    --------------------------------------------------------------------------------
    Version 1.00.29, August 26, 2009, AHP
    --------------------------------------------------------------------------------

    FRONT PANEL:

    1) TABLES MENU: Removed invalid Closed Caption (CLC) options from front panel
       and added new ATSCCONVERT option. The only valid closed caption options are
       OFF, ATSC, ATSC708 and ATSCCONVERT.

    2) TRANSMIT MENU: Added Type of Service (TOS) and Time to Live (TTL) settings
       to the Multicast Sub Menu.

    ENCODER:

    3) Enhanced the recently added VBI Source (VBS) command so that it enforces
       dynamic updates to tables when the VBI Source (VBS) is changed.

    4) Added ATSCCONVERT as an option for closed captions. This option will
       convert CEA-608 608-E closed caption data to CEA-708-D formatted closed
       caption data.

    5) Added ATSC caption service descriptor and short event descriptor when
       captions are enabled and present.

    6) Enhanced ATSC table versioning and initialization process to ensure properly
       formatted ATSC tables. Incorrect initialization sequence or table
       malformation would result in binding of the application at boot time and
       produce CC errors in the transport stream.

    7) Adjusted encoder boot to ensure that the encoder initializes with valid SDI
       parameters. Previously, units might not auto-detect HD-SDI at boot time.

    8) Added the ability for the device to simultaneously unicast to up to four
       unicast destinations. Each unicast has independent Multicast Mode (MMO),
       Multicast Send IPA (MSI), Multicast Send Port (MSP), Type of Service (TOS),
       Time to Live (TTL) and FEC Parameter (FPR) settings. Each setting is
       identified by a numeric option immediately following the command.
       (ex. TOS 0 gets the Type of Service setting for the 1st unicast. TOS 1
       gets the 2nd.)

    9) Added corrective action at startup to ensure that all device communications
       are in sync.

    SYSTEM:

    10) Modified the drive mount function to ensure that devices not utilizing
        a hard-drive can maintain minimal logging on the CF Card for debugging
        and troubleshooting purposes.

    WEB USER INTERFACE:

    11) Updated application login page to now display the currently running
        firmware version under the Quick Links section.

    12) Enhanced web user interface to prevent memory leaks, improve performance
        and avoid communication errors when there is an abundance of configuration
        requests or when the device has been running over an extended period of
        time.

    13) The Service Tab has been divided into 3 sub tabs for ease of use:
        - ASI Transport - Contains transport rate, service data and table
           information.
        - IP Transport - Contains Multicast/Unicast variables.
        - Bars, Tones and ID - Contains switches for overlaying Bars, Tones or
           Service Information.

    14) The VBI Tab has been divided into 2 sub tabs for ease of use:
        - Captions - Contains fields specific to closed captioning.
        - Teletext - Contains fields specific to teletext. These fields are
           editable when the frame rate of the encoded video is 50p or 25i.
        * NOTE: Splice PID and AMOL PID information has been moved to the PID tab.
        They are not part of the PID paradigms schemes located on that tab.

    15) Added power cycle capability to the System Tab via Power Cycle button.
        Power cycling the device will stop all encoding / conf.decoding and you
        will not be able to communicate with the device while it resets.
        (approx. 45 secs.)

    16) Fixed logic on Audio 2 sub tab that incorrectly showed SDI as a valid
        option for PASSTHRU mode. Corrected issues in logic for Audio 1 and 2
        that prevented users from selecting valid input options when in ENCODE
        mode.

    -------------------------------------------------------------------------------
    Version 1.00.28 series   --  INTERNAL BUILDS --
    -------------------------------------------------------------------------------

    --------------------------------------------------------------------------------
    Version 1.00.27, August  10, 2009, AHP
    --------------------------------------------------------------------------------

    ENCODER:

    1) Added new command VBISOURCE (VBS). This option allows users to select which
       input to extract VBI data from when the video input is SDI. This is
       primarily designed for teletext and WSS capture from a COMPOSITE source
       while encoding video from a SDI source.
       Note: The rules concerning CLOSEDCAPTION (CLC) and this command are found
       below.

       Video Source (Input) is SD-SDI
        - VBI Source is set to SDI: CC options are ATSC 608
        - VBI Source is set to COMPOSITE: CC option is ATSC 608

       Video Source (Input) is COMPOSITE
        - VBI Source is set to SDI: Not Valid
        - VBI Source is set to COMPOSITE: CC option is ATSC 608

    2) One channel of Dolby E, Dolby Digital AC-3 and Linear PCM Passthru is now
       available via the SDI input.

    3) Added the ability to generate Color Bars [ECOLORBARS], OSD [ECOLORBARSOSD]
       and Color Bars and Tones [ECOLORBARSTONE].
       Note: Rendering requires a stable video input.

    WEB USER INTERFACE:

    4) VBI TAB:
       - Added VBI Source selection option.

    5) SERVICE TAB:
        - Exposed NIT parameters for configuration. These setting are only used
        when tables are set to DVB.
        - Added functionality to trigger Color Bars, OSD or Bars and Tones.

    6) AUDIO TAB:
        - Fixed bug that prevents the editing of data rate and audio level when
        switching from PASSTHRU mode to ENCODE mode.
        - Adjust selection options so that Passthru of Dolby E, Dolby Digital AC-3
        and Linear PCM are selectable when input is SDI.

    --------------------------------------------------------------------------------
    Version 1.00.26, August  7, 2009, AHP
    --------------------------------------------------------------------------------

    SYSTEM:

    1) Added automatic corrective action in the event that the number of incoming
       requests to the encoder backlogs. This condition occurs rarely and is
       specific to long-term (24 hour +) encodes. This corrective action flushes
       out pending commands in order to stabilize the command channel.

       Example log sequence:

       [ETRANS]:  251517 readRply: 4 bytes of residual data in command buffer, it
             will be removed
       [ETRANS]:  251517 readRply: 17 bytes of residual data in command buffer, it
             will be removed
       [ETRANS]:   54000 CMD(2127, 194, 2): ->QV1^M
       [ETRANS]:   54000 Error reading reply, CMD(2127, 99): <-
       [ETRANS]:   54000 Backlog too deep, flushing

    --------------------------------------------------------------------------------
    Version 1.00.25   --  INTERNAL BUILD --
    --------------------------------------------------------------------------------

    --------------------------------------------------------------------------------
    Version 1.00.24, July 23, 2009, AHP
    --------------------------------------------------------------------------------

    FRONT PANEL:

    1) Added Transport Stream Id to front panel PIDS menu.

    SYSTEM:

    2) Corrected issues with SNMP that prevented values from being set.

    WEB USER INTERFACE:

    3) AUDIO TAB: Modified the Dolby Parameter configuration values so that they
       are only valid when encoding Dolby Digital AC3.

    4) AUDIO TAB: Fixed bug that would prevent changing MPEG 1 Layer 2 format
       (Mono or Stereo) when encoding MPEG 1 Layer 2.

    --------------------------------------------------------------------------------
    Version 1.00.23, July 16, 2009, AHP
    --------------------------------------------------------------------------------

    ENCODER:

    1) Fixed bug with uploading profiles. Previous versions would not run or save
       the profile after upload so the settings would not take effect or be saved.

    SYSTEM:

    2) Implemented route (IP layer 3) for IP unicast streaming.

    WEB USER INTERFACE:

    3) The Audio Tab has been split into sub tabs.
       1 - Global Audio Tab
       1 - Audio sub tab per Audio Encoder

    4) Exposed additional Dolby parameter settings for Audio 1 & 2.

    5) Added a signed certificate to our ftp upload applet as well user
       notification when uploads have completed.

    --------------------------------------------------------------------------------
    Version 1.00.22, July 1, 2009, AHP
    --------------------------------------------------------------------------------

    WEB USER INTERFACE:

    1) GENERAL: Updated version management in UI to include files with .gz
       extension.

    --------------------------------------------------------------------------------
    Version 1.00.21, June 26, 2009, AHP
    --------------------------------------------------------------------------------

    ENCODER:

    1) Added automatic synchronous functionality for the audio encoders when they
       are all operating with the same parameters.

    2) Expanded profile handling to include additional FEC (FEP) parameters.

    SYSTEM:

    3) Fixed bug on api (telent 23) that prevented users from using direct api
       commands to version upgrade a unit.

    WEB USER INTERFACE:

    4) GENERAL: Updated version management in UI to use binary version process.

    --------------------------------------------------------------------------------
    Version 1.00.20, June 22, 2009, AHP
    --------------------------------------------------------------------------------

    SYSTEM:

    1) Fixed build-time bug preventing the correct profile generation file from
       being included.

    WEB USER INTERFACE:

    2) GENERAL: Updated version management in UI to use binary version process.

    --------------------------------------------------------------------------------
    Version 1.00.19, June 18, 2009, AHP
    --------------------------------------------------------------------------------

    FRONT PANEL:

    1) Removed independent Secondary Audio Command. It has been replaced with an
       OFF option found under Audio Mode.

    2) Removed Dolby Audio Input option from Audio Menus. This setting is managed
       automatically.

    3) Relocated Sample Frequency to the top of the Audio Menu as it is a global
       configuration for both Audio 1 and Audio 2.

    4) Added Linear PCM option to Encoder Audio Menu > Audio Type. It is only
       available in Passthru Mode.

    ENCODER:

    5) Implemented dynamic Wide Screen Signaling (WSS) option for Aspect Ratio
       (ARA) specific to PAL video. Selecting WSS will enable the encoder to read
       the incoming WSS flag and will adjust the aspect ratio in the MPEG2 video
       elementary stream accordingly. Note that Aspect Ratio is related to Active
       Format Descriptor (AFD). It is recommended to set AFD to WSS if Aspect Ratio
       is set to WSS.

    6) Implemented static AFD support for NTSC video. This functionality is
       dependent upon closed captioning being turned on for the device. AFD is used
       by downstream decoding devices to properly display pixel aspect ratio on
       displays with differing aspect ratios. An AFD compatible display or STB/IRD
       is required. See API Notes and help hints for more information.

    7) Adjusted lip sync for Dolby AC3 (2.0) when in passthru mode.

    8) Profile generation has been updated to include recently added configurations
       and previously omitted commands. Out-dated and unused configurations have
       been removed. Additionally, we have modified profile naming to allow for
       spaces in the profile name.

    9) Modified default lip sync settings for D1 (NTSC and PAL).

    10) Reduced latency through encoder by approximately 4 frames.

    11) Corrected value testing relative to the ENCYRPTION ECR command. This command
        was not setting properly in previous versions.

    SYSTEM:

    12) Added INACTIVE status to NTPSRVRADDRESS for local synchronization.

    13) Fixed issue with networking that prevented network settings from
        being set.

    14) Added NTPSVRIPADDRESS RESTART command. See API documentation for use
        details.

    WEB USER INTERFACE:

    15) PROFILE TAB: Added functionality to download and upload profiles from the UI.
        The upload process automatically loads and saves new settings with optional
        overwrite and rename functions.

    16) PID Tab:  Added new PID paradigm, WBU-ISOG.
        Settings are:
        PMT - 0x00100 hex  256 dec
        Video - 0x00101 hex  257 dec
        PCR - 0x00101 hex  257 dec
        Audio 1 - 0x00102 hex  258 dec
        Audio 2 - 0x00103 hex  259 dec
        Transport Stream ID - 0x0001 hex  1 dec

    17) SYSTEM Tab:  IPA address and SubnetMask Ethernet fields are no longer reset
        when disabled (DHCP mode).

    18) STATUS PANEL:  Multicast, RTP, IP:Port and FEC settings can be monitored in
        real-time on the status panel.

    19) STATUS PANEL: Support for ADS API command detects the current status of the
        different AUDIO inputs. LED indicating the current status (PLAYING,
        IDLING, STOPPING, etc...) is updated in real-time.

    --------------------------------------------------------------------------------
    Version 1.00.18 Series -- INTERNAL BUILDS
    --------------------------------------------------------------------------------

    --------------------------------------------------------------------------------
    Version 1.00.17, May 19, 2009, Test Build, JT
    --------------------------------------------------------------------------------
    ENCODER:

    1)  Added user data support, closed captioning per SMPTE 334 for HD and NTSC for
        SD. Captions are compliant with CEA 608 and 708.  Supports all MPEG 2
        resolutions per ATSC A53.  Supports all MPEG 4 AVC resolutions per ATSC A72.

    2)  Support for Network Attached Storage (NAS) using Network File System (NFS).

    3)  Added support for Linear PCM Bypass Mode for AES inputs 1 and 2. The PCM is
        packaged according to SMPTE302M. Use this setting when passing uncompressed
        PCM Audio or Linear Acoustics E2.

    4)  Enabled AES 1 and 2 out to default AES 1 and 2 in loop. Only works when AES
        1 and 2 are in mode PASSTHRU.

    5)  Reduced default latency through encoder.

    6)  Added STEALIPADDRESS command and functionality. This can be used for
        enhanced security by limiting addresses that can access this unit using
        secure shell.

    7)  Added SMPTE 2022 forward error correction transmit capability. See
        FECPARAMS command documentation.

    UI:

    8)  AUDIO tab: Removed artificial audio rate enforcement of 192000 kbits/sec.

    9)  AUDIO tab: Added option for Linear PCM Audio Type (available in PASSSTHRU mode).

    10) AUDIO tab:  Support to turn ON/OFF Audio 1.

    11) PROFILE tab: When creating a new profile, profile name can be typed directly,
        since corresponding field is selected by default.

    12) PROFILE tab: Prevents page-refreshing when pressing "Enter" or "Return" key when
        creating a new profile.

    13) SERVICE tab:  FEC parameters and settings are disabled when MULTICAST is set to
        OFF, and re-Enabled when MULTICAST is set to SEND.

    14) SYSTEM tab:  Date field can be edited with or without using the calendar widget.

    15) STATUSPANEL: MULTICAST, IP:Port FEC PARAMS exposed on STATUS PANEL and refreshed
        in real-time.

    16) PID tab:  Hex values standardized 0xXXXX where uppercase X is a HEX digit.

    --------------------------------------------------------------------------------
    Version 1.00.16, May 7, 2009, GE
    --------------------------------------------------------------------------------

    GUI:

    1) HELP Tab: Exposed link for user's manual

    2) VIDEO Tab: Updated help blurb for Chromatype field.

    SYSTEM:

    3) Support for SNMP trap messages.

    4) Support to submit/retrieve profiles by uploading/downloading them from/to
       the unit.

    --------------------------------------------------------------------------------
    Version 1.00.11, April 30, 2009, GE
    --------------------------------------------------------------------------------

    1) Removed Program Number 2 and Program Map PID from PID menu.

    2) Added transmit menu on the front panel

    3) Created feature for chroma 422 on SD.

    GUI:

    4) AUDIO tab: Removed artificial audio rate enforcement of 192000 kbits/sec.

    5) VIDEO tab: Chromatype field set to 420 if M2SD422 key is not enabled.

    6) HELP tab:  Added link to API documentation.

    7) SYSTEM tab: Fixed bug that displayed the word "Arguments" for IPAddress
          and Subnet Mask fields when DHCP is active for that port.

    8) SYSTEM tab:  Date field accepts direct input without using calendar widget.
          Calendar control widget can still be used by clicking on the calendar icon.

    9) FEATURES tab: Enhanced error checking on the unit response when inserting a
          key to lock/unlock features. Notification of the status of the operation
          (SUCCESS, FAILURE) is displayed at the top of the screen, and dissapears
          after 3 seconds.

    10) PID tab: Hex values format standardized 0xXXXX where uppercase X is a HEX
           digit.

    11) VIDEO tab: Help blurb for CODEC field displays new customized message.

    12) STATUS PANEL: CODEC/CHROMA fields updated in real-time.

    --------------------------------------------------------------------------------
    Version 1.00.10, April 20, 2009, TEST, JT
    --------------------------------------------------------------------------------

    1)  UI: Corrects errors audio settings.

    2)  ENCODER: Corrects configuration load error.

    --------------------------------------------------------------------------------
    Version 1.00.09, April 19, 2009  JT
    --------------------------------------------------------------------------------

    1)  Removed launch of ecapt on start-up due to errors after encoding for about
        45 minutes.

    --------------------------------------------------------------------------------
    Version 1.00.08, April 18, 2009  JT
    --------------------------------------------------------------------------------

    1)  Initial release candidate build for edje-5110.
Created By: Adtec Digital Inc