Директива

Пример использования

Примечания

DA/DATA/DB

DA Value 1 string или

data Value string или

DB Value 1 string

Определяет данные в памяти программ Если задана строка, то каждый ее байт размещается в отдельном слове Вместо директив data или db рекомендуется использовать директиву dw, поскольку она более определенно указывает адрес размещения Директивы data/DB/dw сохраняют соответствующие данные не в качестве фрагмента (полей) команды retlw Для определения последней необходима директива DT. Упомянутые выше директивы удобнее для применения в исходных файлах последовательного EEPROM

ORG 0x02100

DE Value I string

Эта команда используется для сохранения данных в EEPROM данных PIC-микроконтроллера. Директиве de должен предшеавовать оператор org 0x02100, чтобы программный счетчик PIC-микроконтроллера находился по требуемому для программирования EEPROM адресу

#DEFINE

»DEFINE Label [string]

Данная директива указывает компилятору на то, что каждый раз, когда в тексте программы будет варечаться имя label, он должен заменить его на строку string. Строка является факультативной, и Label может использоваться для условной компиляции программы. Если имя Label должно быть заменено конаантой, то следует применить одну из директив объявления конаанты. Эта директива размещается в первом столбце исходного файла

DT Value [ Value ] 1 string

Создает таблицу в программной памяти, то есть помещает значение Value в поле операторов retlw. Если параметром директивы DT является арока, то каждый байт последней размещается в отдельной команде retlw

DW Value [, Value ]

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

ELSE

Используется в сочетании с директивами IF, IFDEF и IFNDEF для определения альтернативного пути ассемблирования

Завершает программный блок. Эта директива должна ставиться в конце всех исходных файлов приложений

ENDC

Используется для завершения блока констант CBLOCK

Директива

Пример использования

Примечания

ENDIF

Применяется для обозначения конца блока условного ассемблирования, открываемого директивой if (следует обратиться к описанию директив IF, IFDEF иIFNDEF)

ENDM

Используется для завершения макроопределения MACRO

ENOW

Служит для обозначения конца (последней команды) директивы цикла WHILE. Следует обратиться к описанию директивы WHILE, чтобы понять, как используется данная директива

ERROR

ERROR string

Вводит в код сообщения об ошибке ERROR, при этом сообщение string заносится в файлы листинга и ошибки (Listing/Error File)

ERRORLEVEL

ERRORLEVEL

0 M 1 2, + It 1 - »

Задает типы сообщений, которые будут вводиться в файлы листинга и ошибок ( » - номер, 2 - ошибка, 1 - предупреждение, 0 - сообщение) Указание «минуса» (-) перед числом приводит к тому, что любые ошибки, предупреждения или сообщения игнорируются ассемблером и сообщаться 0 них ничего не будет. При указании «плюса» (+) любые ошибки, предупреждения или сообщения будут выводиться ассемблером

EXITM

Используется для возврата из макроса при ассемблировании Применять эту директиву рекомендуется только в том случае, когда при выполнении макроса возникла ошибка и необходимо прервать работу до выяснения ошибки. Действие ЕХПм внутри тела макроса может привести к появлению сообщения Phase Error (Ошибка фазы), которую будет очень сложно выявить

EXPAND

EXPAND

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

EXTERN

EXTERN Label

Объявляет внешние имена, то есть разрешает использовать в данном объектном файле имена, объявленные в других файлах

FILL

FILL Value, Count

Записывает значение Value в Count слов программной памяти. Если Value заключено в скобки, то это команда ассемблера (например, (goto 0)). В более ранних версиях MPLAB директива Fill не имела параметра Count и заполняла значением Value любой адрес памяти программ, который не содержал команды, или области, не зарезервированные с помощью RES

Директива

Пример использования

Примечания

GLOBAL

GLDBAL Label

Задает имя в объектном файле, доступ к которому осуществляется из других объектных файлов. Директива GLOBAL отличается от EXTERN тем, что может быть размещена в исходном коде только после того, как будет определено имя (Label)

IDATA

IDATA Address

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

„IDLOCKS

IDLOCKS Value

Устанавливает значение четырех идентификационных ячеек PIC-микроконтроллера с помощью четырех полубайт величины Value. Эта директива не применяется для микроконтроллеров 17Схх

IF Parm1 COND Parm2 : , "True" Code ELSE

: . "False" Code ENDIF

Если выражение Parml COND Parin2 является иаинным (True), то ассемблируется код ветви True. В противном случае ассемблируется код ветви False. Директива ELSE и код ветви False являются факультативными

IFDEF

IFDEF Label . ; "True" Code ELSE

; ; "False" Code ENDIF

Если имя Label было определено (с помощью директивы »DEFINE), то ассемблируется код ветви True. В противном случае ассемблируется код ветви False. Директива ELSE и код ветви False являются факультативными

IFNDEF

IFDEF Label

. , "True" Code

ELSE

: , "False" Code ENDIF

Если имя Label не было определено (с помощью директивы »DEFINE), то ассемблируется код ветви True. В противном случае ассемблируется код ветви False. Директива ELSE и код ветви False являются факультативными

INCLUDE

INCLUDE "FileName.Ext"

Загружает файл FileName. Ext в исходный файл с позиции директивы INCLUDE

LIST

LIST option [,...]

Определяет опции ассемблера для исходного файла. Существуют следующие опции:

Опция

По умолчанию

Описание

b = nnn

Задает шаг табуляции /

\ 1

с ппп

732 / Указывает ширину столбца /