Контролери, врати и четци

Контролери показва контролерите за достъп на тенанта. Всеки контролер се достига чрез един конектор, има една или две врати и до два четеца, които обслужват тези врати.

Добавянето, промяната и премахването на контролери, врати и четци изисква ролята Администратор на тенанта; операторите могат да изпратят конфигурацията отново; всички могат да разглеждат (Роли и права).

Типове контролери

Тип контролер избира драйвера на конектора:

Тип	Драйвер	Състояние
Симулатор (без хардуер)	simulator	Завършен. Софтуерни контролери в конектора за изпробване, демонстрации и тестове (Изпробване на Edge със симулатора).
TRAcK ACCESS TrackBase002	trackbase002	Още не е проверен. Конекторът говори протокола на контролера по TCP: конфигурира контролера, чете събитията му, сверява часовника му и отваря вратите му. Нужен му е ПИН кодът на контролера, зададен в Edge (ПИН на контролера). Вижте Контролери TrackBase002.

Контролери TrackBase002

Първо проверете с един контролер

Протоколът е възстановен чрез обратно инженерство от сървърния софтуер на производителя и още не е проверен с истински контролер. Изпробвайте го с един контролер, преди да преместите цял обект. Журналът на конектора на ниво debug показва всеки обмен с контролера (със скрит ПИН).

Преди да добавите такъв:

• Пригответе ПИН кода на контролера: въведете го в ПИН на контролера, когато добавяте контролера (ПИН на контролера). Без него контролерът е Офлайн с грешката the controller's PIN is not set: set it in Edge, а конфигурацията му – Неуспешна с config_rejected.
• Изчистете паметта за карти на контролера с инструментите на производителя. Edge не може да изброява или изчиства картите на контролера: картите, записани преди това със софтуера на производителя, които липсват в конфигурацията на Edge, не се премахват.
• Достигайте го по TCP/IP. RS-485 (серийна връзка) не се поддържа: конфигурацията е Неуспешна с unsupported.

Какво може да пази контролерът:

• Картата се записва с една времева зона, затова трябва да има едни и същи графици на всяка врата, която отваря. Иначе конфигурацията е Неуспешна с config_rejected, като назовава картата.
• Всеки различен набор от графици става времева зона на контролера: най-много 16 на контролер, най-много 8 времеви прозореца на ден за всяка (прозорците на припокриващи се или съседни графици се обединяват). Повече: config_rejected.
• Номерата на картите са 24-битови. Картите Wiegand 26 се побират (код на обекта и номер); ключовете iButton трябва да се побират в 6 шестнадесетични цифри. Два идентификатора с един и същ 24-битов номер: config_rejected. Пълна памет: capacity_exceeded.
• Празниците не се спазват: в тях важат времената за делничните дни, а контролерът показва предупреждението holidays are not enforced by TrackBase controllers: weekday times apply on them.
• Четците iButton (четци 3 и 4) приемат всяка записана карта на всяка врата, както прави и софтуерът на производителя. Контролерът показва предупреждение, когато това има значение.

Как работи:

• Промените се изпращат като разлика спрямо последно приложеното. Повторно изпращане на конфигурацията презаписва всяка времева зона и карта.
• Събитията се четат от журнала на събитията на контролера (31 968 записа). Нов контролер се чете от текущата му позиция: по-старите събития не се внасят. Четенията на карти пристигат като разрешен достъп, отказан достъп или непозната карта с вратата, четеца, посоката и идентификатора. Контролерът не записва дали е отворил, затова конекторът решава по конфигурацията, която е приложил (без празниците). Другите записи (температури, входове) още не се показват.
• След рестартиране на конектора събитията пристигат, след като конфигурацията бъде приложена отново: автоматично, когато контролерът е онлайн, с нов опит всяка минута.
• Конекторът сверява часовника на контролера в часовата зона на конфигурацията, когато се разминава с повече от 2 секунди.
• Дистанционното отваряне задейства Реле на ключалката на вратата; контролерът го освобождава след собственото си време на релето, затова Време за отключване (ms), зададено в Edge, не се изпраща.
• Онлайн или Офлайн идва от четене на състоянието, най-много на всеки 30 секунди. Състоянията на вратите остават Неизвестно: още не се отчитат. Липсващият ПИН и предупрежденията по-горе се показват като грешката на контролера.
• Фърмуер показва версията и типа на контролера, напр. 0123 (type 02).

Добавяне на контролер

Изберете Добавяне на контролер (трябва да има поне един конектор) и попълнете:

Поле	Значение
Конектор	Конекторът, който достига контролера. Избран е предварително, ако е само един; офлайн конекторите са отбелязани с (offline).
Име	Например Главен вход; 1–200 знака.
Тип контролер	Вижте Типове контролери. Не може да се промени по-късно.
Връзка	TCP/IP или RS-485 (Modbus).
Адрес	хост:порт, напр. 192.168.1.50:5000; за RS-485 серийният порт или Modbus шлюзът.
Адрес по шината (1-31)	Само за RS-485: адресът на контролера по шината.
Врати	Две врати с по един четец или Една врата с четци за вход и изход (вижте Режими на вратите). Може да се промени по-късно (Промяна на подредбата на вратите).
Обект	Неговият обект (графиците следват часовата зона на обекта) или Без обект (часовата зона по подразбиране на тенанта).
ПИН на контролера	Само за TrackBase002, по избор: ПИН кодът, с който е настроен контролерът (този, който е използвал софтуерът Track Access), число от 1 до 4294967294. Без него контролерът се добавя, но не работи, докато не бъде зададен ПИН (ПИН на контролера).

Изберете Добавяне на контролер. Edge създава вратите и четците и изпраща конфигурацията веднага (Контролерът е добавен: конфигурацията му е на път.).

Един конектор не може да има два контролера на един и същ адрес (и адрес по шината): controller_address_taken.

Търсене на контролери

Вместо да въвеждате адреса, изберете Търсене на контролери. Конекторът търси контролери и диалогът показва тези, които са отговорили (Намерени: 2. Изберете един, за да попълните формата.). Изборът на контролер попълва адреса, връзката, адреса по шината, режима на вратите и модела, серийния номер и фърмуера.

• Симулатор: показва се всеки симулиран контролер на конектора.
• TrackBase002: първо въведете Адреси за проверка (по един на ред) (до 256). Търсенето няма ПИН кодове: показва се всеки адрес, който отговори по TCP, без фърмуера му. Добавете го с неговия ПИН на контролера; тогава Проверка на връзката показва фърмуера.

Търсенето изисква конекторът да е онлайн (иначе connector_offline) и се прекратява след две минути.

Режими на вратите

Режим на вратите	Врати	Четци
Две врати с по един четец (two_unidirectional)	Врата 1 (реле 1), врата 2 (реле 2) с имена <контролер> – door 1 и – door 2	Wiegand 1: вход през врата 1; Wiegand 2: вход през врата 2
Една врата с четци за вход и изход (one_bidirectional)	Врата 1 (реле 1) с името на контролера	Wiegand 1: вход; Wiegand 2: изход

Новите врати имат време за отключване 3000 ms и аларма за задържане след 30 секунди.

Промяна на подредбата на вратите

Врати в Редактиране на контролера превключва между двата режима. Edge изгражда наново вратите и четците така, както би ги създал при добавяне на контролера с новия режим, като запазва това, което остава:

• Врата 1 винаги остава с името си, релето на ключалката, времето за отключване и мястото си в групите за достъп. Идентификаторът ѝ не се променя, така че историята ѝ остава с нея.
• Една врата → две врати: добавя се врата 2 (реле 2 или първото реле, което врата 1 не използва; с име <контролер> – door 2), а четецът Wiegand 2 става неин четец за вход. Врата 2 още не е в никоя група за достъп: добавете я към групите, които трябва да минават през нея.
• Две врати → една врата: врата 2 се премахва, а четецът Wiegand 2 става четец за изход на врата 1. Докато групи за достъп използват врата 2, това се отказва с door_in_use (409), като се посочват групите (door "Main entrance – door 2" is used by the access groups Staff: remove it from them first); диалогът го показва под Врати. Първо премахнете врата 2 от тези групи. Събитията на врата 2 остават в журнала на достъпа.
• Четците запазват името си и дали са включени; вратата и посоката им следват новата подредба.

Преди запазване диалогът обяснява какво ще стане. Новата подредба се изпраща на контролера веднага, както и нов адрес.

Списъкът с контролери

Колона	Значение
Име	Отваря контролера.
Обект	Неговият обект.
Адрес	Неговият адрес; #n е адресът по шината RS-485.
Конектор	Конекторът, който го управлява.
Състояние	Онлайн, Офлайн, Грешка (онлайн, но съобщава за проблем, показан на страницата на контролера), Неизвестно (конекторът му е офлайн или още не е отчел) или Деактивиран (Деактивиране на контролер).
Конфигурация	Състоянието на синхронизацията: Синхронизиран, Изчаква, Синхронизира се, Неуспешна (причината при посочване) или Деактивиран. Вижте Синхронизация на конфигурацията.
Карти	Картите в контролера спрямо капацитета му, напр. 412 / 2000.

Страницата на контролера

Преглед

Конектор, Обект, Модел, Сериен номер, Фърмуер (както ги отчита контролерът), Последно видян, състоянието на Конфигурация с Приложена версия и Желана версия и кога е приложена последно, и Карти, които пази, от 2000. Проблем, за който контролерът съобщава (състояние Грешка), се показва отдолу.

При TrackBase002 се показва и ПИН на контролера: Зададен или Не е зададен (ПИН на контролера).

Когато конекторът е офлайн, страницата го казва: Конекторът е офлайн: промените се прилагат, когато се свърже отново.

ПИН на контролера

TrackBase002 отговаря само на команди, които носят неговия ПИН. Редът ПИН на контролера в Преглед показва дали е зададен; самият ПИН не се показва никога повече, след като бъде запазен.

• Задаване на ПИН (или Смяна на ПИН, когато вече има) иска ПИН кода: число от 1 до 4294967294, този, с който е настроен контролерът. Запазване на ПИН (ПИН кодът е запазен: конекторът го използва оттук нататък.).
• Изчистване на ПИН го изтрива от Edge след потвърждение; конекторът не може да достигне контролера, докато не бъде зададен ПИН отново.
• Без ПИН страницата предупреждава: Задайте ПИН на контролера: без него конекторът не може да го достигне.

Задаването, смяната и изчистването на ПИН кода изискват ролята Администратор на тенанта. Edge пази ПИН кода шифрован с главния ключ на сървъра и го изпраща на конектора само с всяка задача за контролера; журналът на одита записва само дали има зададен ПИН. Нов или изчистен ПИН изпраща конфигурацията на конектора отново.

• Сървърът се нуждае от EDGE_MASTER_KEY за ПИН кодовете. Без него запазването или изчистването на ПИН е неуспешно с master_key_missing (controller PINs need EDGE_MASTER_KEY on the server).
• Ако сървърът вече не може да дешифрира запазен ПИН (главният му ключ е изгубен или сменен), конфигурацията на контролера е Неуспешна с controller_pin_unavailable: задайте ПИН кода отново.

Врати

Всяка врата с името си, Реле на ключалката (1–4), Време за отключване (ms) (100–60000: колко дълго ключалката е освободена при достъп или дистанционно отваряне) и Състояние (Заключена, Отключена или Неизвестно, докато контролерът не го отчете). Администраторите на тенанта променят името, релето и времето за отключване и избират Запазване; промяна на релето или времето се изпраща на контролера. Операторите и администраторите на тенанта отварят вратата и оттук (Врати и дистанционно отваряне).

Времето за аларма за задържане (0–3600 секунди, 0 = никога) се задава чрез API (API на Edge).

Четци

Всеки четец с неговия Канал (wiegand1, wiegand2, ibutton1, ibutton2), Име, Врата, която обслужва, Посока (Вход или Изход) и дали се използва (Включен или Изключен). Администраторите на тенанта именуват четците (напр. Вход фоайе; до 200 знака, Запазване се появява, щом името се промени), променят вратата и посоката и включват или изключват четци; промяна на вратата, посоката или състоянието се изпраща на контролера. Изключен четец не отваря нищо.

Дейност

Последните задачи на контролера: прилагане на конфигурации, проверки, отваряне на врати, с тяхното Състояние (Създадена, Изпратена, Потвърдена, Изпълнява се, Успешна, Неуспешна, Изтекло време, Отменена) и Грешка.

Проверка на връзката

Проверка на връзката кара конектора да достигне контролера и да отчете какъв е: Контролерът отговори: TrackBase002 или Контролерът не отговори: … с причината.

Повторно изпращане на конфигурацията

Повторно изпращане на конфигурацията (оператори и администратори на тенанта) изпраща пълната конфигурация на контролера, дори ако Edge смята, че контролерът я пази: след като контролерът е подменен, нулиран или променен ръчно. Edge прави това и сам, когато контролерът отчете конфигурация, различна от последно потвърдената.

Редактиране на контролер

Редактиране на контролера в заглавната част на страницата на контролера (администратори на тенанта) отваря форма с текущите настройки на контролера:

Поле	Значение
Име	1–200 знака.
Обект	Друг обект или Без обект.
Връзка	TCP/IP или RS-485 (Modbus).
Адрес	Както при добавянето.
Адрес по шината (1-31)	Само за RS-485.
Врати	Подредбата на вратите (Промяна на подредбата на вратите).

Запазване изпраща само промененото (Контролерът е запазен); грешките, открити от сървъра, се показват при съответното поле. Типът на контролера не може да се промени, а ПИН кодът има свой диалог (ПИН на контролера).

• Нов обект изпраща конфигурацията отново (часовата му зона).
• Нов адрес, връзка или адрес по шината, нов ПИН и нова подредба на вратите също я изпращат отново, дори когато самата конфигурация не се е променила: тогава конекторът обновява начина, по който достига контролера.
• Чрез API това е PATCH /tenants/{tenantID}/controllers/{controllerID} с някое от name, site_id или clear_site, transport, address, unit_id, door_mode, pin, clear_pin или enabled (Деактивиране на контролер).
• Деактивиран контролер също може да се редактира; промените се изпращат, когато бъде активиран отново.

Деактивиране на контролер

Деактивиране на контролера в заглавната част на страницата на контролера (администратори на тенанта) кара Edge и неговия конектор да оставят контролера изцяло на мира, например докато старият софтуер на производителя го управлява или докато е в сервиз. Потвърждението обяснява какво спира; след него:

• Конекторът спира да чете, конфигурира и сверява часовника на контролера: Edge отменя задачите му за конфигурация, които още са на път, и изпраща на конектора edge.controller.remove, както при премахване на контролера. Контролерът запазва това, което съдържа, и работи самостоятелно.
• Промените по картите, картодържателите, групите, графиците и празниците не се изпращат към него и Edge не опитва отново: докато е деактивиран, нищо не се нарежда за него.
• Събитията му не се събират, а това, което конекторът все още може да съобщи за него (състояние, врати), се пренебрегва.
• Състояние и Конфигурация показват Деактивиран в списъка и като значка в заглавната част на страницата, а страницата казва Този контролер е деактивиран. Той не се брои в таблото (нито в контролерите онлайн и общия им брой, нито като изчакващ или неуспешен).
• Отваряне, Проверка на връзката и Повторно изпращане на конфигурацията се скриват. Чрез API отварянето на негова врата, проверката и повторното изпращане се отказват с controller_disabled (409).
• Настройките му все още могат да се променят: име, обект, връзка, ПИН, подредба на вратите, врати и четци. Нищо не се изпраща, докато не бъде активиран отново.

Активиране на контролера (след потвърждение) връща всичко обратно: конфигурацията се изпраща отново изцяло (Изчаква, после Синхронизира се), включително всички промени, направени, докато контролерът е бил деактивиран, и конекторът отново започва да го управлява, когато я приложи.

Деактивирането и активирането се записват в журнала на одита като controller.update (enabled в стойностите преди и след). Чрез API това е PATCH /tenants/{tenantID}/controllers/{controllerID} с enabled: false или enabled: true; контролерите съдържат enabled, а деактивираният има sync_status disabled.

Премахване на контролер

Премахване на контролера (с потвърждение) премахва контролера заедно с вратите и четците му, а групите за достъп губят тези врати. Конекторът спира да го управлява. Журналът на достъпа пази събитията му.