На многих закладках диалога настройки свойств проекта Options можно использовать так называемые переменные аргументов (argument variables, далее по тексту переменные IAR) для составления файловых путей и опций командной строки. В таблице ниже перечислены эти переменные и указано их назначение.
Таблица 1. Переменные среды IAR (argument variables).
Переменная |
Описание |
$CONFIG_NAME$ |
Имя текущей, активной в настоящий момент конфигурации. К примеру, это может быть конфигурация Debug или Release. |
$CUR_DIR$ |
Текущая директория. |
$CUR_LINE$ |
Текущая строка. |
$DATE$ |
Сегодняшняя дата. |
$EW_DIR$ |
Директория верхнего уровня, в которой установлена система IAR Embedded Workbench, например это может быть каталог C:\ Program Files (x86) \ IAR Systems \ Embedded Workbench 6.5\. |
$EXE_DIR$ |
Каталог, куда попадает выходной двоичный исполняемый файл. |
$FILE_BNAME$ |
Имя файла без расширения. |
$FILE_BPATH$ |
Полный путь файла без расширения имени файла. |
$FILE_DIR$ |
Каталог активного файла (путь до файла без имени файла). |
$FILE_FNAME$ |
Имя активного файла без полного пути до него. |
$FILE_PATH$ |
Полный путь до активного файла (открытого в окне редактора Editor, окне проекта Project или окне сообщения Message). |
$LIST_DIR$ |
Папка, куда записываются файлы листинга компиляции. |
$OBJ_DIR$ |
Папка, куда записываются объектные файлы компиляции. |
$PROJ_DIR$ |
Корневой каталог проекта (папка, где лежит файл проекта с расширением *.ewp). |
$PROJ_FNAME$ |
Имя файла проекта без полного пути до него. |
$PROJ_PATH$ |
Полный путь до файла проекта (путь + имя файла). |
$TARGET_DIR$ |
Каталог главного выходного файла. |
$TARGET_BNAME$ |
Имя главного выходного файла без расширения и пути. |
$TARGET_BPATH$ |
Полный путь до главного выходного файла без расширения имени файла. |
$TARGET_FNAME$ |
Имя главного выходного файла без пути до него. |
$TARGET_PATH$ |
Полный путь до главного выходного файла. |
$TOOLKIT_DIR$ |
Каталог активного продукта, например это может быть папка C:\ Program Files (x86) \ IAR Systems \ Embedded Workbench 6.5 \ arm\. |
$USER_NAME$ |
Имя (логин) текущего пользователя системы Windows. |
$_ENVVAR_$ |
Значение переменной окружения ENVVAR. Будет подставлено значение переменной окружения с именем без префикса $_ и суффикса _$. |
[Где можно использовать переменные IAR]
Preprocessor -> Additional include directories. В свойствах проекта можно настроить дополнительные пути для поиска заголовочных файлов. Применение в путях переменных IAR позволяет не только упростить пути и сделать их более удобочитаемыми, но еще и позволяет сделать проекты свободно переносимыми в любой каталог на диске. Т. е. проект можно свободно перемещать по каталогам диска, при этом он не потеряет своей целостности и функциональности.
Build Actions. В свойствах проекта можно настроить выполнение командной строки до начала компиляции (раздел опций Build Actions -> строка ввода Pre-build command line) и после окончания компиляции (раздел опций Build Actions -> строка ввода Post-build command line). Здесь в командной строке можно указывать переменные IAR. К примеру, передача в командный файл переменной IAR $DATE$ позволит автоматически документировать компиляции проекта, или генерировать специальные файлы данных при каждой компиляции. См. также [1].
Меню Tools. Меню Tools -> Configure Tools...предоставляет дополнительные команды, которые пользователь может настроить самостоятельно. Например, можно настроить вызов внешнего текстового редактора, командного файла для выполнения каких-нибудь действий, запуска программатора и т. п. В окне настройки инструментария Configure Tools можно использовать встроенные переменные IAR из таблицы 1.
[Ссылки]
1. IAR EW ARM: автоматическая генерация версии прошивки. |