Руководство для пользователя

5.1. Входные данные

Входными данными для Макропроцессора является файл, содержащий исходный код программы, написанный на языке Ассемблера, с использованием макросов.

Язык Ассемблера ограничен следующими директивами и операторами: START, END, EXTREF, EXTNAME, BYTE, WORD, RESB, RESW, LD, LOADR1, SAV, LOADR2, ADD, JMP, CALL, SAVER1.

Макроязык ограничен следующими директивами: MACRO, MEND, AGO, AIF, ESLI, WHILE, ENDW.

Обязательные требования Макропроцессора к содержанию исходного файла:

5.1.1. Исходный код должен содержать директиву START.

5.1.2. Исходный код должен содержать имя программы.

5.1.3. Исходный код должен заканчиваться директивой END.

5.1.4. Заголовки макроопределений должны содержать уникальное имя макроса.

5.1.5. Каждое макроопределение должно заканчиваться директивой MEND.

5.1.6. Операторы AGO и AIF в качестве параметра должны имеет макрометку, которая в данном макросе описана. Макрометка имеет следующий формат:

«%ИмяМетки»

5.1.7. Оператор AIF должен содержать правильное условное выражение в качестве своего параметра.

5.1.8. Не допускается переход на метку, на которую ранее уже осуществлялся переход.

5.1.9. Не допускается создание бесконечных циклов.

5.2. Выходные данные

Выходными данными работы Макропроцессора, в случае отсутствия ошибок, является программный код на языке Ассемблера, с осуществленными макроподстановками. Дополнительными выходными данными является заполненная таблица ТМО, Тим.

5.3. Порядок работы

Работа с приложением возможна в двух режимах:

· консольный;

· графический.

Консольный режим работы.

Для запуска приложения в консольном режиме необходимо передать все необходимые для работы макропроцессора данные в качестве ключей параметров. Допустимы следующие параметры-ключи:

1. -help – вывод на экран справки;

2. -output – определение имени файла, в который необходимо записать результат выполнения макропроцессирования; имя файла должно содержаться в следующем параметре; формат ключа команды:

-output <путь к файлу>

Если введенный файл не найден или не записан, то результат запишется в стандартный файл Output.txt

3. -input – определение имени файла, содержащего исходный текст программы на языке ассемблера, который необходимо обработать; имя файла должно содержаться в следующем параметре; формат команды:

-input < путь к файлу >

4. -tim – вывод таблицы ТИМ в консольное окно.

5. -tmo – вывод таблицы ТМО в консольное окно.

6. –kod- вывод конечного файла в консольное окно.

Ключи –input <путь к файлу> и –output является обязательным, остальные параметры обязательными не являются.

Если введен параметр помощи, то все остальные параметры игнорируются, и выводится только помощь. Определение имени входного файла обязательно (его отсутствие приведёт к ошибке), тогда как определение выходного файла не обязательно: в этом случае результат работы программы будет сохранен в стандартном файле.

Рис. 1 Вызов справки

Запуск программы с ключами: -input, -output, -tim, -tmo, -kod (Рис. 2)

Графический режим работы

Для запуска приложения в графическом (GUI) режиме, необходимо не указывать параметров при загрузке программы на выполнение. Главная форма приложения имеет следующий вид:

Рис.1

В верхней части формы расположено главное меню:

· Файл:

o Открыть - Открыть исходный текст из файла

o Сохранить - сохранить результат выполнения макропроцессирования в файл на диске.

Также на форме присутствуют кнопки:

o Пошагово- запускает пошаговую обработку всего текста.

o Полный проход – запускает обработку всего текста.

o Очистить- очистка всех таблиц, в которые были занесены данные после обработки текста

В таблицу исходный текст загружается файл, а в таблице «Конечный текст» содержится программный код на языке Ассемблера, с осуществленными макроподстановками.

В нижней части формы расположено поле, которое показывает все ошибки, возникшие при работе приложения.

Если мы нажмём кнопку «Файл» -> «Открыть», то открывается окно (рис. 2), где выберем необходимый файл:

Рис. 2 Выбор загружаемого файла

При выборе файла test.asm, получим следующий результат (рис.3):

Рис. 3 Окно, после загрузки содержимого файла

Файл, содержащий пример исходного текста программы, теперь отображён на форме, в таблице «Исходный текст».

Далее, при нажатии кнопок «Пошагово» или «Полный проход» программа осуществляет обработку исходного текста, и заполняются соответствующие таблицы (Рис. 4).

Рис. 4. После запуска обработки исходного текста

Для очистки таблиц ТМО, ТИМ и др. необходимо нажать клавишу «Заново».Для сохранения расширенного кода, кода ТМО или бин кода используйте кнопку в меню «Сохранить» (Рис. 5).