Adtec API Help

# LIST LST LI ## Description:
      Displays or changes the current playlist. The list contains the name of the list, the current
      list pointer position (shows which spot is currently playing, or if the transport is stopped,
      the spot that will play when the PLAY command is issued) and the spots in the list.  The
      verbose form of the command also shows the characteristics of each spot.  The characteristics
      are the same as the DIR S command verbose output.
## Form:
      Command Handler: DCMD
      <NAME.DEST> LIST|LST|LI [ARGUMENT]
      DEST Argument:
      DCMD            Decoder Command System
      Argument List:
      Terse    Verbose          Description
       none    CLEAR            Clears the list.
       none    LOAD filename    Loads the specified list file into the system
                                filename example: playlist.smil.
       none    PTR  <INDEX>     Change the pointer to the argued index.
       none    ADD  <SPOTNAME>  Add SPOTNAME to the end of the current list.
       none    ADDM <SPOTNAME>  Add SPOTNAME to the end of the current list.
       none    SAVE             Saves volatile list to non-volatile memory.
## Response:
      MODIFY LIST RESPONSE
        Verbose- "OK\r\n" to acknowledge receipt of command, or
                 "ERROR- [Description]\r\n" if error, ending command
        Terse-   "0\r\n" to acknowledge receipt of command, or
                 "[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
        "\r\n" concludes modify responses (empty line)

      DISPLAY LIST RESPONSE
        Verbose- "OK\r\n" to acknowledge receipt of command, followed by
                 "List pointer is m, n program(s) in the list\r\n", or
                   "ERROR- [Description]\r\n" if error, ending command
        Terse-   "0\r\n" to acknowledge receipt of command, followed by
                 "[TERSE NUMERIC VALUE]\r\n", or
                 "[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
        "\r\n" concludes display responses (empty line)
## Examples:
      Verbose command to retrieve current setting:
      *.DCMD LIST <enter>
         Response is: OK\r\n
                      "/mnt/hd/media/list/test.smil"\r\n
           1- 04/05/06 19:58     13.703 Mbytes spts      mpeg2 dolby_ac3    layer2\r\n
                00:00:29.990  3.75 Mbps "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam\r\n
                  Ch2.mpg"\r\n
           2- 04/05/06 19:58     13.703 Mbytes spts      mpeg2 dolby_ac3    layer2\r\n
                00:00:29.990  3.75 Mbps "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam\r\n
                  Ch2.mpg"\r\n
                      List Pointer is 1, 2 program(s) in the list\r\n
                      \r\n

      Terse command to retrieve current setting:
      *.DCMD LI <enter>
         Response is:
                   0\r\n
                   0000\r\n
                   "/mnt/hd/media/list/test.smil"\r\n
                   "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam Ch2.mpg"\r\n
                   "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam Ch2.mpg"\r\n
                   \r\n

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

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

      Verbose command to change the pointer index in the list:
      *.DCMD LIST PTR <2> <enter>
         Response is: OK\r\n

      Terse command to change the pointer index in the list:
      *.DCMD LI PTR <2> <enter>
         Response is: 0\r\n

      Verbose command to add a spot to the end of the list:
      *.DCMD LIST ADD <SPOT.MPG> <enter>
         Response is: OK\r\n
                      "/mnt/hd/media/list/test.smil"\r\n
           1- 04/05/06 19:58     13.703 Mbytes spts      mpeg2 dolby_ac3    layer2\r\n
                00:00:29.990  3.75 Mbps "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam\r\n
                  Ch2.mpg"\r\n
           2- 04/05/06 19:58     13.703 Mbytes spts      mpeg2 dolby_ac3    layer2\r\n
                00:00:29.990  3.75 Mbps "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam\r\n
                  Ch2.mpg"\r\n
           2- 04/05/06 19:58     13.703 Mbytes spts      mpeg2 dolby_ac3    layer2\r\n
                00:00:29.990  3.75 Mbps "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam\r\n
                  SPOT.MPG"\r\n
                      List Pointer is 1, 3 program(s) in the list\r\n
                      \r\n

      Terse command to add a spot to the end of the list:
      *.DCMD LI ADD <SPOT.MPG> <enter>
         Response is:
                   0\r\n
                   0000\r\n
                   "/mnt/hd/media/list/test.smil"\r\n
                   "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam Ch2.mpg"\r\n
                   "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam Ch2.mpg"\r\n
                   "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam SPOT.MPG"\r\n
                   \r\n

    Verbose command to save the list to non-volitile memory:
      *.DCMD LIST SAVE <enter>
         Response is: OK\r\n
                      "/mnt/hd/media/list/test.smil"\r\n
           1- 04/05/06 19:58     13.703 Mbytes spts      mpeg2 dolby_ac3    layer2
                00:00:29.990  3.75 Mbps "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam
                  Ch2.mpg"\r\n
           2- 04/05/06 19:58     13.703 Mbytes spts      mpeg2 dolby_ac3    layer2
                00:00:29.990  3.75 Mbps "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam
                  Ch2.mpg"\r\n
           2- 04/05/06 19:58     13.703 Mbytes spts      mpeg2 dolby_ac3    layer2
                00:00:29.990  3.75 Mbps "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam
                  SPOT.MPG"\r\n
                      List Pointer is 1, 3 program(s) in the list\r\n
                      \r\n

      Terse command to save the list to non-volitile memory:
      *.DCMD LI SAVE <enter>
         Response is:
                   0\r\n
                   0000\r\n
                   "/mnt/hd/media/list/test.smil"\r\n
                   "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam Ch2.mpg"\r\n
                   "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam Ch2.mpg"\r\n
                   "/mnt/hd/media/mediahub Vod Ac3 Ch1 Mcam SPOT.MPG"\r\n
                   \r\n
## Notes:
      The legacy ADDM command option is not currently implemented where it will
      accept multiple spots as arguments. The legacy ADDM however will work
      identically to the legacy ADD command where it will add the single argued
      spot to the end of the currently loaded list.

      The legacy PTR command option currently does not give the location of the
      index in the currently loaded list. Use the list command to find the location
      of the index. Use the PTR option to set the pointer to a new index only. The
      new pointer location will take effect when the currently playing spot is
      finished.

      Several LISTs can exist on the same unit.  They are stored in the
      /mnt/hd/media/list directory and can be loaded at any time by using the
      "LIST LOAD filename" command.  All list file names use the 'smil' extension.
      It is important to note that the default location for a list file, if only a
      file name is argued, is /mnt/hd/media/list.

      The filename may contain spaces if the filename is surrounded by double quotes.
      Valid command format:
      LIST LOAD "test clips.smil"
      Invlaid command format:
      LIST LOAD test clips.smil
## Products Supporting Command: mediaHUB mediahub-hd SoloistHD4111 edjeHD4111 signEdjeHD SoloistHD Pro Created By: Adtec Digital Inc