www.oSLIK.ru
:: SX1.ru :: SL45.ru ::

Правила   FAQ   Поиск   Пользователи   Группы
Профиль   Новых сообщений нет   Выход [ _Danila_Master_ ]

Инструкция по использованию Apatcher'а

Следующая тема
Предыдущая тема
Следить за ответами в теме

| Список форумов www.oSLIK.ru » Siemens SX1 F.A.Q.

Автор | Сообщение

ficker
Z-Team member

Зарегистрирован: 29.11.2003
Сообщения: 997

Добавлено: Сб Авг 20, 2005 11:30 pm |

Инструкция по использованию программы Apatcher

Краткое описание

Apatcher это программа для создания, редактирования применения патчей к запущенной прошивке или файлу. Патчи созданные Apatcher’ом могут содержать различные шрифты, стили символов, такие как жирный, курсив, подчеркнутый и даже графику и различные диалоговые окна, содержащие информацию. Для облегчения работы с текстом, apatcher оснащен панелями инструментов, форматирования и линейкой, которые ускоряют работу по созданию патча.

Знакомство c Apatcher’ом

Рабочее окно Apatcher

Рабочее окно Apatcher’а состоит из Меню и нескольких закладок, Patch and SXP(R) editor, ROLF, Z Core/Var.

Меню
Меню содержит различные команды, которые пользователь может использовать при работе с текстами. Если указать на команду, то в строке состояния отображается ее функциональное назначение. Я думаю, что назначение этих команд не вызовет вопросов, так как они сходны с таковыми в WordPad например.

Описание закладки Patch and SXP(R) editor

Из названия закладки не трудно догадаться, что эта часть программы служит для создания и редактирования патчей.

Панели инструментов
Панели инструментов содержат различные инструменты для работы с текстом, а также для работы с патчами. Если с инструментами для работы с текстом, я думаю всем понятно, то о панели инструментов для работы с патчами расскажу подробнее:

С помощью этой кнопки, патч применяется к загруженной в память прошивке.

С помощью этой кнопки, патч применяется к файлу. Например к файлу XBI для создания мода прошивки.

С помощью этой кнопки область памяти с загруженной прошивкой сохраняется в файл, этот файл называется dump файл.

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

Описание закладки ROLF

Закладка ROLF служит для работы с диском A телефона, загруженного из dump файла прошивки или из памяти загруженной прошивки.

Панель инструментов
Панель инструментов содержит следующие инструменты для работы с диском A телефона:

С помощью этой кнопки, диск A загружается из dump файла прошивки.

С помощью этой кнопки, диск A загружается из памяти запущенной прошивки.

С помощью этой кнопки, отредактированный диск A сохраняется в dump файл.

С помощью этой кнопки обновляется информация о диске A, например при его редактировании.

С помощью этой кнопки, удаляются файлы с диска A, например для освобождения места под свои файлы.

С помощью этой кнопки, выбранный файл открывается с внешней программой, ассоциированной с этим типом файлов.

С помощью этой кнопки можно открыть диск A для исследования или редактирования. Открывается в виде папки.

Описание закладки Z Core/Var

Закладка Z Core/Var служит для работы с диском Z телефона, загруженного из dump файла прошивки или из памяти загруженной прошивки.

Панель инструментов
Панель инструментов содержит следующие инструменты для работы с диском Z телефона:

С помощью этой кнопки, диск Z загружается из dump файла прошивки.

С помощью этой кнопки, диск Z загружается из памяти запущенной прошивки.

С помощью этой кнопки обновляется информация о диске Z.

С помощью этой кнопки можно открыть диск Z для исследования. Открывается в виде папки.

Работа c Apatcher’ом

Основная функция Apatcher’а такая же как и у Winswup Memory Patcher (WSMP), т.е. для установки патчей.

1. Как устанавливать патчи с помощью Apatcher’а.
Для этого нам потребуется патч, который можно скачать здесь
Запускаем Apatcher, в меню File выбираем пункт Open и в появившемся диалоговом окне выбираем необходимый для установки патч. Кроме своих (*.sxpr) патчей, Apatcher также понимает патчи от WSMP (*.sxp).
Вид окна Apatcher’а с загруженным патчем:

Перед тем как применить патч, необходимо запустить swup прошивку (напр. 07102004-K1_SiemensvA114_signed.exe, скачать можно тут), в память которой будет устанавливаться патч.
После того как прошивка загрузилась, в Apatcher’е нужно нажать (Apply patch for RAM) для установки патча в память.
Вид окна с успешно установленным патчем:

Об успешной установке патча говорит надпись All DONE!

После этого, не закрывая swup прошивку, прошиваем телефон по общепринятой методике.
Внимание:
Если телефон прошивается только для установки патчей, т.е. без повышения/понижения версии прошивки, то в диалоговом окне swup прошивки достаточно выбрать следующие пункты:

2. Как установить патч для файла.
Для этого нам потребуется патч. Запускаем Apatcher, в меню File выбираем пункт Open и в появившемся диалоговом окне выбираем необходимый для установки патч.
Вид окна Apatcher’а с загруженным патчем:

Далее нажимаем на (Apply patch for file) и в появившемся диалоговом окне выбираем файл, в который хотим установить патч, например XBI файл прошивки.
Вид окна с успешно установленным патчем:

Об успешной установке патча говорит надпись All DONE!

3. Функция (Save memory WinSWUP to dump file).
Эта функция служит для сохранения памяти запущенной прошивки в файл, например для последующего изучения.

4. Функция (Any file replacer).
Служит для создания патчей, заменяющих файлы на диске Z или A. Например для файлов, перенос которых на другой диск не возможен по каким-то причинам.
Для этого потребуется оригинальный файл, который нужно заменить, и редактированный файл, причем размер редактированного файла должен быть меньше или равен размеру оригинального файла. Далее нажимаем (Any file replacer), в появившемся диалоговом окне выбираем оригинальный файл, во втором появившемся окне выбираем редактированный файл, после этого в третьем диалоговом окне пишем имя нового патча.
Вид окна Apatcher’а со сгенерированным патчем:

Об успешной генерации патча говорит надпись All DONE!

5. Работа с диском A (ROLF) телефона.
Нажав на закладку ROLF, попадаем в редактор диска A (ROLF) телефона.
Описание и назначение кнопок на панели инструментов:

(Open Swup dump) - служит для открытия dump файла прошивки, для извлечения из него содержимого диска A.
Вид окна Apatcher’а с открытым диском A:

(Extract A from winswup memory) - служит для извлечения диска A из памяти запущенной прошивки.

(Save disk A dump) – служит для сохранения редактированного диска A в dump файл. С помощью этой функции можно полностью заменить диск A по своим потребностям. Для работы этой функции необходим Apacker.

(Delete current file from list) - служит для удаления файлов из списка.

(Open file) – открывает файл, с внешней программой, ассоциированной с этим типом файлов, например *.jpg файлы с Adobe Photoshop.

(Explore Disk A folder) диск A открывается в виде обычной папки.

Для редактирования диска:
Нажимаем (Explore Disk A folder), диск A открывается в виде обычной папки, где вручную можно удалить/создать необходимые файлы. Завершив редактирование диска, на панели инструментов нажимаем (Refresh).
-Необходимо учитывать, что диск A имеет ограниченный размер около 3.3mb.
Если он превышен информация о количестве файлов на диске и размер, выделится красным цветом:

Отредактировав диск, нажимаем (Save disk A dump), после чего в появившемся диалоговом окне пишем имя для dump файла диска A. После чего создается dump файла диска A и патч необходимый для его установки:

Этот патч теперь можно установить в память запущенной прошивки, или в XBI файл.

6. Работа с диском Z (Core/Var) телефона.
Нажав на закладку Z (Core/Var), попадаем в эксплорер диска Z (Core/Var) телефона.

Описание и назначение кнопок на панели инструментов:

(Open Swup dump) - служит для открытия dump файла прошивки, для извлечения из него содержимого диска Z.
Вид окна Apatcher’а с загруженным диском Z:

(Extract Z from winswup memory) - служит для извлечения диска Z из памяти запущенной прошивки.

(Refresh) – служит для обновления списка файлов.

(Open file) - открывает файл, с внешней программой, ассоциированной с этим типом файлов, например *.jpg файлы с Adobe Photoshop.

(Explore Disk Z folder) - диск Z открывается в виде обычной папки.

Описание команд(для опытных юзеров)

Помимо форматирования текста в патчах, в Apatcher'е есть возможность добавлять диалоговые окна, которые будут выводиться на экран во время установки патчей. Эти окна могут содержать различную формацию по установке патчей, описание. Так же с помощью этих команд можно создать своеобразный сценарий установки патча, или мода прошивки.

Список и описание команд:

selectbox:title:str_1:d_1:str_2:d_2: .... str_n:d_n
выводит диалог выбора с заголовком title, и вариантами str_1, ... , str_n
если выбран выриант str_k, это равносильно комманде jump:d_k
пример:
selectbox:установить темы?:да:0:нет:3:дополнительный режим:-10:выход:2
replace:......... (патч 1)
jump:1
break
...
...
...
break
label:10
...
...

label:value[:dialog]
Выход из режима goto если value равно ранее сохранненному (знак при сравнении не учитывается только абсолютное значение)

Режим "goto" в этот режим входим, когда у selectbox или jump отрицательное число, модуль этого числа запоминаем
в этом режиме комманды пропускаются, кроме комманды
label:value
если эта комманда всретилась, то сравниваем value с запомненным
если равны, то выходим из режима "goto"
в обычном режиме label просто пропускаются
по сути - это переходы по меткам, но только всегда вперед
пример
jump:-10
....
....
label:10

set:flag:value[:dialog]
установить любой flag (от 0 до 127) в 0 или 1

not:flag[:dialog]
Инвертировать флаг

jump:step:flag[:dialog]
Перейти на step шагов при совпадении флага
jumpn:step:flag[:dialog]
Перейти на step шагов при НЕ совпадении флага

Если флаг установлен, то пропустить step комманд (step >= 0) или переход на метку |step| (step < 0), если если флаг не указан, то в любом случае
jumpn - все аналогично jump, только переход, если флаг сброшен, а не установлен.
примеры:
1.
jump:4 (пропустить 4 комманды)
2.
jumpn:-10:127 (если флаг 127 сброшен, переход на метку 10)
...
...
label:10

rundll|x.dll|y[|dialog]
Запустить в x.dll функцию GetCommand: function(index: byte): pchar; cdecl; с параметром "y"
Разделителем строк является символ 10=0хА
декларация GetCommand для тех, кто пишет на Си:
extern "C" __declspec(dllexport) char* __cdecl GetCommand(unsigned char cNum);

replacefile:search:entered:file[:dialog]

replacetext:oldtext:newtext[:dialog]

replaceunicode:oldtext:newtext[:dialog]

replace:oldhex:newhex[:dialog]

break[:х:dialog]
x=0 инфо
x=1 Yes=Break
x=2 No=Break
x=3 Инфо, затем Break
если параметров нет- break безусловный

include|x.sxp[|dialog]
включает в патч файл x.sxp

Ссылки по теме:

APatcher - здесь ведется обсуждение данной программы, так же здесь можно найти последнюю версию.
Патчи можно скачать здесь.
Прошивка - что это такое, как ставить, и для чего, обо всем этом можно почитать здесь.
Подробный FAQ по темам от Z-TEAM
Что такое МОД прошивки, как его сделать, можно почитать здесь.

In English

The instruction on use of the Apatcher

The brief description

Apatcher is the program for creation, editing and installation of patches to the firmware memory or a file. Patches created with Apatcher can contain various fonts, styles of symbols, such as fat, the italics underlined and even to the schedule and various dialogue windows, containing the information. For simplification of work with the text, apatcher it is equipped by panels of tools, formatting and a ruler which accelerate work on creation of a patch.

Acquaintance the Apatcher

Working window of Apatcher

Working window of Apatcher consists from Menu and several tabs, Patch and SXP(R) editor, ROLF, Z Core/Var.

Menu
The menu contains various commands which the user can use at work with texts. If to specify a command in a line of a condition its functional purpose is displayed. I think, that purpose of these commands will not cause questions as they are similar to those in WordPad for example.

The description of a Patch and SXP(R) editor tab

From the name of a tab it is not difficult to guess, that this part of the program serves for creation and editing of patches.

Panels of tools
Panels of tools contain various tools for work with the text, and also for work with patches. If with tools for work with the text, I think all clearly about the panel of tools for work with patches I shall tell more in detail:

By means of this button, the patch is applied to the firmware loaded into memory.

By means of this button, the patch is applied to the file. For example to XBI file, for making of firmware mod..

By means of this button the area of memory with the loaded firmware is kept in a file, this file refers to dump a file.

By means of this button it is possible to make a patch for replacement of any file in an firmware loaded into memory, or XBI file.

The description of ROLF tab

ROLF tab serves for work with disk A of phone loaded from dump of a file of an firmware or from memory of the loaded firmware.

Panels of tools
The panel of tools contains following tools for work with disk A of phone:

By means of this button, disk A is loaded from dump a file of an firmware.

By means of this button, disk A is loaded from memory of the started firmware.

By means of this button, edited disk A is kept in dump file.

By means of this button the information on disk A is updated, for example at its editing.

By means of this button, delete files from disk A, for example for clearing a place under the files leave.

By means of this button, the chosen file opens with the external program, associated with this type of files.

By means of this button it is possible to open disk A for research or editing. Opens in a folder.

The description of Z Core/Var tab

Z Core/Var tab serves for work with disk Z of phone loaded from dump of a file of an firmware or from memory of the loaded firmware.

The panel of tools
The panel of tools contains following tools for work with disk Z of phone:

By means of this button, disk Z is loaded from dump a file of an firmware.

By means of this button, disk Z is loaded from memory of the started firmware.

By means of this button the information on disk Z is updated.

By means of this button, the chosen file opens with the external program, associated with this type of files.

By means of this button it is possible to open disk Z for research. Opens in a folder.

Work with Apatcher

Basic function Apatcher same as well as at Winswup Memory Patcher (WSMP), i.e. for installation of patches.

1. How to install patches with Apatcher.
For this purpose we need a patch, which we can take here
Start Apatcher, in menu File select Open, and in the appeared dialogue window, choose desired patch (*.sxpr). Also in Apatcher can be used (*.sxp) patches from WSMP.
Window of Apatcher with the loaded patch:

Before applying a patch, it is necessary to start swup an firmware (for example 07102004-K1_SiemensvA114_signed.exe, download it here), in which memory the patch will be installed.
After the firmware was loaded, in Apatcher it is necessary to press (Apply patch for RAM) for installation of a patch in memory.
Window with successfully installed patch:

About successful installation of a patch speaks inscription All DONE!

After that, not closing swup firmware, we flash phone using standard technique .
Attention:
If phone is flashed only for installation of patches, i.e. without increase/downturn of the version of an firmware in a dialogue window swup firmware it is enough to choose following items:

2. How to install a patch for a file.
For this purpose we need a patch. We start Apatcher, in menu File we choose item Open and in the appeared dialogue window choose patch for installation.
Window of Apatcher with the loaded patch:

Then press (Apply patch for file) And in the appeared dialogue window we choose a file in which we wish to install a patch, for example XBI a file of an firmware.
Window with successfully established patch:

About successful installation of a patch speaks inscription All DONE!

3. Function (Save memory WinSWUP to dump file).
This function serves for preservation of memory of the started firmware in a file, for example for the subsequent studying.

4. Function (Any file replacer).
Serves for creation of the patches replacing files on disk Z or A. For example for files which carry on other disk is not possible for any reasons. For this purpose the original file with which it is necessary to replace is required, and edited file, and the size edited file should be less or is equal to the size of an original file. Further we press (Any file replacer), in the appeared dialogue window the original file is chosen, in the second appeared window is chosen edited file after that in the third dialogue window we write a name of a new patch.
Window of Apatcher with the generated patch:

About successful generation of a patch speaks inscription All DONE!

5. Work with disk A (ROLF).
Press ROLF tab, we get in the editor of disk A (ROLF) phone. The description and purpose of buttons for panels of tools:

(Open Swup dump) - serves for opening dump file of an firmware, for extraction from it contained disk A.
Window of Apatcher with open disk A:

(Extract A from winswup memory) - serves for extraction of disk A from memory of the started firmware.

(Save disk A dump) – serves for preservation of edited disk A in dump a file. By means of this function it is possible to replace completely disk A on the needs. For work of this function it is necessary Apacker.

(Delete current file from list) - serves for deleting files from list.

(Open file) – opens a file, with the external program, associated with this type of files, for example *.jpg files with Adobe Photoshop.

(Explore Disk A folder) – opens disk A in a folder.

For editing disk A:
Press (Explore Disk A folder), disk A opens in the form of a usual folder where manually it is possible to remove/create necessary files. Having finished editing of a disk, on panels of tools it is pressed (Refresh).
- It is necessary to consider, that disk A has the limited size nearby 3.3mb. If it is exceeded the information on quantity of files on a disk and the size, will be allocated with red color:

Finish editing of disk, press (Save disk A dump), then in the appeared dialogue window we write a name for dump a file of disk A. Then it is created dump a file of disk A and a patch necessary for its installation:

This patch now can be installed in memory of the started firmware, or in XBI a file.

6. Working with disk Z (Core/Var).
Press on Z (Core/Var) tab, we get in an explorer of a disk Z (Core/Var) of the phone.

The description and purpose of buttons for panels of tools:

(Open Swup dump) - serves for opening dump file of an firmware, for extraction from it contained disk Z.
Window of Apatcher with loaded disk Z:

(Extract Z from winswup memory) - serves for extraction of disk Z from memory of the started firmware.

(Refresh) – serves for updating the list of files.

(Open file) - opens a file, with the external program, associated with this type of files, for example *.jpg files with Adobe Photoshop.

(Explore Disk Z folder) – disk Z opens in folder/

The description of commands (for advanced users)

Besides formatting the text in patches, in Apatcher there is an opportunity to add dialogue windows which will be displayed during installation of patches. These windows can contain a various formation on installation of patches, the description. As by means of these commands it is possible to create the original script of installation of a patch, or a firmware mod.

The list and the description of commands:

selectbox:title:str_1:d_1:str_2:d_2: .... str_n:d_n
Shows dialogue of a choice with heading title, and variants str_1..., str_n if it is chosen variant str_k, it is equivalent command jump:d_k an example:
selectbox:Install themes?:Yes:0:No:3:Additional mode:-10:Exit:2
replace:......... (patch 1)
jump:1
break
...
...
...
break
label:10
...
...

label:value[:dialog]
Output from a mode goto if value equally earlier saved (the sign at comparison is not considered only absolute value)

Mode "goto" into this mode we enter, when at selectbox or jump a negative number, the module of this number it is remembered in this mode commands are passed, except for command
label:value
If this command has met it is compared value with remembered if are equal, we leave a mode "goto" in a usual mode label are simply passed as a matter of fact are transitions on labels, but only always forward
example
jump:-10
....
....
label:10

set:flag:value[:dialog]
to establish any flag (от 0 до 127) in 0 or 1

not:flag[:dialog]
To invert flag

jump:step:flag[:dialog]
To pass on step steps at concurrence of a flag
jumpn:step:flag[:dialog]
To pass on step steps at NOT concurrence of a flag

If the flag is established to pass step command (step> = 0) or transition to a label |step | (step <0) if if the flag is not specified in any case jumpn - all is similar jump, only transition if the flag is dumped, instead of is established.
examples:
1.
jump:4 (to pass 4 commands)
2.
jumpn:-10:127 (If the flag 127 is dumped, transition to a label 10)
...
...
label:10

rundll|x.dll|y[|dialog]
To start in x.dll function GetCommand: function(index: byte): pchar; cdecl; with a parameter "y"
Divider of lines is the symbol 10=0хА
declaration GetCommand for C coders:
extern "C" __declspec(dllexport) char* __cdecl GetCommand(unsigned char cNum);

replacefile:search:entered:file[:dialog]

replacetext:oldtext:newtext[:dialog]

replaceunicode:oldtext:newtext[:dialog]

replace:oldhex:newhex[:dialog]

break[:х:dialog]
x=0 info
x=1 Yes=Break
x=2 No=Break
x=3 Info, then Break
If no parameters, break unconditional

include|x.sxp[|dialog]
include in patch file x.sxp

Some useful links

APatcher - Here discussion of the given program as here it is possible to find last version is conducted.
Patches here.
All about firmware here.
Themes FAQ by Z-TEAM
Firmware mod – how to make it.

_________________
!!! oSLIK.ru - 5 ЛЕТ !!!
Linux on SX1

Показать сообщения:
все сообщения

за последний день

за последние 7 дней

за последние 2 недели

за последний месяц

за последние 3 месяца

за последние 6 месяцев

за последний год

Начиная со старых

Начиная с новых

| Список форумов www.oSLIK.ru » Siemens SX1 F.A.Q.

Перейти:
Выберите форум

www.SX1.ru

----------------

Siemens SX1 Forum

Siemens SX1 F.A.Q.

Series 60 Games

Series 60 Soft

Series 60 Review

Applet Creative

Siemens SX1 FirmWareZ

SX1 MODificated FirmWareZ

SX1 Hardware

English oSLIK forum

Linux on SX1

www.SL45.ru

----------------

SL45 Flash`n`Patch

SL45 Midlets + Creative

SL45 Вопросы и Ответы

Pocket PC

----------------

Pocket PC Forum

Pocket PC FAQ

Pocket PC Soft

Pocket PC Games

Pocket PC FirmWareZ

Pocket PC Hardware

Pocket PC News

News & Tests

----------------

GSM NEWS

FLASH memory NEWS

Тесты и Обзоры

Commercial Projects

----------------

Slimper Soft

Misc

----------------

Ремонт\Моддинг\Аксессуары

Барахолка

Встречи Форума

Siemens x55

Музыка для мобилы

Книга Жалоб и Предложений

phpBB & SQL

Web Resourses

Distribution

ТУПИК

iPhone

Следить за ответами в теме
Следующая тема
Предыдущая тема
Вы не можете начинать темы
Вы не можете отвечать на сообщения
Вы не можете редактировать свои сообщения
Вы не можете удалять свои сообщения
Вы не можете голосовать в опросах

Powered by phpBB :: © 2003-05 balaban :: Forum Logo by litruh@

[AD]