Files
cuframes-composer/CMakeLists.txt
T
gx 636b70b64c Phase 4: ZMQ control plane + MQTT health publisher
Phase 4a — control plane через ZMQ REP socket с JSON-командами.
Позволяет операторам менять text overlay'и runtime'ом без рестарта.
Live-validated: команды set_text label-parking → "⚠ ВНИМАНИЕ ⚠"
и set_text label-gate → "Машина у ворот" отрабатывают, текст
обновляется в потоке RTSP без перерывов.

Phase 4b — MQTT health publisher через libmosquitto. Каждые 10с в
composer/<instance>/health публикуется JSON {active,stale,dead,total,
uptime_s} с retain=true. Опционально публикуется HA MQTT discovery
config — четыре сенсора (active/stale/dead/total) появляются в HA
автоматически с expire_after=30s.

Содержимое:

- include/cuframes_composer/overlay.h — cfc_overlay_set_id/get_id/get_type
  для lookup'а через control plane.
- include/cuframes_composer/composer.h — cfc_composer_find_overlay(id).
- include/cuframes_composer/control.h — cfc_control_config_t (endpoint +
  composer + cuda_ctx для text rebuild в worker thread).
- src/control.c — ZMQ REP socket в фоновом потоке + zmq_poll с 200мс
  timeout'ом для проверки stop_flag. JSON-диспатчер для команд ping /
  health / set_text / set_visible / list_overlays. cuCtxSetCurrent
  на старте worker'а — без этого update_text валится на cuMemAlloc.
- include/cuframes_composer/health.h — cfc_health_config_t (host/port/
  user/pass + topic_prefix/instance + interval + publish_discovery).
- src/health.c — mosquitto_connect_async + loop_start + background
  thread с publish health каждые N секунд + один разовый publish_discovery
  для HA.
- examples/grid_record — флаги --control tcp://0.0.0.0:5599,
  --mqtt host[:port], --mqtt-instance NAME, --mqtt-user/--mqtt-pass.
  Для text overlay'ев — prefix "id=NAME:" в --text задаёт control-plane ID.

CMakeLists.txt — find_library(zmq), find_library(json-c),
find_library(mosquitto) + linkage всех трёх.

Production TODO: создать отдельного MQTT user'а для composer'а вместо
переиспользования frigate creds (используется только в smoke).
2026-06-03 06:20:38 +01:00

103 lines
5.1 KiB
CMake

cmake_minimum_required(VERSION 3.20)
project(cuframes-composer
VERSION 0.1.0
DESCRIPTION "Multi-source video grid composer на CUDA + NVENC + RTSP"
LANGUAGES C CUDA
)
set(CMAKE_C_STANDARD 11)
set(CMAKE_C_STANDARD_REQUIRED ON)
set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
# CUDA архитектуры. Покрываем production-сценарии:
# sm_61 = Pascal (GTX 1050/1060/1070/1080) — низкобюджетный prod
# sm_75 = Turing (RTX 2060/Quadro RTX) — частый prod
# sm_86 = Ampere consumer (RTX 3060/3090)
# sm_89 = Ada Lovelace (RTX 4090) — тестовое окружение разработки
# sm_120 = Blackwell (RTX 5090) — текущий dev-хост
# Pascal (sm_61) обязателен — у пользователя в проде GTX 1050.
if(NOT DEFINED CMAKE_CUDA_ARCHITECTURES)
set(CMAKE_CUDA_ARCHITECTURES "61;75;86;89;120")
endif()
if(NOT CMAKE_BUILD_TYPE)
set(CMAKE_BUILD_TYPE Release)
endif()
# ── Опции сборки ────────────────────────────────────────────────────────
option(BUILD_EXAMPLES "Сборка smoke-test программ из examples/" ON)
option(BUILD_TESTS "Сборка модульных и интеграционных тестов" OFF)
# ── Зависимости ─────────────────────────────────────────────────────────
# CUDA Toolkit — для cudart, заголовков cuda.h (Driver API), nvcc.
# NVENC SDK сам идёт через nv-codec-headers + dlopen libnvidia-encode.so,
# поэтому CUDA::nvenc намеренно НЕ линкуем (см. дизайн-документ часть 1.6).
find_package(CUDAToolkit 12.0 REQUIRED)
find_package(Threads REQUIRED)
# dl — для dlopen libnvidia-encode.so в runtime
find_library(LIBDL_LIBRARY dl REQUIRED)
# PNG — для декода RGBA-иконок overlay'ев (Phase 3b)
find_package(PNG REQUIRED)
# FreeType — для text overlay'ев (Phase 3c)
find_package(Freetype REQUIRED)
# ZMQ + json-c — для control plane (Phase 4a)
find_library(LIBZMQ_LIBRARY NAMES zmq REQUIRED)
find_path(LIBZMQ_INCLUDE_DIR zmq.h)
find_library(LIBJSONC_LIBRARY NAMES json-c REQUIRED)
find_path(LIBJSONC_INCLUDE_DIR json-c/json.h)
# Mosquitto — для MQTT health (Phase 4b)
find_library(LIBMOSQUITTO_LIBRARY NAMES mosquitto REQUIRED)
find_path(LIBMOSQUITTO_INCLUDE_DIR mosquitto.h)
# ── Сторонние библиотеки (subomodules в third_party/) ───────────────────
# cuframes — статически линкуем libcuframes. cuframes_static — это static lib
# который определён в third_party/cuframes/libcuframes/CMakeLists.txt.
# PIC обязателен — cuframes_static линкуется в наш SHARED libcuframes_composer.
set(CMAKE_POSITION_INDEPENDENT_CODE ON)
set(BUILD_TESTING OFF CACHE BOOL "" FORCE)
set(BUILD_EXAMPLES OFF CACHE BOOL "Cuframes examples" FORCE)
set(BUILD_TOOLS OFF CACHE BOOL "Cuframes tools" FORCE)
set(BUILD_FFMPEG_FILTER OFF CACHE BOOL "" FORCE)
set(BUILD_PYTHON_BINDINGS OFF CACHE BOOL "" FORCE)
add_subdirectory(third_party/cuframes)
# Восстанавливаем BUILD_EXAMPLES для наших собственных examples/
set(BUILD_EXAMPLES ON CACHE BOOL "" FORCE)
# nv-codec-headers — header-only, нужны заголовки nvEncodeAPI.h
# (NVENC) и cuviddec.h (NVDEC, на будущее). Не как target, просто include path.
set(NVCODEC_HEADERS_DIR
"${CMAKE_CURRENT_SOURCE_DIR}/third_party/nv-codec-headers/include")
if(NOT EXISTS "${NVCODEC_HEADERS_DIR}/ffnvcodec/nvEncodeAPI.h")
message(FATAL_ERROR
"nv-codec-headers заголовки не найдены в ${NVCODEC_HEADERS_DIR}/ffnvcodec/. "
"Выполни: git submodule update --init --recursive")
endif()
# ── Подпроекты ──────────────────────────────────────────────────────────
# src/ — основная библиотека композитора
add_subdirectory(src)
# examples/ — smoke-test программы (по фазам разработки)
if(BUILD_EXAMPLES)
add_subdirectory(examples)
endif()
# ── Сводка конфигурации ─────────────────────────────────────────────────
message(STATUS "")
message(STATUS "cuframes-composer ${PROJECT_VERSION} конфигурация:")
message(STATUS " Build type: ${CMAKE_BUILD_TYPE}")
message(STATUS " CUDA Toolkit: ${CUDAToolkit_VERSION}")
message(STATUS " CUDA include: ${CUDAToolkit_INCLUDE_DIRS}")
message(STATUS " nv-codec-headers: ${NVCODEC_HEADERS_DIR}")
message(STATUS " BUILD_EXAMPLES: ${BUILD_EXAMPLES}")
message(STATUS " BUILD_TESTS: ${BUILD_TESTS}")
message(STATUS "")