ПТ-1 1.0 РЭ

From r-wiki
Jump to: navigation, search

Contents

Инструкция по конфигурированию и использованию программного обеспечения к ПТ-1

Назначение

ПТ1 продукт.png Dsc039525.jpg

ПТ-1 служит для отображения вызовов на экране монитора или телевизора. Вывод изображения на экран происходит при помощи интерфейса HDMI.

ПТ-1 имеет 4 основных режима работы:

  • режим 1 - ПТ отображает сигналы от всех кнопок вызова,
  • режим 2 - отображает сигналы от кнопок вызова с привязкой к зонам,
  • режим 3 - очередь без самообслуживания
  • режим 4 - очередь с самообслуживанием.

Каждый из этих режимов отличается отображением вызовов на экране ПТ.

Подключение

Для работы устройства необходимо подключить внешний блок питания с номинальным напряжением 5В, током нагрузки не менее 4А, и плюсом на центральном контакте разъёма. Также нужен HDMI кабель для подключения телевизора. Файлы программы отображения хранятся на microSD карте.

Описание режимов работы

Режим работы 1 - прием от всех кнопок вызова

Экран разбит на 2 части (2 поля): левая, отображает 1 вызов крупным планом и правая, содержащая остальные вызовы. При отсутствии вызовов, в левом поле мигает символ '_'. При поступлении вызова, номер, в зависимости от настроек:

Занимает место в левом поле вывода, смещая левый номер (при его наличии) в правую часть Помещается в конец списка вызовов правого поля.

В зависимости от настроек, вызовы меняют цвет по таймеру (максимум 3 цвета) и по истечению предустановленного в настройках времени исчезают с экрана ПТ.

Режим работы 2 - прием от кнопок вызова с привязкой к зонам

Весь экран разбивается на предустановленное количество зон (от 1 до N, N <= 10). Зонам присваиваются номера кнопок вызова, за которые они отвечают. При нажатии на кнопку вызова, обслуживаемой указанной зоной, номер кнопки будет высвечиваться в поле отображения этой зоны. В зависимости от настроек, вызовы меняют цвет по таймеру (максимум 3 цвета) и по истечению заданного времени исчезают с экрана ПТ.

Режим работы 3 - очередь без самообслуживания

Режим работы имеет 2 основных поля вывода, поле ожидания (обычно заказа) и поле готовности. Способ применяется например в кафе "Макдональдс". После принятия заказа, кассир нажимает на ПВ (либо номер заказа и колокольчик, либо просто колокольчик. Во втором случае номер заказа увеличивается на еденицу). Кассиру выдаётся чек (в случае включения в функционал ПТ термопринтера), который впоследствии отдаётся клиенту, а на экране ПТ в поле ожидания появляется номер заказа (такой же номер печатается на чеке). Когда заказ готов, кассир на ПВ нажимается номер заказа и кнопку сброс. После этого номер заказа перемещается в поле готовности, клиент видит что заказ с его номером готов и забирает свой заказ. После некоторого (настраиваемого) промежутка времени заказ исчезает из поля готовности.

Режим работы 4 - очередь с самообслуживанием, электронная очередь

Режим работы имеет 2 основных поля вывода, поле ожидания и поле обслуживания. Способ применяться в таких учреждениях как "Сбербанк". Клиент заходит в учреждение, нажимает на кнопку, принтер печатает чек с номером в очереди, а в поле ожидания отображается его номер. Когда кассир готов пригласить следующего в очереди клиента, он нажимает на кнопку и на экране на против окна с которого был совершен вызов высветится номер следующего клиента.


Работа с файлом настроек ПТ (внесение изменений в файл конфигураций ПТ)

Основой ПТ является микро компьютер с установленной операционной системой Linux, под управлением которой работает описываемая далее программа. В ПТ имеется файл конфигураций, находящийся в файловой системе, который читается программой перед её запуском. Файл конфигураций возможно редактировать двумя различными способами:

Веб-интерфейс (под управлением Windows, требуется сторонний компьютер)

Для этого требуется, чтобы ПТ был подключено к сети ethernet, можно использовать ноутбук или персональный компьютер по управлением операционной системы Windows. По умолчанию, предприятием-изготовителем установлен IP адрес 192.168.1.178 с портом 8080. Для подключения через веб-интерфейс в адресной строке браузера (Internet Explorer, Google Chrome) набираем http://192.168.1.178:8080/. Пароль для входа по умолчанию: pwdpwd123. После того как в конфигурацию были внесены изменения (произведены настройки режимов работы ПТ) необходимо перезагрузить устройство.

Изменение файла вручную (под управлением Linux, требуется USB клавиатура и мышь)

При помощи файлового менеджера. Для этого требуется подключить клавиатуру и мышь к потам USB ПТ. Выход на рабочий стол из основной программы осуществляется по нажатию клавиши Esc. Конфигурационный файл находится по адресу: /home/bananapi/rcall/config.ini. Для корректной записи файла требуется вначале перемонтировать файловую систему в read-write. Это делается путём выполнения скрипта /home/bananapi/auxiliaryScripts/remount-rw.sh или при помощи запуска скрипта mount_rw находящимся на рабочем столе. После изменения конфигурационного файла обязательно перемонтировать файловую систему обратно в read-only. Это делается при помощи выполнения скрипта /home/bananapi/auxiliaryScripts/remount-ro.sh или запуска скрипта mount_ro находящимся на рабочем столе. Если же не получается обратно примонтировать систему в read-only, нужно правильно перезагрузить ПТ (для сохранения настроек и восстановления режима read-only). Логин и пароль к руту: bananapi.

Конфигурационный файл. Содержание, описание параметров.

Файл настроек является ключевым файлом на устройстве. Существует его копия с оригинальными настройками, лежащая по тому же адресу с именем defaultConfig.ini. Файл настроек устроен таким образом, что если какая-либо настройка неверно прочтена, то программа запущена не будет, вместо неё выведется окно ошибки с указанием какая переменная не установлена или установлена неверно. Конфигурации существуют как общие для всех режимов, так и индивидуальные.


Описание конфигурационных параметров

Комментариями являются символы: "#" или ";".

Цвета могут настраиваться либо при помощи названия цвета в английском варианте, например: gray, purple, yellow... Или же при помощи rgb в шестнадцатеричной системе, например "#FF0000" для красного цвета. Обязательно цвет в виде rgb заключать в кавычки, иначе парсер решит, что это комментарий.

Анимация

Устройство поддерживает анимацию файлов в формате ".gif". После её установки требуется убедиться в том, что анимация корректно отображается, экран не тухнет и приложение не вылетает. Чаще всего проблемы возникают с файлами больших размеров. FPS может просаживаться в зависимости от качества и отображаемого размера анимации и, в связи с этим, анимация фона недоступна. Каждое ".gif" изображение имеет определённое количество циклов анимации. На данный момент поддерживается только формат ".gif" с бесконечным количеством циклов.

Общие конфигурации для всех режимов

mode: режим работы ПТ. Возможные значения: 1,2,3,4

rstnum: номер кнопки для сброса всех вызовов. Нажатие кнопки с данным номером очищает все вызовы. 0 -- кнопка не используется

sortmode: используется (1 и 2 отображения) для определения помещения нового вызова (слева или справа). (очень плохо описано).

group: номер принимаемой группы. 0 - принимать все группы

backgroundAnimation: 0 - картинка, 1 - анимация

background: фоновая картинка или анимация

time1: время отображения вызова с цветом callclr1 в секундах

time2: время отображения вызова с цветом callclr2 в секундах

time3: время отображения вызова с цветом callclr3 в секундах. Если параметр равен 0, то вызов остаётся до его сброса. В противном случае по истечении этого времени вызов пропадает.

callclr1: цвет1

callclr2: цвет2

callclr3: цвет3

skipsubnum: отвечает за пропуск субномеров(актуально для режимов 1, 2)

defaultfontfamily: (1, 2 режимы) шрифт по умолчанию

defaultfontsize: (1, 2 режимы) размер шрифта по умолчанию

largefontfamily: (1 режим) шрифт по умолчанию

largefontsize: (1 режим) размер шрифта по умолчанию


Конфигурирование работы Режим 1

blinkingcolor: цвет мигающего символа "_"

Конфигурирование работы Режим 2

areai: вместо i должен идти номер зоны. Номера должны начинаться с 1. Максимальное количество отображаемых зон -- 10. Принимаемые значения: список кнопок, которые отображает зона.

Конфигурирование работы Режим 3, 4

В этих режимах экран разбивается на сетку gridxmax x gridymax y. Все дальнейшие точки и поля указываются в этих координатах. Точка (0, 0) является верхней левой координатой экрана. Для указания прямоугольника используются левая верхняя точка и правая нижняя. Точка (gridxmax, gridymax) является правой нижней.

gridxmax: количество элементов сетки по ширине

gridymax: количество элементов сетки по высоте

waitfieldfontcolor: цвет вызовов поля ожидания

waitfieldfontfamily: шрифт вызовов поля ожидания

waitfieldfontsize: размер вызовов поля ожидания

waitfieldrect: область поля ожидания

readyfieldfontcolor: цвет вызовов поля готовности

readyfieldfontfamily: шрифт вызовов поля готовности

readyfieldfontsize: размер вызовов поля готовности

readyfieldrect: область поля готовности

animation: опциональный файл анимации

animationRect: прямоугольная область анимации

labeli префикс означает наличие какого-либо статического поля. Нумерация полей начинается с 1, то есть если мы хотим 3 поля, то префиксы должны быть label1, label2, label3. У статического поля требуется описать следующие параметры:

text: текст поля

color: цвет текста

size: размер текста

background: цвет фона. В случае прозрачного фона требуется ввести: ""

font: шрифт текста

rect: прямоугольная область статического поля

Для задания параметров поля требуется склеить префикс с ассоциируемыми параметрами. Например label1text для указания текста полю. Все параметры являются обязательными.

Анимированные файлы

animationi: опциональные файлы анимации. Организованы точно так же, как и поля labeli. Анимация Имеет следующие 3 параметра-постфиксы:

path: анимированный файл

rect: прямоугольная область анимации. Если размер анимации не совпадает с размером области, картинка будет масштабирована

type: Тип анимации. Может принимать следующие значения:

0: Анимация работает постоянно

1: Анимация влючается при помещении номера в поле ожидания

2: Анимация включается при помещении номера в поле готовности

3: Комбинация 1го и 2го типов

=Пример указания анимированного изображения:

  • animation1Path = "penguin.gif"
  • animation1Rect = 650, 100, 950, 400
  • animation1Type = 0

Анимированные вызовы=

wfcAnimation: Анимация вызова поля ожидания. Принимаемые значения:

 0: Анимация отсутствует
 1: Анимация небольшой тряски
 2: Постепенное увеличение вызова
 3: Эластичное увеличение вызова
 4: Постепенное Увеличение вызова с его передвижением снизу вверх
 5: Кружение вызова с постепенным уменьшением радиуса и конечной остановкой
 6: Постепенное изменение прозрачности цвета вызова
 7: "Прыгающее" изменение прозрачности цвета вызова

wfcDuration: время анимации поля ожидания в миллисекундах

rfcAnimation: анимация вызова поля готовности. Принимаемые значения аналогичны параметру wfcAnimation.

rfcDuration: время анимации поля готовности в миллисекундах

Режим 3

rfcLifeTime: время в секундах, после которого вызов в поле готовности исчезнет. Если значение меньше либо равно нулю, то вызов не исчезнет пока его не сбросят.

Режим 4

staticTextColor: цвет текста статических полей

staticTextFont: шрифт текста статических полей

staticTextSize: размер текста статических полей

Поле готовности режима 4 визуально состоит из отображаемых пар: статический текст поля, например "Окно 1" и номер обслуживаемого заказа, например 233. Текст поля находится слева от заказа. У человека, сидящего за местом "Окно 1" имеется кнопка, при нажатии которой вызывается следующий человек из очереди. Следующий параметр указывает статический текст поля и номер кнопки, при помощи которой возможно вызывать клиентов к данному месту.

bindbuttoni: нумерация также начинается с номера 1 и записывается вместо i. Значение параметра выглядит следующим образом: "статический текст", номер_кнопки. При нажантии кнопки с номером номер_кнопки первый по списку из поля ожидания перемещается в поле готовности справа от надписи "статический текст". Надписи статически расположены в поле готовности одна под другой в порядке нумерации, например bindbutton2 будет расположен под bindbutton1. Пример заполнения:

bindbutton1 = "Касса 1", 101 bindbutton2 = "Касса 2", 102 ... При нажатии кнопки 101, самый старый вызов поля ожидания переместится справа от текста "Касса 1". Логика работы с кнопой 102 аналогична.

Другие настройки

serial: номер порта, по которому программа будет связываться с радиомодулем. Номер зависит от операционной системы и используемых пинов. Изменяться вообще не должен, оставлен для отладки программы.

address: адрес устройства. Требуется для разделения вызовов нескольких таких устройств. Диапазон 1..31.


Замечание к работе Приемника телевизионного ПТ-1.

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

Настройка

За настройки табло отвечает файл zzzcfg.ini. backupzzzcfg.ini — его резервная копия. Они находятся на microSD карте. Файл конфигурации читается только при загрузке, поэтому после изменения настроек устройство нужно перезагрузить. perl_serv.pl — веб конфигруратор, позволяет править файл конфигурации через сеть, если подключен сетевой кабель и известен адрес устройства. Программа использует IP:192.168.1.178:8080. Пароль по умолчанию — "pwdpwd123" без кавычек, пароль поменять или отключить можно только имея доступ к perl_serv.pl. perl_serv.pl тоже находится на на microSD карте, его можно отредактировать в текстовом редакторе с поддержкой кодировки UTF-8 . perl_serv.pl представляет собой программу на языке perl. Параметры, отвечающие за обработку пароля, отмечены в комментариях. файл zzzcfg.ini, хранящий конфигурацию, можно отредактировать обычным текстовым редактором с поддержкой UTF-8, или же через веб интерфейс(должен быть подключен сетевой кабель, и известен адрес устройства): Пример фалй конфигурации.png

Обновление ПО

  1. Скачать обновление TV-1.1.4
  2. Распаковать архив на чистую USB-флешку.
  3. Подключить USB-флешку к работающему ТВ-1.
  4. Устройство автоматически начнет процесс обновления.
  5. Устройство автоматически перезагрузится.
  6. Извлечь USB-флешку из разъема USB, после того как устройство запуститься после процесса обновления