XGecu T48 работает в Linux через minipro — программу командной строки с открытым исходным кодом. Для обычного чтения и записи поддерживаемой памяти запускать Xgpro через Wine не требуется. Начните с проверки версии minipro, обнаружения программатора и точного обозначения микросхемы в его базе: список Xgpro и база minipro не совпадают.
Инструкция рассчитана на Debian/Ubuntu и работу с памятью в панельке или подходящем адаптере. Сначала сохраните два дампа и сравните их, затем переходите к записи.
Что проверить до подключения микросхемы
Поддержка T48 есть в основном проекте minipro. Старые сообщения о том, что Linux его не распознаёт, относятся в том числе к версиям до добавления этой модели. Чтобы узнать версию и сведения о сборке, посмотрите вывод minipro -V и список поддерживаемых программаторов.
minipro -V
minipro -Q
minipro -k
-V выводит сведения о версии, -Q — поддерживаемые модели программаторов, -k проверяет подключённый прибор. На этом этапе оставьте ZIF-панель пустой. Если T48 определяется, переходите к выбору чипа; если нет, сначала разберите USB-подключение и права доступа.
Для NAND, eMMC и специальных переходников проверьте поддержку нужной операции в вашей сборке. Наличие чипа в списке Xgpro не гарантирует, что minipro сможет прочитать и записать его через тот же адаптер.
Установка minipro в Debian и Ubuntu
Если minipro доступен в репозитории вашего выпуска, можно начать с пакетной установки:
sudo apt update
sudo apt install minipro
minipro -V
minipro -Q
Если пакет не содержит поддержки T48 или нужного исправления, соберите программу из основного репозитория. Пакетный вариант и ручная установка могут оказаться в разных каталогах; команда command -v minipro покажет, какой исполняемый файл запускается.
sudo apt-get install build-essential pkg-config git libusb-1.0-0-dev zlib1g-dev
git clone https://gitlab.com/DavidGriffith/minipro.git
cd minipro
make
sudo make install
command -v minipro
minipro -V
Сборке нужна библиотека libusb и её заголовочные файлы. Если make завершился ошибкой, не переходите к установке: проверьте первое сообщение об отсутствующей зависимости. Для T48 не требуется выполнять инструкции загрузки внешних алгоритмов, предназначенные для T56 и T76.
Доступ к USB без постоянного запуска от root
После сборки установите правила udev из того же каталога исходников:
sudo cp udev/*.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules
sudo udevadm trigger
Отключите и снова подключите программатор. Правила проекта используют uaccess для локального сеанса и группу plugdev для систем, где доступ выдан через неё. Во втором случае проверьте наличие группы и добавьте своего пользователя:
getent group plugdev
sudo usermod -a -G plugdev "$USER"
После изменения групп выйдите из сеанса и войдите заново. Если группы нет, не выполняйте команду добавления вслепую: используйте принятый в вашем дистрибутиве способ выдачи доступа. В удалённом SSH-сеансе права через uaccess могут отличаться от прав пользователя за рабочим столом.
lsusb
minipro -k
T48 использует USB VID:PID a466:0a53; тот же идентификатор встречается у других моделей XGecu. Название TL866II Plus в выводе lsusb ещё не означает, что подключён другой прибор. Модель уточняйте по ответу minipro. Если устройство видно в lsusb, но доступ запрещён, проверьте правила и членство в группе; если его нет и в lsusb — кабель, порт и питание.
Выбор микросхемы: маркировка, корпус, напряжение
Перепишите полную маркировку с корпуса, включая буквенный суффикс. Например, схожие названия серии W25Q не позволяют считать все исполнения одинаковыми по питанию. Нужны даташит именно вашего чипа и соответствующий адаптер.
minipro -q T48 -L W25Q32
minipro -d "W25Q32JV@SOIC8"
-L ищет записи по части имени, а -d показывает параметры выбранной записи. В примере использовано имя из документации minipro; для своего чипа скопируйте точное имя из полученного списка. Проверьте объём, корпус, напряжения и расположение вывода 1. Совпадение объёма у двух микросхем не делает их взаимозаменяемыми.
Для SOIC/SOP8 важна ширина корпуса: адаптер XGecu SOP8 200 mil выбирают под соответствующее исполнение. У адаптера XGecu WSON8 5×6 другое посадочное место. Механически подходящий переходник сам по себе не добавляет алгоритм в minipro.
Сначала два чтения и сравнение дампов
Отключите программатор от USB, установите микросхему по схеме посадки выбранного устройства и проверьте ориентацию вывода 1. Затем подключите USB. Для первого чтения предпочтительна отдельная микросхема в подходящей панельке. При подключении прищепкой к плате отключите питание самой платы. Другие её компоненты могут нагружать линии и питание программатора и мешать чтению.
Следующие команды подходят только для точно выбранного в примере чипа. Они читают область code в два разных файла и сравнивают их побайтно:
minipro -p "W25Q32JV@SOIC8" -c code -r backup-1.bin
minipro -p "W25Q32JV@SOIC8" -c code -r backup-2.bin
cmp backup-1.bin backup-2.bin
sha256sum backup-1.bin backup-2.bin
wc -c backup-1.bin
При совпадении файлов cmp ничего не печатает и возвращает код 0. Если дампы различаются, запись отложите: проверьте контакт, посадку, кабель и влияние платы. Для 32-Мбит памяти полный бинарный образ содержит 4 194 304 байта. Для другой ёмкости пересчитайте ожидаемый размер: число битов разделите на восемь.
Проверьте, что файл не состоит целиком из FF или 00, если ожидаются данные. Совпадение двух пустых чтений не доказывает исправность подключения. Сохраните исходный дамп отдельно от файла для записи и подпишите его маркировкой чипа и датой.
Запись и контроль результата
Запись изменяет содержимое микросхемы и может включать предварительное стирание. Выполняйте её, когда сохранён исходный дамп, выбран правильный чип и подготовлен подходящий образ. Файл обновления BIOS с сайта изготовителя платы может содержать служебную оболочку: его размер и структура должны соответствовать способу прошивки.
minipro -p "W25Q32JV@SOIC8" -c code -w firmware.bin
minipro -p "W25Q32JV@SOIC8" -c code -m firmware.bin
По умолчанию minipro проверяет данные после записи; -m запускает отдельное сравнение памяти с файлом. Не добавляйте -v: в minipro эта опция отключает проверку после записи. Опции -s и -S ослабляют сообщения о несовпадении размера, а -y позволяет продолжить при несовпадении ID. Они не исправляют неправильный выбор микросхемы.
Для AVR и PIC область code не исчерпывает всё содержимое: EEPROM и конфигурационные биты могут храниться отдельно. Перед работой с микроконтроллером сохраните все используемые области и разберите назначение fuse/lock-битов: их изменение может повлиять на дальнейший доступ к устройству.
Как разбирать ошибки
| Симптом | Что проверить |
|---|---|
| В minipro нет T48 | Версию и путь запускаемого файла, наличие поддержки модели в -Q. После сборки может запускаться старый пакет. |
| USB виден, доступ запрещён | Правила udev, повторное подключение, права текущего сеанса и группу plugdev. |
| LIBUSB_ERROR_OVERFLOW | Совместимость сборки с T48, затем кабель и порт. В старых версиях такая ошибка возникала из-за отсутствия реализации протокола T48. |
| ID не совпал | Полную маркировку, выбранную запись, ориентацию и контакты. Не начинайте с подавления ошибки ID. |
| Два чтения различаются | Посадку, загрязнение контактов, адаптер и влияние подключённой платы. Сначала получите стабильный дамп. |
| Размер образа не совпадает | Ёмкость чипа, выбранную область и формат файла. Не дополняйте образ случайными байтами ради запуска записи. |
| Предупреждение о версии firmware | Ожидаемую и найденную версии, совместимость конкретной сборки. Обновление программы на ПК и прошивки прибора — разные операции. |
Когда нужен другой рабочий сценарий
Если minipro не выполняет нужную операцию с конкретным чипом или специальным адаптером, используйте Xgpro в совместимой Windows-среде. Запуск его окна через Wine ещё не подтверждает доступ к USB и работу выбранного алгоритма. Перед сменой программ сохраните дампы, точное имя устройства, версию minipro и сообщения об ошибке: это позволит повторить проверку с теми же исходными данными.
