К документации

Кастеры

Управление NTRIP-кастерами, инстансами, mount points и клиентами.

Кастеры

Кастер — центральный объект NTRIP-инфраструктуры. Через него базовые станции публикуют поправки, а роверы и приложения получают доступ к этим поправкам.

В списке кастеров видны созданные кастеры аккаунта. Если включены счетчики, рядом отображается количество связанных инстансов, mount points и клиентов.

Создание кастера

Для создания кастера достаточно указать имя. Имя должно быть понятным для команды: например, название проекта, региона или заказчика.

Сам по себе кастер еще не принимает подключения. Чтобы он заработал, ему нужен инстанс на сервере.

Страница кастера

После открытия кастера левое меню меняется. Вместо общего меню появляются вложенные разделы:

  • Instances — где и на каких портах запущен кастер;
  • Mount points — точки подключения базовых станций;
  • Clients — учетные данные для роверов и приложений.

Эти разделы относятся к выбранному кастеру, а не ко всему аккаунту.

Instances

Инстанс — это запущенный экземпляр кастера на конкретном сервере. При создании выбирают сервер и порты:

  • NTRIP port — порт для NTRIP-подключений, часто используют 2101;
  • HTTP port — порт для HTTP-доступа и служебных запросов, например 8080.

На странице инстанса можно посмотреть статус, конфигурацию, события и авторизации.

Полезные действия:

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

Pull Relay

Принимайте внешний NTRIP-поток на выделенном инстансе и публикуйте его под локальным mount point. Доступно на Enterprise и Trial с YCCaster 2.1.0 или новее. Настройка, Fixed GGA, связь с Nearest Base и диагностика — в разделе «Relay».

Группы Nearest Base

Nearest group позволяет роверу подключаться к нескольким базовым станциям по одному имени. Ровер периодически отправляет своё положение в сообщениях NMEA GGA, а кастер выбирает ближайшего подключённого участника группы с корректными координатами. При движении ровера выбранная база может меняться, но имя подключения остаётся прежним.

Это выбор потока существующей базы: группа не создаёт виртуальную базовую станцию (VRS) и не объединяет поправки нескольких баз. Добавляйте потоки, совместимые с вашим ровером.

Схема: BASE_A и BASE_B входят в NEAREST_NORTH. Ровер отправляет GGA и получает поправки выбранной базы.

Схематический пример с демонстрационными именами. Выбор зависит от положения ровера и доступных подключённых участников.

Перед настройкой

  • Нужен выделенный инстанс с YCCaster 2.0.2 или новее. Общие инстансы не поддерживают nearest groups. Приложение должно получить сведения о версии работающего инстанса.
  • Управлять группами может администратор аккаунта.
  • Создайте mount points баз и учётные данные NTRIP-клиентов в том же аккаунте и кастере, что и инстанс.
  • Подключите базы к этому инстансу и проверьте их координаты. База, подключённая только к другому инстансу, не участвует в выборе.

Создание группы

  1. Откройте Casters → ваш кастер → Instances → ваш инстанс → Nearest Base.
  2. Нажмите Create group.
  3. Задайте Connection name, например NEAREST_NORTH, и при необходимости Description. Начните имя с латинской буквы или цифры; используйте латинские буквы, цифры, точки, подчёркивания и дефисы, до 100 символов. Имя нельзя изменить после создания; оно не должно совпадать с именем физического mount point.
  4. В Who can connect? выберите один из режимов доступа ниже.
  5. Отметьте базы в Member mount points и нажмите Save group.
  6. Переподключите затронутые базы: назначение группы применяется при следующей авторизации. Нажмите Refresh, чтобы проверить результат.

На одном инстансе mount point может входить только в одну nearest group. Пустую группу сохранить можно, но поправки она не выдаёт. После удаления группы её имя подключения остаётся зарезервированным.

Кто может подключаться

РежимКому предоставляется доступ
All NTRIP clients in this accountПодходящим NTRIP-клиентам этого аккаунта и кастера. Режим по умолчанию.
Selected NTRIP clientsТолько учётным данным, выбранным в Allowed NTRIP clients. Пустой список запрещает доступ всем.

В списке выбираются учётные данные NTRIP-клиентов, а не пользователи админки. В обоих режимах сохраняются проверки логина и пароля, аккаунта, подписки, срока действия клиента и совместимости версии NTRIP.

Доступ к группе разрешает получать поправки от любого её участника. Права прямого подключения к отдельным mount points не ограничивают выбор внутри группы. Добавляя базу, вы открываете её поток всем клиентам, допущенным к группе.

Подключение ровера

Используйте блок Connection в карточке группы:

Настройка ровераЗначение
HostIP инстанса или настроенное доменное имя
PortNTRIP-порт инстанса, например 2101
Mount pointТочное Connection name, например NEAREST_NORTH
Username / passwordУчётные данные разрешённого NTRIP-клиента
Send GGAПериодическая отправка NMEA GGA с текущим положением ровера

Пример подключения ровера: адрес инстанса, порт 2101, mount point NEAREST_NORTH, учётные данные NTRIP и периодическая отправка GGA.

Настройки на иллюстрации приведены для примера. Скопируйте фактический адрес, порт и имя из карточки своей группы.

Группа может не отображаться в списке источников приёмника: при необходимости введите её точное имя вручную. Без корректного положения ровера кастер не может выбрать ближайшую базу. Если нет подключённых участников с корректными координатами, группа не сможет выдавать поправки.

Координаты и готовность баз

Таблица группы показывает Last authorized coordinates, Origin и Observed state. Для выбора используются координаты из описания потока mount point (STR) с учётом ручного переопределения источника. Положение объекта Base на карте не служит источником координат для nearest-выбора.

Origin показывает, сообщила ли координаты база, заданы ли они вручную или использованы оба источника. Отсутствующие или некорректные координаты исключают базу из nearest-выбора, даже если прямое подключение к mount point работает.

СостояниеЧто проверить
ReadyПри последней авторизации назначена нужная группа, а свежая телеметрия указывает на активное соединение. Это не проверка свежести RTCM или качества RTK.
Coordinates requiredИсправьте координаты потока или ручное переопределение, затем переподключите базу.
Reconnect to applyПереподключите базу, чтобы применить сохранённое назначение группы.
Offline or no recent telemetryПроверьте подключение базы и телеметрию инстанса, затем нажмите Refresh.

Страница не обновляется автоматически. Счётчик готовых баз отражает наблюдаемое состояние, но не гарантирует пригодность каждого потока для ровера.

Применение изменений и диагностика

  • Изменение состава или координат: переподключите все затронутые базы, включая удалённых участников.
  • Изменение доступа: применяется при следующей авторизации клиента. Существующие соединения автоматически не закрываются.
  • Удаление группы: запрещает новые подключения; действующие клиентские соединения могут продолжаться до закрытия. Переподключите базы, чтобы убрать старое назначение.

Если поправок нет, проверьте доступ клиента, периодическую отправку GGA, координаты баз и их подключение именно к этому инстансу. События и авторизации инстанса помогут найти причину ошибки. В разделе «Сессии» можно проверить сессии баз и подключения роверов; nearest-клиент может посетить несколько баз в рамках одного соединения.

Сейчас выбор работает без гистерезиса: на границе двух баз небольшие изменения положения могут вызывать частые переключения. Мгновенное переключение при отключении базы не гарантируется: выбор замены может зависеть от следующего GGA. После смены источника проверяйте RTK-статус ровера.

Mount points

Mount point — это точка, куда подключается базовая станция и откуда роверы получают поправки. В форме задаются:

  • имя mount point, уникальное внутри кастера;
  • username и password для подключения источника;
  • версия NTRIP: Any, v1 или v2;
  • шифрование пароля;
  • пользователь или группа, которым mount point будет доступен в Field app.

Для NTRIP v1 username может быть скрыт, потому что в этом режиме схема подключения отличается. Пароль можно сохранить в зашифрованном виде; после сохранения зашифрованный пароль уже нельзя просто посмотреть в интерфейсе.

На странице mount point можно обновить параметры, удалить точку, настроить источник и права доступа.

Ссылка Session history на странице mount point открывает историю его серверных сессий. Выберите сессию, чтобы проверить трафик, подключения роверов и события. Подробнее — в разделе «Сессии».

Источник mount point

Источник описывает, откуда берутся поправки. Обычно это базовая станция или внешний NTRIP-источник. Через настройки источника можно обновить параметры подключения или переопределить источник, если нужно временно переключить mount point на другой поток.

Это полезно, когда:

  • меняется адрес или порт базовой станции;
  • нужно перенести поток на другой инстанс;
  • источник временно недоступен, и требуется резервный вариант.

Clients

Клиент — это учетные данные для ровера, приложения или другого потребителя поправок. В форме задаются:

  • владелец из списка пользователей;
  • username и password;
  • версия NTRIP;
  • срок действия;
  • шифрование пароля.

Username должен быть уникальным внутри кастера. Срок действия можно оставить пустым, если доступ не должен истекать автоматически.

Клиенты удобны для управления полевыми устройствами: одному роверy можно выдать отдельный логин, затем отключить или заменить его, не затрагивая остальные подключения.

Удаление и переименование

Кастер можно переименовать или удалить. Перед удалением проверьте, есть ли у него инстансы, mount points и клиенты. Удаление кастера влияет на всю связанную NTRIP-схему, поэтому для рабочей инфраструктуры сначала лучше остановить или перенести подключения.