Сервис RDS. Настройка¶

Настройка сервиса производится при помощи конфигурационного файла rds_server/server.xml, расположенного в инсталляционной директории сервиса.

Если данного каталога в инсталляционной директории нет, его необходимо создать.

В файле описывается последовательность действий, производимых с данными (к примеру, загрузка при помощи LOAD_XML, затем применение преобразования PARSE_XSL, сохранение и отправка на кодер с SAVE_DST_RDS_DEVICE), а также атрибуты отображения информационной строки на экране (длительность показа или число повторений бегущей строки). Подробное описание параметров настройки сервиса и их атрибутов вы найдете далее. Редактирование конфигурационного файла производится в любом текстовом редакторе. Параметры RDS задаются в XML-формате; после открывающей угловой скобки следует название параметра, затем атрибуты и их значения в виде:

<ПАРАМЕТР АТРИБУТ1=’ЗНАЧЕНИЕ1’ АТРИБУТ2=’ЗНАЧЕНИЕ2’ />

Перечисление атрибутов заканчивается закрывающей угловой скобкой. Сервис RDS чувствителен к регистру букв в конфигурационном файле.
После редактирования и сохранения конфигурационного файла необходимо перезапустить сервис, чтобы внесенные изменения вступили в силу.

Описание используемых тэгов XML и параметров¶

RDS_SERVER¶

RDS_SERVER – позволяет указать параметры работы сервера RDS. Доступные атрибуты:

1. PERIOD - период обновления из конфигурационного XML файла (в секундах);
2. RETRY - таймаут подключения к устройству после ошибки;
3. RDS_DEVICE – тип используемого RDS-кодера (UECP - для всех устройств с протоколом UECP, или ORBAN - для процессора Orban 5500i);
4. CONNECT_TYPE – тип подключения к кодеру, по TCP или COM-порту (COM, TCP_CLIENT);
5. CONNECT_PARAMS – параметры подключения:
   1. ‘port=4 baud=9600 parity=N data=8 stop=1’ - для подключения через COM-порт.
   2. ‘IP=192.168.0.38 PORT=6666’ – для подключения по TCP.
6. CONNECT_PROTOCOL – используемый протокол работы с кодером (UECP, ORBAN. Устаревшие значения: CO4DSP_UECP, CO4DSP_TERMINAL - больше не поддерживаются);
7. SITE – номер сайта кодеров RDS, по умолчанию 0 - все сайты;
8. ENCODER – номер кодера RDS, по умолчанию 0 – все кодеры;
9. DS – номер набора данных кодера, по умолчанию 0 – текущий набор данных;
10. PSN – номер выбранного набора данных, по умолчанию 0 – текущий PSN.
11. MAX_DURATION - указывается максимальное значение для ограничения duration в тегах RT, DRT, CMD, STR. Рекомендуется не задавать большие значения, так как может привести к неожидаемым результатам.
    Если не объявлять атрибут, значение по умолчанию равно 7200 секунд.

Примеры открывающего тэга RDS_SERVER:

кодер с UECP протоколом, поддерживающий протокол TCP/IP в качестве транспортного:

<RDS_SERVER RDS_DEVICE='UECP' CONNECT_TYPE='TCP_CLIENT' CONNECT_PARAMS='IP=192.168.0.38 PORT=6666' CONNECT_PROTOCOL='UECP' PERIOD='3600' RETRY='30' >

кодер с UECP протоколом, подключенный через реальный COM-порт:

<RDS_SERVER RDS_DEVICE='UECP' CONNECT_TYPE='COM' CONNECT_PARAMS='port=4 baud=9600 parity=N data=8 stop=1' CONNECT_PROTOCOL='UECP' PERIOD='3600' RETRY='30' >

кодер с UECP протоколом, подключенный через виртуальный COM-порт (типично для Fora600k):

<RDS_SERVER RDS_DEVICE='UECP' CONNECT_TYPE='COM' CONNECT_PARAMS='port=19' CONNECT_PROTOCOL='UECP' PERIOD='120' RETRY='30' >

кодер Orban 5500i (номер порта и IP-адрес можно выяснить/изменить с помощью программы Optimod 5500i PC Remote):

<RDS_SERVER RDS_DEVICE='ORBAN' CONNECT_TYPE='TCP_CLIENT' CONNECT_PARAMS='IP=192.168.0.16 PORT=22201' CONNECT_PROTOCOL='ORBAN' PERIOD='120' RETRY='30' >

Примечание: Для кодеров FORA-600 и Orban отдельным тэгом PARAM должен быть включен режим BIDIRECTIONAL (В этом режиме кодер отправляет подтверждение получения команды.).

LOAD_XML¶

Параметр LOAD_XML позволяет управлять загрузкой данных из удаленного XML-источника. Доступные атрибуты:

1. XML_ID - ID источника (строка); по данному ID-данные в последствии будут идентифицироваться пр разборе в сервисе. Если ID не указан, содержимое XML будет использовано для генерации команд кодеру. В этом случае в XML файле вложенные тэги должны быть типа STR или WORD.
2. INET_SRC – адрес (URL) расположения данных (к примеру, ftp://ftp.data.com/data.xml);
   1. LOGIN – имя пользователя;
   2. PASSWORD – пароль;
   3. PROXY – адрес (URL) прокси-сервера (записывается в формате адрес:порт);
   4. PASSIVE - тип подключения к серверу, на котором расположен источник данных (параметр может иметь значения: ON или OFF).
3. FILE_SRC – путь расположения данных (к примеру, d:\rds\data.xml);
4. COMPRESSION - использование компрессии GZip (параметр должен иметь значение GZ)

Примеры строки:

<LOAD_XML XML_ID='XML_1' INET_SRC='ftp://ftp.prime-tass.ru/cuts/brent.xml.gz' LOGIN='login' PASSWORD='password' PROXY='192.168.0.254:3128' PASSIVE='ON' COMPRESSION='GZ' />

<LOAD_XML XML_ID='XML_1' FILE_SRC='C:\brent.xml.gz' COMPRESSION='GZ' />

PARSE_XSL¶

Параметр PARSE_XSL позволяет применить к загруженным из XML данным XSLT-преобразование. Доступные атрибуты:

1. STYLE – местоположение и название файла XSL-преобразования на локальном диске;
2. XML_ID - ID данных (идентификация должна совпадать с присвоенной ранее на этапе загрузки).

Пример строки:

<PARSE_XSL XML_ID='XML_1' STYLE='C:\Parse.xsl' />

WORD¶

Параметр WORD позволяет загрузить в службу RDS слово (не более 8 символов). Доступные атрибуты:

1. VAL – загружаемые данные (8 символов);
2. DUR - длительность показа загруженных данных на экране приемника (в секундах), если параметр не задан или задан пустой, то данные показываются в течении 5 секунд.

Пример строки:

<WORD VAL='RDS' DUR='5' />

STR¶

Параметр STR позволяет загрузить строку с данными в кодер. В отличии от описанного ранее параметра WORD, STR работает с данными неограниченной длины.

Доступные атрибуты:

1. VAL – непосредственно загружаемые данные;
2. DUR - длительность показа загруженных данных на экране приемника (в секундах), если параметр не задан или задан пустой, то данные показываются в течении 5 секунд.
3. GROUP - признак начала группы или окончания группы строк (согласно логике работы сервиса RDS, поток данных может разрываться не в любой точке; признак начала группы указывает точку возможного разрыва); атрибут может иметь значения ON или OFF.

Пример строки:

<STR DUR='1' VAL='FM' GROUP='ON' />

После предварительной настройки приложения Джинн в качестве параметра строки можно использовать тэги [artist] и [title]. Процесс настройки описан в разделе Настройка DIGISPOT II Джинн.

Пример использования тэгов:

<STR VAL='[@artist]' />
<WORD VAL='' DUR='1' />
<STR VAL='[@title]' />

SAVE_DST_RDS_DEVICE¶

Послать данные в кодер.
Пример строки:

<SAVE_DST_RDS_DEVICE />

SAVE_XML¶

Параметр SAVE_XML позволяет сохранить загруженные ранее при помощи LOAD_XML данные в файл. Доступные атрибуты:

1. XML_ID - ID источника (идентификация должна совпадать с присвоенной ранее на этапе загрузки);
2. FILE_DST – имя и путь к файлу, для сохранения данных.

Пример строки:

<SAVE_XML XML_ID='' FILE_DST='С:\dest_xsl.xml' />

SAVE_DST_XML¶

Параметр SAVE_DST_XML позволяет сохранить обработанные при помощи PARSE_XSL данные в файл. Доступные атрибуты:

1. FILE - файл для сохранения.

Пример строки:

<SAVE_DST_XML FILE='С:\dest_xsl.xml' />

PARAM¶

PARAM позволяет задавать дополнительные атрибуты, например, управлять функциями установки и сброса флагов TP/TA на управляемом RDS-кодере. Многие современные радиоприемники, имеющие функции RDS, позволяют автоматически переключаться из любого режима на передачу дорожной информации в эфире радиостанции. Эта функция реализуется при помощи двух флагов, устанавливаемых на RDS-кодере. Флаг TP (Traffic Programme Identification) является индикатором того, что радиостанция периодически передает сводки дорожной информации. При этом непосредственно во время передачи дорожных сводок используется дополнительный флаг: TA (Traffic Announcement).

Синтаксис тега PARAM подразумевает использование следующих атрибутов:

1. NAME – имя устанавливаемого флага. В данном случае это TP или TA.
2. VALUE – длительность включение параметра. Если атрибут VALUE = 0 - флаг не установлен, иначе установлен на длительность равную значению "VALUE"(в секундах).

Важно, что тэги PARAM зависят от порядка следования; для корректной работы требуется поместить их перед тэгами (SAVE_DST_RDS_DEVICE), иначе флаги на кодере установлены не будут. В процессе работы RDS-сервиса можно изменять значения атрибутов VALUE тэгов PARAM. При этом флаги на кодере будут переустанавливаться.

Пример строки:

<PARAM NAME="TA" VALUE="300" />

Синтаксис тега PARAM подразумевает использование следующих значений атрибута NAME:

1. Включить режим работы BIDIRECTIONAL (режим обмена с подтверждением) для UECP или ORBAN протокола.

1. для кодеров FORA-600 и Orban режим должен быть включен.
2. для кодера W2COM должен совпадать с настройками кодера.

2. Установить таймаут ответа при обращении к кодеру в режиме BIDIRECTIONAL. Значение должно быть указано в миллисекундах. Значение по умолчанию 2000.

3. Установить скорость скроллинга в 1 секунду.

4. Установить шаг скроллинга (например, в 1 символ):

1. в качестве значения указано число - на сколько символов за один раз протягивается строка
2. в качестве значения указано слово auto - за один раз строка протягивается на одно слово, отображаются все символы, влезающие в буфер (8 символов)
3. в качестве значения указано слово auto2 - за один раз строка протягивается на одно слово, не отображаются "огрызки" слов в конце строки, не влезающие в буфер (8 символов), отображаются только целые слова, длинные слова начинаются с начала буфера

5. Включить/выключить режим «BLOCK RT». В этом режиме все строки загружаются в кодер и за отображение этих строк отвечает сам кодер. Блок может содержать до 8 строк. По умолчанию этот режим включен. Для наполнения блока строками используется параметр – RT (DRT).

6. Переключить режим AB.

7. Установить действие, выполняемое при получении значения шаблона, используемого в RT или PS ( например шаблон [%artist] или [@title] ).

• Возможные значения тэга ‘VALUE’
  • VALUE=‘SHOW_AT_ONCE’ - Выбрать в качестве следующего ближайший в очереди элемент, в состав которого входит установленный шаблон.
  • VALUE=‘RESTART_LIST’ - Выбрать в качестве следующего первый элемент из очереди как указано в конфигурационном файле.
  • VALUE=‘DO_NOTHING’ - Ничего не делать (это значение установлено по умолчанию).
• MAX_DELAY_SEC - это максимальная разрешенная задержка до перехода на элемент, который был выбран в качестве следующего. Если до окончания воспроизведения текущего элемента осталось меньше указанного времени, следующий элемент будет воспроизведен после текущего. В противном случае, следующий элемент будет воспроизведен через указанное время. Значение параметра задается в секундах.

RT¶

Тег RT используется для наполнения блока RT данными, синтаксис тега подразумевает использование следующих атрибутов:

1. VAL – содержимое строки;
2. DUR – в течении какого времени в секундах должна выводиться строка.

Пример:

<RT VAL='-RT 1-' DUR='5' />

CMD¶

Данный тэг отправляет команду в кодер.

Пример для UECP протокола:

Загрузить строку в RT, отображать загруженную строку в течении 10 секунд.

<CMD VAL='0x0a 0 0 10 0x1f "radiotext"' DUR='10' />

Пример для ORBAN протокола:

Загрузить строку в RT.

<CMD VAL='"RT=radiotext"' />

Пример XML-файла:¶

<RDS_SERVER RDS_DEVICE='UECP' CONNECT_TYPE='COM' CONNECT_PARAMS='port=1' PERIOD='120' RETRY='30' >
<TODO>

   <PARAM NAME='BIDIRECTIONAL' VALUE='1' />
   <PARAM NAME='STR_STEP_SECS' VALUE='3' />
   <PARAM NAME='STR_STEP_CHARS' VALUE='auto' />
   <PARAM NAME='SWITCH_RT_AB' VALUE='1' />  

   <WORD VAL='RADIO.FM' DUR='5' />
   <STR VAL='Telefon reklamnoy slujby 41-00-77' />

   <RT VAL='RADIO.FM 000.0 FM' DUR='10' />
   <RT VAL='Telefon reklamnoy slujby 41-00-77' />

   <SAVE_DST_RDS_DEVICE />

</TODO>
</RDS_SERVER>

на дисплей RDS-приёмника: "RADIO" 5 сек "Telefon reklamnoy slujby 41-00-77" бегущей строкой