2. Квартиры

2.1 Раздел «Коды»

Раздел «Коды» предназначен для создания и назначения кодов для конкретной квартиры.

На странице отображается полный список всех кодов, которые хранятся в устройстве. 

Для того, чтобы создать новый код необходимо нажать на кнопку «Добавить код» (Рисунок 1).

image.png

Рисунок 1 — Кнопка добавления нового кода


Далее появляется окно, в котором нужно указать следующие данные (Рисунок 2):

image.png

Рисунок 2 — Создание нового кода


При необходимости можно удалить ненужный код, нажав на кнопку «Корзина», расположенную рядом с кодом (Рисунок 3).

image.png

Рисунок 3 — Удаление конкретной квартиры


Если нужно удалить разом все коды, то можно нажать на кнопку «Очистить все» (Рисунок 4).

image.png

Рисунок 4 — Удаление всех кодов


Для быстрого поиска конкретной квартиры или кода предусмотрен «Поиск», который позволит найти интересующий код либо квартиру (Рисунок 5).

image.png

Рисунок 5 — Поисковое поле


Перед поиском необходимо выставить переключатель на нужный параметр в зависимости от цели поиска. Переключатель содержит следующие параметры (Рисунок 6):

image.png

Рисунок 6 — Переключатель параметра поиска

2.2 Раздел «Ключи»

Раздел «Ключи» содержит список ключей, которые были добавлены и привязаны к квартире.

Один ключ может быть привязан только к одной квартире. 

Для добавления нового ключа необходимо нажать на кнопку «Добавить ключ» (Рисунок 7).

image.png

Рисунок 7 — Кнопка добавления ключа

Затем появится окно, в котором необходимо указать следующие данные (Рисунок 8):

image.png

Рисунок 8 — Добавление нового ключа

Каждый ключ, находящийся в системе, можно отредактировать или удалить. При редактировании есть возможность изменить квартиру, к которой будет привязан данный ключ (Рисунок 9).

image.png

Рисунок 9 — Удаление или редактирование ключа

В разделе предусмотрен поиск, позволяющий найти необходимый ключ, введя его идентификатор (Рисунок 10).

image.png

Рисунок 10 — Поиск ключа

В верхней части раздела находятся настройки, позволяющие работать с несколькими ключами одновременно (Рисунок 11):

image.png

Рисунок 11 — Общие настройки


2.2.1 Шифрование ключей через умный домофон Сокол в целях защиты от копирования

Прежде, чем начать работу по прошивке ключей, необходимо убедиться в том, что ключи не были прошиты ранее, они должны быть пустыми. Из-за особенностей различных типов ключей прошивка через панель может срабатывать не с первого раза (иногда требуется до 10 прикладываний). В случае, если Вы планируете использовать шифрование на постоянной основе, рекомендуем использовать для этого сторонние программаторы, например https://ikey.ru/tmd5s/

Ключи должны быть залиты на панель перед шифрованием вручную или через автосбор.

Работу по шифровании ключей рекомендуется проводить через POSTMAN. API работает на порту 8080 (если прошивка до 2 5 7 *) и 80 (для прошивки от 2 5 7 *).

Последнюю версию API можно запросить в группе поддержки в Telegram либо скачать с этой страницы.


Шаг 1

Для шифрования ключей через панель потребуется использовать API /v1/key/markup/mifare (Рисунок 12).

При GET-запросе с панели мы увидим ответ, в котором отобразятся 16 секторов (0-15) с данными по каждому сектору. По умолчанию они все пустые. 

image.png

Рисунок 12 

Нужно выбрать любой один сектор из 16 (не рекомендуется использовать сектор 0, так как в нём чаще всего хранятся системные данные ключа).

Для защиты ключа от копирования, нужно шифровать все сектора от 0 до 15.


Шаг 2

Создаем массив данных:

{
    "enable": true,
    "numSectors": 1,
    "markup": {
        "1": {
            "skip": {
                "err": true,
                "always": false
            },
            "key": {
                "type": "A",
                "value": "FFFFFFFFFFFF"
            },
            "3": "FFFFFFFFFFFFFF078069FFFFFFFFFFFF",
            "2": null,
            "1": null,
            "0": null
        }
    }
}

Где:

"enable": true,  — включает режим прошивки ключей
    "numSectors": 1, количество секторов (всегда 1, так как проверка осуществляется по одному сектору)
    "markup": {
        "1": { — номер сектора
"key": {
                "type": "A", тип ключа
                "value": "FFFFFFFFFFFF" — для авторизации в пустой сектор всегда будут такие значения
},
            "3": "FFFFFFFFFFFFFF078069FFFFFFFFFFFF",  — имеет вид "TypeA_AccessBits_TypeB"
и имеет структуру: TypeA = FFFFFFFFFFFF, Access bits = FF078069, TypeB = FFFFFFFFFFFF
            "2": null,
            "1": null,
            "0": null

}

В зависимости от того, в какой сектор вы будете зашивать нужный вам ключ, вы выбираете раздел из 12 символов (typeA/typeB) и записываете туда нужное значение, в будущем при проверке ключей домофонной панелью нужно будет указать именно тот раздел, в котором вы вписали ключ. Например готовый ключ в данном примере может выглядеть следующим образом: 112233445566FF078069FFFFFFFFFFFF, соответственно редактировали мы только typeA и использовать в следующем методе мы будем "key_type": "A".

AccessBits наугад вписывать не нужно, так как можно заблокировать запись/чтение секторов ключа.
Калькулятор для вычисления accessbits под различные требования: http://calc.gmss.ru/Mifare1k/

Ключ для шифрования обязательно надо запомнить: в будущем он указывается как проверочный.


Шаг 3

Вставляем массив в POSTMAN.

Обратите внимание на значения в синих прямоугольниках (рисунок 13).

image.png

image.png

Рисунок 13.

Нажимаем кнопку SEND.

Режим шифрования включен.


Шаг 4

Далее нужно начать прикладывать ключи: при этом на панели последовательно будут появляться надписи HOLD и OPEN. Это значит, что ключ шифруется. Если отображается только надпись OPEN, то ключ готов к использованию.

После того, как зашифровали все нужные ключи, необходимо в массиве в POSTMAN исправить строку "enable": true на "enable": false и снова нажать SEND. Тем самым мы выключим режим шифрования ключей.

"enable": false,  — выключает режим шифрования ключей


Шаг 5

Далее используем метод /key/settings. Через GET можно получить массив данных.

Правим его по примеру

{
    "mode": 1,
    "autocollect": {
        "enabled": false
    },
    "encryption": {
        "enabled": true,
        "key_type": "A",
        "key_auth": "112233445566",
        "sector": 1,
        "increment": {
            "enabled": false,
            "block": 0,
            "openByError": false
        }
    },
    "kb_codes": true,
    "offset": 255
}

Где:

"enabled": true, — вписываем чтобы включить шифрование
key_auth": "112233445566"— тут вписываем шифр, который придумали ранее
"sector":первым указываем сектор, который указывали ранее перед шифрования


Отправляем команду PUT (рисунок 14).

image.png

Рисунок 14

Шаг 6

Теперь нужно зайти в саму панель в раздел Квартиры→Ключи и убедиться, в настройках включено шифрование (рисунок 15).

image.png

Рисунок 15 — Включение шифрования.

После этого нужно включить шифрование на каждом ключе, нажав на шестеренку рядом с ключом (рисунок 15а).

image.png

Рисунок 15а — Включение шифрования на каждом ключе.

На этом процесс шифрования завершен. Теперь домофон могут открывать только прошитые ключи, скопированные ключи работать не будут.

Видеоинструкция по шифрованию ключей

2.2.2 Проверка зашифрованных ключей

Проверка позволит ограничить доступ в подъезд по незашифрованным ключам.

Используется метод /key/settings

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

image.png

Рисунок 16 — Разметка ключа


Каждый ключ имеет сектора с 0 по 15. В секторе располагается блок, который содержит 4 строки (0, 1, 2, 3). Каждая строка поддерживает 16 байт, но 3-я строка зарезервирована, как ключ доступа.

Строка с ключом доступа содержит:

Key_type — включает в себя «Key A» и «Key B». Поле Key_type представляет из себя выпадающий список для выбора.

Key_auth — это текстовое поле, в котором указано значение «Key A» или «Key B». Может содержать только 12 символов в 16-ой системе (6 байт).

Sector — содержит сектора от 0 по 15. Именно здесь выбирается какой сектор будет проходить проверку.


Increment

Increment — это улучшенная защита от копирования. Такая защита достигается следующим способом: когда происходит авторизация в сектор ключа (от 0 до 15), в указанный блок от 0 до 3 записывается число. При следующем прикладывании ключа это число каждый раз увеличивается на 1. Данное действие записывается также и в логи. Например, было изначально число 1, мы приложили ключ и число увеличилось на 1, то есть стало 2. Теперь число 2 будет хранится и в ключе, и в логах. А внешний сервис должен следить за тем, чтобы в прикладываемом ключе и в логах данные числа равномерно увеличивались. Если новое значение в ключе меньше значения в сервисе, то внешний сервис должен заблокировать ключ.

{
  "autocollect": {
    "enabled": false
  },
  "encryption": {
    "enabled": false,
    "key_type": "B",
    "key_auth": "FFFFFFFFFFFF",
    "sector": 0,
    "increment": {
      "enabled": false,
      "block": null,
      "openByError": false
    }
  }
  "kb_codes": true,
  "offset": 255
}


2.3 Раздел «Квартиры»

В разделе «Квартиры» отображается полный список квартир, добавленных на панель домофона. Здесь присутствуют как общие настройки, так и настройки для конкретной квартиры. 

Для того, чтобы открыть общие настройки, необходимо нажать на кнопку «Общие настройки» (Рисунок 17).

image.png

Рисунок 17 — Открытие общих настроек


Далее будет окно с настройками, состоящее из двух вкладок:

  1. Аудио;
  2. Диагностика.

Вкладка «Аудио» содержит параметры, позволяющие настроить звук для всех квартир. Отрегулировать можно следующие параметры (Рисунок 18):

Уровни громкости

Трубка

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

Дополнительно

Техническое уточнение: EchoD (расположен в sip/options) используется для эхоподавления SIP. Он может только включать / выключать подавление (по умолчанию включен).

image.png

Рисунок 18 — Настройка общего звука для панели, трубки и мобильного приложения


Вкладка «Диагностика» содержит параметры, обеспечивающие возможность индивидуальной настройки звонков в трубке.

Здесь можно указать параметры в диапазоне 0-255. Значение 255 считается стандартным (Рисунок 19):

image.png

Рисунок 19 — Настройка сопротивления


Чтобы открыть настройки для конкретной квартиры, необходимо нажать на «Шестеренку» рядом с нужной квартирой (Рисунок 20).

image.png

Рисунок 20 — Открытие персональной настройки квартиры


Далее появится окно с настройками, поделенная на 5 вкладок:

  1. Основные настройки;
  2. Аудио;
  3. Ключи;
  4. Коды;
  5. Диагностика.

Во вкладке «Основные настройки» расположены следующие параметры (Рисунок 21):

image.png

Рисунок 21 — Основные настройки конкретной квартиры


Вкладка «Аудио» содержит параметры, позволяющие настроить звук для конкретной квартиры.

По умолчанию применяются общие настройки, выбранные для всех квартир. Отрегулировать можно следующие параметры (Рисунок 22):

Уровни громкости

Трубка

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

image.png

Рисунок 22 — Настройка звука для панели, трубки и мобильного приложения для конкретной квартиры


Вкладка «Ключи» позволяет добавить ключ, который будет привязан к данной квартире.

Для добавления нового ключа в поле «Добавить ключ» необходимо ввести номер ключа и нажать на кнопку «Добавить» (Рисунок 23).

image.png

Рисунок 23 — Привязка нового ключа к квартире


При необходимости можно удалить ключ, нажав на кнопку «Корзина», расположенная напротив ненужного ключа (Рисунок 24).

image.png

Рисунок 24 — Удаление ключа


Вкладка «Коды» содержит список кодов, привязанных к данной квартире.

Для добавления нового кода в поле «Добавить код» следует ввести номер кода и нажать на кнопку «Добавить» (Рисунок 25).

image.png

Рисунок 25 — Привязка нового кода к квартире


Существует возможность удалить код при нажатии на кнопку «Корзина», расположенную напротив ненужного кода (Рисунок 26).

image.png

Рисунок 26 — Удаление кода


Вкладка «Диагностика» содержит настройки, позволяющие решить проблему со звонком для конкретной квартиры. Используются следующие параметры (Рисунок 27):

image.png

Рисунок 27 — Настройка сопротивления конкретной квартиры


Для добавления новой квартиры необходимо нажать на кнопку «Добавить квартиру» (Рисунок 28).

image.png

Рисунок 28 — Кнопка добавления квартиры


Далее откроется окно, в котором необходимо указать следующие данные (Рисунок 29):

image.png

Рисунок 29 — Добавление новой квартиры


Для удаления квартиры следует нажать на кнопку «Корзина», расположенную напротив ненужной квартиры (Рисунок 30).

image.png

Рисунок 30 — Удаление квартиры

Техническое уточнение. Если квартира забита в матрицу, то данную квартиру нельзя удалить пока она находится в матрице.

Функция «Настройка текущего звонка» позволяет отрегулировать параметры звука во время звонка. Для этого, во время звонка, необходимо отрегулировать настройки звука и нажать на кнопку «Обновить настройки для текущего звонка» (после завершения звонка настройки на панели сбрасываются). Если требуется сохранить данные настройки на квартиру, то указываем квартиру, для которой применятся данные параметры и нажимаем на кнопку «Применить к квартире» (Рисунок 31). 

image.png

Рисунок 31 — Настройка текущего звонка

2.3.1 Настройка уровней громкости и устранение неполадок

Чтобы задать параметры уровня громкости на панели и в трубке, необходимо зайти в раздел “Квартиры”, далее пункт “Квартиры”. Есть возможность регулировать уровни громкости как для отдельной квартиры, так и для всех квартир одновременно. Если на отдельной квартире не выставлены индивидуальные настройки, то к ней применяются настройки из раздела “Общие настройки”. При нажатии кнопки “Настройки текущего звонка” возможно в реальном времени управлять настройками уровней громкости.