# Модуль работы с турникетами, соляриями

# Турникеты

**Перечень устройств, с которыми работаем:**

#### Турникеты производства Perco. 

Триподы: Серии TTR-04, T-5 и т.п.

[![image-1630575767567.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630575767567.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630575767567.png)

Тумбовые турникеты. Серия TTD

[![image-1630575925260.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630575925260.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630575925260.png)

<div id="bkmrk-%D0%A1%D0%BA%D0%BE%D1%80%D0%BE%D1%81%D1%82%D0%BD%D1%8B%D0%B5-%D0%BF%D1%80%D0%BE%D1%85%D0%BE%D0%B4%D1%8B.-">Скоростные проходы. ST-01</div>[![image-1630575986191.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630575986191.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630575986191.png)

Как правило схема управления турникетом у них одинаковая.

#### Турникеты Praktika T - 01

[![image-1630576329065.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630576329065.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630576329065.png)

#### Турникеты Ростов-Дон т9м1.

Подключение идет через плату XS2

[![image-1630576483586.png](https://docs.shelter.ru/uploads/images/gallery/2021-09/scaled-1680-/image-1630576483586.png)](https://docs.shelter.ru/uploads/images/gallery/2021-09/image-1630576483586.png)

#### Ростов-Дон Т283М1

[![image.png](https://docs.shelter.ru/uploads/images/gallery/2024-06/scaled-1680-/image.png)](https://docs.shelter.ru/uploads/images/gallery/2024-06/image.png)

# Контроль доступа с помощью биометрии. Интеграция с PocketKey

**Для осуществления контроля биометрии используется интеграция с оборудованием и ПО PocketKey !!!**

**Данный функционал доступен с версии gkhostconnect 1.86.0.5 и новее.**

**1. Типовая логика обслуживания клиента.**

- Клиента регистрируют в системе Абонемент
- Клиенту в системе Абонемент прикрепляется идентификтаор (бесконтактная карта Mifare)
- Происходит обучение системы распознавания лицу данного клиента (см п.4)
- Клиент проходит к турникету на вход и прикладывает карту к считывателю
- Трек с карты передается в gkhostconnect для анализа доступа
- В случае разрешенного доступа gkhostconnect Отправляет в систему распознавания id клиента и происходит сверка фото в БД системы распознавания и фото с камеры на турникете
- В случае совпадения лица турникет открывается на вход
- При выходе контроль биометрии не осуществляется

**2. Установка и настройка**

Установку и настройку ПО для распознавания и сохранения биометрических данных устанавливается на компьютер заказчика специалистами PocketKey

В **gkhostconnect.ini** необходимо в секции **\[gkhost\]** прописать следующие настройки:

```
[gkhost]
host=172.22.3.241
port=8075
local=0
CanSendData=1
ProtocolType = 3
```

Где:

- host, port - адрес и порт, на котором работает ПО PocketKey
- ProtocolType=3 - указывает, что необходимо работать с биометрией

Вот это нужно добавить в мануал:  
-добавить в мануал указание настройки использовать биометрию  
-айди устройств должны быть двузначными  
-обучение проходит через веб fit.recognitionx.com, для того чтобы войти - в файле hosts прописать: 192.168.0.100(айпишник сервера где развернут покет кей локально) fit.recognitionx.com

Всвязи с ограничениями связанными с храненинем биометрических данных в PocketKey  
появилась реализация PocketKey Dynamic, в которой вместо биометрии используется   
моб. приложение (есть реализации на iOs и Android) и терминалы сканируют QR код из приложения (постоянно обновляется).  
Внесение идентификатора в базу PocketKey просходит либо через личный кабинет PK либо автоматически при помощи предлагаемого   
co стороны PocketKey API (В Абонемент данное Api не реализовано).

# Модуль "Управления турникетом"

**Интерфейс "Абонемент-Турникет"** - программный комплекс, позволяющий связать аппаратную часть (турникеты, магнитные замки и другие устройства управляемые с помощью контроллеров UCS) и ПО Абонемент, позволяя контролировать доступ клиентов к тем или иным платным зонам объекта.

Информация в данной статье актуальна для версий: *gkHost.exe* - 3.2.0.1 и *gkhostconnect.exe* - 1.88.0.6 , доступных в версии Абонемент 1.128 в папках *\\FullVersionVer128\\GKHOST\\* и *\\FullVersionVer128\\gkhostconnect\\* соответственно.

## Введение

Комплекс состоит из 2х составляющих:

**gkHost** - отвечает за сообщение с контроллерами UCS;

**gkhostconnect** - отвечает за связь с БД Абонемент и исполнение установленной логики контроля доступа к указанным ресурсам.

Данные составляющие могут быть разнесены на разные машины. Связь между ними осуществляется в рамках протокола TCP-IP.

Но, как правило, удобно их держать в рамках основного сервера Абонемент.

## gkHost

 Данная составляющая должна быть установлена на машине, обязательно находящейся в той же подсети что и контроллеры UCS (по умолчанию - 172.31.х.х)(например, в рамках альтернативной конфигурации сетевого адаптера).  
<span style="color: #3366ff;"> Принципиально важно, что бы подсеть была с маской 255.255.0.0. Адрес интерфейса, на котором gkHost работает, должен быть, в их случае, от 192.168.0.1 до 192.168.31.254.</span>

Программа не имеет графического интерфейса.

### Настройки:

*gkHost.ini*

```
[log]
;Настройки логирования
  Name = gk3Host.log
  level = 10
  debugLevel = 10
  ByMonthes=1
  ByDays=1
  ByHours=1

[log.protocol]
;Настройки логирования сообщения с контроллерами
  Name  = gk3Host.protocol.log
  level = 10
  debugLevel = 10
  stampKind = 4145
  ByMonthes=1
  ByDays=1
  ByHours=1

[telnet]
;Порт используемый для связи с gkhostconnect
  port = 5556

[gk3]
;Представлены настройки подходящие, для контроллеров настроенных по умолчанию
;IP-адрес, на котором будет работать сервер протокола GK3 - должен совпадать с IP-адресом машины в подсети контроллеров UCS
  ip = 172.31.32.100         // здесь должно быть 172.31.0.100
;PORT -- порт протокола GK3 
  port = 18251
;NET -- сеть протокола GK3
  net = 172.31.0.0
;MASK -- маска сети протокола GK3
  mask = 255.255.0.0
```

<div id="bkmrk-%D0%94%D0%BB%D1%8F-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B8-%D0%BF%D1%80%D0%BE%D1%86%D0%B5%D1%81">Для установки процесса службой Windows, достаточно просто запустить прилагаемый *install\_gkh.bat* от имени администратора.</div><div id="bkmrk-%C2%A0-3"> </div><div id="bkmrk-%C2%A0-4"> </div>## gkhostconnect

<div id="bkmrk-%C2%A0-5"> </div><div id="bkmrk-%D0%94%D0%B0%D0%BD%D0%BD%D0%B0%D1%8F-%D1%81%D0%BE%D1%81%D1%82%D0%B0%D0%B2%D0%BB%D1%8F%D1%8E%D1%89%D0%B0%D1%8F%C2%A0">Данная составляющая отвечает за связь с БД Абонемент и исполнение установленной логики контроля доступа к указанным ресурсам, как было указано выше.</div><div id="bkmrk-%C2%A0-6"> </div>### Основные настройки в файле *gkhostconnect.ini*:

<div id="bkmrk-%5Bappservice%5D-%3B%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE"><div>```
[AppService]
;Настройки службы создаваемой при запуске с ключом -install
;Имя сервиса
DisplayName = UCS Служба GKHOSTConnect
;Внутреннее имя сервиса (одно слово. Только латинские символы и цифры. Начинается с буквы)
ServiceName = UCSGKHOSTConnect
Description = Служба-интерфейс контроля доступа UCSGKHOSTConnect

[Application]
;Скрывать приложение автоматически, если запущено не службой
    AutoHide=0

[log]
;Настройки логирования
name=.\log\gkhostconnect.log
level=30
debuglevel=30
ByMonthes=1
ByDays=1
BYHOURS=1

[LOCK.SERVER]
;настройки на сервер блокировок Абонемент
TCPHOST = 127.0.0.1
TCPPort = 1111

[database]
;Настройки на БД Абонемент
dbname=127.0.0.1/3080:C:\_UCS\_FITNESS\IBDATA\fitness.FDB
dbuser = ucs
DBPassword = oQKH8n0BFUE=

[devices]
;Настройки применяемые для всех устройств
;Тарификацию начинаем после того как турникет провернулся: 
при CheckTurnDirect=0 - считается, что турникет провернулся в ту сторону, в которую была дана команда.  
при CheckTurnDirect=1 - (по умолчанию) дополнительный контроль. Тарификация начинается , только если от турникета получено сообщение, что он провернулся в ту сторону, в которую была дана команда.  
CheckTurnDirect=1
;Время ожидания прохода в секундах (должно быть больше, чем время ожидания в настройках турникета)
TurniquetTimeOut=10
;Обрабатывать все символы в приходящих с контроллеров треках
ToProcessAllCharsInCard=1
; Не обрабатывать следующие треки (CF = 'No Card')
NoProcessedCardsNo=CF

[gkhost]
;настройка связи с gkHost
host=127.0.0.1
port=5556
local=0

ProtocolType=0
CanSendData=1
```

<div> </div><div>Остальные секции данного *ini* файла специфические и требуют контроля только при использовании специфического оборудования, и описаны в статьях посвящённых данному оборудованию.</div><div>При настройке базового функционала, изменять данные секции не требуется.</div><div> </div><div>Для запуска программы в режиме графического интерфейса, запускать её требуется с ключом **-desktop**.</div><div>Для установки программы в качестве службы Windows, требуется запустить её с ключом **-install** от имени администратора.</div><div> </div></div></div>### Основное окно программы:

<div id="bkmrk-%D0%A0%D0%B8%D1%81.1-%D0%9E%D1%81%D0%BD%D0%BE%D0%B2%D0%BD%D0%BE%D0%B5-%D0%BE%D0%BA%D0%BD%D0%BE-"><div><div>[![](https://support.shelter.ru/sites/files/upload/images/nodes/8953/1.png)](https://support.shelter.ru/sites/files/upload/images/nodes/8953/1.png)</div><div>*Рис.1 Основное окно программы gkhostconnect* </div><div> </div><div>Как видно на рис.1, основное окно программы содержит 3 основных вкладки:</div><div>**GKHOST** - настройки взаимодействия с *gkHost*;</div><div>**Устройства контроля доступа** - настройки взаимодействия с контроллерами UCS;</div><div>**Печатные формы** - печатные формы, отрабатывающие при различных событиях.</div><div> </div><div>Также внизу окна отображается состояние связи с БД Абонемент и связи с *gkHost* (Пиктограмма лампочки в строке состояния: лампочка горит - связь установлена, лампочка погашена - связь не установлена).</div><div> </div></div></div>#### Вкладка GKHOST:

<div id="bkmrk-%D0%A0%D0%B8%D1%81.2-%D0%92%D0%BA%D0%BB%D0%B0%D0%B4%D0%BA%D0%B0-gkhost"><div><div>![](https://support.shelter.ru/sites/files/upload/images/nodes/8953/3.png)</div><div>*Рис.2 Вкладка GKHOST основного окна gkhostconnect*</div><div> </div><div>На рис.2 представлена вкладка GKHOST. На данной вкладке, по умолчанию, настроек производить не требуется, если был корректно настроен *gkhostconnect.ini* </div><div> </div></div></div>#### Вкладка Устройства контроля доступа:

<div id="bkmrk-%D0%A0%D0%B8%D1%81.3-%D0%92%D0%BA%D0%BB%D0%B0%D0%B4%D0%BA%D0%B0-%D0%A3%D1%81%D1%82%D1%80%D0%BE%D0%B9"><div><div>![](https://support.shelter.ru/sites/files/upload/images/nodes/8953/2.png)</div><div>*Рис.3 Вкладка Устройства контроля доступа*</div><div> </div><div> </div><div>Вкладка Устройства контроля доступа представлена на рис.3. На данной вкладке происходит основной этап настройки *gkhostconnect* на конкретные контроллеры и логики контроля доступа к конкретным ресурсам в Абонемент.</div><div>Как видно на рис.3:</div><div>В левой части окна находится таблица со всеми ресурсами заведёнными в Абонемент;</div><div>В центральной части окна находится таблица со всеми контроллерами, которыми будет управлять *gkhostconnect;*</div><div>В правой части окна находятся свойства выбранного контроллера.</div><div> </div><div>Соответственно, для внесения нового контроллера в список, требуется:</div>- Выбрать ресурс к которому будет привязан данный контроллер в левой части окна.
- Нажать кнопку "**+**" в центральной части окна.
- Далее произвести настройку свойств добавленного контроллера в правой части окна.
- Сохранить внесённые изменения кнопкой "**✓**" или кнопкой "**Сохранить**".

</div></div>#### Основные свойства контроллера:

<div id="bkmrk-device%2Crelay%C2%A0--%D0%BF%D1%80%D0%B5%D0%B4%D0%BF"><div>- ***device,relay*** - предпоследняя и последняя цифра IP-адреса контроллера в десятичном формате. (например device=32 и relay=20, для IP=172.31.32.20);
- ***Тип устройства*** - указывает, какое устройство подключено к контроллеру;
- ***Направление прохода*** - направление прохода контроллируемое данным контроллером;
- ***Кого пускать*** - самоговорящее название свойства;
- ***Проход группы*** - разрешён ли групповой проход для одного клиента, если есть таким образом настроенные абонементы.

<div>Из остальных свойств отметим также следующие:</div>- ***Генерировать событие при разрешённом доступе*** - устанавливается в случае, если устройство подключённое к контроллеру не возвращает факт прохода. В таком случае, проход будет считаться осуществлённым в момент разрешения прохода и человек будет введён в ресурс, независимо от того, прошёл ли он;
- **Команда для входа, Команда для выхода, Команда для входа/выхода** - комманды посылаемые на контроллер, для выполнния соответствующих действий. Определяются прошивкой контроллера. (Значения по умолчанию - для импульсного разрешения прохода для прошивки *gk3\_trn\_3\_0\_0\_19\_9600x2\_hex*).

<div> </div><div>Все остальные свойства имеют говорящие названия, и настраиваются согласно схеме обслуживания клиентов.</div><div> </div></div></div>## **Важно! Декодирование треков карт**

<div id="bkmrk-%D0%94%D0%BB%D1%8F-%D0%B4%D0%B5%D0%BA%D0%BE%D0%B4%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-%D1%82%D1%80"><div>Для декодирования треков приходящих со считывателей, подключённых к контроллерам, *gkhostconnect* использует *decodecards.dll*, настраиваемый через *decodecards.ini* .</div><div>Так как треки приходящие с контроллеров часто не совпадают в точности с треками получамыми со считывателей на рабочих местах, требуется дополнительно поризвести тестирование и настройку декодирования.</div><div>**Соответственно, использовать *decodecards.ini* настроенный под Абонемент или TCPCardReader не получится** - декодированные треки будут отличаться от заведённых в Абонемент, и gkhostconnect не сможет найти клиента в БД.</div></div>

# Подключение CardLan как считывателя для турникета

- Контроллер gk является ведомым при таком подключении.

1\) прошить контроллер спец. прошивкой ( например 100 )

2\) в EEPROM контроллера прописать адрес CardLan'a

- CardLan подключить по microUSB ( центральный вход сзади ) и залить в него ethernet.sh с IP,MASK'ой и MAC'ом

IP=172.31.32.12  
MASK=255.255.0.0  
MAC=00:0E:C6:87:72:12

из инструкции от GK   
&gt; По прошивке контроллера для Cardlan.  
&gt;   
&gt; Нужно прошить прошивку в контроллер и установить ip адрес валидатора, с которым будет работать контроллер.  
&gt;   
&gt; Как это делается:  
&gt; В gkTools подключиться к контроллеру.  
&gt; Перейти во вкладку EEPROM и подгрузить данные(зеленый кружок).  
&gt; Перевести адрес валидатора, с которым будет работать устройство, в hex вид, например: 172.31.32.10( DEC ) -&gt; AC.1F.20.0A(HEX).  
&gt; Записать последовательно 4 значения адреса в поля с координатами 13,0 14,0 15,0 16,0 (это первая строка таблицы).  
&gt; Сохранить изменения(дискета).  
&gt; Перезагрузить контроллер.  
&gt;   
&gt; Внимание! Теперь контроллер возможно будет перезагрузить только снятием питания, тк UDP порт изменился.

# Мобильный турникет



# Описание функционала

(реализованный и запланированный функционал)

*<u>Какие задачи решает приложение?</u>*

Приложение предназначено для контроля и учёта посещений гостей, для регистрации услуг гостю, для анализа загрузки ресурсов.

*<u>Как работает?</u>*

Приложение устанавливается на смартфон с NFC считывателем.

Приложение используют сотрудники предприятия (операторы), которые контролируют вход/выход в одну или несколько зон тарификации.

Для этого необходимо просканировать электронный идентификатор клиента и отметить вход/выход посетителя.

Для аналитики используется отчёт «Загрузка ресурсов».

*<u>Целевая аудитория</u>*

Любое предприятие, где требуется вести контроль и учёт посещений клиентов: например, спортивные площадки, детские развивающие и обучающие центры и пр.

*<u>Терминология</u>*

Пользователь – сотрудник объекта и пользователь системы Абонемент, который работает с мобильным приложением.

Посетитель – клиент, который посещает ресурсы и получает услуги.

Идентификатор – электронный носитель, прикрепленный к профилю посетителя или пользователя. При помощи идентификатора осуществляется авторизация пользователя или идентификация посетителя в приложении.

Профиль – учётная запись пользователя или посетителя.

Магазин – через интерфейс магазина пользователь может зарегистрировать (добавить без оплаты) посетителю дополнительные услуги.

Дополнительные услуги – заведенные услуги в справочнике услуг ПО Абонемент. К дополнительным услугам не относятся абонементы.

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

*<u>Функциональные возможности приложения</u>*

Авторизация пользователя в приложении при помощи ввода логина/пароля или идентификатора;

Поиск посетителя по идентификатору;

Отображение информации о посетителе: ФИ, Фото, Ресурсы (доступные, а также те, в которых присутствует посетитель);

Регистрация входа посетителя (в один или несколько ресурсов);

Регистрация выхода посетителя (из одного или нескольких ресурсов);

Отображение тарифов по абонементу (если посещение в ресурс доступно по нескольким тарифам) в профиле посетителя;

Выбор тарифа, в рамках которого происходит регистрация посещения;

Отображение даты окончания действия абонемента в профиле посетителя;

Отображение списка дополнительных услуг в Магазине;

Возможность выбрать дополнительные услуги и начислить в профиле посетителя;

Возможность удалять дополнительные услуги из корзины (до момента начисления услуг);

Возможность регистрации дополнительных услуг в профиле посетителя;

Подтверждение идентификатором посетителя при начислении дополнительных услуг в профиле посетителя;

Навигация внутри магазина (НАЗАД, НАЧАЛО, В КОРЗИНУ);

Вывод информации о выбранных дополнительных услугах в магазине (КОЛ-ВО, СУММА);

*Отчет « Загрузка ресурсов»:*

Отображение количества присутствующих посетителей в ресурсах плюс остаток времени посещения;

Цветовая визуализация (красный цвет) в случае, если в ресурсе есть посетитель с превышением по времени посещения;

Цветовая визуализация (зеленый цвет) в случае, если в ресурсе есть посетитель;

Детализация по посетителям в рамках выбранного ресурса;

Обновление данных в автоматическом или ручном (кнопка ОБНОВИТЬ ОТЧЁТ) режимах;

*Настройки приложения:*

Настройка списка контролируемых пользователем ресурсов (дополнительно проверяются права пользователя для работы с ресурсами);

Отображение информации о пользователе (ФИ сотрудника, время авторизации, выход);

Отображение технической информации (адрес сервера, API ключ (зашифрованная информация)).

## Необходимые пользовательские настройки

**Справочник пользователей**

Для успешной авторизации пользователя в приложении:

Пользователь должен быть заведен в справочнике пользователей.

Пользователю должен быть назначен логин и пароль для WEB (настройки/пользователи и роли/пользователи/карточка клиента/ поля «Логин для WEB», «Пароль для WEB»).

Для успешной авторизации пользователя в приложении при помощи идентификатора к профилю пользователя должен быть прикреплен идентификатор поддерживаемого типа.

Проверяется права доступа у пользователя для работы с ресурсами, а именно настройка «Доступные корпуса и этажи в контроле присутствия». Если ресурс недоступен согласно настройкам прав доступа, то он не отображается в списке ресурсов в профиле пользователя в приложении (раздел «Настройки/Ресурсы»). Это значит, что пользователь не может обслуживать посетителей в недоступных ему ресурсах.

**Справочник услуг**

Для отображения услуг в разделе Магазин необходимо настроить справочник услуг. В приложении отображаются все услуги, заведенные в справочнике.

**Посетители**

Для успешного поиска клиента в приложении:

Гость должен быть заведен в базе данных Абонемент.

Гостю должен быть прикреплен идентификатор поддерживаемого типа.

Для доступа в ресурс у гостя должны быть соблюдены условия посещения (например, период действия абонемента, расписание, тариф, оплата и пр.).

# Техническая часть и настройки

### Системные требования

**Версия Абонемент:**

- Не ниже 138

**Мобильный телефон:**

- Android 7.1+
- Для работы считывателя бесконтактных карт необходимо наличие NFC модуль

**Требования к бесконтактным картам:**

- Считывание производится только бесконтактных карт/браслетов формата Mifare Classic (4 byte UID)

### Лицензирование

Модуль лицензируется по количеству одновременно работающих приложений.

Приложение занимает лицензию, пока в нём авторизован пользователь. Как только пользователь выходит из учётной записи в приложении занимаемая лицензия освобождается. Также лицензия освобождается автоматически, в случае бездействия пользователя в приложении в течении 15 минут.

[Подробнее про лицензирование модулей Абонемент.](https://support.ucs.ru/ru/node/8922)

### Настройки

#### Connecter

Для работы приложения необходимо развернуть API (Connecter) на любом доступном с мобильных устройств шлюзе.

Помимо обычной настройки Connecter на БД, сервер блокировок, внешний порт доступный из сети, в которой будут находиться мобильные устройства, необходимо соблюсти следуюющие моменты:

В папке с connecter должны присутствовать следующие файлы, доступные в поставке Абонемент версии 139 и выше:

- *\\Connecter\\ResponseTransformSchema.ini*
- *\\Connecter\\XSLT\\..*
- *\\Connecter\\frf\\MobTurn\_ResourceLoading.fr3*
- *\\Connecter\\frf\\MobTurn\_ResourceLoading.ini*

В *connecter.ini* следующие параметры **обязательно** должны быть заполнены таким образом:

```
[charset]
UseUrlEncode=0

[DataFormat]
RequestDataFormat=1
```

Для корректного считывания карт Mifare Classic в *decodecards.ini* используемого connecter, настройки должны быть следующие:

```
[general]
usemask=1

[mask]
  card_ALL = *

[cards.card_ALL]
code=2
CardDecodeType = MASK
mask=hhhhhhhh
bitmask=$FFFFFFFF
```

####  

#### Мобильное приложение

Для установки мобильного приложения достаточно передать файл .apk (установочный файл android) на устройство, и используя любые средства установить приложение.

В мобильном приложении необходимо на вкладке настроек "Технические" (пиктограмма шестерёнок) настроить адрес к настроенному API connecter, и зашифрованный пароль доступа.

#### Шифрование пароля (PrivateKey connecter.ini)

Для получения пароля доступа указываемого в мобильном приложении, необходимо воспользоваться утилитой GenCryptPrivateKey.exe, доступной в поставке connecter со 138 версии Абонемент.

В утилите в поле PrivateKey необходимо прописать значение ключа прописанного в одноимённом параметре в connecter.ini. После нажатия на кнопку "Сформировать" в поле CryptKey появится зашифрованная версия ключа, которую необходимо будет указывать в мобильном приложении в параметрах подключения к API.

# Проводные контролеры - изменение параметров и прошивка

**Изменение параметров игрового контролера GK**

1.Изменение адреса на Ethernet-контролере.

По умолчанию адрес на контролере является 2001.

- Запустить утилиту gkTools.
- Нажать кнопку **Start**.
- В закладке install указать два блока цифр GK адреса, прошиваемого контролера (2001, 2002, 2003 и т.д.), нажать кнопку **set** и **restart**. После этого внизу появится сообщение connected with host \*\*\*
- Затем считать данные с точки доступа при помощи кнопки с **зелеными** стрелочками. В окне GK-address указать новые два блока цифр, нажать кнопку **без названия** (справа от поля GK address) и кнопку сохранить (**дискетка**).
- Нажать кнопку **restart**. Должна появиться надпись disconnected with host \*\*\*
- GK-адрес на контролере изменен.

В локальной сети не должно быть устройств с одинаковыми GK-адресами!

2\. Для заливки файла прошивки firmware (формат \*.fw) на игровом контролере (используется для обновления прошивок или изменения функционала контролера) понадобится утилита gkTools.

По умолчанию GK-адрес на контролере является 2001.

Процесс прошивки:

a. Запустить утилиту gkTools

b. Нажать кнопку Start.

c. В закладке install указать два блока цифр GK адреса, прошиваемого контролера (2001, 2002, 2003 и т.д.), нажать кнопку set и restart. После этого внизу появится сообщение connected with host \*\*\*

d. Зайти на вкладку Uploading и выбрать файл прошивки с расширением \*.fw и нажать upload.

e. Нажать кнопку RestartAppFW и кнопку Restart. После этого внизу появится сообщение disconnected with host \*\*\*

Игровой контролер прошит.

# Описание контроллера

# **Контроллер**<span style="color: rgb(68, 68, 68);"> - это техническое устройство для управления оборудованием.</span>  


Контроллер имеет:

<div id="bkmrk-%D0%94%D0%B2%D0%B0-%D1%80%D0%B5%D0%BB%D0%B5%2C-%D0%BA%D0%BE%D0%BD%D1%82%D0%B0%D0%BA%D1%82%D1%8B-%D0%BA"><div><div><div><div><div>- **Два реле**, контакты которых рассчитаны на коммутацию тока до 3 А и 30 В постоянного тока.
- **Четыре логических ввода.**   
    При подключении необходимо соблюдать полярность входных напряжений.  
    Напряжение логического нуля должно быть не более 1 В. Напряжение логической единицы не более 30 В.
- **интерфейс RS232C**, для подключения считывателя
- **интерфейс RS232C (RJ12 )**, для подключения второго считывателя через переходник
- **интерфейс UART (RJ45)**, подключения платы расширения
- **интерфейс для управления жидкокристаллическим дисплеем**
- **интерфейс Ethernet**, для обмена данными с персональным компьютером.

<div>Питание котроллера 12V 0.3А.</div><div>  
</div></div></div></div></div></div></div># Внешний вид и размеры

<div id="bkmrk-%C2%A0%C2%A0%C2%A0-%C2%A0-%C2%A0-%C2%A0-%C2%A0-%C2%A0-%C2%A0-%C2%A0-%D0%9A%D0%BE"><div><div><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td> [![](https://support.shelter.ru/sites/files/upload/images/nodes/8742/contr_size_upper.jpg)](https://support.shelter.ru/sites/files/upload/images/nodes/8742/contr_size_upper.jpg) [![](https://support.shelter.ru/sites/files/upload/images/nodes/8742/contr_size_side.jpg)](https://support.shelter.ru/sites/files/upload/images/nodes/8742/contr_size_side.jpg)

</td><td>![](https://support.shelter.ru/sites/files/upload/images/nodes/8742/kontroller_block12v.png)

</td></tr><tr><td class="rtecenter" colspan="2">**Контроллер со снятой верхней крышкой**</td></tr><tr><td colspan="2">![](https://support.shelter.ru/sites/files/upload/images/nodes/8742/kontroller_into.png)

</td></tr><tr><td class="rtecenter" colspan="2">**Контроллер схематически отображены разъемы**</td></tr><tr><td colspan="2">![](https://support.shelter.ru/sites/files/upload/images/nodes/8742/kontroller_razemi5.png)</td></tr></tbody></table>

</div></div></div># Функциональное назначение проводов и разъемов

## Основной логический провод

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-%D0%A2%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D0%B0-1-%3D%3D%3D%3D%3D%3D%3D%3D%3D%3D"><caption class="rteright">**Таблица 1**</caption><thead><tr><th scope="col">============</th><th scope="col">=====</th><th scope="col">===================================</th><th scope="col">==============================================</th></tr></thead><tbody><tr><td rowspan="2">Питание</td><td>**+12V**</td><td>Питание +12В / 0.3А</td><td colspan="1" rowspan="2">Питание контроллера</td></tr><tr><td>**GND**</td><td>Питание +12В / 0.3А</td></tr><tr><td colspan="1" rowspan="3">Реле №1</td><td>**НР 1**</td><td>Нормально разомкнутый РЕЛЕ1</td><td colspan="1" rowspan="3">Провода для формирования разрешающего  
сигнала на ВХОД</td></tr><tr><td>**СК 1**</td><td>Средний контакт РЕЛЕ1</td></tr><tr><td>**НЗ 1**</td><td>Нормально замкнутый контакт РЕЛЕ1</td></tr><tr><td colspan="1" rowspan="3">Реле №2</td><td>**НР 2**</td><td>Нормально разомкнутый РЕЛЕ2</td><td colspan="1" rowspan="3">Провода для формирования разрешающего  
сигнала на ВЫХОД</td></tr><tr><td>**СК 2**</td><td>Средний контакт РЕЛЕ2</td></tr><tr><td>**НЗ 2**</td><td>Нормальный замкнутый РЕЛЕ2</td></tr><tr><td colspan="1" rowspan="2">Логический 1</td><td>**D1+**</td><td>Вывод "+" логического 1</td><td colspan="1" rowspan="2">Провода, фиксирующие факт прохода на "ВХОД".  
Работают совместно с "Логический 2"</td></tr><tr><td>**D1-**</td><td>Вывод "-" логического 1</td></tr><tr><td colspan="1" rowspan="2">Логический 2</td><td>**D2+**</td><td>Вывод "+" логического 2</td><td colspan="1" rowspan="2">Провода, фиксирующие факт прохода на "ВЫХОД".  
Работают совместно с "Логический 1"</td></tr><tr><td>**D2-**</td><td>Вывод "-" логического 2</td></tr><tr><td colspan="1" rowspan="2">Логический 3</td><td>**D3+**</td><td>Вывод "+" логического 3</td><td colspan="1" rowspan="2">Не используются в Абонемент</td></tr><tr><td>**D3-**</td><td>Вывод "-" логического 3</td></tr><tr><td colspan="1" rowspan="2">Логический 4</td><td>**D4+**</td><td>Вывод "+" логического 4</td><td colspan="1" rowspan="2">Не используются в Абонемент</td></tr><tr><td>**D4-**</td><td>Вывод "-" логического 4</td></tr></tbody></table>

## Интерфейс UART

<div id="bkmrk-%D0%92%D1%8B%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD-%D0%BD%D0%B0-%D0%B2%D0%BE%D1%81%D1%8C%D0%BC%D0%B8-%D0%BA%D0%BE">Выведен на восьми контактную телефонную розетку типа TJ4-8P8C.</div><table border="1" cellpadding="1" cellspacing="1" id="bkmrk-%D0%A2%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D0%B0-%E2%84%962-%D0%98%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD"><caption class="rteright">**Таблица №2**</caption><tbody><tr><td class="rtecenter">**Изображение**</td><td class="rtecenter">**Номер разъема  
TJ4-8P8C**</td><td class="rtecenter">**Назначение вывода**</td></tr><tr><td>-----------------------------------</td><td class="rtecenter">------------------------</td><td>------------------------------------------------------------------------------------</td></tr><tr><td colspan="1" rowspan="8">![](https://support.shelter.ru/sites/files/upload/images/nodes/8742/rj45.png)</td><td class="rtecenter">1</td><td>Вход данных считывателя</td></tr><tr><td class="rtecenter">2</td><td>Общий</td></tr><tr><td class="rtecenter">3</td><td>Выход данных на считыватель</td></tr><tr><td class="rtecenter">4</td><td>Общий</td></tr><tr><td class="rtecenter">5</td><td>+5V</td></tr><tr><td class="rtecenter">6</td><td>Общий</td></tr><tr><td class="rtecenter">7</td><td>+5V</td></tr><tr><td class="rtecenter">8</td><td>Общий</td></tr></tbody></table>

## Интерфейс RS232C

Выведен на шести-контактную телефонную розетку типа TJ4-6P6C.  
С этой розеткой применяется вилка TP-6P6C

<table border="1" cellpadding="1" cellspacing="1" id="bkmrk-%D0%A2%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D0%B0-%E2%84%963-%D0%98%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD"><caption class="rteright">**Таблица №3**</caption><tbody><tr><td class="rtecenter">**Изображение**</td><td class="rtecenter">**Номер разъема  
TJ4-6P6C**</td><td class="rtecenter">**Назначение вывода**</td></tr><tr><td>-------------------------------------</td><td class="rtecenter">----------------------</td><td>-----------------------------------------------------------------------------------</td></tr><tr><td colspan="1" rowspan="6">![](https://support.shelter.ru/sites/files/upload/images/nodes/8742/rj12.png)</td><td class="rtecenter">1</td><td>+5V</td></tr><tr><td class="rtecenter">2</td><td>CTS</td></tr><tr><td class="rtecenter">3</td><td>Общий</td></tr><tr><td class="rtecenter">4</td><td>DTR</td></tr><tr><td class="rtecenter">5</td><td>RxD контроллера</td></tr><tr><td class="rtecenter">6</td><td>TxD контроллера</td></tr></tbody></table>

....