Создать новую пустую конфигурацию .fscp и сразу открыть её — вернётся handle. donor — путь к существующему .fscp, из которого побайтово переносится SecurityConfiguration.xml (учётные записи): сервер его не разбирает и не показывает. Без донора запись просто отсутствует, и пользователей заводят в самом Global Monitor — примет ли он такой файл, не проверено.

Сохранить конфигурацию с правками в НОВЫЙ файл .fscp. Исходник не трогается никогда; существующий файл по пути out_path перезаписывается только при overwrite=true. Записи, которых правка не касалась, копируются побайтово. Перед записью идёт проверка целостности — отключается через check=false.

Что накоплено в сессии: список правок по-русски и какие записи архива будут перезаписаны при сохранении.

Откатить все правки сессии к состоянию на момент открытия архива. Частичный откат не поддерживается.

Открыть файл .fscp и получить handle для остальных вызовов.

Закрыть архив и освободить память сессии.

Сводка по открытому архиву: версии, счётчики, список ГК, записи ZIP.

Дети узла дерева устройств. Без parent — корень конфигурации.

Полная карточка устройства по UID или адресу вида 1.2.1.1.

Поиск устройств по типу (короткое имя драйвера), префиксу адреса, описанию или значению свойства.

Компактное текстовое дерево устройств с потолком по глубине и узлам.

Добавить устройство под указанный узел дерева. driver — короткое имя из list_drivers или UID драйвера. Без int_address берётся первый свободный адрес на линии. count>1 добавляет несколько подряд.

Изменить поля устройства: описание, IntAddress, отключение, серийный номер, привязку к зонам, свойства GKProperty. Задавайте только то, что меняете. Подписи на планах обновляются сами.

Перенести устройство вместе с поддеревом под другой узел — например, перевесить прибор на другую АЛС. Без int_address адрес выбирается свободный на новой линии.

Удалить устройство вместе с поддеревом. Если на него ссылаются зоны, логика или объекты на планах, вызов отказывает и перечисляет ссылки; force=true удаляет вместе с ними.

Объекты верхнего уровня: zone, guard_zone, scenario, direction, mpt, door и др.

Карточка объекта верхнего уровня (зона, сценарий, направление) по UID.

Что за объект скрывается за GUID: устройство, зона, план, подложка, драйвер.

Создать объект верхнего уровня: zone (зона) или scenario (сценарий). Номер No назначается автоматически — следующий свободный. Виды, для которых схема не снята с рабочих конфигураций, создать нельзя.

Изменить поля объекта: имя, описание, Fire1Count/Fire2Count у зоны, DelayTime/Hold/DelayRegime у сценария. Номер No не меняется никогда — он входит в отображаемое имя и на него ссылаются.

Удалить зону или сценарий, вычистив ссылки на него: привязки устройств, условия логики, объекты на планах. Без force отказывает и перечисляет, кто ссылается.

Добавить условие в логику устройства или объекта. group — OnClausesGroup, OffClausesGroup, OnNowClausesGroup, OffNowClausesGroup или StopClausesGroup. state принимается кодом (Fire2) или по-русски (Пожар2). Список для целей и название операции выбираются по виду целей; every=true даёт «во всех» вместо «в любом из».

Убрать логику: указанную группу условий целиком либо, без group, все группы владельца.

Дерево планов с числом объектов на каждом.

План со списком нарисованных на нём объектов (страницами).

На каких планах нарисован объект с данным UID.

Создать план. parent_uid вкладывает его в другой план. image_path — картинка PNG или JPEG с диска: она кладётся в Content/ архива, а размеры плана берутся из её заголовка.

Изменить имя, описание или размеры плана.

Удалить план вместе с вложенными в него и всеми нарисованными объектами. Без force отказывает, если удалять есть что.

Нарисовать объект ГК на плане. Устройства кладутся точкой (left, top), зоны и сценарии — прямоугольником (нужны ещё width и height). Связь ставится с обеих сторон.

Убрать объект с плана, сняв связь с обеих сторон.

Подложки планов из Content/: размер, разрешение, кто ссылается, сироты.

Выгрузить подложку плана в файл на диск (вне архива) для просмотра.

Инлайновое превью подложки. Требует установленной Pillow (pip install -e .[img]); max_px обязателен — оригиналы бывают 5000x4749.

Справочник драйверов Рубеж; query фильтрует по имени, описанию, категории.

Сырой фрагмент XML по пути ElementTree (например Zones/GKZone[1]). Запасной путь, когда типизированных инструментов не хватает.

Выгрузить плоский список устройств в CSV по указанному пути вне архива.

Проверка целостности: устаревшие подписи на планах, битые ссылки на подложки и объекты, сироты в Content/.