SMKDMR XLX Client — Android-клиент подключения к XLX-рефлектору

Заготовка мобильного приложения на Kotlin/Jetpack Compose для подключения смартфона к XLX-рефлектору (мультипротокольный рефлектор XLX, используемый в DMR-сетях) без хотспота и радиостанции. Сейчас приложение содержит один экран: ввод адреса и порта рефлектора, выбор комнаты/модуля, позывного и DMR ID, отправку тестовой UDP-датаграммы и режим PTT, который передаёт сырой PCM-звук с микрофона по UDP.

Полноценным DMR-клиентом приложение не является и в текущем виде стать не может: как прямо сказано в тексте на главном экране, для настоящего DMR нужны вокодер AMBE+2 и кадры протокола MMDVM Homebrew, ни того ни другого в коде нет. Проект — испытательный стенд для будущего транспортного слоя.

Стек

  • Kotlin, Jetpack Compose (Material 3, Compose BOM 2026.01.00), activity-compose.
  • Android Gradle Plugin 9.0.1, Kotlin Compose compiler plugin 2.2.21, Gradle Kotlin DSL.
  • compileSdk/targetSdk 36, minSdk 26, applicationId ru.smkdmr.xlxclient.
  • Android SDK напрямую: AudioRecord (PCM 16 бит, 8 кГц, моно), DatagramSocket/DatagramPacket, kotlinx.coroutines.
  • Внешнее «железо»/сеть: XLX-рефлектор по UDP (в тестовом профиле — порт 62030, модуль F).

Структура

Путь Назначение
settings.gradle.kts Имя проекта SMKDMR, модуль :app, репозитории google/mavenCentral.
build.gradle.kts Корневой файл: объявление плагинов AGP и Compose compiler.
app/build.gradle.kts Конфигурация модуля: SDK, версия 0.1.0, Compose, зависимости.
app/src/main/AndroidManifest.xml Разрешения INTERNET и RECORD_AUDIO, единственная activity-лаунчер.
app/src/main/java/ru/smkdmr/xlxclient/MainActivity.kt Весь код приложения (469 строк): экран XlxConnectionScreen, выпадающий список комнат RoomPicker, блок статуса, функция sendUdpProbe, класс UdpVoiceTestClient с фоновым потоком записи и отправки звука.
app/src/main/res/values/styles.xml Тема Theme.SMKDMR.
app/proguard-rules.pro Пустая заготовка.
README.upstream.md Прежний README автора.

Как запустить

Gradle wrapper в репозитории отсутствует (gradlew, gradle/wrapper/ не закоммичены), поэтому сборка из командной строки «как есть» невозможна.

Способ из авторского README:

  1. Открыть каталог проекта в Android Studio (версия с поддержкой AGP 9.0.1).
  2. Дать среде синхронизировать Gradle и создать wrapper.
  3. Собрать и запустить модуль app на устройстве или эмуляторе с Android 8.0+.

После установки wrapper'а сборка из консоли: ./gradlew :app:assembleDebug.

На экране: заполнить IP/домен, порт, комнату, позывной и DMR ID, кнопкой «Проверить UDP подключение» отправить пробную датаграмму, удержанием кнопки PTT — начать передачу PCM-потока. При первом нажатии PTT запрашивается разрешение на микрофон.

Конфигурация

Файлов настроек, переменных окружения и сохранения состояния нет. Параметры вводятся на экране и живут только в памяти процесса (rememberSaveable). Значения по умолчанию зашиты константами в MainActivity.kt:

Константа Назначение Значение
TEST_HOST Адрес рефлектора 212.3.149.253 (тот же адрес, что у XLX 391 / SMK в репозитории pistar)
TEST_PORT UDP-порт 62030 (порт DMR master для MMDVM)
TEST_ROOM Комната/модуль F (по подписи в UI — тестовый модуль)
TEST_CALLSIGN Позывной PHOENIX
TEST_DMR_ID DMR ID 1030217
AUDIO_SAMPLE_RATE Частота дискретизации 8000
AUDIO_PACKET_SIZE Размер аудиопакета, байт 320
defaultRooms Список модулей в выпадающем списке AH

Формат отправляемых пакетов — самодельный текстовый: SMKDMR-PROBE|CALL=…|ID=…|ROOM=… для пробы и заголовок SMKDMR-PCM|CALL=…|ID=…|ROOM=…|SEQ=…| плюс сырой PCM для PTT. Протоколом XLX/MMDVM это не является, рефлектор такие пакеты отбросит.

Состояние

Прототип одного дня, работа не продолжена. Все 17 коммитов сделаны 2026-05-08, последний коммит — 2026-05-08. Версия приложения 0.1.0.

Из заявленного в авторском README сделаны только экран подключения и валидация ввода; далее добавлен экспериментальный режим PTT с передачей PCM по UDP.

Что не доделано

  • Нет транспортного слоя XLX/DMR: не реализованы кадры MMDVM Homebrew (login/RPTL, RPTK, DMRD), нет вокодера AMBE+2, нет приёма входящего звука и воспроизведения. Передаётся несовместимый самодельный формат.
  • Нет обратной связи о соединении: sendUdpProbe считает отправку датаграммы успехом, ответ не читается (soTimeout выставлен, но receive не вызывается). Экрана состояния соединения и журнала событий, заявленных в авторском README, нет.
  • Нет модели настроек и сохранения последнего сервера/порта/комнаты между запусками — соответствующие пункты плана автора не выполнены.
  • Весь код в одном файле MainActivity.kt, архитектурного разделения (ViewModel, репозиторий) нет.
  • Не закоммичен Gradle wrapper, из-за чего сборка вне Android Studio невозможна; нет CI.
  • Тестов нет ни одного, при этом в зависимостях объявлен androidTestImplementation(composeBom).
  • Нет иконки приложения (ссылки на launcher-иконки удалены отдельным коммитом), нет строковых ресурсов и локализации — тексты зашиты в код по-русски.
  • В коде остались личные тестовые данные: реальный IP рефлектора, позывной и DMR ID, подставляемые в поля по умолчанию.
  • Маркеров TODO/FIXME в коде нет.
S
Описание
No description provided
Readme
52 KiB
Languages
Kotlin 100%