# Обновление прошивки # Что нового? [Firmware]
2.5.0.10.13 — 12.09.2024 ### Прошивка 2.5.0.10.13 Ссылка на файлы прошивки: [https://www.is74.ru/upload/domofonsokol/firmware/x5/2.5.0.10.13.zip](https://www.is74.ru/upload/domofonsokol/firmware/x5/2.5.0.10.13.zip) Ссылка для обновления: [http://firmware.domofon-sokol.ru/X5/2.5.0.10.13/](http://firmware.domofon-sokol.ru/X5/2.5.0.10.13/) Актуальный API можно скачать на странице [API-документация](https://doc.sokol.global/books/umnyi-domofon-sokol-plius/page/api-dokumentaciia "API-документация")

**Обновление на данную версию прошивки возможно НАЧИНАЯ С ВЕРСИИ 2.5.0.6.5**

**ВАЖНО! Данная версия прошивки является переходной и предназначена для устранения возможных проблем с зависанием панели при обновлении. ОБЯЗАТЕЛЬНО обновитесь на данную версию прошивки перед обновлением на последующие версии.**

#### Алгоритм действий при обновлении на данную версию прошивки 1. Перезагрузить панель; 2. Запустить обновление только на раздел OPT: - через API — opt;
```json { "url": "http://firmware.domofon-sokol.ru/X5/2.5.0.10.13", "mcu": false, "opt": true, "media": false, "rootfs": false } ``` - через web-интерфейс — Обновить приложения; [![image.png](https://doc.sokol.global/uploads/images/gallery/2024-09/scaled-1680-/image.png)](https://doc.sokol.global/uploads/images/gallery/2024-09/image.png) 3. Проверить, что версия раздела OPT соответствует данной: **2.5.0.10.13** - Если соответствует, перейти к пункту 4; - Если не соответствует, повторить пункты 1 и 2; 4. Запустить обычное обновление устройства.

**Если во время прошивки через web-интерфейс вы получаете ошибку "Ошибка при проверке подлинности файла /tmp/complex/firmware.bin", то обновление необходимо запустить через API или обратиться за помощью к инженерам группы поддержки**

#### \#Web-Интерфейс - Исправили алгоритм загрузки списка ключей; - Исправили алгоритм загрузки списка квартир; - Исправили ошибку, которая могла возникать при импорте большого количества кодов; - Скорректировали поведение поля "Частота кадров"; - Скорректировали процедуру импорта ключей с разным количеством символов; - Скорректировали процедуру создания ключей с разным количеством символов; - Исправили отображение уровней трубок в персональных настройках квартир; - Исправили отображения стандартных уровней трубок в персональных настройках квартир; - Добавили настройку третьего видеопотока; - Добавили поддержку новых методов матриц ККМ; - /v1/switch/N - /v1/switch/models - Добавили настройку общего кода открытия; - Добавили новые поля в раздел "SIP-аккаунт"; - Порт для вызовов; - SIP-домен для вызовов; - Порт для регистрации; - SIP-домен для регистрации; - Добавили поддержку символа ";" при импорте csv-файла; - Добавили ограничение на ввод кириллицы при смене пароля; - Добавили тестовый вызов с панели в режиме калитка с префиксом; - Добавили блокировку для создания ключа без доступов ко входам; - Добавили переключатель "Имеется задолженность" в персональные настройки квартир; - Добавили подсказку по допустимым форматам SIP-номеров для SOS и Консьерж; - Добавили блокировку для сохранения внешнего входа без выбора "Номер входа" #### \#SIP-клиент - Исправили воспроизведение офлайн-ассистента при открытии внешнего модуля; - Исправили воспроизведение офлайн-ассистента на режим "Открытие любым ключом"; - Исправили воспроизведение офлайн-ассистента при открытии основной двери с любого считывателя; - Добавили оповещение задолжников по квартире при прикладывании ключа; #### \#RTSP-сервер - Исправили ошибку "400 Bad Request" при настройке 3-его видеопотока; - Исправили некорректное отображение OSD на втором потоке; #### \## HTTP-сервер - Заблокировали метод "**/v2/system/upgrade**";

**ВАЖНО! После обновления будет работать только метод "/v3/system/upgrade"**

- Исправили сохранение внешнего модуля без указания адреса; - Исправили загрузку резервной копии без данных о внешних модулях; - Исправили обработку json объекта в методе "**/relay/doors/mapping**"; - Исправили работу параметра "**soundOpenPanel**" в методе "**/panelCode/settings**"; - Добавили метод загрузки резервной копии на FTP-сервер; - /system/backup/ftp - Добавили метод изменения громкости офлайн-ассистента; - /assistant/settings - Добавили ограничение на ввод кириллицей при изменении пароля; - Добавили метод восстановления резервной копии с FTP-сервера; - /system/restore/ftp #### \#UART-клиент - Добавили сообщение в логи для ключа без доступа ко входу; - UUID {uuid}, flat {flat}, has no access to {gate} #### \#Обновление прошивки - Исправили возможную проблему с зависанием панели при обновлении; - Добавили игнорирование последнего символа "/" при запуске обновления; - Добавили перезагрузку устройства перед запуском обновления устройства; #### \#Микроконтроллер - Исправили работу режима "Автосбор"; - Исправили включение "Сервисного режима"; - Исправили завершение вызова в АТ в снятом состоянии; - Исправили открытие основной двери с любого считывателя; - Исправили включение "Режим двери открыты" при запуске панели; - Исправили воспроизведение звуков в трубке при прикладывании ключа; - Исправили бесконечный звук вызова при ошибке вызова по кнопке "Консьерж"; - Исправили закрытие основной двери при открытии внешнего модуля; - Исправили зависание панели при одновременном нажатии кнопок "SOS" и "Вызов"; - Исправили воспроизведение офлайн-ассистента при открытии с внешнего модуля; - Исправили работу "Режим открытых дверей" на втором выходе при использовании ПУЗ с ШИМ; - Добавили изменение громкости офлайн-ассистента.
2.5.9.0.4 — 18.07.2024 ### Прошивка 2.5.0.9.4 Ссылка на файлы прошивки: [https://www.is74.ru/upload/domofonsokol/firmware/x5/2.5.0.9.4.zip](https://www.is74.ru/upload/domofonsokol/firmware/x5/2.5.0.9.4.zip) Ссылка для обновления: [http://firmware.domofon-sokol.ru/X5/2.5.0.9.4/](http://firmware.domofon-sokol.ru/X5/2.5.0.9.4/) Актуальный API можно скачать на странице [API-документация](https://doc.sokol.global/books/umnyi-domofon-sokol-plius/page/api-dokumentaciia "API-документация") #### \#WEB-интерфейс - Исправили нумерацию внешних модулей в окне редактирования ключа; - Исправили отображение списка разрешений для видеопотоков на странице "Настройки видеопотока"; - Исправили сохранение "Границы светлого" меньше "Границы темного" на странице "Настройки видеопотока"; - Изменили метод для настройки смещения OSD по процентам; - Скорректировали цвета ячеек после завершения диагностики абонентских трубок; - Исправили отображение матрицы входов при ненастроенных внешних модулях NCS-102; - Добавили подсказку при отсутствии SIP-регистрации; - Добавили версию Web-Интерфейса на главной странице; - Добавили настройку маски идентификатора ключа в "Мастер настройки"; - Добавили раздел "Инкремент" в настройках Защищенного режима; - Добавили вкладку "Прошивка ключа" на странице "Управление ключами"; - Изменили метод обновление OSD; ``` Было:  /v2/camera/osd Стало: /v3/camera/osd ``` - Изменили метод обновления панели; ``` Было:  /v2/system/upgrade Стало: /v3/system/upgrade ``` - Исправили стандартные значения порогов ЧБ-режима; ``` Порог выключения: 200.000 Порог включения: 1.500.000  ``` - Добавили возможность редактирование UID ключа; - Добавили настройку доступов для автосбора; #### \#SIP-клиент - Исправили вызовы при нажатии на кнопку SOS или Консьерж; - Добавили поддержку заголовка expires от SIP-сервера на запрос SIP.Register; - Разделили SIP-сервер регистрации и SIP-сервер вызовов; #### \#RTSP-сервер - Исправили последовательную нумерацию видеопотоков в методе "/camera/codec"; - Исправили отображение даты/времени в OSD на альтернативном потоке при разрешении (640x480); - Обновили уровни порогов для перехода в цветной и черно-белый режимы; - Добавили настройку частоты кадров видеопотока; #### \#HTTP-сервер - Добавили больше параметров для работы с NCS-102; ``` [GET,PUT] /relay/door_controller { "timeout": 170, - таймаут опроса модулей "busErrors": 2, - кол-во ошибок на линии RS-485; "modules": [ - список модулей { - ... "type": "NCS102", - наименование модуля; "enabled": true, - состояние опроса модуля; "address": 0, - адрес модуля на шине RS-485; "version": "1.2.1.11.5", - версия программного обеспечения; "openTime": 9, - время открытия двери; "button": false, - состояние кнопки открытия; "tamper": false, - состояние датчика открытия; "alwaysOpen": false, - режим "Двери постоянно открыты"; "errors": 0 - кол-во ошибок при взаимодействии с модулем; } ] } ``` - Добавили обновление устройства с помощью одного файла; ``` [GET/PUT] /v3/system/upgrade ``` - Добавили метод для настройки общего кода открытия; ``` [GET/PUT/DELETE] - /openCode/settings { "commonCode": { - Параметры общего кода открытия; "enable": false, - Флаг включения; "value": 12349 - Значение; } } ``` #### \#Микроконтроллер - Исправили работу защищенного режима для ключей SL1; - Исправили отсутствие звука в лайф-трансляции при вызове в SIP; - Добавили работу защищенного режима с инкрементом для ключей SL1; - Исправили отображение надпись "Вызов" после отображения надписи "Открыт" во время вызова; - Исправили время открытия дверей при одновременном открытии с помощью ключа и API-метода; - Исправили бесконечное отображение надпись "Открыт" при одновременном открытии с помощью ключа и API-метода; - Исправили отображение идентификатора ключа "00000000000061" при открытии внешнего модуля NCS-102 через API метод; - Добавили получение параметров с модулей NCS-102; - Исправили реакцию на кнопку "Завершить вызов" при вызове в SOS или Консьерж; - Исправили отображение надписи "Вызов с калитки" после открытия двери с ключа; - Исправили бесконечный вызов при завершении вызова по таймауту в режиме Калитка; - Исправили открытие двери с ключа и(или) API метода в состоянии "Вызов с калитки"; - Добавили режим "Двери постоянно открыты" для внешних модулей NCS-102; - Исправили открытие двери с помощью кода открытия на панели в режиме "Калитка с несколькими домами (префиксом)"; - Добавили общий код открытия двери; - Добавили определение отключения внешних модулей NCS-102; - Добавили режим "Открытие любым ключом" для внешних модулей NCS-102 при активированном "Режим автосбора ключей"
2.5.0.6.5 — 22.05.2024 ### Прошивка 2.5.0.6.5 Ссылка на файлы прошивки: [https://www.is74.ru/upload/domofonsokol/firmware/x5/2.5.0.6.5.zip](https://www.is74.ru/upload/domofonsokol/firmware/x5/2.5.0.6.5.zip) Ссылка для обновления: [http://firmware.domofon-sokol.ru/X5/2.5.0.6.5/](http://firmware.domofon-sokol.ru/X5/2.5.0.6.5/) Актуальный API можно скачать на странице [API-документация](https://doc.sokol.global/books/umnyi-domofon-sokol-plius/page/api-dokumentaciia "API-документация") #### \#SIP-клиент - Исправили тайм-ауты времени дозвона и разговора в SIP и(или) АТ; - Исправили восстановление SIP-регистрации после смены IP-адреса с помощью DHCP; - Исправили отображение номера квартиры в логах при вызове на SIP-номер; - Исправили ошибку, которая могла приводить к зацикленному вызову в режиме калитки #### \#Микроконтроллер

**ВАЖНО! Старый формат логов открытия дверей станет недоступным**

- Изменили логи в связи с появлением разграничения доступов для ключей: - Шаблон: - {Door} is opened by {rfid}, UUID {key\_uuid}, flat {key\_flat} - Примеры: - Main door is opened by main reader, UUID 0000005C01165A, flat 1 - Second door is opened by second reader, UUID 0000005C01165A, flat 1 - External relay 0 is opened by ext. reader 0, UID 0000005C01165A, flat 1 - Исправили задержку открытия входа с дополнительного считывателя; - Добавили отображение на дисплее нескольких точек одновременно; - Добавили игнорирование блокировок квартиры при вызове через кнопки SOS/Консьерж #### \#WEB-интерфейс - Исправили значения громкости на новые методы API; - Исправили визуальную нумерацию строк для коммутаторов Метаком; - Добавили вкладку настроек внешних модулей Beward NCS-102 на странице «Входы» -> «Внешние входы»; - Добавили вкладку настройки управления открытиями входов в зависимости от считывателей на странице «Входы» -> «Управление входами»; - Добавили отображение процесса обновления; - Добавили редактирование доступов ко входам в настройках ключа; - Добавили возможность выбора формата csv-файла (с заголовком или без) при экспорте и импорте кодов и ключей #### \#HTTP-сервер - Исправили метод удаления всех кодов; - Добавили метод открытия внешних модулей: - /relay/external/{id}/open - открытие ncs-102 модулей; - Добавили метод для получения статусов обновления: - GET - /v2/system/upgrade - Получение статуса обновления; - Добавили методы для настройки матриц ККМ по моделям ККМ: - GET/PUT - /v1/switch/matrix/{matrix\_id} — матрицы ККМ для указанного физического ККМ выхода; - GET - /v1/switch/matrix/info/models — получение списка поддерживаемых моделей; - Добавили методы для разграничения доступов ключей: - PUT - /v1/keys/access — Установка доступов всем ключам; - GET/PUT - /key/store/{uuid} — Получение/Обновление информации о ключе; - GET/PUT - /relay/doors/mapping — Настройка открытия считыватывателями входов; - Добавили настройку уровня открытия двери в методах: - levels; - panelCode/levels; - Добавили методы для настройки уровней громкостей от 0 до 15: - /v1/levels - /v1/panelCode - /v1/panelCode/N - /v1/panelCode/N/levels - Исправили отображение времени открытия входа - **ВАЖНО! Минимальное время открытия входа — 4 секунды;** - Добавили параметр модели устройства - - /system/info — Новый параметр "deviceModel"; - ISCom X1 (rev.2); - ISCom X1 (rev.5) #### \#RTSP-сервер - Исправили возможные ситуации, когда не переключалась физическая ИК-шторка в день / ночь; - Расширили угол обзора видимого изображения в видеопотоке; - Исправили отображение OSD, если установлено смещение 0 - **ВАЖНО! Если используются стандартные настройки OSD, то смещения установятся в 0** - Исправили работу аудикодеков со сторонними видеосервисами и плейерами; - Обновили файл шрифтов для отображения буквы "Ё" на экранном тексте (OSD)
2.5.0.4.3 — 01.04.2024 ### Прошивка 2.5.0.4.3 Ссылка на файлы прошивки: [https://www.is74.ru/upload/domofonsokol/firmware/x5/2.5.0.4.3.zip](https://www.is74.ru/upload/domofonsokol/firmware/x5/2.5.0.4.3.zip) Ссылка для обновления: [http://firmware.domofon-sokol.ru/X5/2.5.0.4.3/](http://firmware.domofon-sokol.ru/X5/2.5.0.4.3/) Актуальный API можно скачать на странице [API-документация](https://doc.sokol.global/books/umnyi-domofon-sokol-plius/page/api-dokumentaciia "API-документация") #### \#SIP-клиент - Добавили поддержку прямых звонков (peer-to-peer); - Добавили параметр задержи вызова в SIP; - Исправили логи открытия двери через DTMF-коды; - Добавили поддержку "\*" и "#" DTMF символов; - Добавили поддержку PCMA и PCMU аудиокодеков; - Исправили открытие двери калитки при разговоре с калитки по АТ; - Добавили получение SIP-номеров на калитку с основной панели; - Калитка получает SIP-номера с основной панели в дополнительном заголовке "X-Iscom-AccountsList" #### \#HTTP-сервер - Исправили визуальный баг для режимов "Открытие любым ключом" и "Проверка обратного идентификатора"; - Добавили метод "/v2/openCode" для массового добавления кодов открытия; - Добавили метод "/panelCode/setDefault" для сброса персональных настроек всех квартир; - Исправили сохранение параметров метода "/v1/network/syslog"; - Исправили отображение параметра "deviceId" в методе "/system/info"; - Исправили отображение параметра "sipCallDelay" в методе "/sip/options"; - Исправили ответ при перезагрузках устройства через метод "/system/reboot"; - Добавили новый параметр в метод "/panelCode/номер\_квартиры"; - sipAccounts - SIP-номера для квартиры; - Добавили новый параметр "Усиление микрофона панели" при вызове в SIP (uartFrom) в методах: - - "/levels"; - "/panelCode/levels" - Добавили новый параметр "Громкость разговора в трубке при разговоре с калитки" (thGate) в методах: - - "/levels"; - "/panelCode/levels"; - Добавили новые параметры в метод "/gate/settings": - prefixSize - длина "префикса" при вызове в SIP; - По умолчанию - 4; - flatNumberSize - длина "номера квартиры" при вызове в SIP; - По умолчанию - 0; - Добавили новый параметр в метод "/sip/options"; - videoStreamId - выбора видеопоток в видеовызове; - По умолчанию - 1; - Добавили метод "/relay/doors/mapping" для управления выходами при открытии с основного или дополнительного считывателя #### \#Микроконтроллер - Добавили событие в логи при напряжении ниже 10В: Intercom voltage is lower than 10 volts. Voltage = %d.%d; - Исправили таймауты вызова и разговора в АТ и SIP; - Добавили поддержку цифровых трубок при использовании ДП-К2Д (в разделе "Матрица" необходимо устанавливать Цифрал); - Исправили множественное открытие двери при открытии с DTMF; - Добавили сервисные коды ([описание](https://doc.sokol.global/books/umnyi-domofon-sokol-plius/page/servisnyi-rezim-prednastroika-domofona-s-klaviatury "Сервисный режим. Преднастройка домофона с клавиатуры")); - Добавили скрытый ввод сервисного пароля; - Исправили ситуации, которые могли приводить к зависанию бегущей строки #### \#WEB-интерфейс - Исправили восстановление резервной копии; - Исправили сохранение значения префикса калитки; - Добавили импорт кодов через csv-файл; - Добавили предупреждающее окно при запуске обновления; - Добавили выбор протокола взаимодействия с SIP-сервером; - udp; - tcp; - Добавили сброс персональных настроек квартир в разделе квартиры; - Исправили окрас ячеек матрицы ККМ; - Исправили импорт ключей через csv-файл; - Исправили состояние переключателей: - Открытие любым ключом; - Проверка обратного идентификатора; - Добавили логи на странице обновления; - Добавили выбор скорости бегущей строки; - Добавили постраничное получение ключей; - Добавили просмотр изображения с камеры на весь экран; - Добавили символы "\*", "#" в маску DTMF-символов; - Добавили отображение результатов авторегулировки в матрице ККМ; - Добавили дополнительные чекбоксы для открытия дверей с разных считывателей на странице "Настройка входа"; #### \#RTSP-сервер - Повысили стабильность приложения;
# Инструкция по обновлению прошивки Для домофона Сокол доступно два варианта обновления: ### 1. Через собственный http-сервер Инструкция для Linux

**Важно, чтобы сервер работал по протоколу http, а не https.**

1.1. Если на Вашем сервере не установлен python, то рекомендуем установить python3, если же python установлен, то для запуска скрипта использовать Вашу версию python. Установите python3 с помощью команды: ``` sudo apt install python3 ``` 1.2. Скачайте файлы прошивки со страницы [Что нового rev.5? \[Firmware\]](https://doc.sokol.global/books/umnyi-domofon-sokol-plius/page/cto-novogo-firmware "Что нового? [Firmware]") 1.3. Создайте папку с помощью команды: ``` mkdir /srv/tftp/ISComX1 ``` 1.4. Распакуйте архив с прошивкой в эту папку (пример пути после распаковки: /srv/tftp/ISComX1/2.5.0.4.3) 1.4.1. Переходим в папку где лежат прошивки и запускаем http сервер: ``` python3 -m http.server ``` 1.5. Зайдите в web-интерфейс панели в раздел Система->Обновление - В поле «Путь до папки с файлами на http сервере:» укажите http://{адрес\_вашего\_сервера}:{порт}/{ревизия устройства x2 или x3}/{версия прошивки} 1.6. Нажмите обновить 1.7. Для отслеживания обновления подключитесь к панели по telnet и введите команду: ``` tail -f /tmp/complex.Logs (до версий 2.5.6.х включительно) ``` или ``` tail -f /tmp/iscom/log/upgrade.log (начиная с версий 2.5.7.х) ``` 1.8. По окончанию обновления панель перезагрузится

**ВАЖНО: ни в коем случае не отключайте домофон от сети во время обновления.**

### 2. Сервер компании Интерсвязь (в случае, если панель имеет доступ в Интернет): [http://firmware.domofon-sokol.ru/](http://firmware.domofon-sokol.ru/) 2.1. Зайдите в web-интерфейс умного домофона и перейдите в раздел «Система» -> «Обновление». 2.2. В поле «Путь до папки с файлами на http сервере:» укажите http://{адрес}:{порт}/{ревизия устройства x5}/{версия прошивки} Например: \- [http://firmware.domofon-sokol.ru/X5/2.5.0.4.3](http://firmware.domofon-sokol.ru/X5/2.5.0.4.3/), где 2.5.0.4.3 — версия прошивки, на которую вы хотите обновиться. \- [http://192.168.0.101:8000/2.5.0.4.3](http://192.168.0.101:8000/2.5.0.4.3) (пример заполнения на панели при условии, что http запущен на Linux с помощью команды python3 -m http.server) 2.3. После запуска обновления в течение 30 секунд на экране будет светиться надпись "boot". Это означает, что обновление запущено. 2.4. Примерное время обновления устройства 2 минуты. После завершения обновления панель перегрузится и после этого будет готова к работе.

**ВАЖНО: ни в коем случае не отключайте домофон от сети во время обновления.**