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.
none ADD _INVENTORY_ "_INVENTORY_" is a special entry to play random
local content. See Notes below.
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/hd0/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/hd0/media/list.
The filename may contain spaces if the filename is surrounded by double quotes.
Valid command format:
LIST LOAD "test clips.smil"
Invalid command format:
LIST LOAD test clips.smil
INVENTORY Plaback is an experimental special LIST entry with the name
"_INVENTORY_" (without quotes and case sensitive). This can be used in a LIST
alone or with other items in a LIST. Only media type items are randomly selected
for this initial implementation. All media items will play once before a new
randomized sequence is generated.