КРОСС-АССЕМБЛЕР UniCROSS версия 3.6 - РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ

<< Вернуться к содержанию

НАУЧНО-ИССЛЕДОВАТЕЛЬСКАЯ И ПРОИЗВОДСТВЕННАЯ ЛАБОРАТОРИЯ
"ПРОГРАМНО ОСИГУРЯВАНЕ"
София
-------------------------------------------------------

IBM-PC / ПЫЛДИН

КРОСС-АССЕМБЛЕР

U n i C R O S S

версия 3.6

РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ

редакция 3

София - 1992

UniDOS, UniBIOS, UniASM, UniCROSS, UniED, UniBASIC и UniPASCAL
являются регистрированными торговыми марками и наименованиями
НИПЛ"Програмно осигуряване".

"Пылдин" является регистрированной торговой маркой и
наименованием Содружества "АБАКУС", Болгария.

Настоящий документ, как и любая его часть, не может быть
скопирован, передан или включен в информационно-поисковые системы
каким либо способом без предварительного письменного согласия со
стороны НИПЛ"Програмно осигуряване".

Все права на операционную систему UniDOS, базовую систему
ввода/вывода UniBIOS, текстовый редактор UniED, ассемблеры UniASM и
UniCROSS, интерпретатор UniBASIC, интерпретатор и компилятор
UniPASCAL, как и на любую часть указанных программных продуктов,
сохранены. НИПЛ"Програмно осигуряване" не несет ответственности за
работоспособность программных продуктов в случаях их
нерегламентированной перезаписи или использования.

Программный дизаин и реализация: н.с.Иво Ненов, н.с.Орлин Шопов,
н.с.Георги Петров,

Автор документа и общая редакция: к.т.н. инж. Недялко Тодоров

Предтипографическая подготовка: ................

НИПЛ "Програмно осигуряване" благодарит каждого, кто вышлет свои
замечания, рекомендации и деловые предложения по адресу:

НИПЛ"Програмно осигуряване"
бульвар "Ленин" - 125, блок 1
Болгария 1113 София,

телефон: (..3592) 706248, 706158, 706317
телефакс: (..3592) 706248

СОДЕРЖАНИЕ

1. ВВЕДЕНИЕ

2. СИНТАКСИЧЕСКИЕ КАТЕГОРИИ АССЕМБЛЕРА
2.1. Символы
2.2. Константы
2.3. Выражения
2.4. Списки

3. ТИП ПРОГРАММНЫХ СЕКЦИЙ И ВЕЛИЧИН
3.1. Тип программной секции
3.2. Тип символа
3.3. Тип выражения

4. УСЛОВНАЯ КОМПИЛЯЦИЯ

5. ФАЙЛЫ UniCROSS
5.1. Входной (исходный - source) файл
5.1.1. Поле метки
5.1.2. Поле операции
5.1.3. Поле операнда
5.1.4. Поле комментария
5.2. Отчетный (listing) файл
5.3. Диагностический (error's) файл
5.4. Объектный (object) файл
5.5. PGM-файл

6. ВЫЗОВ КРОСС-АССЕМБЛЕРА

7. АДРЕСАЦИЯ МИКРОПРОЦЕССОРА СМ 601

8. ДИРЕКТИВЫ КРОСС-АССЕМБЛЕРА
8.1. Директивы определения символов
8.1.1. EQU - присвоение значения
8.1.2. GLOBAL - определение глобального символа
8.1.3. EXTERN - определение внешних символов
8.1.4. PUBLIC - определение внутренных символов
8.2. Директивы определения данных
8.2.1. DB - определение байтов
8.2.2. DW - определение слов
8.2.3. DS - определение одинаковых байтов
8.2.4. CHKSUM - контрольная сумма
8.3. Директивы управления трансляцией
8.3.1. SECTION - начало фиктивной секции
8.3.2. ENDS - конец фиктивной секции
8.3.3. PROC - начало процедуры
8.3.4. ENDP - конец процедуры
8.3.5. END - конец программы
8.3.6. ORG - присвоение значения счетчику адреса
8.3.7. ERROR - возбуждение состояния ОШИБКА
8.3.8. RADIX - изменение счетной системы
8.3.9. INCLUDE - вставка файла
8.4. Директивы управления листингом
8.4.1. LIST - включение/отключение листинга
8.4.2. TRUNC - прерывание листинга

Приложение A - КОМАНДЫ МИКРОПРОЦЕССОРА СМ 601
Приложение B - ДИАГНОСТИЧЕСКИЕ СООБЩЕНИЯ
Приложение C - РЕДАКТОР СВЯЗЕЙ ULINK

1. ВВЕДЕНИЕ

В программисткой практике словом "ассемблер" обычно обозначают
две разные вещи: машинно-ориентированный язык низкого уровня и
транслятор программ, написанных на этом языке.

Язык ассемблера является машинно зависимым - каждый компьютер
(или точнее - каждый процессор) имеет свой собственный ассемблер. В ряде
случаев программисткий труд более эффективен, если создание и отладка
программ проводится на компьютерах одного типа (более
производительных), а сами программы выполняются на компьютерах другого
типа (менее производительных). В этих целях и создаются т.н.
кросс-трансляторы или кросс-ассемблеры.

Настоящий документ является руководством пользователя
кросс-транслятора UniCROSS языка ассемблера микропроцессора СМ601
(аналог микропроцессора MC6800). UniCROSS предназначен для работы в
среде операционной системы MS DOS микрокомпьютеров фамилии IBM-PC и
позволяет создавать программы, выполняемые в среде операционной
системы UniDOS микрокомпьютеров фамилии "Пылдин".

В настоящем документе термином "ассемблер" обозначается
как правило программный продукт UniCROSS. Процесс работы программного
продукта называется "трансляцией" или "ассемблированием". В
зависимости от контекста под термином "символ" следует подразумевать
или "графический (отображаемый) символ" или "символ языка ассемблера".

Настоящий документ написан исходя из предположения, что читатель
уже владеет программированием на ассемблере микропроцессора СМ601, а
также усвоил основные понятия и приемы работы с операционными
системами MS DOS (PC DOS) и UniDOS. Руководство не является учебником
языка ассемблера.

При создании следующих версии транслятора изменения и дополнения
к настоящему руководству будут записаны в файле READ_ME.CRS, который
будет поставляться в составе дистрибутивного материала.

Полную информацию о компьютере "Пылдин" и его операционной
системе можно найти в документах "UniDOS - Руководство пользователя" и
"UniBIOS - Руководство пользователя".

В описании UniCROSS приняты следующие обозначения:

<.....> - обязательная составляющая - вводится конкретное
значение описанного. Например, <имя_файла> означает, что на указанном
месте следует ввести имя файла;

[.....] - необязательная составляющая.

{.....} - составляющая, котороая может быть обязательной или
необязательной в зависимости от конкретнего случая - например,
параметр в зависимости от команды.

2. СИНТАКСИЧЕСКИЕ КАТЕГОРИИ АССЕМБЛЕРА

2.1. Символы

Символом называется в ассемблере определенное в программе имя,
которому присвоено шестнадцатеричное число без знака в качестве
значения. Символ определяется директивой присвоения значения или
обявлением меткой.

Имена составляются из букв латынского алфавита, цифр и
символов подчеркнутого пробела "_". Строчные и прописные буквы имеют
одинаковый смысл. Например, для ассемблера имена LooP, LOOP и loop
означают один и тот же символ. Длина имен ограничена только
программной строкой, но учитываются ТОЛЬКО ПЕРВЫЕ 16 символов.

В зависимости от границ применимости в рамках одной программы
символы делятся на ГЛОБАЛЬНЫЕ и ЛОКАЛЬНЫЕ.

ГЛОБАЛЬНЫЕ символы применимы (определены) в полной программе.

ЛОКАЛЬНЫЕ символы применимы только в рамках процедуры, где они
определены. Эта особенность позволяет одному имени присваивать разные
значения в отдельных процедурах.

С учетом последующей обработки объектного модуля редактором
связей часть символов (меток) при помощи соответствующих директив (см
далее EXTERN и PUBLIC) могут быть обявлены ВНЕШНИМИ или ВНУТРЕННЫМИ.

ВНЕШНИМИ являются символы, определенные в другом, не текущем
модуле. Значения внешних символов не известны во время трансляции
модуля. Внешние символы применимы только там, где разрешено
использование неопределенных символов. Нельзя применять внешние
символы в инструкциях с относительной адресацией.

ВНУТРЕННЫМИ называются символы, определенные в текущем модуле и
предназначенные для применения в других модулях. Нет ограничении в
применении внутренных символов в рамках модуля, где они определены.

2.2. Константы

Константы в ассемблере имеют 8- или 16-битовое внутренное
представление и занимают один или два последовательные байта памяти.

В ассемблере применимы константы следующих типов:

- десятичное число
Пример: 123 234 456

- шестнадцатеричное число - идентифицируется символом "$"
Пример: $AB $12 $F2

- двоичное число - идентифицируется символом "%"
Пример: %11 %01 %0001

- графический символ - заключается в апострофы и
константе присваивается значение, равное ASCII-коду символа.
Символ апострофа в качестве графической константы удваивается.
Пример: 'ш' '§' 'А' ''''

2.3. Выражения

ВЫРАЖЕНИЕМ называется последовательность символов и/или
констант и/или символа "*" (обозначающий текущее значение счетчика
адресов), связанных опеарациями.

Значение выражения имеет 16-битовое внутренное представление в
двух последовательных байтах памяти.

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

Приоритет 1
- скобки "(" и ")";

Приоритет 2
- логическое отрицание (!)
- смена знака (-)

Приоритет 3
- умножение (*)
- деление (/)
- получение остатка деления (%)
- логическое И (AND) (&)
- включающее логическое ИЛИ (OR) (|)
- исключающее логическое ИЛИ (XOR) (||)

Приоритет 4
- сложение (+)
- вычитание (-)

Операции одного приоритета выполняются в порядке следования.

После выполнения операции учитываются только младщие два байта
полученного результата.

Если предусмотрено получить в результате работы UniCROSS
объектный модуль (OBJ) или перемещаемая выполнимая программа (PGM), в
выражениях НЕЛЬЗЯ ПРИМЕНЯТЬ ВНЕШНИЕ МЕТКИ (EXTERN). Допустимо ТОЛЬКО
сложение метки с константой и вычитание метки из метки. Во втором
случае в качестве результата получается константа.

2.4. Списки

Списком называется последовательность выражений, разделенных
запятыми.

3. ТИП ПРОГРАММНЫХ СЕКЦИЙ И ВЕЛИЧИН

В языке ассемблера символы, константы и выражения называются
величинами. Величины характеризуются не только значением, но и типом:
относительным или абсолютным. Таким типом облагает и любая программная
секция.

Абсолютными являются величины, представляющие собой фиксированные
адреса памяти или числа. Поэтому константы всегда относятся к
величинам абсолютного типа.

Относительными являются величины, представляющие собой
неопределенные во время трансляции адреса памяти, которые будут
определены во время загрузки или обработки связывающей программой.

3.1. Тип программной секции

Любая программа может включать несколько секций. Каждая секция
может быть абсолютной или относительной в зависимости от того, будет
ли выполняться с фиксированного адреса памяти или нет.

Формирование секции осуществляется описанными ниже директивами
ORG и SECTION. Тип секции соответствует типу выражения, примененного
при ее формировании.

При трансляции относительной секции ассемблер UniCROSS генерирует
необходимую для осуществления перемещаемости информацию, используемую
связывающей программой или в процессе загрузки.

Нефиктивные секции могут быть вложенными на одном уровне
вложения, не учитывая содержащихся в них фиктивных секций.

3.2. Тип символа

Тип символов определяется по следующим правилам:

1. Если символ определен директивой присваивания, то он обладает
типом выражения.

2. Метки и символ "*" счетчика адреса обладают типом текущей
программной секции.

3. Внешние и внутренные символы всегда относительного типа.

3.3. Тип выражения

Тип выражения определяется типом операции и ее операндов по
следующим правилам:

----------------------------------------------------------------
тип операнда 1 операция тип операнда 2 тип результата
----------------------------------------------------------------
Относительный - Относительный = Абсолютный;

Относительный - Абсолютный = Относительный;

Абсолютный - Относительный = Ошибка;

Относительный + Относительный = Ошибка;

Относительный + Абсолютный = Относительный;

Абсолютный + Относительный = Относительный;

Абсолютный <любая> Абсолютный = Абсолютный.

Все остальные, кроме указанных в таблице, выражения недопустимы
и их результатом является ОШИБКА.

4. УСЛОВНАЯ КОМПИЛЯЦИЯ

В ряде случаев очень полезно иметь возможность указать
компилятору что не нужно компилировать определенные части программы.
Простейшим примером такой ситуации является контрольная печать. Она
необходима только в процессе отладки программы. В таких случаях
говорим об "условной" (управляемой) компиляции.

Условная компиляция управляется т.н. "идентификаторами"
компиляции. Фрагмент программы обрабатывается в зависимости от того
определен или не определен некоторый идентификатор.

Идентификатор компиляции обявляется определенным при помощи
директивы .DEFINE. Ранее определенный идентификатор можно обявить
неопределенным при помощи директивы .UNDEF. Директивы имеют следующий
формат:

.DEFINE <идентификатор>

.UNDEF <идентификатор>

Состояние идентификатора (определенное или неопределенное)
проверяется при помощи директив .IFDEF (интерпретация - ЕСЛИ
идентификатор ОПРЕДЕЛЕН) и .IFNDEF (интерпретация - ЕСЛИ идентификатор
НЕ ОПРЕДЕЛЕН). Далее обе указанные директивы обозначены IFxxxx и
программист выбирает какая из них отвечает его целям.

Условная компиляция программных фрагментов осуществляется при
помощи следующей конструкции:

.IFxxxx <идентификатор>
<програмный_фрагмент_1>
[.ELSE
<програмный_фрагмент_2> ]
.ENDIF

Как видно из формального описания конструкции, применение части
.ELSE <програмный_фрагмент_2> не обязательно.

Для UniCROSS указанная конструкция имеет следующее значение:

ЕСЛИ идентификатор определен/не определен
ТО ассемблировать фрагмент 1
ИНАЧЕ ассемблировать фрагмент 2

ВНИМАНИЕ! Не забывайте вводить точку перед ключевым словом каждой
из директив условной компиляции: .DEFINE .UNDEF .IFDEF .IFNDEF .ELSE
.ENDIF.

5. ФАЙЛЫ UniCROSS

UniCROSS работает с файлами четырех видов:

- входной (source) файл, содержащий программу на языке ассемблера
в исходном виде;

- отчетный (listing) файл, содержащий протокол процесса
трансляции;

- диагностический (error's) файл, содержащий сообщения об
обнаруженных во время трансляции ошибках;

- результативный (result) файл, содержащий объектный модуль
(object) или неперемещаемую выполнимую программу (command), или
перемещаемую выполнимою программу (program).

Имена всех файлов UniCROSS составляются по общим правилам
операционной системы UniDOS.

Конкретный тип результатичного файла определяется расширением
имени файла при соблюдении следующих требовании:

- если в исходном программном тексте содержится директива ORG, то
генерируется неперемещаемая выполнимая программа (CMD);

- если в исходном программном тексте содержится директива EXTERN,
то генерируется объектный модуль (OBJ);

Объектные модули обрабатываются редактором связей ULINK. В
результате обработки получаются перемещаемые выполнимые программы
(program).

Следует применять следующие расширения имен файлов:

source: ASM
listing: LST
error's: ERR
result:
- object: OBJ
- command: CMD
- program: PGM

5.1. Входной (исходный - source) файл

Входной (исходный) файл содержит программу на языке
ассемблера в исходном виде.

Программа на языке ассемблера обрабатывается построчно. Длина
строки должна быть не более 255 символов. В одной строке должна быть
записана только одна инструкция. Пустая строка и строка, в которой
первым является символ ";", считаются строками комментария и не
обрабатываются UniCROSS.

Каждая программная строка состоит из 4 полей:

[ [метка] <операция> {операнд} ] [комментарий]

Соседние поля разделяются одним или более пробелами или
табуляциями. В файле листинга поля разделяются одной табуляцией. В
целях улучшения читаемости программы рекомендуем начинать каждое поле
с постоянной позиции строки.

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

5.1.1. Поле метки

Если первым символом строки не является пробел, табуляция или
";", то первое поле каждой строки - поле метки. Поле метки не
обязательное. Допускается ввод строки, содержащей только поле метки.

Метка рассматривается как определенный в программе символ,
значение которого равняется текущему значению счетчика адреса.

В UniCROSS значение счетчика адреса отмечается символом звездочки
"*".

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

5.1.2. Поле операции

В строке программы поле операции следует за полем метки. Если
поле метки отсутствует, перед полем операции должен быть введен хотя
бы один пробел или табуляция.

Поле операции может содержать мнемоническое обозначение машинной
команды или директиву транслятора.

Если в поле операции записана команда, то транслятор генерирует
соответствующий ей машинный код. Если записана директива - она
выполняется.

Все директивы описаны ниже, а мнемонические обозначения всех
машинных команд процессора СМ 601 даны в приложении А.

В поле операции может быть записана команда INT вызова
определенной специальной функции операционной системы UniDOS INT $xx
(xx - шестнадцатеричное число номера функции).

Все функции INT $xx описаны в документе "UniBIOS - Руководство
пользователя".

5.1.3. Поле операнда

Содержание поля операнда определяется операцией. Операнд
указывает объект действия команды.

Если команда двухоперандная, первый операнд записывается как
часть мнемоники команды. Например, для команды ADD можно записать
ADDA или ADDB в зависимости от того, над каким регистром выполняется
операция.

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

Напомним еще раз, что в UniCROSS принято обозначать счетчик
адресов символом звездочки "*".

5.1.4. Поле комментария

Первым символом поля комментария является символ ";". В поле
комментария можно записать любые символы. Они не влияют на ход
трасляции и на генерируемый объектный код.

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

5.2. Отчетный (listing) файл

UniCROSS генерирует отчет (листинг) трансляции со следующим
форматом:

<номер_строки> <адрес> <машинный_код> <исходный_текст>

Например:

- адрес код метка инстр. операнд
--------------------------------------------------------

1 0000 org $100
2 0100 CE 01 05 ldx #message
3 0103 3F 23 int $23
4 0105
5 0105 48 65 6C 6C message db 'Hello worls!',0
6 0113 end

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

5.3. Диагностический (error's) файл

Во время своей работы UniCROSS выводит ДИАГНОСТИЧЕСКИЕ СООБЩЕНИЯ
об обнаруженных ошибках:

- экран монитора в скользящем режиме;

- в отчетный файл (listing), если предусмотрена его генерация;

- в диагностический файл.

Строка диагностического файла имеет следующий формат:

<имя_исходного_файла> (<номер_строки>): ERROR: <сообщение>

Диагностические сообщения приведены в приложении B.

5.4. Объектный (object) файл

Объектный (object) файл имеет следующую структуру:

адрес содержание
----------------------------------------------------------------
$00 (W) $5AA5;
$02 (W) $0001 (номер версии);
$04 (W) число внутренных (ENT) символов;
$06 (W) число внешних (EXT) символов;
$08 (W) длина сегмента кода;
$0A (L) сдвиг кода с начала файла;
$0E (W) сдвиг точки входа с начала файла - $FFFF означает, что нет
точки входа;
$10 (W) длина сегмента данных;
$12-$1F 0
$20 - массив внутренных символов;
- массив внешних символов;
- код;
(W) число сдвигов в массиве сдвигов;
- массив сдвигов;

(B) 0.

Каждый элемент массива внутренных символов имеет следующий
формат:

$00-$0F - имя (в ASCIIZ - закончивает на 0);
$10 (W) - значение;
$12 (W) - тип: >= 0 - относительный;
< 0 - абсолютный.

Каждый элемент массива внешних символов имеет следующий формат:

$00-$0F - имя (в ASCIIZ - закончивает на 0);
$10 (L) - 0.

Каждый элемент массива сдвигов имеет следующий формат:

$00 (B) тип: < 0 - внешний;
>= 0 - не внешний;
бит 0 = LSB;
бит 1 = MSB;
Если оба бита = 1 - WORD;
$01 (W) - значение - если не внешний символ;
- индекс в массиве внешних символов - если внешний символ;
$03 (W) - сдвиг относительно начала кода. Если сдвиг больше длины
кода, считается что это элемент сегмента данных.

Элементы массива должны быть расположены в возрастающем порядке
сдвигов.

5.5. PGM-файл

PGM-файл, содержащий перемещаемую выполнимую программу, имеет
формат:

адрес содержание
----------------------------------------------------------
$00 (W) $A55A;
$02 (W) число слов в таблице сдвигов
$04 (W) сдвиг кода с начала файла
$06 (W) длина кода
$08 (W) сдвиг точки входа с начала файла
$0А (W) длина данных
$0C-$0F 0
$10 начало таблицы сдвигов относительно начала кода
байтов релокации

6. ВЫЗОВ КРОСС-АССЕМБЛЕРА

Кросс-ассемблер может быть вызван двумя командами операционной
системы MS DOS.

Первая из них имеет вид:

UNICROSS <source> [ <listing> [ <result> ]]

где: <source> - имя вводного (исходного) файла. Если расширение
имени не указано, то по умолчанию принимается
расширение .ASM;
<listing> - имя файла листинга трансляции. Если расширение
имени не указано, то по умолчанию принимается
расширение .LST;
<object> - имя выходного файла. Если расширение не указано,
то по умолчанию принимается .PGM.

Необязательные параметры <listing> и <object> можно заменить
символом ";". В таком случае файл листинга не генерируется, а файл
результата будет иметь имя, одинаковое с именем исходного файла и
соответствующее расширение.

Кросс-ассемблер может быть вызван без указания параметров
командой:

unicross

После загрузки программы необходимые для работы параметры будут
уточнены последовательными вопросами (в квадретных скобках указаны
расширения имен по умолчанию):

Source filename [.ASM]:
Listing filename [.LST]:
Object filename [.PGM]:

Если после ввода имени исходного файла будет введен символ ";",
диалог прекратится и остальные параметры будут определены уже
известным образом.

7. АДРЕСАЦИЯ МИКРОПРОЦЕССОРА СМ 601

Микропроцессор СМ 601 допускает 7 видов адресации, представленных
в следующей таблице:

Наименование Синтаксис операнда Длина
----------------------------------------------------------

Внутренная Inherent 1
Аккумуляторная Accumulator 1
Непосредственная Immediate #выражение 2(3)
Прямая Direct выражение 2
Расширенная Extended выражение 3
Индексная Indexed выражение,Х 2
Относительная Relative выражение 2

Операции с ВНУТРЕННОЙ И АККУМУЛЯТОРНОЙ адресацией не
предусматривают операнды. Примеры:

asla
clc
comb
decb

Операции с НЕПОСРЕДСТВЕННОЙ адресацией имеют синтаксис:

<код_операции> #<выражение>

<код_операции> #/<выражение>

Если инструкция не относится к 16-разрядным регистрам и:

- в поле операнда введено #<выражение>, то учитывается младший
байт значения выражения;

- в поле операнда введено #/<выражение>, то учитывается старший
байт значения выражения.

Примеры:

ldaa #$FF
adcb #1
ldx #$FFFF
adda #/end_code - start_code

Операции с ПРЯМОЙ адресацией имеют синтаксис:

<код_операции> <выражение>

Значение выражения должно быть в интервале [0, 255]. Прямая
адресация охватывает только нулевую страницу памяти - адреса в
интервале [$00, $FF]. Примеры:

ldab 0
stab $20
stx $FE

РАСШИРЕННАЯ адресация отличается от прямой только тем, что
значением выражения в поле операнда может быть любой доступный адрес
памяти компьютера. Примеры:

ldaa $2000
stx $1FFE

Операции с ИНДЕКСНОЙ адресацией имеют синтаксис:

<код_операции> X,<выражение>

<код_операции> <выражение>,Х

<код_операции> X

В третьем случае считается, что выражение имеет значение 0.

Примеры:

ldaa X
adda X,1
ldx X,field1
ldab $33,X

Операции с ОТНОСИТЕЛЬНОЙ адресацией имеют синтаксис:

<код_операции> <выражение>

К этой группе операции относятся операции условного и
безусловного перехода, исключая JSR и JMP. В качестве операнда
принимается значение выражения за вычетом текущего значения счетчика
адреса. Значение операнда должно быть в интервале [-129, +125].
Примеры:

bra exit
bne not_equ

8. ДИРЕКТИВЫ КРОСС-АССЕМБЛЕРА

8.1. Директивы определения символов

8.1.1. EQU - присвоение значения

СИНТАКСИС: <метка> EQU <выражение>
<метка> = <выражение>

ПРЕДНАЗНАЧЕНИЕ: присвоение метки тип и значение выражения.

<метка> не должна быть уже определенной. В <выражение> не должна
содержаться внешняя метка (обявленная директивой EXTERN).

Пример:

code_start = $100
lo_byte EQU hi_byte + 1

8.1.2. GLOBAL - определение глобального символа

СИНТАКСИС: GLOBAL <список_меток>

ПРЕДНАЗНАЧЕНИЕ: определение одной или более меток в качестве
глобальных.

Директива GLOBAL должна следовать непосредственно за директивой
PROC.

Пример:

print PROC
GLOBAL print_1, print_2
.
.
print_1 ldx #message_1
.
print_2 ldx #message_2
.
.
ENDP

8.1.3. EXTERN - определение внешних символов

СИНТАКСИС: EXTERN <список_меток>

ПРЕДНАЗНАЧЕНИЕ: определение внешних для данного модуля меток.

Если в программном модуле содержится директива EXTERN, то в
результате ассемблирования генерируется объектный модуль (OBJ).

8.1.4. PUBLIC - определение внутренных символов

СИНТАКСИС: PUBLIC <список_меток>

ПРЕДНАЗНАЧЕНИЕ: объявление меток данного модуля, которые должны
быть доступными для других модулей программы.

8.2. Директивы определения данных

8.2.1. DB - определение байтов

СИНТАКСИС: DB <список_выражений>

ПРЕДНАЗНАЧЕНИЕ: запись в объектном коде одного или более байтов,
каждый из которых является значением очередного выражения списка.
Каждое выражение должно иметь значение в диапазоне 0..255.

<выражение> может быть арифметическим выражением или строкой
символов, заключенных в апострофы.

Пример:

num_base DB 16
hex_chars DB '0123456789ABCDEF'
string DB 'This is a string.', 13, 10, 0
hi_bytes DB first / 256, second / 256
lo_bytes DB first, second

8.2.2. DW - определение слов

СИНТАКСИС: DW <список_арифметических_выражений>

ПРЕДНАЗНАЧЕНИЕ: запись в объектном коде последовательности слов
(старший байт, младший байт), каждое из которых является значением
очередного выражения.

Примеры:

words DW $C000, $D000, $E000, $F000
DW 5*4096 + 3*16 +1
DW first_table, second_table, 0

8.2.3. DS - определение одинаковых байтов

СИНТАКСИС: DS <выражение_1> [,<выражение_2>]

ПРЕДНАЗНАЧЕНИЕ: заполнение области памяти длиной в <выражение_1>
байтов символами, являющимися значениями <выражение_2>.

В выражениях не должны участвовать метки. Если значение
выражения_2 больше 255, то учитывается младший байт значения. Если
выражение_2 не указано, область заполняется нулями.

Примеры:

buffer DS $200
DS $10, 32

8.2.4. CHKSUM - контрольная сумма

СИНТАКСИС: CHKSUM

ПРЕДНАЗНАЧЕНИЕ: формирование в неперемещаемой выполнимой
программе (.CMD) контрольного байта, переводящего контрольную сумму
файла в ноль. Контрольная сумма считается однобайтовым сложением без
переноса.

Рекомендуем применение директивы в случаях ассемблирования
программ, предназначенных для записи в постоянной (ROM) памяти
микрокомпьютера.

8.3. Директивы управления трансляцией

8.3.1. SECTION - начало фиктивной секции

СИНТАКСИС: SECTION [выражение]

ПРЕДНАЗНАЧЕНИЕ: формирование фиктивной секции, начиная с адреса,
являющегося значением выражения или счетчика адресов, если выражение
не введено.

Не допускается вложение фиктивных секций. Конец фиктивной секции
формируется директивой ENDS. Внутри фиктивной секции не генерируется
код. Выражение не должно содержать неопределенные и/или внешние
символы.

8.3.2. ENDS - конец фиктивной секции

СИНТАКСИС: ENDS

ПРЕДНАЗНАЧЕНИЕ: формирование конца фиктивной секции, начало
которой задано директивой SECTION.

При выполнении директивы счетчику адреса присваивается значение,
которым обладал до выполнения директивы SECTION. Применение директивы
вне фиктивной секции не имеет последствий.

8.3.3. PROC - начало процедуры

СИНТАКСИС: <метка> PROC

ПРЕДНАЗНАЧЕНИЕ: определение начала процедуры. Конец
определяется директивой ENDP.

Одна процедура может содержать в себе неограниченное число
других, вложенных процедур.

Все метки в одной процедуре, не объявленные глобальными
директивой GLOBAL, считаются локальными. Поиск некоторой метки
осуществляется сначала в текущей процедуре, а потом среди меток
"родительских" процедур.

8.3.4. ENDP - конец процедуры

СИНТАКСИС: ENDP

ПРЕДНАЗНАЧЕНИЕ: определение конца процедуры. Начало
определяется директивой PROC.

8.3.5. END - конец программы

СИНТАКСИС: END [выражение]

ПРЕДНАЗНАЧЕНИЕ: формирование конца программы со стартовым
адресом, равняющимся значению выражения в случаях ассемблирования
перемещаемых модулей (.PGM и .OBJ).

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

8.3.6. ORG - присвоение значения счетчику адреса

СИНТАКСИС: ORG <выражение>

ПРЕДНАЗНАЧЕНИЕ: присвоение значения счетчику адреса.

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

Если программный модуль содержит директива ORG, то в результате
ассемблирования получится неперемещаемая выполнимая программа (CMD).

8.3.7. ERROR - возбуждение состояния ОШИБКА

СИНТАКСИС: ERROR <выражение>

ПРЕДНАЗНАЧЕНИЕ: возбуждение сосотояния "ОШИБКА" в случае, если
значение выражения отлично от нуля.

Пример:

ERROR * % $100 ; ошибка, если текущее значение
; счетчика адреса не равно границе
; страницы памяти

8.3.8. RADIX - изменение счетной системы

СИНТАКСИС: RADIX <выражение>

ПРЕДНАЗНАЧЕНИЕ: изменение текущей счетной системы на систему с
основанием, определенным значением выражения. Допустимы значения
выражения в интервале 2..16.

Пример:

ldaa #$3F
RADIX 16
ldaa #3F

8.3.9. INCLUDE - вставка файла

СИНТАКСИС: INCLUDE <имя_файла>

ПРЕДНАЗНАЧЕНИЕ: вставка в транслируемый файл другого файла с
именем <имя_файла>.

Параметр <имя_файла> должен задавать полное имя включаемого файла
с указанием устройства и/или директории, если они отличны от текущих.
Включаемый файл может содержать, в свою очередь, директиву INCLUDE.
Допускаются до 8 уровней вложения директивы.

Пример:

INCLUDE b:\dir_1\memory.inc

8.4. Директивы управления листингом

8.4.1. LIST - включение/отключение листинга

СИНТАКСИС: LIST <ключ>

ПРЕДНАЗНАЧЕНИЕ: включение/отключение генерации файла листинга
кросс-ассемблирования. Допускаются два значения ключа: ON - включить
(по умолчанию); OFF - отключить.

Пример:

LIST ON
.
.
LIST OFF

8.4.2. TRUNC - прерывание листинга

СИНТАКСИС: TRUNC <ключ>

ПРЕДНАЗНАЧЕНИЕ: включение/отключение прерывания генерации
листинга после первой строки зоны директив DB, DW и DS. Допускаются
два значения ключа: ON - включить (по умолчанию); OFF - отключить.

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

Приложение A - КОМАНДЫ МИКРОПРОЦЕССОРА СМ 601

Обозначения: А - accumulator A
B - accumulator B
M - Memory operand (8 bit)
M(16) - 16-bit memory operand
S - Stack pointer
X - Index register
P - processor status register

Флаг состояния процессора: H - Half Carry
I - Interrupt disable
N - Negative
Z - Zero
V - Overflow
C - Carry
. - unchanged
* - changed
0 - cleared to 0
1 - set to 1

---------------------------------------------------------------
LмнемоL схема L вид адресации LHINZVCL
L код L действия L-----------------------------------L L
L команды L Inh LRel 2LImm 2LDir 2LInd 2LExt 3L L
---------------------------------------------------------------
ABA A+B -> A 1B 2 *.****
- Add B to A

ADCA A+M+C -> A 89 2 99 3 A9 5 BD 4 *.****
- Add Memory with Carry to A

ADCB B+M+C -> B C9 2 D9 3 E9 5 F9 4 *.****
- Add Memory with Carry to B

ADDA A+M -> A 8B 2 9B 3 AB 5 BB 4 *.****
- Add Memory to A

ADDB B+M -> B CB 2 DB 3 EB 5 FB 4 *.****
- Add Memory to B

ANDA A&M -> A 84 2 94 3 A4 5 B4 4 ..**0.
- Logic AND Memory to A

ANDB B&M -> B C4 2 D4 3 E4 5 F4 4 ..**0.
- Logic AND Memory to B

ASL shift left 68 7 78 6 ..****
- Arithmetic Shift left M

ASLA shift left 48 2 ..****
- Arithmetic Shift left A

ASLB shift left 58 2 ..****
- Arithmetic Shift left B

ASR Aritm shr 67 7 77 6 ..****
- Arithmetic Shift right M

ASRA Aritm shr 47 2 ..****
- Arithmetic Shift right A

ASRB Aritm shr 57 2 ..****
- Arithmetic Shift right B

BCC if C = 0 24 4 ......
- Branch if no carry

BCS if C = 1 25 4 ......
- Branch if carry

BEQ if Z = 1 27 4 ......
- Branch if equal

BGE if N ^ V =0 2C 4 ......
- Branch if greater or equal

BGT Z|(N^V) = 0 2E 4 ......
- Branch if greater

BHI C | Z = 0 22 4 ......
- Branch if High

BITA A & M 85 2 95 3 A5 5 B5 4 ..**0.
- Bit test M with A

BITB B & M C5 2 D5 3 E5 5 F5 4 ..**0.
- Bit test M with B

BLE Z|(N^V) = 1 2F 4 ......
- Branch if Less or Equal

BLS C | Z = 1 23 4 ......
- Branch if Low or Same

BLT N ^ V = 1 2D 4 ......
- Branch if Little

BMI N = 1 2B 4 ......
- Branch if Minus

BNE Z = 0 26 4 ......
- Branch if Not Equal
BPL N = 0 2A 4 ......
- Branch if Plus

BRA uncond 20 4 ......
- Branch Always

BSR Brnch Subrt 8D 8 ......
- Branch To SubRoutine

BVC V = 0 28 4 ......
- Branch if Overflow Clear

BVS V = 1 29 4 ......
- Branch if Overflow Set

CBA A - B 11 2 ..****
- Compare A with B

CLC 0 -> C 0C 2 .....0
- Clear Carry

CLI 0 -> I 0E 2 .0....
- Clear Interrupt mask

CLR 0 -> M 6F 7 7F 7 ..0100
- Clear Memory

CLRA 0 -> A 4F 2 ..0100
- Clear A

CLRB 0 -> B 5F 2 ..0100
- Clear B

CLV 0 -> V 0A 2 ....0.
- Clear oVerflow

CMPA A - M 81 2 91 3 A1 5 B1 4 ..****
- Compare A with M

CMPB B - M C1 2 D1 3 E1 5 F1 4 ..****
- Compare B with M

COM not M -> M 63 7 73 7 ..**01
- Compliment (not) memory

COMA not A -> A 43 2 ..**01
- Compliment (not) A

COMB not B -> B 53 2 ..**01
- Compliment (not) B

CPX X - M(16) 8C* 3 9C 4 AC 6 BC 5 ..***.
- Compare ind. reg. X with 16-bit Memory

DAA dec adjust 19 2 ..****
- Decimal adjust A

DEC M - 1 -> M 6A 7 7A 6 ..***.
- Decrement M

DECA A - 1 -> A 4A 2 ..***.
- Decrement A

DECB B - 1 -> B 5A 2 ..***.
- Decrement B

DES S - 1 -> S 34 4 ......
- Decrement Stack Pointer

DEX X - 1 -> X 09 4 ...*..
- Decrement Index Reg. X

EORA A ^ M -> A 88 2 98 3 A8 5 B8 4 ..**0.
- Excluding OR memory to A

EORB B ^ M -> B C8 2 D8 3 E8 5 F8 4 ..**0.
- Excluding OR memory to B

INC M + 1 -> M 6C 7 7C 6 ..***.
- Increment Memory

INCA A + 1 -> A 4C 2 ..***.
- Increment A

INCB B + 1 -> B 5C 2 ..***.
- Increment B

INS S + 1 -> S 31 4 ......
- Increment Stack Pointer

INX X + 1 -> X 08 4 ...*..
- Increment Index reg. X

JMP jump 6E 4 7E 3 ......

JSR jump Subrtn AD 8 BD 9 ......
- Jump to SubRoutine

LDAA M -> A 86 2 96 3 A6 5 B6 4 ..**0.
- Load A

LDAB M -> B C6 2 D6 3 E6 5 F6 4 ..**0.
- Load B

LDS M(16) -> S 8E* 3 9E 4 AE 6 BE 5 ..**0.
- Load Stack Pointer

LDX M(16) -> X CE* 3 DE 4 EE 6 FE 5 ..**0.
- Load Index reg. X

LSR Logic shr 64 7 74 6 ..0***
- Logical Shift Right

LSRA Logic shr 44 2 ..0***
- Logical Shift Right A

LSRB Logic shr 54 2 ..0***
- Logical Shift Right B

NEG 0 - M -> M 60 7 70 6 ..****
- Negate M

NEGA 0 - A -> A 40 2 ..****
- Negate A

NEGB 0 - B -> B 50 2 ..****
- Negate B

NOP NoOPeration 01 2 ......

ORAA A | M -> A 8A 2 9A 3 AA 5 BA 4 ..**0.
- OR A

ORAB B | M -> B CA 2 DA 3 EA 5 FA 4 ..**0.
- OR B

PSHA Push A 36 4 ......
- Push A

PSHB Push B 37 4 ......
- Push B

PULA Pull A 32 4 ......
- Pull A

PULB Pull B 33 4 ......
- Pull B

ROL rol C<-M<-C 69 7 79 6 ..****
- Rotate Left

ROLA rol C<-B<-C 49 2 ..****
- Rotate Left A

ROLB rol C<-B<-C 59 2 ..****
- Rotate Left B

ROR ror C->M->C 66 7 76 6 ..****
- Rotate Right

RORA ror C->A->C 46 2 ..****
- Rotate Right A

RORB ror C->B->C 56 2 ..****
- Rotate Right B

RTI Rtrn Intrpt 3B 10 ******
- Return from Interrupt

RTS Rtrn Subrtn 39 5 ......
- Return from SubRoutine

SBA A - B -> A 10 2 ..****
- Subtract B from A

SBCA A-M-C -> A 82 2 92 3 A2 5 B2 4 ..****
- Subtract with Carry from A

SBCB B-M-C -> B C2 2 D2 3 E2 5 F2 4 ..****
- Subtract with Carry from B

SEC 1 -> C .....1
- Set Carry flag

SEI 1 -> I .1....
- Set Interrupt flag

SEV 1 -> V ....1.
- Set Overflow flag

STAA A -> M 97 4 A7 6 B7 5 ..**0.
- Store A

STAB B -> M D7 4 E7 6 F7 5 ..**0.
- Store B

STS S -> M(16) 9F 5 AF 7 BF 6 ..**0.
- Store Stack Pointer

STX X -> M(16) DF 5 EF 7 FF 6 ..**0.
- Store index register X
SUBA A - M -> A 80 2 90 3 A0 5 B0 4 ..****
- Subtract from A

SUBB B - M -> B C0 2 D0 3 E0 5 F0 4 ..****
- Subtract from B

SWI Soft Intrpt 3F 12 .1....
- Software Interrupt

TAB A -> B 16 2 ..**0.
- Transfer A to B

TAP A -> P 06 2 ******
- Transfer A to Processor status

TBA B -> A 17 2 ..**0.
- Transfer B to A

TPA P -> A 07 2 ......
- Transfer Processor status to A

TST M - 0 6D 7 7D 6 ..**00
- Test Memory

TSTA A - 0 4D 2 ..**00
- Test A

TSTB B - 0 5D 2 ..**00
- Test B

TSX S + 1 -> X 30 4 ......
- Transfer Stack pointer to X

TXS X - 1 -> S 35 4 ......
- Transfer X to Stack pointer

WAI Wait Intrpt 3E 9 .1....
- Wait for Interrupt

Приложение B - ДИАГНОСТИЧЕСКИЕ СООБЩЕНИЯ

Диагностические сообщения выдаются в следующем формате:

<имя_файла>(<номер_строки>): ERROR: <текст_сообщения>

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

Branch out of range. - Переход вне модуля

Can't open include file. - Нельзя открыть файл для вложения.

Can't open listing file. - Нельзя открыть файл листинга.

Can't open source file. - Нельзя открыть исходный файл. -
вероятнее всего не существует файл с указанным именем.

Digit out of radix. - Цифра вне текущей счетной системы.

ENDS without SECTION. - применение директивы ENDS без
директивы SECTION.

Error writing object file. - Ошибка во время записи
объектного файла - вероятнее всего нет свободного пространства на
диске.

Expected close bracket. - Отсутствует закрывающая скобка.

Expected close quote. - Отсутствует закрывающая кавычка
или апостроф.

Expected constant expression. - Не найдено обязательное
выражение типа константы.

Expected expression. - Не найдено обязательное для ввода
выражение.

EXTERN not allowed in not relative mode. - Директива
EXTERN запрещена в случаях неперемещаемого выходного файла.

General syntax error. - Общая синтаксическая ошибка -
вероятнее всего допущена ошибка при написании имени инструкции или
директивы.

Illegal address mode. - Неправильный тип адресации.

Illegal character in text. - В тексте найден не
разрешенный символ.

Illegal expression. - Неправильное арифметическое
выражение.

Illegal name. - Недопустимое имя - недопустимое сочетание
символов в поле метки.

Illegal size of operand. - Недопустимое значение операнда
- вероятнее всего значение операнда типа байт превышает 255.

Improper use of CHECKSUM directive. - Неправильное
применение директивы CHКSUM. - директива CHKSUM применена второй раз
или применена в случае генерации перемещаемого выходного файла.

Include file name expected. - Не введено имя файла для
вложения.

Include files too nested. - Уровень вложения исходных
файлов больше допустимого (до 8 уровней).

Integer overflow. - Целочисленное переполнение (число
больше 65535).

Missing ENDS. - Отсутствует директива ENDS.

ORG inside SECTION. - применение директивы ORG внутри
фиктивной секции.

ORG not allowed in relative mode. - Не разрешено
применение директивы ORG в режиме генерации перемещаемого выходного
файла.

Output buffer overflow. - Переполнение буфера объектного
файла - длина объектного (выходного) файла не должна быть больше 32КВ.

Proc nesting error. - Неправильное вложение процедур.

PUBLIC not allowed in not relative mode. - Директива
PUBLIC запрещена в случаях неперемещаемого выходного файла.

Redefinition of symbol <метка>. - Переопределение метки
<метка>.

There is no memory available. - Нет больше доступной
(свободной) памяти.

Undefined identifier <имя>. - Неопределенный
идентификатор <имя>.

Unexpected directive END. - Неправильное применение
директивы END - вероятнее всего директива END применена во вложенном
файле.

User error. - Потребительская ошибка - сообщение
генерируется во время выполнения директивы ERROR, если значение
операнда отлично от нуля.

Приложение C - РЕДАКТОР СВЯЗЕЙ ULINK

В составе операционной системы UniDOS микрокомпьютеров фамилии
"Пылдин" предлагается редактор связей ULINK, при помощи которого
раздельно ассемблированные объектные модули можно связать в выполнимую
программу.

Вызов редактора связей осуществляется командой UniDOS-а:

ULINK [/[c][p]] <modules>

где: c - опция формирования .CMD выходного файла, если это
возможно. Если опция пропущена, формируется .PGM файл;

p - опция выравнивания объектных модулей на границе страницы;

modules - список объектных модулей или библиотек, которые должны
быть связаны в выполнимую программу. Имена в списке
указываются без расширений. По умолчанию считается что
мудули имеют расширение имен .OBJ, а библиотеки - .LIB.

В результате работы редактора связей создается выполнимой файл
(программа) с именем, совпадающем с именем модуля, содержащего
директиву MAIN и с расширением имени PGM или CMD, в зависимости от
отсутствия или наличия опции "/c" (см. выше).

Каждый объектный модуль состоит из сегмента кода и сегмента
данных. Сегмент данных следует непосредственно за сегментом кода и
может содержать ТОЛЬКО неинициализированные данные. Для создания
такого сегмента следует применить директиву SECTION в начале сегмента
данных.

В процессе обработки редактором связей сегменты кода и данных
всех модулей объединяются, соответственно. Объединение осуществляется
таким образом, что при загрузке выполнимого файла сводной сегмент
данных располагается непосредственно после сводного сегмента кода.

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

Если генерируется CMD файл, программа должна сама проверить
существует ли пространство памяти, достаточное для размещения сегмента
данных. В случае генерации PGM файла такое соответствие
гарантируется.

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

Code too large - сводной сегмент кода длиннее 64Kбайт.

Data too large - сводной сегмент данных длиннее 64Kбайт.

Error in object table - ошибка в таблице сдвигов объектного
модуля.

File too large - модуль длиннее 64Кбайт.

Invalid entry point - неправильная точка входа - точка входа CMD
файла не находуится в его начале.

Invalid file format - неправильный формат объектного модуля.

No entry point given - не указана точка входа - директива MAIN не
введена.

Out of memory - недостаточный объем свободной памяти.

Read error - ошипка при чтении файла.

Too many entry points - много входных точек - директива MAIN
встечается более одного раза.

Too many object files - много объектных файлов - в списке указано
более 256 имен объектных файлов.

Write error - ошибка записи файла.