Выполняет роль сервера для приборов охранно-пожарной сигнализации Астра Дозор и реализует следующие функции:
- логирование и разбор сообщений от прибора
- передачу команд на прибор (список рабочих команд приведен ниже)
- отправка сообщений по протоколу MQTT на настроенный брокер MQTT (список топиков см.ниже)
Настройка прибора выполняется согласно руководства пользователя. Указываются IP-адрес, порт на котором работает сервер и ключ связи для обеспечения шифрования сообщений.
Выполняется запуск демона dozord с параметрами:
- -s - ИД устройства
- -k - ключ связи
- -l - порт сервера, по умолчанию - 1111
- -m - адрес сервера MQTT, 127.0.0.1
- -p - порт MQTT, 1883
- -d - режим отладки
- -h - вывод справки
После подключения устройства выполняется вывод полученных сообщений на экран. Отправка команд осуществляется путем публикации сообщения с текстом команды в соответствующий топик
Клиент с установленным интервалом шлет Keep-Alive сообщения в сторону сервера. Если сервер имеет команды для устройства, то команды упаковываются и отсылаются в виде ответа. Если команд нет, то посылается пустой ответ, содержащий только текущее время сервера (видимо по нему выставляется время на устройстве). При отсутствии ответа от сервера устройство накапливает события у себя в буфере (но теряет дату(!) события). При появлении ответа сервера - на сервер отправляются накопленные события.
Для шифрования сообщений используется общий ключ. Инициатором сообщений является устройство (обусловлено тем, что устройство может находиться за NAT/серой сетью и т.п.). Из этого следует, что отправить на устройство ничего нельзя пока устройство само не отправит сообщение.
Cостоит из открытой и закрытой части.
struct opened {
char msgLength[3];
char unknown;
uint16_t site;
uint32_t seed;
};Закрытая часть зашифрована по алгоритму RC4 (реализация из Wikipedia - RC4). Длина ключа - 16 байт. Ключ строится на основе соли из открытой части и ключа.
Закрытая часть состоит в свою очередь из реквизитов объекта и характеристики устройства и блока сообщений.
struct closed {
uint8_t tag;
short unsigned int channel:4;
short unsigned int sim: 4;
uint8_t voltage;
short unsigned int gsm_signal: 6;
short unsigned int extra_index: 2;
uint8_t extra_value;
};Примечательно, что для получения уровня напряжения нужно значение в сообщении поделить на 10. Channel 0x0 - Ethernet
struct message {
uint32_t time;
uint8_t unknownOne;
uint8_t unknownTwo;
uint8_t encrypted[]
}Перед шифрованием к сформированной строке команды добавляется символ "!" (0x21). В результирующем сообщении, в поле unknownOne устанавливается 0x0, в позицию unknownTwo - 0x7c.
| # | Event Type ID | Event Type | Event Scope | Description |
|---|---|---|---|---|
| 1 | 0x1 | DeviceConfiguration | ConfigurationEvent | Конфигурация устройства |
| 2 | 0x2 | ManualReset | CommonEvent | Выполнен ручной сброс системы |
| 3 | 0x3 | ZoneDisarm | ZoneEvent | Зона «Х» снята с охраны |
| 9 | 0x9 | ZoneWarning | ZoneEvent | Внимание, сработали датчики в зоне «Х» |
| 10 | 0xa | ZoneArm | ZoneEvent | Зона «Х» поставлена на охрану |
| 11 | 0xb | ZoneGood | ZoneEvent | Отмена всех тревог зоны |
| 12 | 0xc | ZoneFail | ZoneEvent | Ошибка постановки на охрану зоны «X» |
| 13 | 0xd | ZoneDelayedAlarm | ZoneEvent | Тревога зоны «Х» после таймаута |
| 15 | 0xf | ZoneAlarm | ZoneEvent | Тревога зоны «Х» |
| 16 | 0x10 | FallbackPowerRecovered | CommonEvent | Резервное питание восстановлено |
| 18 | 0x12 | FactoryReset | CommonEvent | Выполнен сброс на заводские установки |
| 19 | 0x13 | FirmwareUpgradeInProgress | CommonEvent | Производится обновление микропрограммы |
| 20 | 0x14 | FirmwareUpgradeFail | CommonEvent | Сбой обновления микропрограммы |
| 21 | 0x15 | TestEvent | CommonEvent | Тест |
| 22 | 0x16 | TestEvent | CommonEvent | Тест |
| 23 | 0x17 | CoverOpened | CommonEvent | Крышка прибора открыта |
| 24 | 0x18 | CoverClosed | CommonEvent | Крышка прибора закрыта |
| 25 | 0x19 | OffenceEvent | SecurityEvent | Действия под принуждением |
| 27 | 0x1b | UserAuth | AuthenticationEvent | Использован ключ пользователя «Х» |
| 29 | 0x1d | FallbackPowerFailed | CommonEvent | Сбой резервного питания |
| 30 | 0x1e | FailbackPowerActivated | CommonEvent | Выполняется переход на резервное питание |
| 31 | 0x1f | MainPowerFail | CommonEvent | Сбой основного питания |
| 32 | 0x20 | PowerGood | CommonEvent | Восстановлено основное питание |
| 37 | 0x25 | Report | ReportEvent | Ежедневный отчет |
| 38 | 0x26 | FirmwareUpgradeRequest | CommonEvent | Запрос обновления встроенного ПО |
| 39 | 0x27 | CardActivated | GSMEvent | Выполнена смена активной СИМ-карты |
| 40 | 0x28 | CardRemoved | GSMEvent | Извлечена СИМ-карта |
| 41 | 0x29 | CodeSeqAttack | SecurityEvent | Попытка подбора кода |
| 43 | 0x2b | SectionDisarm | SectionEvent | Раздел «Х» снят с охраны |
| 50 | 0x32 | SectionArm | SectionEvent | Раздел «Х» поставлен на охрану |
| 51 | 0x33 | SectionGood | SectionEvent | Отмена всех тревог раздела |
| 52 | 0x34 | SectionFail | SectionEvent | Ошибка взятия раздела «Х» |
| 53 | 0x35 | SectionWarning | SectionEvent | Внимание, раздел «Х» |
| 55 | 0x37 | SectionAlarm | SectionEvent | Тревога раздела «Х» |
| 56 | 0x38 | SystemFailure | CommonEvent | Неисправность системы |
| 57 | 0x39 | SystemDisarm | SecurityEvent | Снятие с охраны |
| 58 | 0x3a | SystemArm | SecurityEvent | Постановка на охрану |
| 59 | 0x3b | SystemMaintenance | SecurityEvent | Введен инженерный код |
| 60 | 0x3c | SystemOverfreeze | ReportEvent | Переохлаждение оборудования |
| 62 | 0x3e | SystemOverheat | ReportEvent | Перегрев оборудования |
| 63 | 0x3f | RemoteCommandHandled | SystemEvent | Обработана внешняя команда |
| # | Event Type ID | Длина сообщения |
|---|---|---|
| 2 | 1 | 7 |
| 3 | 2 | 7 |
| 4 | 3 | 6 |
| 5 | 4 | 6 |
| 6 | 5 | 6 |
| 7 | 6 | 6 |
| 8 | 7 | 6 |
| 9 | 8 | 6 |
| 10 | 9 | 6 |
| 11 | 10 | 6 |
| 12 | 11 | 6 |
| 13 | 12 | 6 |
| 14 | 13 | 6 |
| 15 | 14 | 6 |
| 16 | 15 | 6 |
| 17 | 16 | 6 |
| 18 | 17 | 9 |
| 19 | 18 | 5 |
| 20 | 19 | 5 |
| 21 | 20 | 5 |
| 22 | 21 | 6 |
| 23 | 22 | 6 |
| 24 | 23 | 6 |
| 25 | 24 | 5 |
| 26 | 25 | 5 |
| 27 | 26 | 6 |
| 28 | 27 | 6 |
| 29 | 28 | 6 |
| 30 | 29 | 6 |
| 31 | 30 | 6 |
| 32 | 31 | 6 |
| 33 | 32 | 6 |
| 34 | 33 | 5 |
| 35 | 34 | 7 |
| 36 | 35 | 7 |
| 37 | 36 | 9 |
| 38 | 37 | 9 |
| 39 | 38 | 5 |
| 40 | 39 | 21 |
| 41 | 40 | 6 |
| 42 | 41 | 5 |
| 43 | 42 | 22 |
| 44 | 43 | 6 |
| 45 | 44 | 6 |
| 46 | 45 | 6 |
| 47 | 46 | 6 |
| 48 | 47 | 6 |
| 49 | 48 | 6 |
| 50 | 49 | 6 |
| 51 | 50 | 6 |
| 52 | 51 | 6 |
| 53 | 52 | 6 |
| 54 | 53 | 6 |
| 55 | 54 | 6 |
| 56 | 55 | 6 |
| 57 | 56 | 6 |
| 58 | 57 | 9 |
| 59 | 58 | 9 |
| 60 | 59 | 6 |
| 61 | 60 | 6 |
| 62 | 61 | 6 |
| 63 | 62 | 6 |
| 64 | 63 | 10 |
| 65 | 64 | 8 |
| 66 | 65 | 42 |
| 67 | 66 | 9 |
| 68 | 67 | 78 |
Данные обычно лежат в адресе "0". Приведена таблица для типов событий, использующих иные адреса
| # | Event Type ID | Event Type | Address | Description |
|---|---|---|---|---|
| 1 | 0x1 | DeviceConfiguration | 0 - минорная версия прошивки, 1 - мажорная версия | применить операцию AND 0x7 к мажорной версии |
| 16 | 0x10 | FallbackPowerRecovered | значение напряжения в вольтах | |
| 27 | 0x1b | UserAuth | 3 | ИД пользователя |
| 29 | 0x1d | FallbackPowerFailed | значение напряжения в вольтах | |
| 30 | 0x1e | FailbackPowerActivated | значение напряжения в вольтах | |
| 31 | 0x1f | MainPowerFail | значение напряжения в вольтах | |
| 32 | 0x20 | PowerGood | значение напряжения в вольтах | |
| 37 | 0x25 | Report | 1 | если в позиции 0 значение "2", то значение текущей температуры в гр.Цельсия |
| 57 | 0x39 | SystemDisarm | значение в позиции "0" представляет снятые с охраны разделы в бинарной форме. Т.е. значение ff можно выразить как 1 1 1 1 1 1 1 1.Т.е. все 8 разделов сняты с охраны |
|
| 58 | 0x3a | SystemArm | значение в позиции "0" представляет поставленные на охрану разделы в бинарной форме. Т.е. значение 07 можно выразить как 0 0 0 0 0 1 1 1.Т.е. первые 3 раздела поставлены на охрану |
|
| 63 | 0x3f | RemoteCommandHandled | 5 | в позиции 0 - ИД команды, в позиции 5 - результат обработки |
| Result ID | Result Name |
|---|---|
| 0x1 | Success |
| 0x2 | Not implemented |
| 0x3 | Incorrect parameter(s) |
| 0x4 | Busy |
| 0x5 | Unable to execute |
| 0x6 | Already executed |
| 0x7 | No access |
- Постановка на сигнализацию - "ARM:"
- Постановка на сигнализацию выбранного раздела "2" - "ARM:&2"
- Снятие с сигнализации - "OFF:"
- Снятие с сигнализации выбранного раздела "2" - "OFF:&2"
- Перезагрузка устройства - "REBOOT:"
- Включить зону - "ZON:11"
- Выключить зону - "ZOFF:11"
- Переключить реле - "OUT:1, 0|1|2", где (0 - выключить, 1 - включить, 2 - инвертировать)
- Показать на экран сообщение - "SHOW: MessageToShow"
- Отправка уровня сигнала извещателей (упоминается в истории изменений для версии 4.25) - BRIMS
- Запрос кадра из архива видеокадров (упоминается в истории изменений для версии 4.25) - CAM
- Запрос состояния (упоминается в истории изменений для версии 4.25) - TEST
- /nightshift/notify - при подключении к брокеру MQTT. Формат сообщения:
{\"version\": \"%s\", \"name\": \"nightshift\", \"agentID\": \"%s\", \"siteId\": %d}
- /nightshift/sites/%d/reports - ежесуточный отчет устройстваю. Формат сообщения:
{"agentID": "80d7be61-d81d-4aac-9012-6729b6392a89", "message": {"deviceIp":"127.0.0.1","received":"Wed Jul 22 09:32:48 2020","payload":{"site":1,"typeId":37,"timestamp":"Thu Nov 28 09:00:00 2019","data":"0210000000","temp":16,"event":"Report","scope":"Common"}}}
- /nightshift/sites/%d/events - события от устройства. Формат сообщения:
{"agentID": "80d7be61-d81d-4aac-9012-6729b6392a89", "message": {"deviceIp":"127.0.0.1","received":"Wed Sep 9 12:42:19 2020","payload":{"site":1,"typeId":32,"timestamp":"Sun Dec 8 13:51:20 2019","data":"B71F","event":"PowerGood","scope":"Common"}}
}
{"agentID": "80d7be61-d81d-4aac-9012-6729b6392a89", "message": {"deviceIp":"127.0.0.1","received":"Wed Sep 9 12:42:19 2020","payload":{"site":1,"typeId":31,"timestamp":"Sun Dec 8 13:53:31 2019","data":"A710","event":"MainPowerFail","scope":"Common"}}
}
{"agentID": "80d7be61-d81d-4aac-9012-6729b6392a89", "message": {"deviceIp":"127.0.0.1","received":"Wed Sep 9 12:42:19 2020","payload":{"site":1,"typeId":16,"timestamp":"Sun Dec 8 13:54:48 2019","data":"0E1D","event":"FallbackPowerRecovered","scope":"Common"}}
}
{"agentID": "80d7be61-d81d-4aac-9012-6729b6392a89", "message": {"deviceIp":"127.0.0.1","received":"Wed Sep 9 12:42:19 2020","payload":{"site":1,"typeId":29,"timestamp":"Mon Jan 1 03:00:00 2001","data":"7F01","event":"FallbackPowerFailed","scope":"Common"}}
}
{"agentID": "80d7be61-d81d-4aac-9012-6729b6392a89", "message": {"deviceIp":"127.0.0.1","received":"Wed Sep 9 12:42:19 2020","payload":{"site":1,"typeId":1,"timestamp":"Mon Jan 1 03:00:00 2001","data":"1D043A","event":"DeviceConfiguration","scope":"Common","version":"4.29"}}
- /nightshift/sites/%d/status - состояние устройства на охране/снят с охраны
{"agentID": "80d7be61-d81d-4aac-9012-6729b6392a89", "message": {"deviceIp":"213.87.240.135","received":"Sat Sep 12 12:24:29 2020","payload":{"site":1,"typeId":57,"timestamp":"Sat Sep 12 12:24:28 2020","data":"F800000103","user":1,"event":"SystemDisarm","scope":"Security"}}
{"agentID": "80d7be61-d81d-4aac-9012-6729b6392a89", "message": {"deviceIp":"213.87.240.135","received":"Sat Sep 12 12:24:29 2020","payload":{"site":1,"typeId":57,"timestamp":"Sat Sep 12 12:24:28 2020","data":"F800000103","user":1,"event":"SystemArm","scope":"Security"}}
- /nightshift/sites/%d/zones/%d/events - события от устройства по выбранной зоне
{"agentID": "80d7be61-d81d-4aac-9012-6729b6392a89", "message": {"deviceIp":"127.0.0.1","received":"Wed Sep 9 12:45:15 2020","payload":{"site":1,"typeId":10,"timestamp":"Mon Jan 1 03:00:00 2001","data":"1332","zone":19,"event":"ZoneArm","scope":"Zone"}}
}
- /nightshift/sites/%d/sections/%d/events - события от устройства по выбранному разделу
{"agentID": "80d7be61-d81d-4aac-9012-6729b6392a89", "message": {"deviceIp":"127.0.0.1","received":"Wed Sep 9 12:46:11 2020","payload":{"site":1,"typeId":51,"timestamp":"Wed Dec 29 16:01:21 2038","data":"0121","section":1,"event":"SectionGood","scope":"Section"}}
}
- /nightshift/sites/%d/notify - heartbeat-события от устройства
{"agentID": "80d7be61-d81d-4aac-9012-6729b6392a89", "message": {"deviceIp":"127.0.0.1","received":"Wed Jul 22 09:35:24 2020","payload":{ "site":1,"typeId":null,"event":"KeepAliveEvent","scope":"KeepAlive","channel":0,"sim":0,"voltage":17.00,"signal":0,"extraId":1,"extraValue":20,"data":"0000B2401400"}}}
- /nightshift/sites/%d/commandresults - результат выполнения команды
- /nightshift/sites/%d/disconnnected - топик для публикации MQTT WILL сообщения
- /nightshift/sites/%d/command - команда указывается в теле сообщения
| # | Event Type ID | Event Type | Event Scope | Topic |
|---|---|---|---|---|
| 1 | 0x1 | DeviceConfiguration | ConfigurationEvent | /nightshift/sites/%d/events |
| 2 | 0x2 | ManualReset | CommonEvent | /nightshift/sites/%d/events |
| 3 | 0x3 | ZoneDisarm | ZoneEvent | /nightshift/sites/%d/zones/%d/events |
| 9 | 0x9 | ZoneWarning | ZoneEvent | /nightshift/sites/%d/zones/%d/events |
| 10 | 0xa | ZoneArm | ZoneEvent | /nightshift/sites/%d/zones/%d/events |
| 11 | 0xb | ZoneGood | ZoneEvent | /nightshift/sites/%d/zones/%d/events |
| 12 | 0xc | ZoneFail | ZoneEvent | /nightshift/sites/%d/zones/%d/events |
| 13 | 0xd | ZoneDelayedAlarm | ZoneEvent | /nightshift/sites/%d/zones/%d/events |
| 15 | 0xf | ZoneAlarm | ZoneEvent | /nightshift/sites/%d/zones/%d/events |
| 16 | 0x10 | FallbackPowerRecovered | CommonEvent | /nightshift/sites/%d/events |
| 18 | 0x12 | FactoryReset | CommonEvent | /nightshift/sites/%d/events |
| 19 | 0x13 | FirmwareUpgradeInProgress | CommonEvent | /nightshift/sites/%d/events |
| 20 | 0x14 | FirmwareUpgradeFail | CommonEvent | /nightshift/sites/%d/events |
| 21 | 0x15 | TestEvent | CommonEvent | /nightshift/sites/%d/events |
| 22 | 0x16 | TestEvent | CommonEvent | /nightshift/sites/%d/events |
| 23 | 0x17 | CoverOpened | CommonEvent | /nightshift/sites/%d/events |
| 24 | 0x18 | CoverClosed | CommonEvent | /nightshift/sites/%d/events |
| 25 | 0x19 | OffenceEvent | SecurityEvent | /nightshift/sites/%d/events |
| 27 | 0x1b | UserAuth | AuthenticationEvent | /nightshift/sites/%d/events |
| 29 | 0x1d | FallbackPowerFailed | CommonEvent | /nightshift/sites/%d/events |
| 30 | 0x1e | FailbackPowerActivated | CommonEvent | /nightshift/sites/%d/events |
| 31 | 0x1f | MainPowerFail | CommonEvent | /nightshift/sites/%d/events |
| 32 | 0x20 | PowerGood | CommonEvent | /nightshift/sites/%d/events |
| 37 | 0x25 | Report | ReportEvent | /nightshift/sites/%d/reports |
| 38 | 0x26 | FirmwareUpgradeRequest | CommonEvent | /nightshift/sites/%d/events |
| 39 | 0x27 | CardActivated | GSMEvent | /nightshift/sites/%d/events |
| 40 | 0x28 | CardRemoved | GSMEvent | /nightshift/sites/%d/events |
| 41 | 0x29 | CodeSeqAttack | SecurityEvent | /nightshift/sites/%d/events |
| 43 | 0x2b | SectionDisarm | SectionEvent | /nightshift/sites/%d/sections/%d/events |
| 50 | 0x32 | SectionArm | SectionEvent | /nightshift/sites/%d/sections/%d/events |
| 51 | 0x33 | SectionGood | SectionEvent | /nightshift/sites/%d/sections/%d/events |
| 52 | 0x34 | SectionFail | SectionEvent | /nightshift/sites/%d/sections/%d/events |
| 53 | 0x35 | SectionWarning | SectionEvent | /nightshift/sites/%d/sections/%d/events |
| 55 | 0x37 | SectionAlarm | SectionEvent | /nightshift/sites/%d/sections/%d/events |
| 56 | 0x38 | SystemFailure | CommonEvent | /nightshift/sites/%d/events |
| 57 | 0x39 | SystemDisarm | SecurityEvent | /nightshift/sites/%d/status |
| 58 | 0x3a | SystemArm | SecurityEvent | /nightshift/sites/%d/status |
| 59 | 0x3b | SystemMaintenance | SecurityEvent | /nightshift/sites/%d/events |
| 60 | 0x3c | SystemOverfreeze | ReportEvent | /nightshift/sites/%d/events |
| 62 | 0x3e | SystemOverheat | ReportEvent | /nightshift/sites/%d/events |
| 63 | 0x3f | RemoteCommandHandled | SystemEvent | /nightshift/sites/%d/commandresults |