РАЗКИРПИЧИТЬ РУК-ВО | UNBRICK MANUAL | RELEASES
ВИДЖЕТЫ РУК-ВО | WIDGETS MANUAL | RELEASES
ИГРЫ РУК-ВО | GAMES MANUAL | RELEASES
Инструменты для раскирпичивания основной flash-памяти радиостанции TIDRADIO TD-H9 в HID-режиме (без перехода чипа в UBOOT-режим). Проект состоит из двух частей:
h9_flash.py— консольный флешер (CLI) на Python.ui_app/app.py— оконное приложение (GUI) на PySide6, которое повторяет ту же логику и добавляет кнопки, прогресс и журнал.
Что делает инструмент. Распаковывает пакет
.fw(извлекаетflash.bin), сравнивает CRC секторов рации с целевым образом и перезаписывает только отличающиеся секторы, затем проверяет запись по CRC. Boot-область0x0000..0x4FFFи область настроек0xDA000..0x100000не трогаются.
Официальная прошивка TD-H9 поставляется в виде файла *.fw (например,
TD-H9-V1.0.38.fw). Штатно её заливают фирменной программой через USB Update
(UBOOT) режим.
Однако у чипа есть и второй путь — HID-режим (PTT+2 при включении),
когда рация определяется как HID-устройство VID 0x4C4A, PID 0x4155.
Скрипты работают именно по HID-каналу.
| Компонент | Зачем | Где взять |
|---|---|---|
| TIDRADIO TD-H9 | рация, которую прошиваем | у вас |
| USB-C кабель с передачей данных | физическое соединение (не «зарядка»!) | у вас |
| Python 3.11+ | среда выполнения | python.org |
| Poetry | управление зависимостями и окружением | python-poetry.org |
Пакет hid (pyhidapi) |
доступ к HID-устройству | poetry add hid |
hidapi.dll (x64) |
нативная библиотека для hid |
github.com/libusb/hidapi/releases |
| PySide6 | только для GUI | poetry add pyside6 |
| PyInstaller | сборка exe | poetry add pyinstaller |
Файл прошивки .fw |
что заливаем | в папке firmware |
Важно про
hidapi.dll. Пакетpyhidapi— это лишь Python-обёртка. Ей нужна нативная библиотекаhidapi.dll. Положите её рядом со скриптомh9_flash.py(в корень проекта).
Проект использует Poetry для управления зависимостями. Все зависимости
(hid, pyside6, pyinstaller, …) объявлены в pyproject.toml.
# 1) Установить Poetry (один раз, если ещё нет)
pip install poetry
# 2) Перейти в папку проекта
cd <path>
# poetry env use "<path to python C:\...>" # опционально
# 3) Установить зависимости и создать виртуальное окружение
poetry install
# 4) Положить hidapi.dll (x64) в корень проекта:
# — скачать: https://github.com/libusb/hidapi/releases
# — взять архив hidapi-win.zip, распаковать x64\hidapi.dll
# — поместить рядом с h9_flash.pyВсе команды дальше запускаются через poetry run python ... (или активируйте
окружение Poetry: poetry shell, затем просто python ...).
- Выключите рацию.
- Зажмите одновременно PTT и кнопку
[2]. - Удерживая кнопки, включите рацию — она войдёт в HID-режим (updater).
- Подключите USB-C кабель (обязательно с данными) к компьютеру.
- В системе рация должна определиться как устройство
Jieli Technology USB Composite DeviceсVID 0x4C4A, PID 0x4155.
Проверить можно командой:
poetry run python h9_flash.py --listОжидаемый вывод:
Scanning for JieLi HID devices (VID 0x4C4A):
VID:0x4C4A PID:0x4155 Jieli Technology USB Composite Device (TD-H9 HID flash mode)
Или использовать USBTreeView
Если записи нет — проверьте кабель (нужен с данными, а не только зарядка), удерживание кнопок и порядок включения.
poetry run python h9_flash.py --help| Флаг | Назначение |
|---|---|
--list |
показать найденные JieLi HID-устройства |
--fw <файл.fw> |
путь к пакету прошивки (обязательно для заливки) |
--backup <файл.bin> |
сохранить текущий образ в файл перед записью |
--verify |
медленная полная проверка по сдвинутым CRC перед записью |
--nocheck |
пропустить сверку CRC и принудительно перезаписать все секторы |
--yes |
не спрашивать подтверждения |
poetry run python h9_flash.py --fw "TD-H9-V1.0.38.fw" --backup before.binСкрипт:
- распакует пакет и покажет SHA-256 пакета и образа;
- откроет рацию и проверит геометрию;
- сделает CRC-скан секторов;
- покажет список секторов к перезаписи и спросит подтверждение;
- запишет секторы (от старших к младшим) с проверкой каждого;
- выполнит финальную проверку всех секторов.
После успеха — выключите USB и перезапустите рацию.
poetry run python h9_flash.py --fw "TD-H9-V1.0.38.fw" --backup before.bin --yesСкрипт перед записью дополнительно делает проверку по сдвинутым CRC-окнам — это доказывает, что реальные байты в памяти совпадают с образом, а не только 16-битные CRC секторов (исключает коллизии). Эта проверка медленная (тысячи HID-запросов), поэтому по умолчанию выключена.
poetry run python h9_flash.py --fw "TD-H9-V1.0.38.fw" --verify --yesПри несовпадении запись будет запрещена.
Если нужно перезаписать все секторы приложения независимо от текущего CRC
(не останавливаясь при совпадении) — используйте --nocheck:
poetry run python h9_flash.py --fw "TD-H9-V1.0.38.fw" --nocheck --yes
--nocheckотключает и--verify(если задан вместе). Стирание/запись/проверка каждого сектора всё равно выполняются — пропускается только предварительная сверка.
GUI повторяет консольную логику и добавляет удобства.
poetry run python ui_app\app.py- Инструкция входа в HID-режим вверху окна (сводка из раздела 4).
- Firmware — выбор файла
.fw(кнопка Browse). - Options — опциональный путь к бэкапу, чекбоксы
--verifyи--nocheck. - Progress bar — прогресс по секторам.
- Журнал (лог) — все сообщения; лог копируемый (выделение + Ctrl+C, либо кнопка Copy log), а также кнопка Clear (очистить).
- Detect device — поиск и вывод подключённых JieLi HID-устройств.
- Flash — запуск прошивки в фоновом потоке (окно не зависает).
- Stop — досрочная остановка.
- Подключите рацию в HID-режиме (PTT+2 при включении).
- Нажмите Detect device — убедитесь, что видна
4C4A:4155. - Выберите файл
.fw. - (Опционально) укажите путь к бэкапу.
- (Опционально) включите
--verify/--nocheck. - Нажмите Flash, следите за прогрессом и логом.
- По завершении отключите USB и перезапустите рацию.
Сборка выполняется через PyInstaller (объявлен в poetry). Способ через
spec-файл (рекомендуемый — включает h9_flash.py и hidapi.dll):
poetry run pyinstaller --noconfirm ui_app\flasher.specРезультат: dist\TDH9Flasher.exe — single-file GUI-приложение, в которое
упакованы app.py, модуль h9_flash и hidapi.dll.
Chat-20/
├── h9_flash.py # консольный флешер (CLI)
├── hidapi.dll # нативная библиотека (нужна для CLI и GUI)
├── pyproject.toml # зависимости Poetry
├── ui_app/
│ ├── app.py # оконное приложение (GUI, PySide6)
│ └── flasher.spec # spec-файл PyInstaller для сборки exe
└── README.md # этот файл
| Документ | RU | EN |
|---|---|---|
| Корневой README | README.md | README.en.md |
| Запароливание рации | lock-pass.md | lock-pass.en.md |
| Карта памяти | ram.md | ram.en.md |
| Установка приложений | td9_apps.md | td9_apps.en.md |
| Boot-логотип | td9_logo.md | td9_logo.en.md |
| Пакет картинок | td9_kpi.md | td9_kpi.en.md |
| Настройки APRS/GNSS | td9_aprs.md | — |
| Кастомная прошивка | custom_firmware/README.md | custom_firmware/README.en.md |
| Трекер | myapps/tracking/README.md | myapps/tracking/README.en.md |
| Путевые точки | myapps/tracksvr/README.md | myapps/tracksvr/README.en.md |
| Ограничения трекера | myapps/tracking/LIMITS.md | myapps/tracking/LIMITS.en.md |
| Лицензия | LICENSE.md | — |
| Сторонние компоненты | THIRD_PARTY_NOTICES.md | — |
| Версия | version.md | — |
- Прошивка деструктивна. Перед первым запуском всегда делайте бэкап, если есть возможность.
- Инструмент не пишет boot-область
0x0000..0x4FFFи настройки0xDA000+. - Используйте только проверенный пакет, предназначенный для вашей рации. Несовместимая прошивка может нарушить работу радио.
- Не отключайте рацию и USB во время записи — при прерывании можно получить частично записанное состояние. Повторный запуск перепроверит секторы.
--nocheckопаснее обычного режима: принудительная перезапись без сверки. Используйте осознанно.
| Проблема | Решение |
|---|---|
ImportError: Unable to load ... hidapi.dll |
положите hidapi.dll (x64) в корень проекта |
Устройство 4C4A:4155 не видно в --list |
проверьте кабель (с данными), PTT+2 при включении, работу от имени admin при необходимости |
Package unpack error |
выбранный файл — не валидный TD-H9 пакет .fw |
Radio already matches ... Nothing to write |
рация уже совпадает с образом; используйте --nocheck если нужна принудительная перезапись |
| Окно GUI не открывается (PySide6) | poetry run python -c "import PySide6" — если ошибка, проверьте poetry install |
- Кастомная прошивка с поддержкой запароливания: TD-H9-V1.0.38DKXCE.fw
- Смена загрузочной картинки
- Загрузка картинок
- Загрузка приложений
- Запароливание рации
- Конфигурирование APRS-настроек
Приложения основаны на тулбоксе и кастомной прошивке melidosian/h9toolbox.
Автор: dkxce
Android: dkxce/tdh9android
Desktop: dkxce/tdh9desktop
Widgets: dkxce/tdh9apps
Manual: dkxce/Tidradio-TD-H9





