contact id таблица кодов полная
Обзор протокола ADEMCO Contact ID
Протокол ADEMCO Contact ID (еще называемый CID) – это протокол связи для систем сигнализаций. Для передачи сообщения используется стандарт DTMF, т.е. тональный набор.
Он был задуман для облегчения совместимости и взаимозаменяемости оборудования различных производителей передатчиков и приемников. Пакет данных, который передается на пульт центрального наблюдения (по GSM-сети или проводной телефонной линии) состоит из трех блоков:
Формат сообщения от охранной панели:
ACCT–MT–QXYZ–GG–CCC–S
ACCT – Четырехзначный (пультовый) номер объекта
MT – Тип сообщения, содержит = 18. Используется для обозначения протокола Contact ID.
Q – Тип события:
1 = Тревога или открытие
3 = Восстановление или закрытие
6 = Отчет о состоянии
XYZ – Трехзначный код события – таблицу с кодами можно посмотреть ниже
GG – Группа или номер раздела
CCC – Трехзначный номер шлейфа или пользователя
S – Контрольная сумма
Протокол Ademco Contact ID был разработан и опубликован в 1999 году, с тех пор много воды утекло, и охранные системы не стояли на месте и продолжали своё развитие. Поэтому в настоящее время многие производители самостоятельно разрабатывают протоколы и внедряют их в своё оборудование.
Звуковой файл с примером передачи данных в протоколе Contact ID (взят с форума компании Ритм)
Какие недостатки есть у протокола Ademco Contact ID?
Во-первых, это искажение сигнала на телефонных линиях низкого качества. Ввиду этого, время передачи на пульт сигналов с объекта может составлять достаточно продолжительное время (например, 15-20 минут).
Во-вторых, DTMF сигналы не предназначены для передачи по голосовому каналу сети GSM. Сообщения передаются звуками, и впоследствии оцифровываются и сжимаются, что опять приводит к искажениям сигнала. Вдобавок может сильно возрасти расход по сим-карте, например, от обрыва шлейфа. В зависимости от типа оборудования эта сумма может составить порядка 2-3 тысяч рублей за несколько дней.
В третьих, это недостаточный контроль ошибок, т.к. контрольная сумма считается всего одной цифрой. Статистически это приводит к тому, что каждая 15 ошибка остается, не обнаружена. Вот наглядный пример, как охранная панель передает на мониторинговую станцию сообщение: 1234 18 1131 01 015 8, где как мы уже знаем
1234 = пультовый номер объекта
18 = это число указывает, что мы имеем дело с Contact ID
1 = тип сообщения «тревога»
131 = тревога периметра
01 = номер раздела
015 = номер шлейфа
8 = контрольная сумма, рассчитанная следующим образом:
Сумма всех цифр (число 0 заменяем на 10) = (1 + 2 + 3 + 4) + (1 + 8) + (1 + 1 + 3 + 1) + (10 + 1) + (10 + 1 + 5) = 52, далее ищем ближайшее большее число кратное 15, в нашем случае это 60. Вычитаем 60 – 52 = 8. Как несложно догадаться, контрольная сумма может оказаться случайно правильной, несмотря на искажения информационных символов. При этом мониторинговая станция подтверждает прием сообщения.
В четвертых, протокол Ademco Contact ID является не защищенным способом передачи сообщений. Теоретически, если злоумышленник узнает пультовый номер охраняемого объекта, а так же номер телефона дозвона до мониторинговой станции, он сможет этим воспользоваться. Например, пустить в ход своё оборудование для имитации передачи сообщений о постановке/снятии и тестовых сообщений, а телефонную линию на объекте просто обрезать.
Несмотря на недостатки, данный протокол получил широкое распространение (для своего времени), благодаря своей открытости и информативности, среди прочих DTMF-протоколов.
Какие еще протоколы бывают?
Отличие форматов является степень информативности (Например в PAF не передаются исключения, а NPAF способен работать только с 20ю пользователями)
Телефон (PULSE, DTMF, FSK) – PAF, NPAF, EPAF
GSM (GPRS, CSD, SMS) – Contact ID, Jablotron IP, Jablotron SMS
Ethernet – PAF, NPAF, EPAF
Таблица кодов протокола Contact ID
Посмотреть таблицу с кодами вы можете в спойлере ниже:
Конвертер кодов сигнализации из ContactID в СМС
В этом обзоре рассмотрено довольно специфическое устройство, соответственно и его применение очень ограничено. Может пригодиться тем, у кого дома, или на даче, установлена старая сигнализация с передачей сигналов только по проводной телефонной линии. Обычно такого рода товар качественный и чаще меняется не из-за своего состояния, а из-за морального устаревания. У кого такое есть, с помощью этого устройства можно оживить старушку и продлить ей жизнь.
Покупал устройство на свои, правда чуток дешевле с купоном и по акции — около 40 долларов.
Итак, в квартире имеется старая, но надёжная, сигнализация PARADOX 728 с шестью датчиками движения и двумя дверными с проводным подключением. Досталась от предыдущего хозяина без блока питания и аккумулятора, но это не проблема. В полном комплекте выглядит так — 
Конечно перед покупкой устройства сигнализация была восстановлена, где-то заменены провода, пару датчиков, и протестирована.
Главная задача это транслировать непонятный код вида типа 123418113101002 в текстовое СМС с расшифровкой события, аналогично центральному пульту охраны, только в данном случае пультом будет являться мобильник.
Ток потребления, как видно, небольшой, поэтому у меня без проблем запиталась от самой сигнальной панели.
После установки СИМ карты, подсоединения четырьмя проводами к панели (+,-,RING,TLP), загрузил драйвера с комплектного CD на комп (Винь7), подключил устройство через мини USB (есть возможность слать команды по СМС, но проводом удобнее в разы). Заглянул в девайсы, подсмотрел номер СОМ порта и подключился софтиной к панельке. Там такая картина: 
Из настроек вбил только PIN симкарты, номер телефона для отсылки СМС и отметил галочками, какую инфу пересылать (без ложной скромности — всё).
Во второй вкладке и есть самое интересное — 
После вбивания номера партиции, зоны и СМС текста на мобильник будут приходить не наборы цифр, а расшифрованная информация. Этих кодов сотни, я не стал заниматься паранойей, а запрограммировал в панели высылать только установку, снятие с охраны и срабатывание датчиков на тревогу в охранном состоянии.
Как это выглядит на мобильнике:
без расшифровки смс: 
а теперь бег по квартире с расшифровкой: 
Да, да, кириллицы нет. Если вбить кириллицей — ничего не шлёт.
Ещё один момент, мало ли… Там есть возможность вбить APN и слать коды по GPRS, но количество символом в данных APN ограничено 16 знаками. Поэтому потестить эту функцию не получилось, у моего опсоса их 17. Не лезет. Хотя я и не планировал, изначально планировал использовать дешёвую сим карту только для СМС.
Фото в сборе, осталось окультурить:
Форматы передачи и приема сообщений NAVIgard
______________________________________________________________________________________________
CID = Contact ID — наиболее распространенный в мире высокоинформативный формат передачи тревожных сообщений.
CID поддерживается всеми ведущими производителями контрольных панелей и мониторинговых приемников.
По совокупности критериев оценки каналов передачи сообщений, приведенной в этой таблице, и по результатам функционально-стоимостного анализа приемной и передающей сторон, рекомендуется использовать формат передачи GPRS с резервированием/дублированием CLIP
*трафик, за который оператор связи будет требовать денег, сильно отличается от реального отправленного/принятого трафика.
Причина — в округлении, с заданной оператором точностью, за какой-то период времени, т.е.: если оператор округляет трафик с точностью 100 кб раз в 15 мин (распространённая практика), а в каждые 15 мин происходит любой обмен информацией (тест Е703, переподключение, сервисные сигналы поддержания подключения и прочее), то в месяц будет предъявлено к оплате 4*24*30*100 кб = 281 Мб трафика. Причем точность округления и период, в течении которого происходит округление, даже в пределах тарифных планов одного оператора сильно разнятся. Оптимальным вариантом для передатчика будет выбор тарифного плана с безлимитным интернетом, с дальнейшим анализом порядочности оператора.
CID IP — передача Contact ID в цифровом виде на статический IP адрес по каналу Ethernet.
• CID IP отчет считается доставленным, если передатчик получил ответ от мониторингового приемника о том, что приемник успешно принял отчет.
CID UDP — передача Contact ID в цифровом виде на GPRS приемник, используя GPRS канал оператора GSM связи по протоколу UDP. В UDP-отчете может передаваться за один сеанс связи сразу несколько кодов событий, если на момент передачи произошло более чем одно событие.
• UDP-отчет считается доставленным, если передатчик получил ответ от мониторингового приемника о том, что приемник успешно принял отчет.
NEW! Вместо статического IP адреса можете использовать Ваше доменное имя для передачи отчетов GPRS / CID UDP / CID IP.
CLIP — передача отчетов, используя автоматическое определение номера SIM-карты в сети GSM. Сообщением является сам факт звонка. Через 2 секунды после подъёма трубки соединение обрывается до начала тарификации разговора.
• CLIP-отчет считается доставленным (квитирование), если передатчик получил ответ от оператора связи о том, что абонент (приемники NV DG/DT 2xxx/3xxx) поднял трубку.
ALARM — звонок на телефон с передачей условных тональных сигналов / речевых сообщений, используя голосовой канал оператора GSM связи.
• ALARM-отчет считается доставленным, если передатчик получил ответ от оператора связи о том, что абонент поднял трубку.
VOICE — звонок на телефон с установлением двухстороннего прямого голосового соединения, используя голосовой канал оператора GSM связи.
• VOICE-отчет считается доставленным, если передатчик получил ответ от оператора связи о том, что абонент поднял трубку.
CID DTMF — Передача Contact ID в аналоговом виде на проводные станции мониторинга, используя голосовой канал оператора GSM связи. В DTMF-отчете может передаваться за один сеанс связи сразу несколько кодов событий, если на момент передачи произошло более чем одно событие.
• DTMF-отчет считается доставленным, если передатчик получил ответ от мониторингового приемника о том, что приемник успешно принял отчет.
Стандартные коды для протокола «Ademco Contact ID Protocol»
1 Стандартные коды для протокола «Ademco Contact ID Protocol» Структура передаваемых данных: ОООО КССС ГГ ЗЗЗ, где: ОООО четырехзначный код ограняемого объекта; К классификатор события, установлен в 1 означает новое событие (или «Е»), установленная цифра 3 восстановление (или «R»); ССС трехзначный код события; ГГ двухзначный код группы (адресный шлейф, объединенные в сеть приборы ); ЗЗЗ трехзначный код зоны/пользователя (шлейфа/входа/выхода). Таблица кодов Код Событие Группа «Тревоги» 100 Нажата Кнопка Медицинская тревога 101 Нажата Кнопка Паники 102 Неудача передачи сообщения 110 Пожарная Тревога 111 Тревога Дымовой Детектор 112 Тревога Возгорание 113 Тревога Утечка Воды 114 Тревога Тепловой Детектор 115 Нажата Кнопка Пожар 116 Тревога в Трубопроводе 117 Тревога Детектор Пламени 118 Вероятная Тревога 120 Нажата Кнопка Паника 121 Тревога из-за принуждения 122 Тихая Тревога; кнопка 123 Звуковая Тревога; кнопка 124 Принуждение, вход разрешен 125 Принуждение, выход разрешен 130 Тревога в зоне 131 Тревога в зоне периметра 132 Тревога в зоне внутренняя 133 Тревога в 24 часовой зоне 134 Тревога в зоне Вход/Выход 135 Тревога в зоне День/Ночь 136 Тревога в зоне Наружная 137 Тревога в зоне Тамперная 138 Вероятная Тревога 139 Верификатор проникновения 140 Общая тревога 141 Петля открыта 142 Петля шлейфа закорочена 143 Неисправность модуля расширения 144 Взлом Тампера детектора
2 145 Взлом Тампера модуля расширения 146 Тихая тревога; взлом 147 Неудача контроля детектора 150 Тревога 24 часовая не охранная зона 151 Тревога Детектор Газа 152 Тревога Холодильник 153 Тревога Утечка Тепла 154 Тревога Протечка Воды 155 Тревога Обрыв Фольги 156 Неисправность День 157 Низкий уровень газа в баллоне 158 Высокая Температура 159 Низкая Температура 161 Уменьшение Воздушного Потока 162 Тревога Угарный Газ 163 Неверный уровень в Резервуаре Группа «Наблюдение» 200 Контроль Пожара 201 Низкое Давление Воды 202 Низкая Концентрация СО2 203 Датчик Вентиля 204 Низкий Уровень Воды 205 Насос включен 206 Неисправность Насоса Группа «Неисправности» 300 Неисправность вторичного питания 301 Отсутствие сетевого питания 302 Низкое напряжение аккумулятора 303 RAM ошибка контрольная сумма 304 ROM ошибка контрольная сумма 305 Перезагрузка Системы 306 Изменена программа контрольной панели 307 Неудачный тест 308 Прекращение работы системы 309 Неудача Теста Аккумулятора 310 Неисправность «Земля» 311 Отсутствие Аккумулятора 312 Перегрузка Источника Питания 313 Программная перезагрузка инженером 320 Неисправность Сирены/Реле 321 Неисправность сирены Неисправность сирены Неисправность Реле Тревоги 324 Неисправность Реле Неисправность 325 Неисправность Реверсирование Реле 326 Извещение Устройство Извещение Устройство Неисправность системной периферии 331 Адресный шлейф открыт 332 Адресный шлейф К.З. 333 Неисправность модуля расширения 334 Неисправность повторителя 335 Принтер, нет бумаги 336 Потеря связи с принтером 337 Отсутствие DC питания внешнего модуля
3 338 Низкое напряжение аккумулятора внешнего модуля 339 Перезагрузка внешнего модуля 341 Вскрытие внешнего модуля 342 Отсутствие AC питания внешнего модуля 343 Неудача самотестирования внешнего модуля 344 Обнаружена Помеха на RF устройства 350 Нет связи со станцией мониторинга 351 Неисправность телефонной линии Неисправность телефонной линии Неисправность передатчика дальнего действия 354 Отсутствие связи со станцией мониторинга 355 Отсутствие контроля передатчика дальнего действия 356 Потеря опроса с Центра 357 Проблема КСВ для передатчика дальнего действия 370 Защитный шлейф 371 Защитный шлейф открыт 372 Защитный шлейф замкнут 373 Неисправность пожарного шлейфа 374 Ошибка Выходной зоны 375 Неисправность зоны Паника 376 Неисправность зоны Hold-Up 377 Неисправность датчика наклона 378 Неисправность связанных зон 380 Неисправность Сенсора 381 Потеря контроля за передатчиком RF 382 Потеря контроля RPM 383 Неисправность Тампер Детектора 384 Разряжена батарейка передатчика 385 Детектор Дыма; высокая чувствительность 386 Детектор Дыма; низкая чувствительность 387 Детектор Охраны; высокая чувствительность 388 Детектор Охраны; низкая чувствительность 389 Ошибка самодиагностики Детектора 391 Ошибка контроля детектора 392 Ошибка компенсации ухода частоты 393 Сигнал о техническом обслуживании Группа «Снятия/Постановки» 400 Снятие/Постановка с охраны 401 Снятие/Постановка пользователем 402 Снятие/Постановка раздела 403 Автоматическая снятие/постановка под охрану 404 Снятие/Постановка после установленного времени 405 Прерывание автоматической постановки 406 Отмена Тревоги 407 Снятие/Постановка охраны с компьютера 408 Быстрое Снятие/Постановка 409 Снятие/Постановка с охраны переключателем 441 Постановка с присутствием людей 442 Переключатель; Постановка с присутствием людей 450 Невозможность Снятия/Постановки 451 Снятие/Постановка до установленного времени 452 Снятие/Постановка после установленного времени 453 Отсутствие Снятия в установленное время 454 Отсутствие Постановки в установленное время 455 Неудача Автоматической Постановки
4 456 Частичная Постановка 457 Ошибка: Зона выхода открыта после выходной задержки 458 Пользователь в помещении 459 Тревога после недавней постановки пользователем 461 Ввод некорректного Кода/Пароля 462 Ввод корректного Кода/Пароля 463 Перепостановка после Тревоги 464 Время Автоматической Постановки увеличено 465 Сброс Тревоги Паника 466 Сервисная служба в/вне помещения 411 Запрос на ответный звонок 412 Удачный сеанс выгрузки 413 Неудачный сеанс выгрузки 414 Получена команда системного останова 415 Получена команда останова наборщика 416 Удачный сеанс загрузки 421 Доступ запрещен 422 Рапорт доступа пользователем 423 Доступ под принуждением 424 Выход Запрещен 425 Выход Разрешен 426 Дверь разблокирована и открыта 427 Неисправность, контроль статуса двери 428 Неисправность устройства Запрос на Выход 429 Вход в программирование доступа 430 Выход из программирования доступа 431 Изменение уровня доступа 432 Реле доступа не сработало 433 Запрос на Выход шунтирован 434 Контроль статуса двери шунтирован Группа «Обходы» 501 Считыватель отключен 520 Сирена/Реле отключена 521 Сирена 1 отключена 522 Сирена 2 отключена 523 Реле Тревоги отключено 524 Реле Неисправность отключено 525 Реверсирование Реле отключено 526 Извещение Устройство 3 отключено 527 Извещение Устройство 4 отключено 531 Добавлен модуль 532 Модуль удален 551 Коммуникатор отключен 552 Передатчик дальнего действия отключен 553 Удаленная Загрузка/Выгрузка отключена 570 Зона отключена 571 Пожарная зона отключена часовая зона отключена 573 Мгновенная Зона Охраны отключена 574 Групповое отключение зон 575 Swinger отключен 576 Зона Доступа Шунтирована 577 Зона Доступа Отключена
5 Группа «Тестовые» 601 Ручной тест посылки сообщений 602 Периодический тестовый отчет 603 Периодическая беспроводная передача 604 Пожарный тест 605 Отчет статуса 606 Голосовая связь 607 Режим Тест-Прохода детекторов 608 Периодический Тест Существует Системная Неисправность 609 Видео передача активирована 611 Контрольная точка пройдена 612 Контрольная точка не пройдена 613 Охранная зона протестирована в режиме Тест-Проход 614 Пожарная зона протестирована в режиме Тест-Проход 615 Кнопка Паники протестирована в режиме Тест-Проход 616 Вызов Сервисной Службы 621 Очистка журнала событий 622 Список событий заполнен на 50% 623 Список событий заполнен на 90% 624 Переполнен список событий 625 Системное время запрограммировано 626 Системное время, дата не корректна 627 Вход в режим программирования 628 Выход из режима программирования 629 Маркер в журнале событий на 32 часа 630 Изменение Расписания 631 Невозможность изменения расписания 632 Изменение Расписания Доступа 641 Senior Watch Trouble 642 Контроль ключа 651 Зарезервировано Ademco 652 Зарезервировано Ademco 653 Зарезервировано Ademco 654 Система не активна Добавленные события 900 Загрузка остановлена 901 Загрузка Начата/Закончена 902 Загрузка прервана 910 Автозакрытие после обхода 911 Обход закрыт
Модуль источника питания
Путеводитель по программированию модулей СПОСОБЫ ПРОГРАММИРОВАНИЯ Модули могут быть запрограммированы, используя следующие способы: Используя программное обеспечение WinLoad. Модули могут быть запрограммированы
Использование Asterisk для приема данных от охранных систем
Несколько лет назад мы перевели охранное предприятие, в котором я тогда работал, с обычной «проводной» телефонии на IP на базе Asterisk. Это была отдельная история, со своими пробами, ошибками, эпическими фэйлами и непрерывным познанием нового. С тех пор в части голосовой связи уже все отлажено, работает без сбоев и в достаточной степени устраивает всех заинтересованных лиц.
До последнего времени на проводных линиях работало только пультовое оборудование, в автоматическом режиме принимающее события с охраняемых объектов и передающее их для обработки диспетчерам. И вот, наконец, настал тот час, когда были побеждены собственная лень и административный голем, и функции этих железок тоже были переданы телефонному серверу.
Исходные данные и для чего это было затеяно
Как и что настраивалось
В дистрибутиве Asterisk еще с 2004 года присутствует модуль app_alarmreceiver, который призван эмулировать пультовый приемник. Вызывается он как обычная команда dialplan’а, отвечает на входящий звонок, обрабатывает события и складывает их в текстовый файл/файлы по указанному в настройках пути, после чего может вызвать для обработки этих файлов произвольную системную команду. С чем пришлось столкнуться при настройке:
Для начала — при приеме данных в лог начали пачками валиться сообщения от channel.c вида:
Выяснилось, что хотя стандарт DTMF поддерживает «цифры» длительностью от 40 мс, по умолчанию в Asterisk задано 80 мс, и все посылки меньшей длительности эмулируются до этого значения. В Contact ID длительность цифры определена как 50-60 мс. Благо по просьбам общественности с 2012 года соответствующий #DEFINE в channel.c продублировали параметром mindtmfduration в asterisk.conf, и после установки его равным 50, этот вопрос решился.
Второй проблемой оказалось то, каким образом полученные данные сохраняются и передаются дальше. По умолчанию весь сеанс передачи с одного объекта пишется в файл вида:
А затем для его обработки вызывается команда, указанная в параметре eventcmd файла alarmreceiver.conf. Меня это не устраивало по двум причинам:
Во-первых, при этом события поступят диспетчеру на обработку только после завершения сеанса связи. В случае, если на объекте действительно происходит что-то противоправное и датчики сигнализации срабатывают подряд один за другим, каждая такая сработка и последующее восстановление будут генерировать новые события, и завершение сеанса связи (и как следствие, отправка бойцов по тревоге) произойдет только после того, как на объекте больше не останется никого постороннего (и потенциально — ничего ценного).
Во-вторых, сами по себе события Contact ID не предусматривают какой-либо временной метки, и события появляются у диспетчера и пишутся в БД пультовой программы по мере поступления. При приеме событий «одной большой пачкой» в БД у них всех окажется одинаковый timestamp, что в дальнейшем может вызвать непонимание при общении с владельцами объекта и сложности с восстановлением хронологии реальных событий.
Казалось бы именно для предотвращения таких ситуаций сделан параметр logindividualevents, при котором alarmreceiver создает отдельный файл для каждого события. Но и тут не обошлось без ложки дегтя — файлы-то он отдельные создает, но eventcmd вызывает все равно только один раз при завершении сеанса. В результате от штатного механизма обработки отказались и добавили в incron правило IN_CLOSE_WRITE для папки с файлами событий — теперь они стали поступать на обработку немедленно после приема.
Третье — в метаданных файлов событий указано, с какого номера поступил входящий звонок, но не указано, на какой из наших номеров он пришел. А у нас из-за некоторых организационных особенностей, работает несколько независимых диспетчерских программ со своими БД и своими охраняемыми объектами для каждой. Причем данные с разных объектов приходят на разные входящие номера. Пришлось поправить app_alarmreceiver.c и добавить туда получение DNID из ast_channel и выдачу его вместе с остальными метаданными.
Обработка и передача дальше
Тут особых проблем не возникло, за исключением того, что диспетчерская программа весьма проприетарная и со сторонним оборудованием работать не умеет по принципиальным соображениям. Зато она умеет принимать данные от своего оборудования по UDP, и обработка свелась к простому bash-скрипту, который парсит файлы событий, созданные Asterisk’ом, формирует пакеты «от своего оборудования» и передает их на соответствующий диспетчерский ПК, в зависимости от DNID: