Adtec API Help

# Release Notes
    Updated:  March 25, 2008
    Products: mediaHUB HD
    Revisions for specific product types are noted in the descriptions.

    Copyright Adtec Digital, Inc. 2007 - 2008, All rights reserved.
    http://www.adtecinc.com/

    PLEASE NOTE:

    This release of the mediaHub firmware can only be used on hardware version 3
    units.  The original hardware version 1 is now obsolete, while hardware version
    2 supports standard definition only.  Anyone with version 1 or 2 hardware will
    need to contact Adtec technical support for an upgrade in order to use this
    mediaHUB firmware release.  Support can be reached by the following methods:

    1. Online at www.adtecinc.com/support.html, fill out the online Service Request.
    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 – Friday 9:00am – 5:00pm Central Time)

    Hardware 1 units can be identified as any unit currently running on firmware
    releases less than 2.xx.xx (i.e. all 1.xx.xx versions).

    Hardware 2 units can be identified as any unit currently running on firmware
    releases less than 3.xx.xx (i.e. all 2.xx.xx versions).

    The hardware 2 upgrade incorporates a new confidence decoder subsystem that
    greatly enhances the decoder performance and feature set.  This includes:

    - Faster and more reliable confidence decode
    - Full API command and functionality support
    - Decoded video output support of HD and VGA monitors
    - Many other various items too numerous to list here

    The hardware 3 upgrade incorporates a new encoder subsystem that supports both
    standard and high definition video.

    --------------------------------------------------------------------------------
    Known Issues for Version 3.00.09, March 25, 2008. DWG
    --------------------------------------------------------------------------------

    1)  If the TIMEZONE command is used, the logs will not reflect the updated
        time until the system is rebooted.

    2)  DECODER: BLANK=NOVIDEO functional only for NTSC display target.  Use
        with other targets may result in erratic behavior. [mid1024]

    3)  DECODER: Some DVD content may not decode properly. [mid1054]

    4)  DECODER: Loading large OSD's can cause playback stuttering in some
        cases if a high bit rate clip is playing. [mid1310]

    5)  DECODER: Switching audio track while playing may take several seconds
        before the new track is heard. [mid1898]

    6)  ENCODER: The confidence decode start delay (CONFDECODESTART) is not
        persistent. [mid1900]

    7)  ENCODER: The capture file name (CAPTUREFNAME) is not persistent.
        [mid1900]

    8)  ENCODER: Long encodes (greater than 12 hours) may end prematurely
        (unconfirmed). [mid2098]

    9) ENCODER: Standard definition video encoding is not fully supported yet.

    10) ENCODER: High bitrate encodes may break up occasionally.

    11) DECODER: Confidence decode is only supported up to 20Mbps.  At higher
        bitrates, confidence decode will not be active.

    12) ENCODER: Chroma type (CHT) is not persistent.

    13) Some front panel menu edits may not be properly bounded.

    14) ENCODER: Dolby E passthrough is not fully implemented.

    15) DECODER: Dolby E decoding is not supported.

    --------------------------------------------------------------------------------
    Version 3.00.09, March 25, 2008. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.45 or higher

    1) MPEG layers 1 and 2 audio encode can now source its data from the AES3
       (digital audio) inputs.  Note that the audio input (AIN) command now takes
       precedence over the Dolby audio input (DAI) command.

    2) Dolby audio input (DAI) configuration has been added to the front panel
       menus for both audio channels.

    3) The front panel logged-in state is now persistent when the login duration is
       set to infinite (0).  If the login duration is not infinite, the unit will
       always come up in a logged-out state.

    --------------------------------------------------------------------------------
    Version 3.00.08, March 19, 2008. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.45 or higher

    1) The confidence decode delay API command has been removed.  The delay is now
       fixed to the minimum necessary.

    2) Added support for encoder CFG options CLEAR and ERASE.  NOTE- CFG options
       CLEAR, ERASE, and LOAD are not allowed while actively encoding.  Issuing
       these options while encoding will generate an error.

    3) Corrected bug causing instability in the encoder subsystem during startup.

    --------------------------------------------------------------------------------
    Version 3.00.07, March 13, 2008. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.45 or higher

    1) Added preliminary support for Dolby E passthrough.

    2) Added log-in duration feature to the front panel menu access.  A duration can
       now be set from 0 (never log out) to 9 (9 minutes).  If no front panel
       activity is seen for the set log-in duration the menu access will be disabled
       by a forced log out.

    3) Added audio sync configuration to the encoder front panel menu.

    --------------------------------------------------------------------------------
    Version 3.00.06, March 6, 2008. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.45 or higher

    1) Corrected behavior of API commands MCN, MRP, and MTU such that the channel
       defaults properly when using terse arguments. [mid1349]

    2) Fixed spelling error in the Encoder Status menu.

    3) Updated decoder subsection with the equivalent feature set of the Soloist
       4111 as of release version 2.01.41.

    4) Added DCHP configuration to System Menu.

    5) Corrected bug in encoder compressed audio bypass mode that was causing in-
       compatibility with non-Adtec products that transmit compressed data on AES3
       (IEC 61937).

    --------------------------------------------------------------------------------
    Version 3.00.05, February 26, 2008. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.45 or higher

    1) The commands 'Encode' and 'Stop' can now be issued from the front panel
       encoder status menu.

    2) The encoder and decoder 'Resolution' LEDs are now functional.  The colors
       indicate the following:
       - OFF, standard definition video
       - YELLOW, 720p high definition video
       - GREEN, 1080i or 1080p (decode only) high definition video
       - RED, invalid or VESA (decode only) high definition only

    3) Corrected transport mux rate menu item that was showing 'Transfer Mux Rate'
       in the TRANSMIT MENU.

    4) The audio encode layer and bitrate can now be configured from the front panel
       encoder menu.

    5) The encoder status is now shown as the top menu item, and includes the
       video resolution and rate, audio layer and rate (both channels), and the
       audio sampling frequency.

    --------------------------------------------------------------------------------
    Version 3.00.04, February 19, 2008. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.45 or higher

    1) Corrected issue causing failed encode initiation when STARTUP=ON and SDI is
       selected for video input.

    2) Reduced timeouts required for triggering the end of a capture to file.

    --------------------------------------------------------------------------------
    Version 3.00.03, February 18, 2008. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.45 or higher

    1) Added a transmit menu to front panel, including support for transport mux
       rate and multicast send configuration.

    2) Added the following configurations to the ENCODER front panel menu:
       - video bitrate
       - chroma type
       - video input
       - audio channels 1 and 2 (not fully implemented)

    3) Increased supported bitrate (> 20Mbps) for capture to file.  There may still
       be occasional break up at high bit rates.  This issue is being looked at
       closely.

    4) Fixed bug causing file capture to have a delayed startup, which was causing
       loss of data at times.

    5) On-going hardening of the encoder subsystem.

    6) Fixed bug causing multicast send configuration to not be persistent.

    --------------------------------------------------------------------------------
    Version 3.00.02, January 23, 2008. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.43 or higher

    1) Corrected file permissions issue that was causing encode capture files to be
       inaccessible.

    2) Update/changed several default settings for configuration/API.

    --------------------------------------------------------------------------------
    Version 3.00.01, January 21, 2008. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.43 or higher

    1) Added multicast options to the encoder menu to allow configuring MSI, MSP,
       and MMO from the front panel.

    2) Corrected issue that could cause misalignment in the encoder's API resulting
       in erratic behavior.

    --------------------------------------------------------------------------------
    Version 3.00.00, January 16, 2008. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.43 or higher

    1) Added support for HD video encoding.

    2) Added API commands MMO, MSI, and MSP, in support of routing encoded data
       over IP.

    3) The following commands are new:
       - ACTIVEFORMATDES/AFD/A4
       - AMOLCONFIG/AMC/AC
       - AMOLPID/APQ/AQ
       - ASIMODE/ASM/AM
       - MUSICAMMODE/MCM/MC
       - OFILTERSPATIAL/OFS/OS
       - OFILTERTEMPORAL/OFT/OT
       - STARTUP/STU/SU
       Refer to API documentation for details.

    4) Use of the following commands has changed:
       - AINPUT/AIN/AI
       - INPUT/INP/IT
       Refer to API documentation for details.

    5) The following commands are no longer supported:
       - CLOCKSOURCE/CKS/CK
       - HFILTERSPATIAL/HFS/HF
       - HSCALEPREFILTER/HPF/HP
       - HSCALEBANDWIDTH/HSB/HB
       - MUXDEST/MDE/MD
       - MUXTYPE/MTY/MT
       - PARPIN6/PP6/P6
       - VENCODE/VEN/VE
       - VFILTERSPATIAL/VFS/VF
       - VFILTERTEMPORAL/VFT/VT
       - VPESSIZE/VPS/V1

    --------------------------------------------------------------------------------
    Version 2.00.13, December 12, 2007. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.43 or higher

    1) Added random access indicator (adaptation field and payload) to the start
       of each I frame PES packet.

    2) Corrected missing gigabit ethernet port driver introduced in version 2.00.11.

    --------------------------------------------------------------------------------
    Version 2.00.11, November 27, 2007. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.43 or higher

    1)  The decoder no longer freezes on subsequent playback after MPEG1 system
        streams are played. [mid1046]

    2)  Added new encoder API command CUSTOMQUANTTABLE/CQT/CQ.  The custom quantiz-
        ation table can be turned ON or OFF.  The default is OFF (use standard
        table).

    --------------------------------------------------------------------------------
    Version 2.00.10, September 4, 2007. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.43 or higher

    1)  The file registration system will now search for files in any directory.
        Previous versions would only search in the argued path or the default
        location for the specific file type.

    2)  The FTP command now accepts a status argument.  The "FTP STATUS" command
        will return the results of the last ten FTP PUT commands.  The "STATUS"
        argument can be lower case or upper case.

    3)  Corrected FTPPASSIVE terse command terse from FP to FA.  Added FTP terse
        command "FP".

    4)  File Registration was changed to properly register files less than 1 MB.

    5)  Corrected invalid INPUTAUDIOTYPE command options in the API documentation.

    6) The NAME command has been implemented.  The unit's network hostname will
        be changed to the argued name.  Note: NAME will be implemented as a valid
        prefix for API commands in a subsequent release.

    7) Changed the Telnet timeout from 5 minutes to 7 minutes.  The timer is now
        reset properly on Telnet reads and writes.

    8)  Corrected inconsistencies in various API commands that were introduced in
        earlier releases.

    9)  FTP Mirror client mode no longer actively attempts to free disk space.
        Disk space is only freed by FTP if it is active and the disk space is low.

    10) Updated all references of adCode to mediaHub.

    11) Added API command MANUFACTURE/MFG/MF.

    12) Corrected issue causing FTP transfers to fail for files over 2GB.  This
        problem was reintroduced in an earlier version.

    13) Fixed bug causing record start failure when RDU is set to 00:08:xx:xx or
        00:09:xx:xx. [mid2016]

    14) Added support for firewire as an audio input argument.  This allows the new
        configuration option to be saved (persistent). [mid2000]

    15) Added new API command SMBTRANSFER/SMB/SJ.  See API docs for details.

    16) Encoder uses new memory timing in support of available memory hardware.

    17) Added detection of IPA set to 0.0.0.0 which does not turn on that network
        device.

    --------------------------------------------------------------------------------
    Version 2.00.09, June 8, 2007. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.34 or higher

    1) FTP status has been added for outgoing ftp transfers only.

       The terse results of status space delimited as:

       "id of the transfer" "host ipaddress" "local file" "remote file" "percent
           complete" "rate" "total transferred" "ETA" "status"

       A status of 0 is currently transferring, 1 is completed.

       Terse example:

       * fp status
       ?
       0
       1187 192.168.10.151 "/media/hd0/media/AdtecHD.mpg" "Adtec1.mpg" 65 1.68 76320
       00:21 0
       992 192.168.10.151 "/media/hd0/media/AdtecHD.mpg" "Adtec1.mpg" 100 1.83 111
       00:00 1

       The verbose form:

       * ftp status
       ?
       OK
       Process:       1291
       Server:        192.168.10.151
       Local Name:    /media/hd0/media/Adtec-MediaHub.mpg
       Remote Name:   test32.mpg
       Percent Comp:  100%
       Rate:          8.91 MB/s
       Total Trans:   21118 KB
       ETA:           00:00 ETA
       Status:        Complete
       --------------------------------------
       Process:       1282
       Server:        192.168.10.151
       Local Name:    /media/hd0/media/Adtec-MediaHub.mpg
       Remote Name:   test.mpg
       Percent Comp:  100%
       Rate:          6.26 MB/s
       Total Trans:   21118 KB
       ETA:           00:00 ETA
       Status:        Complete
       --------------------------------------

    --------------------------------------------------------------------------------
    Version 2.00.07, May 9, 2007. DWG
    --------------------------------------------------------------------------------

    GUI compatibility:  mediaControl version 2.2.34 or higher

    1)  NTSCJ decoded video output has been implemented. [mid762]

    2)  Confidence decode start delay can now be set as low as 0 without premature
        playback stop. [mid985]

    3)  TRANSPORT command now reports proper playback percentage for confidence
        decode. [mid1015]

    4)  Concurrent encode and decode support up to the full 15mbps MPEG spec.
        [mid693]

    5)  The decoder's AUDIOTRACKSELECT command has been updated as follows:
        - The audio track may be changed while file playback is active for transport
          streams.  There will be a delay as the new audio track is started by the
          decoder.  Note that program stream audio tracks only take affect at spot
          start.
        - The audiotrack selected (1, 2, etc) corresponds to the order the audio
          tracks were detected by file registration, or the order in which they
          appear in a multicast.
        - The audio parameters are set up automatically based on file registration
          or multicast parameters.  No user configuration is necessary to play a
          selected audio track.
        - If the AUDIOTRACKSELECT command is entered with no options, it will report
          all available tracks for the active stream, along with the currently
          active track.  It playback is not active, the current configuration value
          for AUDIOTRACKSELECT is reported.
        [mid1778]

    6)  Greatly improved configuration setup, load, and save times. [mid789,mid1649]

    7)  Full configuration persistence support for all decoder and most encoder
        commands (CAPTUREFNAME and CONFDECODESTART not supported). [mid480]

    8)  Added support for the parallel port.  The legacy parallel port commands
        PARCHAR, PARMAP and PARTEST are supported. See the updated API pages for
        more details.

    9)  Added support for using the RUN PARxxxxx.DVC command to load a map of
        commands to use for the parallel port. Please refer to the RUN command
        documentation.

    10) NTP properly updates the real time clock (MID 1568).

    11) Video Loop Mode has been partially corrected.  The system will loop for
        all supported MPEG media, however, there will be a noticeable delay during
        the loop transition.

    12) The XCP communication protocol has been implemented.  XCP commands can be
        sent and received from any system that supports XCP, including Adtec's
        legacy decoders.  Commands XCP and XCPKEY have been added to support the
        protocol.  The XCP and XCPKEY settings must be saved by using the XCP SAVE
        command, as those setting are not currently saved as part of the
        CONFIGURATION SAVE.  Please refer to the API documentation for details.

    13) File registration has been updated as follows:
        - The file registration process is more efficient.
        - The VBR bitrate is calculated more accurately.
        - The system supports options to register multiple locations.
        - The system will automatically re-register files after a
          firmware upgrade.
        - Playback now occurs immediately after a firmware upgrade, and the
          alarm condition no longer occurs after an upgrade [mid1410].
        - 'Force' registration has been implemented to allow a spot to be
          played, even if it has not yet been registered.  The 'force' will
          allow playback and will register the file.
        - Corrected a condition where file registration did not properly
          identify the audio codec.

    14) STC Synchronous playback (STCBEACON) has been modified to allow more
        accurate and consistent synchronization.  The slave sync limit is now set
        to lock at  +/- 50 PTS clocks, and the slaves will re-sync if the
        difference is greater than +/- 500 PTS clocks.  The legacy STC Synchronous
        limits are +/-500 PTS clocks and +/- 3000 PTC clocks.

    15) The LIST command has been modified as follows:
        - LIST LOAD now returns the correct spot information [mid1683].
        - If the REPEAT option is set to ALL, the system will check for
          a modified smil file when the list rolls back to the first spot  If the
          active LIST smil file has been modified, the list will be reloaded
          before the first spot is played.
        - When a list is reloaded, the event will be logged.
        - When the system boots, the initially loaded list is now added to the log.
        - If a list is very large, the system will now report back the entire
          list when the LIST or LIST LOAD commands are issued.  Previous releases
          would not return the entire set of list entries.

    16) The multicast receive (decode) system is now more robust.  The decoder can
        continually play streams up to 20 mbps.  The start and stop logic for
        multicast has been changed to incur less false starts.  Multicast will fall
        back to the local LIST when it is stopped or the stream is interrupted.

    17) The SCHEDULE command will now display the currently loaded schedule file.
        The command no longer returns multiple OK responses.

    18) The decoder's TRANSPORT command was modified as follows:
        - The status has been updated to be more descriptive of the current
          transport status.  For instance, while indexing is active, the
          transport status will be "indexing".
        - The size, duration and percent played data was not correct for very large
          files [mid1812].
        - The TRA now reports the bitrate and time active if the system is receiving
          a multicast.  The time active is reset each time the stream is started.

    19) Several commands were updated to conform to the standard API format.  These
        commands include NIP, IP, TRACE and SPW.  In some cases, the incorrect
        API format would cause mediaControl to report a communication loss.

    20) The browser access for the unit has been updated to display consistent
        images.  Added pages for new commands (INDEX, PAUSE, etc) to the API
        document.  The browser pages may be accessed by using a web browser and
        setting the address bar to the unit's IP address.

    21) Command SVUSERPASSWORD has been changed to SVRUSERPASSWORD to maintain
        compatibility with the legacy systems.

    22) Added new decoder transport commands INDEX, REWIND, NEXT, PREVIOUS and
        PAUSE. Please refer to the API document for details.

    23) Several modifications were made to allow more efficient use of system
        resources.

    24) The TIMEZONE (TIZ) default has been changed from 0 to EST-5EDT.

    25) The log system (TRACE) no longer reports broken links when a telnet session
        is terminated since this is a normal condition when telnet is closed.

    26) The timeout for NTP response has been increased to 10 seconds from 1 second
        to prevent inadvertent NTP alarms.

    27) FTP and MIRROR processes have been updated as follows:
        - Command HOSTMODE now accepts upper and lower case arguments.
        - FTP now uses a temporary file for downloads.  This prevents file
          contention when an actively playing spot is also being updated by FTP.
        - FTP is now fully large file compatible.
        - Removed extra OK response for FTP command.
        - Temporary file '.listing' is now removed when the mirroring is completed
          using the DONOTREPLACEMPEG=YES option.

    28) FTP login access has been changed. The system root login is no longer
        accepted by FTP.  Please use "adtec, none" as the userid and password.

    29) The telnet API port (23) and the system telnet port (43) will no longer
        accept the system root login.  Please use "adtec, none" as the userid
        and password for access to any telnet session.

    30) Command SVUSERPASSWD now functions correctly.  This command can be used
        to change the password for user 'adtec'.  Please note that the password
        will change for all user 'adtec' accesses, including FTP, telnet port 23,
        and telnet port 43.

    31) The FTP port will now default to 21.  All newly manufactured systems
        will use the new default port 21.  Existing systems that use port 79
        will maintain that setting unless it is changed using the FTPCMDPORT
        command.

    32) The file system folders have been reorganized to allow the user to
        omit the path name when running a PLAYSPOT, OSD, RUN, LIST or SCHEDULE
        command.  If no path is argued, the system will use default paths.  If
        a path is argued, the system will use the argued path instead of the
        default path.  When a DIR, LIST, SOD or SCHEDULE command is run, the
        system will display the path that is being used (either the default path
        or the argued path).

        The local hard drive is now shown in /media/hd0.  Previous releases
        used the location /mnt/hd/media.
        The new default folders are as follows:
        Media:     /media/hd0/media
        DVC files: /media/hd0/dvc
        Lists:     /media/hd0/list
        OSDs:      /media/hd0/osd
        Log files: /media/hd0/log

        Some additional default directories have been added that will be
        used in future system enhancements.

        NOTE: When the 2.01.10 version is installed, an automatic process will be
              run once to convert the files from the directory structure used in
              version 1.03.15 to the new directory structure.  This includes the
              movement of files to new directories and an update of path names
              within the smil and dvc files.

    33) Browser access to the unit is now supported.  The unit's web site will
        display the currently installed firmware release and includes Adtec contact
        and support information, a quick start guide, datasheets and the full API
        document.  The web browser can be accessed by entering the unit's IP
        address in a browser address bar.

    34) Updated Linux operating system that includes many enhancements for better
        performance and higher reliability.

    35) The API comments for the IPA command have been updated.

    36) Added SPDIFMODE (SPD SJ) command to allow the user to specify a
        format for the SPDIF output.  This allows an encoded Dolby 5.1
        bitsream to be sent directly to an external system for decoding.
        Please see the API documentation for more details.

    37) Added command SHELLCMD (CMD CD) to allow Linux commands (such as
        ls and cat) to be run directly from the API command line.  This is
        an advanced option and should be used only by users knowledgeable
        with the Linux operation system.  See the API document for more
        details.

    38) Command UNITS will now work properly with a Windows Telnet session.

    39) Corrected the default configuration settings for the MCN command.

    40) Corrected MMO command to write valid information when updating the
        configuration file.

    41) Added automatic registration for file types 'dvc' and 'smil'.  The
        DIRECTORY command will now categorize dvc files as schDVC, lstDVC,
        cmdDVC or parDVC.  Lists are categorized as 'smil'.

        DVC files no longer have to follow specific capitalization rules.  The
        prefix and extension are no longer required to be uppercase.
        For example, .DVC, .dvc, .dVc are acceptable extensions and CMD, cmd,
        CmD are acceptable prefixes.

        The AUTO dvc files still require specific capitalization.

        If no extension is argued for a RUN command (EG RUN cmdxxx), the system
        will find the file if the name uses an uppercase DVC for the
        extension.

    42) A new error message has been added to indicate if a file name
        is not registered, "File is not registered".  The terse error
        message is 216.

    43) The system daemon (SYSD) will no longer exit if it fails to detect or
        initialize a valid external device (such as a decoder).  SYSD will remain
        active, so that the system does not become inoperable.  The failure
        will be added to the log file.

    44) The real time clock is now fully functional, and will retain the correct
        time during system resets. [mid914]

    45) The logging process was changed to prevent possible system failures.

    46) A space was inserted in the log message between the log ID and the
        message text.  The space was inadvertently removed in release 1.03.13.

    47) The menu system now parses error messages correctly.  This allows the
        log to show the correct error message for menu system log entries.

    48) The SCHEDULE date format was incorrect.  The format has been changed
        to: DAYOFTHEWEEK MONTH/DAYOFMONTH/YEAR HOUR:MIN:SEC COMMAND
        The old format had the MONTH and DAYOFMONTH reversed.  The API has
        also been updated with the correct format.

    49) The OSD processing was updated to detect and handle timeout conditions.

    50) The OSD process was updated to prevent a conflict that could cause the
        decoder to stop functioning properly.

    51) Several changes were made in the decoder system to increase decoder
        reliability.

    52) Multicast receive has been changed to auto detect encoding standards and
        PIDs.  The multicast system has the following limitations:
        - Does not detect the number of audio channels, defaults to 2 (stereo).
        - Multicast tune time is about 2 seconds.

    53) Multicast will now start playing at system startup, if enabled. [mid1288]

    54) The PCR PID is now used when assigning parameters for multicast receive.

    55) Improved playback of streams with H.264 (AVC) video.

    56) Magenta hues during startup and video (display target) changes have been
        eliminated.

    57) Program streams will now play Dolby audio. [mid1004]

    58) The STOP command will now respond immediately if issued near the end of a
        low bitrate clip. [mid833]

    59) The REPEAT and VIDEOTYPE terse commands (RP and VT) now function properly.
        [mid1565]

    ================================================================================
    NOTE:  THE FOLLOWING HARDWARE 1 NOTES ARE FOR REFERENCE ONLY.  WITH THE UPDATE
           TO HARDWARE vERSION 2, SOME OF THESE ITEMS MAY NO LONGER BE APPLICABLE.
    ================================================================================

    --------------------------------------------------------------------------------
    Version 1.03.15, January 5, 2007. GMC
    --------------------------------------------------------------------------------
    1)  This release will be required to be installed as a prerequisite for the next
        release.  The next release will contain an updated Linux operating system,
        and the VERSION command has been modified in this release to allow the
        upgrade to function properly.

    2)  Several changes were made to the release upgrade process to make the upgrade
        process more reliable.

    --------------------------------------------------------------------------------
    Known Issues for Version 1.03.12, October 6, 2006. GMC
    --------------------------------------------------------------------------------

    1) A/V sync may not always be accurate.

    3) Confidence decode does not always show the last frame of video until
       the next clip is started.

    4) Decoder may freeze during playback.  The system automatically detects the
       freeze and will reset the decoder board without forcing a full system reset.

    5) The IPA command is not compatible with the legacy IPA command. It now
       requires a 0 or 1 (IPA 0 192.168.22.23).  This will be changed to use 0 as a
       default if it is not argued in the command in a future release.

    6) As of this release, the BLANK, VIDEOLOOPMODE, OSD, OVS, STC Beacon
       and multicast functionality has not been ported to the mediahub.

    --------------------------------------------------------------------------------
    Version 1.03.12, October 6, 2006. GMC
    --------------------------------------------------------------------------------

    1)  Fixed bug that could cause the end of a clip to be cut-off when
        transitioning to the next clip in a playlist.

    2)  Enhanced/corrected functionality of the timezone API command. [mid1142]

    3)  Previous days system logs are archived properly now. [mid1321]

    4)  Added new front panel system menu 'MIRROR MENU' that allows changing
        HOSTMODE, HOSTIPADDRESS, and CLTUSERPASSWORD.

    5)  Improvements to GATEWAYIPADDRESS command handling.

    6)  LIST LOAD no longer causes the system to crash when the playlist file is
        empty. [mid1183]

    7)  Units should no longer fail to function when there is no front panel
        hardware present (or if the front panel isn't working).

    8)  Schedule event log messages no longer append '^m' characters. [mid1312]

    9)  Modified SCH command responses to be properly formatted when using a Windows
        telnet client. [mid1312]

    10) The GIP command now properly returns 0.0.0.0 if no gateway is active.  It
        also has the ability to set the gateway address to 0.0.0.0.

    11) The front panel no longer shows garbage characters when the gateway is
        disabled (GIP=0.0.0.0). [mid1316]

    12) The TIMEZONE command has been updated to use standard +/- settings similar
        to legacy API.

    13) Changed behavior of playback from list such that when file registration
        related errors occur during the start of a clip, the transport will move on
        to the next file instead of trying the same file repeatedly.

    --------------------------------------------------------------------------------
    Version 1.03.11, Sep 14, 2006. GMC
    --------------------------------------------------------------------------------

    The main purpose of this release is to add system level enhancements such as
    scheduling, mirroring and ftp changes.  No changes were made to the decoder
    board firmware or encoder board firmware, although some improvements have been
    made for decoder transport control.

    Note: The following notes are an accumulation of applicable release notes from
          May 24, 2006 to September 14, 2006

    1)  Added API command DONOTREPLACEMPEG.  If this is set to YES, files of same
        name will not be mirrored regardless of timestamp.

    2)  API login(s) is/are now consistent with Linux console login(s).

    3)  Added API command SVUSERPASSWORD to allow reassigning login passwords.  Note
        that passwords cannot be viewed.

    4)  Added initial support for API command UNITS.

    5)  File registration now records audio language and private descriptors.

    6)  Added new option 'S' to the DIR command that will include H and V sizes in
        the directory listing.

    7)  Several functional updates and enhancements for mirroring.

    8)  Added support for LIST option 'PTR'.  See the API documentation for details.

    9)  Slight update of system and decoder front panel menus.

    10) Fixed bug in mirroring that caused an error when updating its configuration
        file.

    11) Changed time zone menu such that a user now selects his/her UTC offset from
        a list instead of having a free-form edit field.  This is an interim fix to
        ensure valid entries until a full implementation of timezone is available
        from the front panel menu.  The API TIMEZONE command can still be used to
        enter more specific timezone information.

    12) The RUN command reply has been corrected (take out space).

    13) There was a residual issue with the API VERSION command's DELETE option.  It
        should be corrected now. [mid1087]

    14) Playback should not freeze after changing display targets. [mid920]

    15) The TIMEZONE API command now reports the current time zone setting when
        issued with no arguments. [mid1085]

    16) Removed 1 second delay for decoder-specific API commands issued while the
        unit is idling. [mid1078]

    17) The system VERSION API command's DELETE option should work now. [mid1087]

    18) Added new TIME menu to the front panel's SYSTEM menu.

    19) The API command TIMEZONE now defaults to UTC if no value has been set.

    20) The front panel decoder menu is now labeled correctly, similar to the
        system menu.

    21) Fixed bug causing 'Error. Time Out' messages and eventual unit failure when
        on the Decoder Status menu. [mid1096]

    22) Time should now be changeable and NTP should work correctly. [mid1088]

    23) Missing folder/file dependencies no longer cause unit to become
        unresponsive. [mid1074]

    24) After a file plays using PLAYSPOT, the list to should now resume normally.
        [mid1083]

    25) Audio detection and identification should now be more robust overall in the
        file registration process.

    26) Fixed inconsistent network address edits from the front panel. [mid1047]

    27) Increased responsiveness of the DIRECTORY command.

    28) Implemented API command TIME to report system data and time.

    29) Implemented API command TIMEZONE for setting time zone.

    30) Implemented DELETE option for the system API command VERSION.

    31) Fixed bug in the LIST API command that didn't allow for '0' entries in
        the playlist. [mid1086]

    32) Diagnostic output capability has been removed until further notice.

    33) Changing INPUTAUDIOTYPE or VIDEOTYPE during playback should no longer
        affect current playback. [mid1025]

    34) Added TIME and TIMEZONE API commands.

    35) First-stage revamping of front panel menu navigation.

    36) Support for double-quotes on virtually all API command arguments, allowing
        spaces in filenames, etc.

    37) Changed the DIR command's audio type field widths to match. [mid1029]

    38) Executable files in the /mnt/hd/media folder are now registered.

    39) Stale/invalid file data is no longer displayed by the DIR command. [mid1036]

    40) Units will now return to their previous state (IDLE, PLAYING, etc.) after a
        PLAYSPOT file has completed. [mid1030]

    41) Corrected cause of error "mirror Daemon not starting in CCMS mode" during
        startup.

    42) Added .FEC download exclusion for mirroring. [mid986]

    43)  Changed RDY file output to "windows ascii" format.

    44) The TRANSPORT command has been updated per [mid990]:
        a) proper file registration information is displayed.
        b) proper file name displayed after issuing a PLAYSPOT command.

    45) The PLAYSPOT command now overrides current playback when issued.  Normal
        playback is resumed (multicast or file) once the indicated clip has played.
        [mid1009]

    46) Video-only and audio-only transport streams should play.

    47) Changed default playlist location to /mnt/hd/media/list (was
        /mnt/hd/media/schedule). This default is used for CFG clear. [mid991]

    48) There's no longer a slight delay before entry of password during login
        for telnet (port 23) sessions.

    49) The decoder alarm LED will now light RED when detected error conditions
        cause problems with playback.

    50) The video and audio LEDs now reflect the actual file content and only light
        if the video and audio are present, respectively.

    51) The audio and video LEDs no longer go out at the end of low bitrate clips.
        [mid840]

    --------------------------------------------------------------------------------
    Version 1.02.03, May 19, 2006. GMC
    --------------------------------------------------------------------------------

    1) Increased a timeout parameter to prevent the decoder from being reset when
       the system has a heavy workload.

    2) The system did not always wait for all data to be sent to the decoder
       before the decoder was stopped.  The decoder has also been updated to
       enable it to show the last frame of video in most cases.

    3) The transport system tracks errors and will go to a stopped state if the
       error count becomes too large. In previous releases, the transport would
       remain in an invalid state during error conditions.

    4) File Registration:
       File registration support has been added to automatically identify and
       classify media stream type, video type, and audio type.
       Directory "/mnt/hd/media" is continually checked, and any new spots are
       automatically registered.  Hidden files within /mnt/hd/media are not checked.
       The file registration results are used by the transport to verify that the
       spot is compatible with the decoder and will not play the spot if it is not
       compatible.  File registration allows the decoder to transition between
    spots
       with different characteristics (such as audio encode type) and automatically
       adjust to the changes.

    5) Added DIRECTORY (DIR) command to display registration data.  The command
       is based on the legacy DIR, however the output formats are different.
       Sample outputs are:
       DIR
       spts          mpeg2 -------- -------- 00:05:04.990  5.00 Mbps "timecode.mpg"
       spts          mpeg2 -------- layer2   00:00:30.090  8.00 Mbps "clip4.mpg"
       spts          mpeg2 layer2   -------- 00:00:29.940  3.35 Mbps "l1_32000.mpg"

       DIR u
       spts          mpeg2 -------- -------- "timecode.mpg"
       spts          mpeg2 -------- layer2   "clip4.mpg"
       spts          mpeg2 layer2   -------- "l1_32000.mpg"
       ------------- ----- -------- -------- "default_clip.smil"

       DIR s
       05/05/06 09:16    182.009 Mbytes spts          mpeg2 -------- --------
             00:05:04.990  5.00 Mbps "timecode.mpg"
       01/01/00 01:46     33.730 Mbytes spts          mpeg2 -------- layer2
             00:00:30.090  8.00 Mbps "clip4.mpg"
       05/15/06 00:19     12.012 Mbytes spts          mpeg2 layer2   --------
             00:00:29.940  3.35 Mbps "l1_32000.mpg"
       05/05/00 03:37      6.421 Mbytes program       mpeg2 layer2   layer2
             00:00:14.920  3.18 Mbps "pgm.mpg"setEch
       01/01/00 01:46     33.945 Mbytes spts          mpeg2 -------- layer2
             00:00:30.290  8.00 Mbps "clip1.mpg"

       DIR u s
       05/05/06 09:16    182.009 Mbytes spts          mpeg2 --------
             -------- "timecode.mpg"
       01/01/00 01:46     33.730 Mbytes spts          mpeg2 --------
             layer2   "clip4.mpg"
       05/15/06 00:19     12.012 Mbytes spts          mpeg2 layer2
             -------- "l1_32000.mpg"
       03/20/06 22:40      0.000 Mbytes ------------- ----- --------
          -------- "default_clip.smil"

    6) DUMPFREG (DFR) command was added to show the entire registration results for
       an argued file(s).  Please refer to the API documentation for more
       information.

    7) The PLAYSPOT command will now return an error message if the spot is not
       compatible with the decoder.  The new verbose and terse messages are:
         Verbose - "Mux type not supported" Terse- 209
         Verbose - "Video codec not supported" Terse- 210
         Verbose - "Audio codec not supported" Terse- 211
         Verbose - "Specified audio not found" Terse- 212
         Verbose - "Specified video not found" Terse- 213
         Verbose - "Specified file is not registered as media type" Terse- 214

    8) The IPA command now returns a correct terse mode response if the command
       was not successful.

    9) The decoder configuration default process did not properly reset the
       configurations.  This has been correct so that the proper values are
       displayed after a CFG command when the configuration values have been
       reset by the system.

    10) The AUDIOSTREAMID (AUI) command did not return a correct value when it
        was entered with no parameters.

    11) The RUN command has been added for DVC types CMD and SCH.  Please refer to
        the API document for more information.

    12) Scheduling capability has been added to the system.  The scheduling is
        based on the legacy Adtec scheduling processes  The SCHEDULE command is
        used to set up the schedule and support for running SCHAUTO.DVC at startup
        has been added.

    13) FTP Mirroring capability has been added to the system.  The mirroring is
        based on the Adtec legacy FTP mirroring process.  Several commands have been
        added to support mirroring, including: FTP, HOSTTIMER, HOSTIPADDRESS,
        HOSTMODE, CLTUSERPASSWORD, FTPCLIENTPASV, MIRRORLISTFILE, FTPTIMEOUT,
        FTPDATATIMEOUT.  Please refer to the Adtec API document for more
        information.

    14) The HOSTIPADDRESS command will now accept a command port as part of the
        argument. The updated command format is HIP nnn.nnn.nnn.nnn:pppp, where
        pppp = command port number.  The port argument is not is not required.

    15) The RESET command is now functional in the Adtec API interface. Please
    refer
        to the API document for more information.

    16) The command listener application has been modified to be more robust.
        Connection logins no longer block other logins.  Telnet sessions no longer
        require CRLF terminations.  Any combination of CR, LF, or both will work.
        The registration process properly handles multiple registration requests
        from the same process.  Echo requirements were changed to provide for
        generic echo handling.

    17) The application architecture has been converted to reduce the workload in
        the system and to improve messaging throughput between tasks.

    --------------------------------------------------------------------------------
    Version 1.02.02, April 18, 2006. GMC
    --------------------------------------------------------------------------------

    1) The NTP Daemon is now properly initialized, and NTP now functions on the
       mediaHUB.

    2) The decoder menu options were changed to reflect mediaHUB functionality.
       The video options have been restricted to options that are available on the
       mediaHUB.

    3) The encoder menu has been modified to show the status of the encode.

    4) The VERSION script was not executable, that has now been corrected.

    5) The network default options are now properly initialized.

    --------------------------------------------------------------------------------
    Version 1.02.01, April 11, 2006. GMC
    --------------------------------------------------------------------------------

    Confidence Decoder Changes-

    1)  Implemented rudimentary LED status for decoder.

    2)  Added support for NTP.  This is configurable from the front panel.

    3)  When a decoder freeze is detected, the system will reset the decoder board
        without forcing a full system reset.  During the decoder reset, the
        decoder alarm LED is red, and any API commands will receive a "Hardware
        not available" response.  The terse response error number is 550.
        An dma freeze error message was added: Decoder Dma timeout (terse form:545).
        This error is sent when the decoder process detects no activity in the
        dma data transfer.  Generally this error will result in an automatic decoder
        board reset.

    4)  When the decoder configuration is cleared, the system will use the 'default'
        settings for each configuration option.  This will prevent conflicts
        between the Soloist HD4111 reset values and the mediaHUB decoder reset
        values.

    5)  When the STOP command is issued from the API, the decoder will stop
        immediately without waiting for buffers to empty.  This allows a more
        immediate response to the STOP command.  When a 'normal' stop condition is
        reached at the end of a PLAYSPOT or LIST, the buffers are allowed to drain
        so that nearly the entire clip is decoded (see unresolved issue #3).

    6)  The terse form of the LIST command was incorrect(LS).  The legacy terse form
        is LI and the terse form of the command has been changed to LI.

    7)  The VIDEO command now accepts 'terse' arguments.  For instance, "VID NTSC"
        command can now be argued as VID 1.

    8)  Modified decoder BANNER command to allow multiple lines for the verbose
        response. The new reply more closely resembles the legacy BANNER reply.  The
        updated standards for the BANNER command replies are:
          Terse:   mediaHUB v1.02.01
          Verbose: Adtec Digital mediaHUB Studio Encoder
                Version v1.02.01
                Adtec Digital, Inc. (c) 2006

    9)  Changed command name AUDIOTYPE to INPUTAUDIOTYPE due to terse name
    conflicts.
        The new command format is:
          INPUTAUDIOTYPE/IAT/IA [argument]
          The arguments are:
             DEFAULT, AC3_20, MPEG_L1, MPEG_L2, AAC0_20, AAC1_20, AAC2_20, WMA,
             WMAPRO_2, LPCM, PCM ,DVD ,DTS_20

        Note: Only DEFAULT, AC3_20, MPEG_L1, MPEG_L2 and LPCM are valid for the
              mediaHUB decoder.

    10) The Soloist HD4111 and the mediaHUB now share much of the same code base.
        As new commands and features are added, they will generally become available
        for both systems.  For instance, MMO, MRI and MRP are now available in the
        mediaHUB, even though they would not be used for a studio encoder system.

    12) The decoder now supports the VIDEO command.  PAL mode and NTSC_J mode are
        both available.  The NTSC_J black level has not been verified on an
        oscilloscope, but the values used are the default values from the DENC
        manufacturer.  This fix references Mantis issues #632 and #762.

    Encoder Changes-

    1) Added a confidence decode start configuration option. The default value is 3
       seconds.  This option is not yet kept as a persistent configuration option
       and must be reset after each system boot.  This fix references Mantis issue
       #604.
         The command name is:
           CONFDECODESTART/CDS/CD [OFF | seconds]

           Note:    Setting this configuration to "OFF" disables confidence
                    decoding.  Seconds should be greater than or equal to 0.
           Warning: If the encode is shorter than seconds, confidence decode will
                    not start.

    2) The encode writes directly to the specified file, and no longer uses a
       temporary default.mpg to capture the encode.  This fix references Mantis
       issue #618 and #817.

    3) Added some validity checks to the specified encode file name.

    4) The encode process will not fail and exit if the decoder process does not
       respond to the decoder start command.  Prior to this fix, the encode process
       would fail and stop running if the decoder process was not active.

    5) The timeout for interprocess communication was raised from 1 second to 5
       seconds.  Under some system loads, the interprocess communication would
       timeout.

    6) Encoder API commands are now 'case insensitive' for most options.  The
       capture file name is still case sensitive.

    7) The default configuration settings were changed to valid options.

    8) The configuration file is saved at startup.  If no configuration file exists,
       the system will now successfully create a new file using the default options.
       [mid901].

    9) The encoder's audio level setting (ALV) should be set to 55, not 50, to
       achieve encodes at 0 dB. The mediaHUB GUI has been modified to use 55 for a
       0 dB encode.

    General changes-

    1) Added large file support (greater than 2 GB) for encoding, decoding and FTP.
       [mid695].

    2) NTP is now supported.  The NTP configuration can be updated from the front
       panel, or by using the NIP command.

    3) The command listener startup script can now be configured to disable com2 or
       telnet.  This is not a 'user' setting, but is included in the release notes
       for information purposes.

    4) The operation of the front panel has been significantly improved.  The
       drivers have been modified to be more robust and communication errors have
       been greatly reduced.  Support for multiple key press special functions was
       added.  If multiple keys are pressed at once, the auto repeat function is not
       used, and the keys are always set to the on state.

    5) The system daemon (sysd) now supports requests to reset and reinitialize
       external boards (such as decoders and encoders).  This was added to allow the
       system to recover when an external board stops functioning properly and needs
       to be reset.  The result of the reset is sent back to the requestor so that
       the external board can be reactivated after the reset.

    6) The directory structure and scripts for all systems (mediaHUB, DPI and
       Soloist HD4111) have been changed to allow more robust firmware upgrades.
       This change also enables more efficient testing methods for the developers,
       and provides a framework for release building.  The updated system structure
       has been named 'NimbleForest'.

    7) Continued to add log message IDs to the systems for use in diagnostics.

    8) Added MRI, MMO, MRP and MTU commands.  These commands have the same command
       arguments as their legacy counterparts with one exception.  The Gem platform
       may contain multiple ethernet interfaces (eth0 and eth1) and the multicast
       can be set up for either interface.  A 'new' api format has been designed to
       maintain compatibility with the old format.
       New command format example:
         Command "MRI eth0 239.10.10.10" will set up ethernet port eth0.
         Command "MRI eth1 239.10.10.10" will set up ethernet port eth1.
         Command "MRI 239.10.10.10" will default to set up ethernet port eth0, and
                 this is compatible with the legacy command format.

       The verbose response will include the eth0 or eth1 port info, however, the
       terse response will not include the eth0 or eth1 information.  This allows
       the response to maintain compatibility with the terse legacy response format.

       NOTE:  These commands do not apply directly to the use of an mediaHUB as a
              studio encoder, but are available if the user desires to receive a
              multicast to the mediaHUB's decoder.

    --------------------------------------------------------------------------------
    December 15, 2005. JPT
    --------------------------------------------------------------------------------

    1) Added TRACKSELECT, VIDEO, INPUTAUDIOTYPE, and AUDIOSTREAMID commands to
       decoder.

    2) STOP command now clears DMA to decoder which ends data flow quicker.

    3) Implemented rudimentary LED status for decoder.

    4) Corrected error in ECAPT diagnostics causing garbage in the label.

    5) Default value for "decode start seconds" is 3. Previously, it had been OFF.

    6) Added CONFDECODESTART command to encoder.

    7) Added command handlers for IPADDRESS, IPMASK and GATEIPADDRESS which
       "forward" these commands to the system command handler. This was necessary
       because the menu system will not send queries directly to the system command
       handler.

    8) Modified command dispatcher to handle "empty" commands, properly returning a
       terse okay ("0").

    9) Corrected timer error causing early timeouts. This corrects issues with
       encoder board communication receiving bad or no replies.
Created By: Adtec Digital Inc