=============================================================================== * LenovoWinTools * * Средство для работы с образами чипов Qualcomm * * Версия - 1.0 * * Copyright - vin2809 2015 * =============================================================================== Руководство пользователя по работе со средством LenovoWinTools ---------------------------------------------------------------- 1. Введение. 1.1. Назначение. Средство LenovoWinTools предназначено для разборки/сборки образов устройств на основе чипов Qualcomm. Оно содержит программые разработки автора и некоторые свободно распространяемые программы. Для работы требуется: - Windows 7 или выше без установки CYGWIN; - установленный пакет .NET 4.0. Дополнительных настроек не требуется. Средство позволяет: - обработать образ прошивки для Qualcomm типа .qsb: - разобрать его; - сложить кусочные файлы прошивки (как правило это файлы system, cache, preloader, persist, userdata); - образы Boot.img/Recovery.img: - распаковать и запаковать с учетом секции second и дерева устройств devtree; - распаковать и запаковать образы, содержащие файловые системы, например, system.img, типа ext2-ext4. 1.2. Инсталляция средства LenovoWinTools. Инсталляция средства производится путем распаковки архива в любом удобном для Вас месте. При этом будет создана папка LenovoWinTools, содержащая: - папки _In/, App/ и Cygwin/; - а также файлы Readme.txt, и menu.bat. Папка _In пустая и предназначена для размещения исходных образов для обработки. Папка App/ содержит набор командных файлов, производящих обработку образов. В папке Cygwin/ находятся авторские разработки и свободно распространяемые служебные библиотеки и файлы. Файл Readme.txt содержит инструкцию пользователя, т.е. читаемый Вами сейчас текст. Файл menu.bat служит для создания меню средства LenovoWinTools. ------------------------------------------------------------------------- | ВНИМАНИЕ. Никакого прописывания путей доступа к служебным файлам в | | переменных среды ОС Windows НЕ ТРЕБУЕТСЯ. | ------------------------------------------------------------------------- Во время работы появятся и другие, необходимые папки: - Pack, в которой будут находиться файлы Boot, Recovery и System после запаковки, а также папка Image, в которой будут находиться собранные файлы образов; - Unpack, в которой ПОЛНОСТЬЮ распакованные файлы образов Boot, Recovery, System и другие будут находиться в папке Image; - Qsb, в которой будут находиться разобранные прошивки типа *.qsb. 1.3. Деинсталляция средства LenovoWinTools. Деинсталляция средства производится путем удаления корневой папки средства, т.е. папки LenovoWinTools. 2. Основные правила работы. 2.1.Образы, предназначенные для распаковки, положите в папку _In средства. Имена входных файлов ОБЯЗАТЕЛЬНО должны содержать ключевые слова и могут иметь названия следующего вида: - *.qsb; - *boot*.img; - *recovery*.img; - *cache*.img; - *prelo*.img; - *persis*.img; - *system*.img. 2.2.Для начала работы запустите файл menu.bat. При этом на экране появится меню средства. 2.3.При первом запуске выполните инициализацию средства. При инициализации создадутся рабочие папки и ВСЕ файлы, расположенные в папке _In, будут скопированы во входную рабочую папку Unpack/Image. Образ прошивки *.qsb НЕ копируется. Это сделано для того, чтобы сохранить исходные файлы в папке _In в неизменном виде. 2.4.После разборки образа *.qsb в папке Qsb/ создается папка с именем образа, в которую помещаются файлы из прошивки. Здесь же создается папка cfg/ с файлом настроек *.cfg. 2.5.После разборки других образов содержимое помещается в папку Unpack, в которой будет создана следующая структура папок: Boot(Recovery)/cfg/ devtree/ kernel/ ramdisk/ second/ Папки devtree и second создаются по мере надобности. В папке cfg/ будут находиться настройки образа, в папке kernel Вы найдете ядро, т.е. бинарный файл kernel, а в папке ramdisk будет распакованное содержимое. Для выполнения сборки образа его составные части, т.е. ramdisk, ядро, а, возможно и настройки, поместите в соответствующие папки в Unpack. Созданный образ будет находиться в выходной папке Pack/Image/. 3. Описание средства. 3.1. Главное меню команд. Главное меню команд средства имеет следующий вид: **************************** * LenovoWinTools_v1.0 * * ( Qualcomm ) * **************************** * Copyright C vin2809 * * 2015 * **************************** * Image commands: * * --------------- * * 1-Qsb * * 2-Boot/Recovery * * 3-System,cache,... * * * **************************** * Tools commands: * * --------------- * * 4-Init Tools * * 5-Clean * * * **************************** * 6-Exit * **************************** Please, choose command: Выбор команды производится путем ввода номера, указанного перед ней. В текущей версии Вы можете выполнить следующие действия: - перейти к меню обработки образа *.qsb - "1"; - перейти к меню обработки образов Boot/Recovery набрав цифру "2"; - перейти к меню обработки образов, содержащих файловые системы (System, Cache, Persist, Preload, Userdata) - "3"; - провести инициализацию рабочей области средства - "4"; - провести очистку рабочей области средства - "5"; - завершить работу, т.е. выйти из средства - "6". 3.2. Меню Qsb. Для перехода к обработке образа прошивки типа *.qsb выполните команду "1-Qsb". При этом Вы перейдете в меню "Qsb commands". Меню обработки образов Boot имеет следующий вид: **************************** * Qsb commands: * * --------------- * * 1-Qsb unpack * * 2-Qsb pack * * 3-Join chunk file * * * **************************** * 4-Return * **************************** "Please, choose command:" 3.2.1.Разборка образа *.qsb. Для разборки образа *.qsb выполните команду "1-Qsb unpack". При этом на экран выводится сообщение: * Choice Qsb-file * и список образов прошивок. После указания требуемого, образ будет разобран в автоматически созданную папку с именем образа. В этой же папке будет создана папка конфигурации cfg, содержащая файл параметров *.cfg. На экран выводятся имена доставаемых из прошивки файлов. 3.2.2.Сборка образа *.qsb. Для сборки образа подготовьте настройки в файле *.cfg: "File Name" - название файла прошивки; "Author" - автор прошивки. Все файлы прошивки сложите в папку Qsb/"имя образа" и выполните команду "2-Qsb pack". При этом появится запрос на выбор собираемого файла, что позволяет Вам собирать разные прошивки независимо друг от друга: * Choice Qsb-file * При сборке прошивки на экран будут выводиться имена добавляемых файлов. ------------------------------------------------------------------------- | ВНИМАНИЕ. Для сборки НЕОБХОДИМЫ файл разметки памяти gpt_main0.bin | | и файл rawprogram0.xml, используемый при прошивке (flash) | | образа *.qsb в мобильное устройство. | ------------------------------------------------------------------------- 3.2.3.Сборка кусочных файлов. Для сложения кусочных файлов типа *_1.img в один выполните команду "3-Join chunk file". Появится запрос на выбор папки прошивки, содержащей кусочные файлы. Все кусочные файлы, имена которых начинаются на system, cache, persist, preload, userdata, и находящиеся в папке с прошивкой *.qsb, будут собраны в соответствующий файл. Собранные файлы будут помещены в папку Unpack/Image/, что позволяет обрабатывать их средством. 3.3. Меню Boot/Recovery. Образы Boot/Recovery имеют ОДИНАКОВУЮ структуру, поэтому обрабатываются из одного меню. Для перехода к обработке выполните команду главного меню "2-Boot/Recovery". При этом Вы перейдете в меню "Boot/Recovery ", имеющее следующий вид: **************************** * Boot/Recovery * * ----------------- * * 1-Unpack image * * 2-Pack image * * * **************************** * 3-Return * **************************** Please, choose command: По команде "1" производится распаковка образов, а по команде "2" производится запаковка образов. По команде "3" производится возврат в главное меню средства. 3.3.1. Разборка образа boot/recovery.img. При выполнении команды появится запрос на выбор файла: * Choice file * и список возможных файлов для разборки. После указания файла дальнейшая работа производится автоматически. При анализе файла выявляются составляющие и каждая из них помещается в отдельную автоматически созданную папку. 3.3.2. Сборка образа boot.img. *** Choose path *** 3.4. Меню "System commands". Меню позволяет обрабатывать образы, содержащие файловые системы (ФС) ext2-ext4. Это могут быть файлы-образы cache, persist, preloader, system, userdata. Для перехода к обработке выполните команду "3-System,cache,..." главного меню. При этом Вы перейдете к меню "System commands". Меню обработки образов ФС имеет следующий вид: ************************************* * System commands: * * ------------------------------- * * 1-unpack ext3 * 2-pack ext3 * * 3-unpack ext4 * 4-pack ext4 * * * * ************************************* * 5-Return * ************************************* Please, choose command: 3.4.1. Разборка образа ФС. Разборка образа ФС типа ext3 производится командой "1-unpack ext3", а типа ext4 - "3-unpack ext4". Последовательность действий всегда одинакова: просто выбрать файл-образ из предложенного списка. Распаковка образов ФС производится автоматически в созданную папку с именем образа, расположенную в папке Unpack/. 3.4.2. Сборка образа ФС. Сборка образа ФС типа ext3 производится по команде "2-pack ext3", а типа ext4 - "4-pack ext4". Последовательность действий всегда одинакова: по команде производится выбор папки для обработки и запаковка содержимого образов ФС. 3.4.4.Возврат в главное меню. По команде "5" производится возврат в главное меню средства. 3.5. Инициализация. Для проведения инициализации выполните команду "4-init Tools". При этом будут созданы все необходимые для работы средства LenovoWinTools структуры папок и будет произведено копирование входных образов (кроме *.qsb) в рабочую папку Unpack/Image. 3.6. Очистка средства. Для очистки рабочей области выполните команду "5-CLEAN". При этом ВСЕ дополнительные папки вместе с содержимым будут удалены, средство LenovoWinTools завершит работу и примет вид, какой оно имело сразу после инсталляции. 3.7. Выход. Для выхода выполните команду "6-Exit". При этом произойдет ТОЛЬКО выход из средства без всякой очистки, что позволит Вам позже вернуться к работе. Copyright C vin2809, 2015