Файл настроек сервера .dmrc
Вместо ссылки сервер можно отдать файлом. Это обычный JSON с расширением .dmrc: его можно положить в чат клуба, на сайт или в письмо. На телефоне файл открывается в DMRConnect и сразу предлагает добавить сервер.
- Кому
- админам, которые раздают настройки файлом, и тем, кто генерирует их скриптом
- Формат
- JSON в UTF-8, поле
"format": "dmrconnect-server", расширение.dmrc - Серверы
- HBlink, FreeDMR, XLX, рефлекторы YSF, NXDN, P25. BrandMeister файлом не передаётся
Когда файл удобнее ссылки
Ссылка и QR-код удобнее почти всегда: их не надо сохранять и искать в загрузках. Файл выручает в двух случаях. Первый - когда у сервера много модулей XLX со своими названиями: названия модулей (moduleNames) есть только в файле, в ссылку они не входят. Второй - когда настройки генерирует ваш скрипт и раздаёт их почтой или через облако.
Пример
{
"format": "dmrconnect-server",
"v": 1,
"name": "XLX250 Клуб R0A",
"type": "XLX",
"host": "xlx250.example.org",
"port": 62030,
"password": "",
"talkgroup": 6,
"slot": 2,
"colorCode": 1,
"options": "",
"modules": ["A", "B", "C", "D"],
"module": "A",
"moduleNames": {"A": "Общий", "B": "Иркутск", "C": "Техника", "D": "Эхо"}
}
Поля
| Поле | Обязательно | Значение |
|---|---|---|
format | да | строго "dmrconnect-server", иначе файл не будет принят |
v | нет | версия, сейчас 1 |
name | да | название в списке серверов |
type | да | "HBLINK" (и FreeDMR), "XLX", "YSF", "NXDN", "P25". Заглавными, в отличие от ссылки |
host, port | да | адрес и порт сервера |
password | нет | пароль мастера HBlink или FreeDMR |
talkgroup, slot | нет | группа и слот после добавления, по умолчанию 9 и 2 |
colorCode | нет | цветовой код 0..15, по умолчанию 1 |
options | нет | строка опций, приложение отправит её мастеру в RPTO как есть |
modules, module | нет | XLX: список модулей и модуль по умолчанию |
moduleNames | нет | XLX: свои названия модулей, словарь «буква - название» |
Позывного и DMR ID в файле нет и быть не может: их человек вводит при импорте. Так файл можно раздавать всему клубу, не раскрывая ничьих данных. Неизвестные поля приложение пропускает.
Как человек его открывает
- Получает файл в Telegram, почте или скачивает с сайта.
- Нажимает на него. Android предлагает открыть в DMRConnect, он объявлен обработчиком файлов
.dmrc. - Приложение показывает окно импорта с данными сервера и просит позывной и DMR ID.
Если телефон не предлагает DMRConnect (так бывает с файлами из некоторых мессенджеров, которые прячут расширение), файл открывают изнутри приложения: экран «Серверы», кнопка «Импорт сервера из файла».
Как выгрузить готовый
Проще всего настроить сервер у себя в DMRConnect и выгрузить его: на экране «Серверы» у карточки сервера кнопка экспорта (значок «поделиться») сохраняет файл название.dmrc. Позывной и ID в него не попадают. У BrandMeister кнопки нет: пароль Hotspot Security и ESSID у каждого свои, общий файл для BrandMeister не имеет смысла.
Отдавать с сайта
Отдавайте файл с типом application/json или application/octet-stream и с заголовком Content-Disposition: attachment, чтобы браузер его скачал, а не показал текстом. Пароль мастера в файле лежит открыто, поэтому файл с паролем держите там, где его видят только свои.
Нашли неточность или не хватает функции? Напишите в группу DMRConnect, поправим справочник.