opengd77-uv380-sms/NOTES.md

# DMR-данные (SMS) на TYT MD-UV380 под OpenGD77

Что это: доработка прошивки OpenGD77, которая учит рацию передавать и принимать
пакетные данные DMR — текстовые сообщения. В апстриме этого нет: в официальном
README прямо написано, что отправка и приём SMS не поддерживаются.

Базовый исходник — официальный релиз **R20260131** (ветка `MDUV380_DM1701`),
скачан с opengd77.com. Первый коммит в этом репозитории — он же, без единого
изменения. Всё, что дальше — наши правки, так что `git diff` первого и второго
коммита показывает ровно их.

---

## Что работает (проверено в эфире)

**Режим модема (хотспот), обе стороны.** Раньше SMS через рацию-модем молча
пропадали: модем подтверждал кадры хосту, а в эфир ничего не уходило. Теперь
данные проходят насквозь в обе стороны. Проверено с настоящим сервером и вторым
приёмником.

**Приём SMS на самой рации.** В обычном режиме (не модем) рация принимает
сообщение из эфира, собирает его из кадров, разбирает сетевую обёртку и
показывает на экране: отправитель, текст, кнопка OK.

**Меню Messages** в главном меню: `New msg`, `Inbox`, `Outbox`; у папок —
список сообщений и `Delete All`. Хранится по 6 сообщений на папку, текст до 64
символов (ограничение оперативной памяти, см. ниже).

**Отправка с рации** — код написан, собран, но **в эфире не проверялась**.
Сборка пакета при этом сверена побайтово с эталоном сервера (два разных
сообщения, приватное и групповое, включая контрольные суммы и нарезку на кадры).

## Чего нет

- Отправка не проверена в эфире, ввод текста с клавиатуры не написан:
  `New msg` шлёт фиксированный текст, кнопка «Ответить» — короткое `OK`.
- Подтверждение доставки (TMS-ACK) не отправляется: отправитель, запросивший
  его, покажет «не доставлено», даже если текст на экране появился.
- Контрольные суммы принятых блоков не проверяются.
- Кириллица не поддержана — символы вне ASCII заменяются на `?`. Нужен
  кириллический шрифт (в проекте есть образец: отдельный набор для японского).
- Режим `rate 3/4` не декодируется (там иное кодирование). Практическое
  следствие: приватные сообщения от AnyTone напрямую не читаются, групповые
  `rate 1/2` — читаются.

---

## Как это устроено

Ключевая находка: **чип HR-C6000 умеет собирать кадры данных сам** — это уже
использовалось прошивкой для пробуждения репитера. Нужно положить 12 байт
полезной нагрузки на страницу регистров `0x02` и записать тип кадра в регистр
`0x50` (значение — тип из стандарта, сдвинутый на 4 бита). Чип добавит
помехоустойчивое кодирование и синхронизацию.

Приём симметричен: принятые данные читаются с той же страницы `0x02`.

Новые файлы:

- `application/source/functions/sms.c` + `include/functions/sms.h` — сборка
  входящих сообщений, хранилище Inbox/Outbox, очередь передачи.
- `application/source/functions/smsSend.c` — построение исходящего пакета:
  TMS, IP/UDP, контрольная сумма сообщения, заголовок данных, преамбулы.
- `application/source/user_interface/menuMessages.c` — экраны меню.

Изменённые файлы:

- `hardware/HR-C6000.c` — захват кадров данных в обоих режимах, передача
  данных вместо голоса.
- `functions/hotspot.c` — разбор типа кадра от хоста, отправка данных хосту.
- `applicationMain.c` — разбор принятого и показ на экране.
- `user_interface/menuSystem.{c,h}` — регистрация экранов, пункт меню.
- языковые файлы — добавлена строка `messages` (во все 21).

---

## Сборка

Проект рассчитан на STM32CubeIDE, Makefile в нём нет — он написан нами:
`MDUV380_firmware/Makefile.opengd77`. Нужен `arm-none-eabi-gcc` (проверено на 14.2).

```
cd MDUV380_firmware
tools/codec_cleaner.Linux -C            # из каталога application/source/linkerdata
make -f Makefile.opengd77 -j$(nproc)
```

Первый шаг обязателен: он создаёт пустую секцию под AMBE-кодек, которого в
исходниках нет.

**Про кодек.** Официально его «донорит» заводская прошивка TYT. Если её нет,
кодек можно взять из дампа самой рации (она уже работает в DMR): секция лежит
по смещению `0x6937C` от начала образа, длина `0x48BB0`, и в дампе она в
открытом виде. Скрипт слияния — в истории работ, логика тривиальна: заменить
эту область в собранном `.bin` на область из дампа.

Без кодека прошивка соберётся, но DMR работать не будет (только FM).

## Прошивка

```
sudo python3 MDUV380_firmware/tools/opengd77_stm32_firmware_loader.py \
     -f OpenMDUV380.bin -m MD-UV380
```

Рация должна быть в режиме DFU (`0483:df11`) — вход только кнопками при
включении, программного способа нет. Нужен `python3-usb` и root.

Калибровка и codeplug при прошивке не страдают: они в отдельной микросхеме
памяти, прошивается только флеш микроконтроллера. Проверено побайтовым
сравнением до и после.

---

## Ловушки, на которые мы потратили время

**Не то дерево.** Для MD-UV380 нужна ветка `MDUV380_DM1701` (STM32). Ветка
`MK22` — это GD-77/DM-1801/RD-5R, там другая структура и другой код хотспота.
Исходники OpenGD77 не публикуются на GitHub — только zip-архивами на сайте.

**Линковка кодека.** Современный `ld` отвергает вызов по абсолютному числовому
адресу. Адреса AMBE заменены на символы через `.thumb_set` — машинный код
получается идентичный (проверено дизассемблером).

**Уведомление на экране не годится для показа.** `uiNotificationShow()` из
главного цикла затирается штатной перерисовкой экрана. Из-за этого несколько
часов казалось, что приём не работает, хотя он работал. Правильно —
`menuSystemPushNewMenu(UI_MESSAGE_BOX)`: экран держится до нажатия кнопки.

**Правка передачи может сломать голос.** Признак «это кадр данных» ставится
только на пути хотспота, а сбрасывается после отправки. Если передача
оборвалась, признак залипал — и обычная голосовая передача уходила без
заголовка вызова, то есть рация излучала, а приёмники её не понимали.
Вывод: любую правку передающего тракта проверять голосом с самой рации, а не
только в режиме модема.

**Оперативной памяти мало.** Дважды упирались в переполнение при линковке
(360 и 240 байт). Отсюда ограничения: 6 сообщений на папку, текст 64 символа.
Если понадобится больше — хранить сообщения во флеш-памяти, а не в ОЗУ.

**Диагностика.** Счётчики сборщика публикуются в хвост звукового буфера
(сигнатура `SMSD`) и читаются по USB штатным протоколом CPS (область 7). Это
надёжнее экрана. Тем же протоколом (область 6) можно снимать содержимое экрана
рации — удобно для отладки. Осторожно: частый опрос подпирает главный цикл
прошивки и мешает приёму.

**Режим модема.** Рация входит в него автоматически от первого же кадра MMDVM
по USB. Штатно она выходила из него после 20 секунд молчания хоста; по просьбе
владельца это заменено на выход при отсоединении USB-хоста — так режим не
отваливается при живой программе, но рация сама возвращается в норму, когда
кабель вынут.

---

## Лицензия

Исходный код OpenGD77 распространяется под собственной лицензией авторов
(BSD-подобная, но пункт 4 прямо запрещает коммерческое использование и
включение в проекты, допускающие коммерческое использование). Эти правки —
производная работа и наследуют те же условия.