SVDRP

Материал из RuVDRWiki

Перейти к: навигация, поиск

Содержание

Введение

Simple VDR protocol (SVDRP) позволяет с помощью простого соединения по TCP через порт 2001 посылать простые комманды в VDR, например для отображения простых текстовых сообщений на экране телевизора или простого удалённого администрирования. Прежде чем сделать первую попытку соединения надо разрешить соединения для клиентской машины.Это происходит через прописывание разрешенных клиентов в файле svdrphosts.conf. Учетная запись выглядит так

IP-Address[/Netmask]

Т.е. каждая строка обозначает одно "разрешение". Можно прописывать не только отдельные адресса, но и целые сетевые сегменты. Например запись 192.168.1.0/24 позволит всем клиентам из сегмента 192.168.1.х подключение к SVDRP-порту

Комманды

Обозрение

CHAN CLRE DELC DELR DELT EDIT
GRAB HELP HITK LSTC LSTE LSTR
LSTT MESG MODC MODT MOVC MOVT
NEWC NEWT NEXT PLAY PLUG PUTE
SCAN STAT UPDT VOLU QUIT

Описание

[]
>= 1.3.31
CHAN [ + | - | <Номер> | <Название> | <ID> ]
Переключает канал вверх,вниз или перепрыгивает к номеру канала,названию канала или к ID канала.Без параметров или после переключения канала покажет номер и название актуального канала.
CLRE
Удаляет данные EPG.
DELC <Номер>
Удаляет канал.
DELR <Номер>
Удаляет запись с указанным номером.Узнать номер записи можно командой LSTR. После удаления записи, номера записей не изменяются.

ВНИМАНИЕ: ЗАПИСИ УДАЛЯЮТСЯ без ПРЕДУПРЕЖДЕНИЯ!

DELT <Номер>
Удаляет таймер.
EDIT <Номер>
Edit the recording with the given number. Before a recording can be edited, an LSTR command must have been executed in order to retrieve the recording numbers.
GRAB <Название файла> [ jpeg | pnm [ <Качество> [ <Ширина> <Высота> ] ] ]
Сохраняет актуальное телевизионное изображение в JPEG или PNM-формате.При использывании JPEG можно указывать качество (стандартно: максимальное),ширину и высоту (стандартно:полный экран).
HELP [ <Название> ]
Помощь.
HITK [ <Кнопка> ]
"Нажимает" кнопку ДУ.Без параметра перечисляются названия всех допустимых кнопок.
LSTC [ <Номер> | <Название> ]
Без параметра перечисляются все каналы.При использывании номера, перечислит только введённый канал.При использывании названия,перечисляются все каналы с указанным названием.

К описанию формата смотри Syntax_channels.conf

LSTE [ <Канал> ] [ now | next | at <Время> ]
Без параметра выводятся все данные EPG.Если указывается <канал>(либо номер,либо ID канала), тогда показываются данные EPG только выбранного канала. 'now, 'next' 'at <time>' являются фильтрами
LSTR [ <Номер> ]
Без параметра перечисляются все записи.Если указывается <номер> записи,тогда показывается вся инфа о данной записи.
LSTT [ <Номер> ]
Без параметра перечисляются все таймеры, иначе только указанный <номером> таймер.
MESG [ <Сообщение> ]
Показывает на экране телевизора сообщение о OSD.Без параметра показывает актуальное сообщение (если такое имеется).Как только OSD станет доступным, сообщение будет показано на пару секунд,если прежнее сообщение ещё не могло показаться, то оно будет переписано.
MODC <Номер> <Установки>
Изменяет установки канала.Формат <установок> должен быть одинаковым с форматом команды LSTC.
MODT <Номер> on | off | <Установки>
Изменяет таймер.Формат <установок> должен быть одинаковым с форматом команды LSTT.С 'on' и 'off' можно включать и выключать таймер.
MOVC <Номер> <после>
Перемещает канал на <после> в списке каналов.
MOVT <Номер> <после>
Перемещает таймер на <после> в списке таймеров.
NEWC <Установки>
Создаёт новый канал.Формат <установок> должен быть одинаковым с форматом команды LSTC.
NEWT <Установки>
Создаёт новый таймер.Формат <установок> должен быть одинаковым с форматом команды LSTT

Пример <установок>:

1:19:5:2010:2150:51:50:Das Gelbe vom Ei:
active:channel:day_of_month:starttime:endtime:priority:durability:title:

day_of_month может иметь при этом следующие форматы:

19
2005-03-19
MTWTFSS
MTWTFSS@19
MTWTFSS@2005-03-19
NEXT [ abs | rel ]
Показывает следующий таймер.Без параметра показывает в разборчивом формате.С параметром 'abs' абсолютное время указывается в секундах,в то время как при параметре 'rel' с данного момента до начала записи в секундах.Первое выведенное значение означает номер таймера.
PLAY <number> [ begin | <position> ]
Play the recording with the given number. Before a recording can be played, an LSTR command must have been executed in order to retrieve the recording numbers. The keyword 'begin' plays the recording from its very beginning, while a <position> (given as hh:mm:ss[.ff] or framenumber) starts at that position. If neither 'begin' nor a <position> are given, replay is resumed at the position where any previous replay was stopped, or from the beginning by default. To control or stop the replay session, use the usual remote.
PLUG <name> [ <command> [ <options> ]]
Send a command to a plugin. The PLUG command without any parameters lists all plugins. If only a name is given, all commands known to that plugin are listed. If a command is given (optionally followed by parameters), that command is sent to the plugin, and the result will be displayed. The keyword 'help' lists all the SVDRP commands known to the named plugin. If 'help' is followed by a command, the detailed help for that command is given. The keyword 'main' initiates a call to the main menu function of the given plugin.
PUTE
Вводит данные EPG.Отдельная точка в строке оканчивает ввод данных и заботится о дальнейшей обработки данных, которые до этого временно сохранялись.
SCAN
Запускает сканирование EPG.На системах только с одной DVB картой, сканирование будет проводиьтся на этой карте, если в данное время не ведётся запись (доступно с версии 1.3.x).
STAT disk
Предоставляет сведения о потреблении места на жестком диске.
UPDT <Установки>
Обновляет таймер.Формат <установок> должен быть одинаковым с форматом команды LSTT.
VOLU [ <Номер> | + | - | mute ]
Устанавливает громкость либо непосредственно (рабочии значения от 0 до 255) или постепенно. С 'mute' выключает полностью звук.Без параметра показывает актуальную громкость.
QUIT
Заканчивает подключение с VDR (SVDRP).Альтернативно можно также нажать на CTRL-D.

Возвращаемые коды

214 Текст справки
215 Внесение EPG
216 Image grab data (base 64)
220 VDR-Service готов
221 VDR-Service закрывает канал передачи 
250 Затребованная акция ОК, закончена
354 Запуск передачи данных EPG
451 Затребованная акция прекращена: локальная ошибка во время обработки
500 Синтаксическая ошибка, неизвестная команда
501 Синтаксическая ошибка в параметре или аргументе
502 Команда не реализовывана
504 Параметр команды не реализовыван
550 Затребованная акция не выполнена
554 Трансакция не удалась

Ответы имеют следущий формат:

<Возвращаемый код><-|Пробел><Текст><newline>

Пример:

help
214-This is VDR version 1.3.11
214-Topics:
214-    CHAN    CLRE    DELC    DELR    DELT
214-    GRAB    HELP    HITK    LSTC    LSTE
214-    LSTR    LSTT    MESG    MODC    MODT
214-    MOVC    MOVT    NEWC    NEWT    NEXT
214-    PUTE    SCAN    STAT    UPDT    VOLU
214-    QUIT
214-To report bugs in the implementation send email to
214-    vdr-bugs@cadsoft.de
214 End of HELP info

Замечания

VDR может вести только одно соединение/нить к SVDRP,поэтому в это время Vdradmin не доступен, так как тоже использует SVDRP.

Опции

Параметр Описание
-d hostname destination hostname (default: localhost)
-p port SVDRP port number (default: 2001)

Приложения/Расширения/Примеры

Личные инструменты
На других языках