Программный продукт FoRAServer v1.

 

Руководство пользователя

NOVSU RDS LAB  2000

1. Назначение

2. Возможности

3. Требования к аппаратному и программному обеспечению

4. Инсталляция

5. Запуск программы. Главное окно программы

6. Подготовка к работе

7. Отображение команд в окне терминала

8. Ввод команд в кодер

9. Список команд UECP, реализованных в кодере RDS


1. Назначение

Программа  предназначена для приема информации от других программ комплекта ROSTON RDS (InitEncoder, ForaRC, FMManager) и отправки этой информации в  кодер “ФОРА 600” через последовательный порт компьютера по протоколу UECP. Программа является базовой и должна быть запущена перед работой с другими программами комплекта.  

2. Возможности

  • Прием информации от программ комплекта ROSTON RDS
  • Отправка RDS информации в  кодер через COM порт по протоколу UECP
  • Отображение отправляемой информации в окне терминала
  • Сохранение передаваемой информации в log-файлы c указанием даты и времени отправки
  • Возможность ручного ввода информации из командной строки (требует знания протокола UECP)
  • Работа с файлами готовых команд  

3. Требования к аппаратному и программному обеспечению

Программа разработана для функционирования под управлением операционной системы Windows 95/98/2000/NT4.0. Для работы с программой рекомендуется использовать компьютер с процессором класса Pentium и выше.  

4. Инсталляция

Скопируйте файлы в отдельный каталог и запустите программу установки Setup.exe. Следуйте указаниям программы установки.

5. Запуск программы. Главное окно программыЗапуск программы осуществляется выбором пункта FORAServer в меню “Пуск” Windows. На экране монитора появится главное окно программы, представленное на рис. 1.

   

Рис. 1. Главное окно программы 

Меню Файл позволяет получить информацию о программе и выйти из программы.

Меню Команды вызывает окно ввода команд. Подробнее об этом окне смотрите ниже.

Меню Параметры позволяет установить параметры последовательного порта, настроить внешний вид окна терминала и определить необходимость ведения log-файлов, а также выбрать язык (русский или английский).

Строка ввода команд и переключатель выбора формата ввода команд предназначены в основном для отладки команд кодера.

В окне терминала отображается информация, отправляемая в кодер, и ответ кодера.

Строка состояния отражает общее количество обработанных и отправленных в кодер запросов (поле «Всего») и количество запросов, поступивших в программу, но еще не обработанных и не отправленных в кодер (поле «В очереди»).

6. Подготовка к работе

Перед тем как использовать программу, необходимо определить и настроить последовательный порт, через который компьютер соединен с кодером. Это можно сделать с помощью диалогового окна настройки параметров порта, показанного на рис. 2. Для вызова этого окна выберите меню Параметры –> Порт.

Установите в этом окне номер последовательного порта, скорость работы порта, управление потоком. В поле «Время ожидания» можно определить время ожидания ответа от кодера в миллисекундах. Значение по умолчанию – 100 мс. Вы можете увеличить это значение, если, как вам кажется, программа работает некорректно.

Остальные параметры порта затенены и не могут быть изменены, отображаются только для информации.

Рис. 2. Окно настройки параметров последовательного порта    

7. Отображение команд в окне терминала 

Окно терминала позволяет Вам следить за процессом обмена информацией программы с кодером. Окно терминала с отображенной информацией представлено на рис. 3.  

Рис. 3. Отображение команд в окне терминала

Выражение, стоящее после символа -> отражает команду, пришедшую в FORAServer в исходном виде.

Выражение, стоящее после символа = отражает команду, преобразованную программой в формат UECP и отправленную в кодер.

Выражение, стоящее после символа <- представляет собой ответ кодера, преобразованный программой в понятный пользователю вид.

Выражение, стоящее после символа = ниже символа <- представляет собой ответ кодера в формате UECP. Данное выражение отображается, только если кодер работает в двунаправленном режиме.    

Настройка параметров терминала  

Настройка параметров терминала осуществляется в диалоговом окне, представленном на рис. 4. Для вызова этого окна выберите меню Параметры ? Терминал.

Рис. 4. Окно определения параметров терминала  

Пункт «Сохранение в *.log файл» при его отметке позволяет сохранять протокол работы программы в файл. Имя создаваемого файла отражает время и дату создания файла. Например, имя файла 0702_114713.log говорит о том, что файл был создан 2-го июля в 11 часов 47 минут 13 секунд.

В поле «Очистка при заполнении» введите максимальное количество строк, отображаемое в окне терминала. При достижении этого количества окно терминала очистится. Если отмечен пункт «Сохранение в *.log файл», то удаляемая информация сохраняется в log-файл, а в окне терминала появится строка вида: Запись в файл ММДД_ЧЧММСС.log.

Вы также можете задать цвет окна терминала в выпадающем списке, определить шрифт и цвет отображаемых в окне терминала символов при нажатии на кнопку «Шрифт». Нажмите ОК, чтобы подтвердить сделанные изменения.  

8. Ввод команд в кодер 

Как уже было сказано, с помощью FORAServer можно не только отправлять в кодер информацию, полученную от других программ комплекта, но и непосредственно вводить команды в кодер. Для этого Вам необходимо знать формат команд протокола UECP (См. пункт 9).

Команды можно вводить из командной строки и пользуясь специальным окном ввода команд, представленным на рис. 5.

При написании команд можно вводить данные, определяющие целый UECP-фрейм или только MSG-поле фрейма, позволив программе дописать недостающую часть. Для выбора нужного режима воспользуйтесь переключателем выбора формата ввода (см. рис.1).  

При написании команд следует учитывать следующие моменты:

1. Пробелы, стоящие между символами, игнорируются программой. Вы можете  использовать их для наглядности вводимых команд.

2. Команды, вводимые в кодер, должны быть представлены в шестнадцатеричном формате, но программа позволяет вам вводить данные и в строковом виде. Вы можете комбинировать данные разных типов в одной команде.

3. При вводе строковых данных заключайте их в одинарные кавычки (пример: ‘hello‘). При отправлении данных в кодер программа автоматически преобразует данные, ограниченные такими символами, в шестнадцатеричный вид.

4. Для указания длинны строковых данных используйте символ “#”. Он должен стоять непосредственно перед строкой. Пример: # ’hello’. Программа сама подсчитает количество символов в такой строке и укажет его в готовой UECP-команде.

5. Вы можете вставлять комментарии при вводе команд. Для этого в начале строки поставьте знак « ; » (точка с запятой). Комментарии отражаются в окне терминала, но не отправляются в кодер.  

Работа с окном ввода команд  

Окно ввода команд, представленное на рис. 5, предлагает Вам расширенные возможности при написании и сохранении команд. Это окно вызывается выбором меню Команды.  

Рис. 5. Окно ввода команд  

Вы можете написать сразу несколько команд. Новая команда должна начинаться с новой строки.

Для выполнения всех введенных в окно команд нажмите кнопку Выполнить.

При написании команд Вы можете использовать стандартные сочетания клавиш для работы с текстом: Ctrl-C (скопировать выделенный фрагмент в буфер), Ctrl-V (вставить фрагмент из буфера), Ctrl-X (вырезать фрагмент). Пункты меню Редактирование позволяют осуществлять те же действия. Пункты меню Файл позволяют вам осуществить следующие действия:

  • сохранить написанные команды в файл с расширением .cmd – пункты «Сохранить», «Сохранить как».
  • создать новый файл команд – пункт Новый.
  • открыть существующий файл команд – пункт Открыть.
  • отправить написанные команды в кодер – пункт Выполнить.
  • закрыть окно ввода команд – пункт Закрыть.

Кнопки панели инструментов этого окна дублируют основные пункты меню.  

9. Список команд UECP, реализованных в кодере RDS 

Список команд UECP, реализованных в кодере RDS (внутреннее программное обеспечение от 03.03.2000)  

Команды UECP, реализованные полностью:

01 PI
02 PS
06 PIN
04 DI
03 TA/TP
05 MS
06 PTY
12 Paging network group designation
1E RDS on/off
22 RDS phase
0E RDS level
16 Group sequence
23  Site address
27 Encoder address

Команды UECP, реализованные с ограничениями (в скобках со звездочками указаны отличия от UECP, остальные элементы протокола кодера соответствуют UECP):

0A
RT MEL: 01..41 (* не 00..41 *)
MED: Первый байт
Bit 7: Reserved
Bits 6..5: Buffer configuration (* 10 при MEL>1 - добавить радиотекст, 00 при MEL=1 - очистить буфер радиотекста *)
Bits 4..1: Number of transmissions (* всегда 0001, повторная передача осуществляется повторным добавлением радиотекста в буфер *)
Bit 0: A/B status control
26 TDC
(* для версий групп 5A и 5B существуют отдельные буферы, информация из них передается независимо, в соответствии с порядком групп Group Sequence *)
MED: второй байт
Bit 7: Reserved
Bits 6..5: Buffer Configuration (* всегда 00. Информация передается 1 раз, затем удаляется из буфера *)
Bits 4..0: Channel Number
1B Paging call with alphanumeric message (80 characters)
MED: Первый байт:
Bits 7..4: Number of repetitions (* Всегда 0001, сообщение передается 1 раз, затем удаляется из буфера*)
Bits 3..0: Pager address (MSB)
0D Real Time Clock
MED: Первый байт: 00..63 Last two decimal digits of Year expressed as hex (* 00..FF, 2000 год = 64 *)
MED: Байт 7: Centiseconds (* Игнорируется *)
3C Communications port configuration - Speed
MED: Первый байт: (* Всегда 01h *)
MED: Второй байт: (* Доступны значения 06, 07, 08, 09. Значение, устанавливаемое при холодном запуске кодера - 08 *)    

Нереализованные команды UECP:

3E PTYN
13 AF
14 EON AF
1A slow labelling codes
2E linkage information
40 ODA Configuration and Short Message Command
41 ODA Identification Group usage sequence
42 ODA Free-format group (Message bits)
43 ODA Relative Priority Group Sequence
44 ODA "Burst Mode" Control
45 ODA "Spinning Wheel" timing Control
2B EWS
25 IH
30 TMC
24 Free-format group
0C Paging call without message
08 Paging call with numeric message (10 digits)
20 Paging call with numeric message (18 digits)
11 International paging with numeric message (15 digits)
10 International paging with functions message
31 EPP transmitter info
32 EPP call with add. message
33 EPP call with alphanum. message
34 EPP call with num. message
35 EPP call with fn. message
09 Real time clock correction
19 CT on/off
21 ARI on/off
0F ARI area (BK)
1F ARI level
28 Make PSN list
0B Psn enable/disable
2C Communication mode
2A Ta control
15 EON TA control
1D Reference input select
1C Data set select
38 Extended group sequence
29 Group variant code sequence
2F PS character code table selection
3A Encoder access right
3B Communications port configuration - Mode
3D Communications port configuration - Timeout
18 Message acknowlegement
17 Request message
2D Manufacturer's specific command

Другие особенности кодера:  

Кодер работает только в однонаправленном режиме  

DSN: всегда 1
PSN: всегда 0

Изменение в списке команд UECP, реализованных в кодере RDS (внутреннее программное обеспечение от 01.04.2000):  

Добавлена команда 13 (AF) со следующими ограничениями  

13 AF
(* список всегда переписывается полностью, от начала до конца, без возможности добавления или изменения части списка. Максимальная длина списка ограничена длиной одного поля MED. *)
MED: байты 1,2: Start Location (* всегда 0000h *)
MED: последний байт (* всегда 00h, Terminator *)

Для тестирования введен двунаправленный режим работы кодера  

2C Communication mode
В режиме 2 (Bi-directional mode, spontaneous response) кодер дает подтверждение приема команд (18 Message Acknowledgement).
Команда 17 (Request message) не реализована, поэтому режим 1 (bi-directional mode with requested response) не работает.