Настройка интеграции с замковой системой SALTO
Сотрудники технической поддержки Shelter настройкой замковой системы не занимаются
Данная инструкция написана для замковых систем SALTO с версией программного обеспечения HAMS 100 v6.6.0.33 (Рис 1.) и Ethernet энкодером (Рис 2.).
Версия Ethernet v 01.02, версия Reader v02.43.

(Рис. 1)

(Рис. 2)
Заведение номерного фонда в программном обеспечении SALTO и ее настройка осуществляется системным администратором гостиницы
или представителями замковой системы. Сотрудники и инженеры отдела Shelter не занимаются настройкой программного обеспечения замковой системы.
Список доступных энкодеров и их настройки можно посмотреть в «Список периферии» на вкладке «Периферия» (Рис 3).

(Рис. 3)
Интеграция данной замковой системы осуществляется через PMS интерфейс, который включается в «Основные опции» на вкладке «Инструменты» (Рис. 4)

(Рис. 4)
В «Параметры связи» необходимо ввести IP адрес и номер порта компьютера, на котором будет запускаться ПО замковой системы
с включенным PMS интерфейсом.
Интеграция данной замковой системы с Shelter производилась на следующей версионности:
- версия библиотеки SdmTesa.dll 1.50.0.124 (библиотеку можно скачать тут)
- версия shelter 2.12.123.2420
После скачивания файлов с ftp, библиотеку SdmTesa.dll необходимо расположить в директории с shelter.exe.
Далее переходим в настройки Shelter, добавляем модуль для замковой системы (TESA HT28_TCP) и выставляем необходимые параметры (Рис 5).

(Рис. 5)
После чего, данные параметры продублируются в shelter.ini:
[HARDWARE.HT28-TCP]
;HOST – IP адрес, на котором запущена замковая система с включенным PMS интерфейсом
HOST=172.22.5.115
;PORT – порт подключения к PMS интерфейсу
PORT=5010
;DEVICEADDR – 1 если используется USB или RS232 энкодер, 2 если используется Ethernet энкодер.
DEVICEADDR=2
;USEPMSTRACK – использовать PMS трек для связки с RK и закрытия на номер. Если 0, то на вторую дорожку идентификатор записываться не будет.
Если 1, то будет.
USEPMSTRACK=1
;USEPMSTRACK – длина PMS трека
PMSTRACKMAXLEN=40
;DOCHECKOUT - Если 1, то перед изготовлением ключа, предыдущая информация на ключе стирается. Функция CancelCard. 0 — не стирается.
DOCHECKOUT=0
;DORESET, NEEDENQACK , ACTION - данные настройки в классической (базовой) реализации связи не менять!
DORESET=1
NEEDENQACK=1
ACTION=E
;DEFADDROOM2=101, DEFADDROOM3=102, DEFADDROOM4=103 - при данных настройках все ключи изготовленные из shelter будут
дополнительно открывать двери 101,102 и 103. Данные параметры можно оставить пустыми.
DEFADDROOM2=
DEFADDROOM3=
DEFADDROOM4=
IsLockMakeMultiKeys=0
; Файлы с логами будут создаваться в папке TESALogs, она создаедтся автоматически в каталоге с Shelter.
[BOOT]
BOOT_2=sdmTESA.dll
[HARDWARE]
LockCard=HT28-TCP
Далее заходим в shelter и для номерного фонда, в котором будут использоваться двери с электронами замками,
включаем опцию «Номер (ресурс) оборудован эл. замком».
Для замковой системы SALTO в поле «Номер устройства» необходимо выставить значение 0. (Рис 6).

(Рис. 6)
Для выпуска карты и проверки корректности настроек переходим на шахматку и в проживающем госте нажимаем на модуль замковой системы (Рис 7),
на котором будет представлена информация по заезду/выезда гостя.

(Рис. 7)
После изготовления ключей (основного/дополнительного) в shelter, корректность записи можно проверить в программном обеспечении замковой
системы, считав его на вкладке «Ключи» (Рис 8).

(Рис. 8)
Анализ основных ошибок
1. Несоответствие даты/времени выезда/заезда. Возвращается ошибка Bad checkout date and/or time или ErrorMessage= -1. (Рис. 9)

(Рис. 9)
В логе замковой системы:
4 06.04.2018 12:32:26> TESA card writting failured, error=1, OS error=0; ParamStr=&CMD=ISEXTRAROOMS
2. Нет связи с PMS интерфейсом (не настроен PMS интерфейс) или не запущено программное обеспечение замковой системы.
Возвращается ошибка ErrorMessage= -10. (Рис. 10)

(Рис. 10)
В логе замковой системы:
E2 06.04.2018 12:58:52> Transmit() (Exception): Can't connect socket; WSAError=10061
w3 06.04.2018 12:58:52> DoCommand failured. Result=-10, Win32 error code=0
4 06.04.2018 12:58:52> TESA card writting failured, error=-10, OS error=0;
3. Нет связи с энкодером или неверно указан параметр DEVICEADDR. Возвращается ошибка ErrorMessage= -3. (Рис. 11)

(Рис. 11)
В логе замковой системы:
5 06.04.2018 13:06:38> DoCommand finished with Answer=NF, Full answer=NFі1і, Result=-3
4 06.04.2018 13:06:38> TESA card writting failured, error=-3, OS error=0;
Важно!!! Замечена следующая симптоматика в работе энкодера:
При установленом в shelter.ini параметре «USEPMSTRACK = 0» при записи ключа энкодер пытается записать карту 2 раза (в итоге пищит два раза):
1. Записывает на дорожку замковой системы.
2. Пытается записать идентификатор на вторую дорожку для закрытия на номер, но т.к. параметр отключен, записать не дает, однако энкодер все равно пищит.