clever-show/docs/server.md

Настройка сервера

Файл конфигурации

Конфигурация сервера задаётся в файле Server/server_config.ini, имеющем вид (по умолчанию):

[SERVER]  
port = 25000  
buffer_size = 1024  
  
[BROADCAST]  
use_broadcast = True  
broadcast_port = 8181  
broadcast_delay = 5  
  
[NTP]  
use_ntp = False  
host = ntp1.stratum2.ru  
port = 123

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

Раздел 'Server'

В этом разделе задаются параметры сетевого взаимодействия сервера, доступны следующие параметры:

• port - TCP порт, на котором будут приниматься входящие соединения от клиентов (коптеров). При использовании broadcast данный порт будет сконфигурирован у клиента автоматически. Рекомендуется изменить значение по умолчанию в целях безопасности (любое пятизначное и более число, если другое ПО не использует выбранный порт).
• buffer_size - размер буфера при приёме и передаче данных. Не рекомендуется изменять. Рекомендуется использовать единое значение у сервера и клиентов.

Раздел 'Broadcast'

Сервер использует UDP broadcast (на адрес 255.255.255.255 с выбранным портом), чтобы передавать клиентам (коптерам) актуальную информацию о конфигурации сервера и собственном адресе сервера для подключения (IP адрес и порт сервера). Таким образом, обеспечивается автоматическое подключение клиентов к серверу без необходимости дополнительной ручной конфигурации. В данном разделе задаются параметры этого механизма.

• use_broadcast - будут ли использованы broadcast'ы для передачи данных (при значении False broadcast'ы НЕ будут отправляться). Используйте False в случае повышенных требований безопасности, перегруженности сети или невозможности передачи по широковещательному каналу (из-за конфигурации брандмауэра или сети)
• broadcast_port - UDP порт, по которому будет осуществляться отправка сообщений. Рекомендуется изменить значение по умолчанию в целях безопасности. Внимание! При изменении этого параметра клиенты НЕ смогут принимать сообщения автоконфигурации до изменения (вручную) соответствующего параметра в конфигурации клиента на равное значение.
• broadcast_delay - Периодичность (в секундах, целочисленное значение), с которой будет происходить отправка broadcast сообщений. Увеличьте задержку для уменьшения нагрузки на сеть. ИЛИ Уменьшите задержку для уменьшения времени отклика и подключения при первом запуске клиентов.

Раздел 'NTP'

Помимо синхронизации времени (с миллисекундной точностью) с помощью пакета chrony, предоставляется альтернатива - возможность использования внешних (при наличии соединения локальной сети с интернетом) или внутрисетевых NTP-серверов. Внимание! Для корректной работы системы, и сервер, и клиенты должны использовать единый способ синхронизации времени (набор параметров в этом разделе). Данный раздел полностью унифицирован и для сервера, и для клиентов.

• use_ntp - Определяет, будет ли использоваться синхронизация времени с помощью NTP. (при значении False будет использовано локальное время ОС (синхронизируется автоматически при использовании chrony). Рекомендуется использование crhony, а не NTP
• host - имя хоста или IP адрес NTP сервера (локального или удаленного)
• port - порт, используемый NTP сервером

Интерфейс сервера

Сервер имеет визуальный графический интерфейс для удобства взаимодействия.

Меню

Раздел 'Actions'

Данный раздел содержит несколько утилит по отправке различных данных на выбранные клиенты. Внимание! Не пытайтесь использовать данные команды во время полёта коптеров!

• Send Animations - отправка файлов анимации (экспортированных аддоном к Blender) на выбранные клиенты (коптеры). В диалоговом окне необходимо выбрать папку, содержащую файлы анимации (автоматически создается аддоном). Каждый файл анимации будет отправлен на клиент с именем (copter ID), соответствующим имени файла без расширения.
• Send Configurations - отправка единого файла конфигурации клиента на все выбранные клиенты. В диалоговом окне необходимо выбрать один файл конфигурации в установленном формате. Файл конфигурации может быть неполным, в таком случае будут перезаписаны лишь указанные в файле параметры. Не рекомендуется использовать данное действие для массовой перезаписи Copter ID, кроме значения /hostname. Внимание! НЕ отправляйте на клиенты файл конфигурации сервера.
• Send Aruco map - отправка единого файла карты aruco маркеров на все выбранные клиенты. В диалоговом окне необходимо выбрать один файл карты в установленном формате. Файл на клиенте будет перезаписан. После получения и записи файла клиент автоматически перезапустит сервис clever. Для работоспособности полётных функция необходимо подождать некоторое время до полного запуска сервиса.

Боковая панель инструментов (команд)

Управление

• Preflight check - Отправка команды: все выбранные клиенты выполняют самодиагностику и предполётную проверку. Результаты, вместе с другими параметрами клиента, будут отображены в таблице по мере поступления данных. *Спинбокс Start after N seconds - Задаёт время задержки до синхронного запуска выполнения анимаций коптерами. Не рекомендуется использовать 0 (нулевую задержку). Для загруженных\подверженных помехами