UnitX HID Flasher: загрузка прошивки

UnitX HID Flasher записывает прошивки .ufw в устройства UnitX со встроенным USB HID-загрузчиком. Программа проверяет файл и подключённое устройство, показывает ход записи и после завершения перезагружает устройство.

Сборки UnitX HID Flasher для Windows (.exe) и Linux (.AppImage) готовятся. Ссылки на них появятся на этой странице. ODHIDDfu — другая программа: она предназначена для устройств с DFU-прошивками и не заменяет UnitX HID Flasher при работе с файлами .ufw.

Установка и запуск

macOS: DMG

1. Откройте файл unitx-hid-flasher.dmg.
2. Перетащите UnitX HID Flasher в папку Applications.
3. Запустите программу из папки Программы.

Пакет подписан для проверки целостности, но не нотариализован Apple. Если macOS не разрешает первый запуск, откройте Системные настройки → Конфиденциальность и безопасность и подтвердите открытие UnitX HID Flasher.

Windows: EXE

Инструкция пригодится после публикации сборки для Windows.

1. Скачайте unitx-hid-flasher.exe с этой страницы и сохраните его в отдельную папку, например Документы\UnitX HID Flasher.
2. Запустите файл двойным щелчком. Установка в систему не требуется.
3. Если Windows заблокировала загруженный файл, откройте Свойства → Общие, отметьте Разблокировать и примените изменение. Разблокируйте только файл, скачанный с сайта UnitX.
4. Если программа запускается, но не видит загрузчик, закройте её, нажмите правой кнопкой мыши на unitx-hid-flasher.exe и выберите Запуск от имени администратора. Подтвердите запрос контроля учётных записей Windows.

Отдельный драйвер для загрузчика не нужен: Windows использует стандартный драйвер USB HID. Не заменяйте его через Zadig на WinUSB, libusbK или другой драйвер — после такой замены UnitX HID Flasher может перестать видеть устройство.

Linux: AppImage

Инструкция пригодится после публикации сборки для Linux.

1. Скачайте unitx-hid-flasher.AppImage с этой страницы.

2. Откройте свойства файла и разрешите запуск как программы. То же самое можно сделать в терминале, открытом в папке с файлом:

   chmod +x unitx-hid-flasher.AppImage
   

3. Запустите файл двойным щелчком или из терминала:

   ./unitx-hid-flasher.AppImage
   

Если появляется сообщение о недоступном FUSE, установите совместимый пакет по инструкции своего дистрибутива. Например, в Ubuntu 24.04 это libfuse2t64, а в некоторых предыдущих версиях Ubuntu и Debian — libfuse2. После этого снова запустите AppImage.

Права доступа к USB HID

Если у программы нет доступа к USB, UnitX HID Flasher может сообщить, что загрузчик не найден, хотя устройство уже находится в нужном режиме. Порядок настройки доступа зависит от операционной системы и описан ниже.

Windows

Сначала попробуйте обычный запуск. Если загрузчик 0483:A26A не определяется, один раз запустите EXE от имени администратора. Если после этого устройство нашлось, причина связана с правами или политикой доступа к USB. На личном компьютере можно запускать программу с повышенными правами только на время прошивки. На рабочем компьютере лучше попросить администратора разрешить доступ к устройству, а не отключать контроль учётных записей или защиту Windows.

Linux

UnitX HID Flasher обращается к USB-устройству через libusb. Постоянно запускать графическую программу через sudo не следует. Вместо этого один раз создайте правило udev, которое даст активному пользователю сеанса доступ только к загрузчику UnitX с VID 0483 и PID A26A:

printf '%s\n' 'SUBSYSTEM=="usb", ATTR{idVendor}=="0483", ATTR{idProduct}=="a26a", MODE="0660", TAG+="uaccess"' \
  | sudo tee /etc/udev/rules.d/70-unitx-hid-flasher.rules >/dev/null
sudo udevadm control --reload-rules
sudo udevadm trigger --subsystem-match=usb

Отключите устройство от USB, подключите снова, переведите в загрузчик и перезапустите UnitX HID Flasher. Проверить, что Linux видит загрузчик, можно командой:

lsusb -d 0483:a26a

Если lsusb показывает устройство, а программа его не открывает, выполните разовую проверку из терминала:

sudo ./unitx-hid-flasher.AppImage --console --check

Если с sudo загрузчик находится, а без sudo — нет, проверьте содержимое правила, перезагрузку udev и повторное подключение устройства. Для обычной работы вернитесь к запуску без sudo. В системе без поддержки uaccess администратор может назначить устройство отдельной ограниченной группе через GROUP="имя-группы". Не устанавливайте MODE="0666": такое правило разрешит доступ к загрузчику всем локальным пользователям.

macOS

В macOS отдельное USB-правило не требуется. Права администратора могут понадобиться при первом запуске, чтобы разрешить открытие приложения в разделе Конфиденциальность и безопасность. После подтверждения запускайте программу из папки Программы как обычно. Если окно открывается, но загрузчик не определяется, переподключите устройство, закройте другие программы для работы с USB HID и снова нажмите Проверить устройство.

Как обновить прошивку

1. Скачайте файл .ufw именно для своей модели и аппаратной ревизии. Файл от другого устройства не подойдёт.
2. Переведите устройство в загрузчик по инструкции к своей модели. После этого основной последовательный порт может исчезнуть — это штатное поведение.
3. Откройте UnitX HID Flasher и перетащите .ufw в окно либо укажите путь к файлу.
4. Нажмите Проверить устройство. В журнале должно появиться сообщение о совместимом загрузчике 0483:A26A.
5. Нажмите Прошить и дождитесь сообщения Готово. Во время записи не отключайте устройство и USB-кабель.
6. После перезагрузки подключитесь к устройству штатной программой и проверьте версию прошивки.

Флажок Не перезагружать устройство после прошивки нужен, только если после записи устройство должно остаться в загрузчике. Для обычного обновления оставьте его выключенным.

Если программа не видит устройство

• Убедитесь, что устройство переведено именно в режим загрузчика, а не работает в основном режиме.
• Проверьте права доступа по инструкции для своей операционной системы выше.
• Переподключите USB-кабель и снова нажмите Проверить устройство.
• Закройте другие программы, которые могут использовать это HID-устройство.
• Проверьте, что выбрали файл с расширением .ufw для нужной модели.

Если загрузчик по-прежнему не определяется, обратитесь в поддержку и укажите модель устройства, аппаратную ревизию и название файла прошивки.