kpda-gis/README.md

ПК ЦКИ (Программый Комплекс поддержки ЦКИ)

     

   

Картографический пакет ПК ЦКИ предназначен для обработки и визуализации цифровой картографической информации в защищенной операционной системе реального времени «Нейтрино».

ПК ЦКИ оптимизирован для работы на широком спектре оборудования, включая аппаратные платформы на базе российских процессоров, и применяется в качестве базового ПО при построении ГИС различного назначения для мобильных, бортовых и стационарных систем и комплексов.

Подробнее о продукте можно прочитать здесь.

Поддерживаемые платформы

Обзор

Содержание

• Компоненты
• Зависимости
• Сборка
• Запуск

Компоненты

• doc - справка по формату GCM, и др.
• src - исходные компоненты проекта
  • apps - демонстрационные и тестовые приложения
  • lib - исходники используемых библиотек
  • services - компоненты ядра, драйверов для работы с серверами и имитаторов серверов
    • gis-core - ядро картографического пакета
    • drivers - исходники драйверов форматов картографической информации
  • utils - конвертеры карт и дополнительные утилиты для работы

Подробную информацию по конкретному компоненту (приложению, утилите, драйверу и т. д.) можно найти в файлах README.md, находящихся в директории этого компонента.

Зависимости

Сборка

ПК ЦКИ поддерживается на ЗОСРВ "Нейтрино" версий 2024 и 2021.

Для комплекта разработчика 2021 необходимо дополнительно подключить sqlite3:

1. Установить sqlite3 на свое устройство. Например, для Debian/Ubuntu ввести следующую команду:

sudo apt update && sudo apt install sqlite3

2. Собрать sqlite3 под требуемую аппаратную платформу, установив библиотеки в указанную вами папку.

• Например, для armle-v7:

make CPULIST=arm VARIANTLIST=le.v7 INSTALL_ROOT_nto=my_sqlite_install_dir install && make clean

• Для x86:

make CPULIST=x86 INSTALL_ROOT_nto=my_sqlite_install_dir install && make clean

3. Полученные библиотеки необходимо поместить на целевое устройство с ОС "Нейтрино" версии 2021 в папку /opt/gis/lib.

4. Установить переменные окружения, используя ранее выбранную папку установки:

export SQLite3_INCLUDE_DIR=my_sqlite_install_dir/armle-v7/usr/include/sqlite

export SQLite3_LIBRARY=my_sqlite_install_dir/armle-v7/usr/lib/libsqlite3.so.8

Сборка ПК ЦКИ для 2021 и 2024:

1. Перейти в выбранную для сборки папку:

mkdir my_gis_build && cd my_gis_build

2. Настроить cmake:

cmake --toolchain=$KPDA_HOST/mk/cmake/toolchain-nto-armle-v7.cmake path-from-my_gis_build-folder/kpda-gis

3. Собрать проект:

cmake --build . -jn, где n - количество потоков.

4. Установить в выбранную папку:

cmake --install . --prefix my_gis_install_dir

Примечание: при развертывании на целевое устройство my_gis_install_dir должно быть присвоено значение /opt/gis.

Запуск

Пример запуска приложения gis-monitor

1. Установить необходимые переменные окружения

export PATH=/opt/gis/bin:/opt/gis/sbin:$PATH export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/gis/lib

2. Дополнительные настройки

Изменение языка	export ABLANG=ru_RU
Уровень отладочного вывода (Error - 1, Warning - 2, Info - 3)	export GIS_DEBUG_LEVEL=3
Установка размера кэша в байтах	export GIS_CORE_DATABUFFER_SIZE_LIMIT=960000000

3. Добавить файлы цифровой картографической информации в директорию, соответствующую исходному формату ЦКИ, в $GIS_CORE_MAP_CACHE (по умолчанию /opt/gis/data/maps/cache).

4. Запуск ядра и приложения

При запуске ядра c опцией -d передается название драйвера требуемого формата. Подробнее об имеющихся драйверах можно прочитать тут.

Пример запуска с драйвером для формата SXF:

gis-core -dsxf-local,sync=hard справка

Запуск демонстрационного приложения gis-monitor:

gis-monitor -x50 -y50 справка