SCons это открытая (open source) система сборки кода, написанная на Python, выполняющая ту же задачу, что и GNU Make. Однако она применяет отличающийся от обычного Makefile принцип для обработки исходного кода, используя в качестве задания содержимое файлов скриптов SConstruct и SConscript. Эти файлы также написаны на Python, и могут содержать код синтаксиса Python, так что в SConstruct могут вызываться стандартные библиотеки Python, и файлы SConscript хорошо подходят для сложной обработки, не ограничиваясь набором правил Makefile.

Подробное руководство пользователя по SCons можно найти на официальном сайте [2]. Здесь описывается базовое использование SCons, как его использовать в проекте RT-Thread.

[Система сборки]

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

На сегодняшний день самой популярной системой сборки является GNU Make. Множество хорошо известных open source проектов, такие как ядро Linux, собираются с использованием Make. Make определяет организацию и зависимости файлов проекта путем чтения Makefile, и выполняет указанные в нем команды.

По историческим причинам синтаксис Makefile запутанный, и вводит в ступор новичков. Кроме того Make неудобно использовать на платформе Windows, для этого нужно устанавливать командную строку Cygwin или MSYS. Для преодоления недостатков Make, разработаны альтернативные системы сборки, к которым относятся CMake и SCons.

[Система сборки RT-Thread]

Изначально RT-Thread собиралась под управлением Make/Makefile. Начиная с версии 0.3.x команда разработчиков RT-Thread перешла на систему сборки SCons. Целью этого перехода было избавить всех от сложной конфигурации Makefile, упрощение конфигураций различных IDE, перенос фокуса разработки на функционал RT-Thread.

Кое-кто может сомневаться в отличии описанной системы сборки и какой-либо IDE. Система IDE предоставляет пользователю графический интерфейс над конфигурированием и выполнением процесса сборки. Большинство IDE генерируют файлы скрипта наподобие Makefile, CMakeLists.txt или SConscript, основываясь на исходном коде, который пользователь добавил в проект, и при компиляции система IDE просто запускает систему сборки на основе Make, CMake или SCons.

sudo apt-get install scons

[Основные функции SCons]

Система сборки RT-Thread поддерживает несколько компиляторов, включая ARM GCC, MDK, IAR, VisualStudio и Visual DSP. В основном используются платформы ARM Cortex M0, M3, M4, которые поддерживаются средами разработки ARM GCC, MDK, IAR. Некоторые BSP могут поддерживать только один компилятор. Ознакомиться с поддерживаемыми в настоящий момент компиляторами можно путем чтения опции CROSS_TOOL файла rtconfig.py, находящегося в директории BSP.

Если чип относится к платформе ARM, то можно использовать утилиту Env и ввести в её командной строке команду scons, чтобы непосредственно скомпилировать BSP. В настоящий момент по умолчанию используется компилятор ARM GCC, потому что Env поставляется с компилятором ARM GCC. Компилирование BSP командой scons показана на сриншоте ниже.

Если нужно использовать другой компилятор, который BSP уже поддерживает для компиляции проекта, или если чип BSP не относится к платформе ARM, то Вы не сможете непосредственно скомпилировать проект командой scons. Необходимо самостоятельно установить соответствующий компилятор, и указать путь к нему. Перед компиляцией проекта можно использовать следующие две команды в интерфейсе Env, чтобы указать компилятор MDK и путь к нему.

set RTT_CC=keil
set RTT_EXEC_PATH=C:/Keilv5

[Основные команды SCons]

В этой секции описаны часто используемые для компиляции RT-Thread команды SCons. SCons может не только выполнять основную компиляцию, но также может генерировать проекты MDK/IAR/VS.

scons

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

scons -s

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

scons -c

Выполнит очистку цели компиляции (аналог команды make clean). Эта команда очистит временные файлы и файлы target, которые были сгенерированы после выполнения последней команды scons.

scons --target=XXX

Если Вы используете проект, разрабатываемый в MDK/IAR, то когда Вы откроете или закроете некоторые компоненты, необходимо использовать следующие команды для регенерации соответствующего настроенного проекта, когда выполняете компиляцию и загрузку в mdk/iar.

scons --target=iar
scons --target=mdk4
scons --target=mdk5

В командной строки Env войдите в директорию BSP компилируемого проекта. После использования команды scons --target=mdk5 в каталоге BSP сгенерируется новый файл проекта MDK с именем project.uvprojx. Двойным кликом на этом файле откройте этот проект, чтобы компилировать и отлаживать его в среде MDK. Команда scons --target=iar будет генерировать новый проект IAR с именем project.eww. Пользователи, которые не используют SCons, могут использовать этот метод. Если project.uvproj не открылся, то удалите project.uvopt и пересоберите проект.

В директории bsp/simulator можно использовать следующую команду, чтобы генерировать проект для vs2012 или vs2005.

scons --target=vs2012
scons --target=vs2005

Если Вы предоставляете файлы шаблона для других проектов IDE в каталоге BSP, то можно также использовать эту команду для генерации соответствующих новых проектов, таких как ua, vs, cb, cdk.

За этой командой также может идти параметр -s (например scons –target=mdk5 -s), чтобы не печатались внутренние команды.

Примечание: для генерации файла проекта MDK или IAR предпосылкой является файл шаблона проекта в директории BSP, и тогда scons добавит в генерируемый проект соответствующий исходный код, пути поиска заголовков, параметры компилятора, параметры линкера и т. д., в соответствии с файлом шаблона. Касательно того, какой чип используется для проекта, то это напрямую указывается в этом файле технического шаблона. В большинстве случаев этот файл шаблона пустой файл проекта, который помогает SCons в генерации project.uvprojx или project.eww.

scons -jN

Многопоточная цель компиляции, можно использовать эту команду для ускорения компиляции для компьютерах, где есть несколько ядер. Обычно одно ядро CPU может поддерживать 2 потока. Используйте команду scons -j4 на двухядерном PC.

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

Сборка фреймворка проекта. Есть интересная команда, которая позволяет подготовить проект к копированию в другое место.

scons --dist

Использование этой команды сгенерирует директорию dist в каталоге BSP. Это структура каталогов разрабатываемого проекта, включая исходный код RT-Thread и связанные с BSP проекты. Не относящиеся к BSP папки и libcpu будут удалены, и Вы можете свободно скопировать свою работу в любую директорию.

scons --verbose

Эта команда приведет к очень подробному выводу сообщений компиляции. Вряд ли когда-нибудь эта команда Вам понадобится.

[Расширенное использование SCons]

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

Чтобы улучшить поддержку RT-Thread нескольких компиляторов и упростить настройку параметров компиляции, RT-Thread создает отдельный файл rtconfig.py для каждого BSP. Таким образом, с каждом каталоге RT-Thread BSP существуют 3 файла: rtconfig.py, SConstruct и SConscript, которые управляют процессом компиляции BSP. Существует только один файл SConstruct в BSP, но файлов SConscript несколько. Можно сказать, что файл SConscript является основой организации исходного кода.

RT-Thread SConscript также присутствуют в большинстве папок с исходным кодом. Файлы исходного кода "ищет" файл SConscript, и добавляет соответствующие файлы к макросу, определенному для компилятора в rtconfig.h. Ниже в качестве примера, как SCons делает сборку проекта, приведено описание компиляции stm32f10x-HAL/BSP.

Встроенные функции SCons. Если Вы хотите добавить свои собственные исходные файлы кода к системе сборки SCons, то можете создать файл SConscript, или просто изменить существующий. Файл SConscript может управлять добавлением исходных файлов, и может указывать группу исходных файлов (подобно концепции Groups в таких IDE, как MDK/IAR).

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

GetCurrentDir()

Берет путь текущей директории.

Glob('*.c')

Берет все C-файлы в текущей директории. Измените значение параметра в этой функции, чтобы расширение имени файла соответствовало всем файлам в текущей директории.

GetDepend(macro)

Эта функция определена в файле скрипта building.py, находящегося в директории tools. Она читает информацию конфигурации из файла rtconfig.h для макроса с именем macro. Эта функция вернет true, если в файле rtconfig.h этот макрос включен, иначе вернет false.

Split(str)

Разделит строку str на список строк.

DefineGroup(name, src, depend, **parameters)

Это функция RT-Thread, основанная на расширении SCons. DefineGroup используется для определения компонента. Компонентом может быть директория (в файле или подкаталоге), и группа или папка в некоторых последующих файлах проекта IDE.

Параметры DefineGroup():

Что может быть указано в parameters: 

SConscript(dirs, variant_dir, duplicate)

Читает новый файл SConscript. Описание параметров:

[Примеры SConscript]

Ниже показаны несколько примеров SConscript, поясняющих, как использовать утилиту scons.

import os

cwd = str(Dir('#'))
objs = []list = os.listdir(cwd)

for d in list:
    path = os.path.join(cwd, d)
       if os.path.isfile(os.path.join(path, 'SConscript')):
        objs = objs + SConscript(os.path.join(d, 'SConscript'))
Return('objs')

Import('rtconfig')

from building import *

cwd = GetCurrentDir()

# Добавление основных драйверов.
src = Split("""

board.c

stm32f1xx_it.c

""")

if GetDepend(['RT_USING_PIN']):
    src += ['drv_gpio.c']

if GetDepend(['RT_USING_SERIAL']):
    src += ['drv_usart.c']

if GetDepend(['RT_USING_SPI']):
    src += ['drv_spi.c']

if GetDepend(['RT_USING_USB_DEVICE']):
    src += ['drv_usb.c']

if GetDepend(['RT_USING_SDCARD']):
    src += ['drv_sdcard.c']

if rtconfig.CROSS_TOOL == 'gcc':
    src += ['gcc_startup.s']

CPPPATH = [cwd]

group = DefineGroup('Drivers', src, depend = [''], CPPPATH = CPPPATH)

Return('group')

src = ['board.c', 'stm32f1xx_it.c']

from building import *

cwd = GetCurrentDir()
src = Glob('*.c')
CPPPATH = [cwd, str(Dir('#'))]

group = DefineGroup('Applications', src, depend = [''], CPPPATH = CPPPATH)

Return('group')

Import('rtconfig')

from building import *

cwd     = GetCurrentDir()
src     = Split('''

shell.c

symbol.ccmd.c

''')

fsh_src = Split('''

finsh_compiler.c

finsh_error.c

finsh_heap.c

finsh_init.c

finsh_node.c

finsh_ops.c

finsh_parser.c

finsh_var.c

finsh_vm.c

finsh_token.c

''')

msh_src = Split('''

msh.cmsh_cmd.cmsh_file.c

''')

CPPPATH = [cwd]

if rtconfig.CROSS_TOOL == 'keil':
    LINKFLAGS = '--keep *.o(FSymTab)'

    if not GetDepend('FINSH_USING_MSH_ONLY'):
        LINKFLAGS = LINKFLAGS + '--keep *.o(VSymTab)'

else:
    LINKFLAGS = ''

if GetDepend('FINSH_USING_MSH'):
    src = src + msh_src

if not GetDepend('FINSH_USING_MSH_ONLY'):
    src = src + fsh_src

group = DefineGroup('finsh', src, depend = ['RT_USING_FINSH'],

                     CPPPATH = CPPPATH, LINKFLAGS = LINKFLAGS)

Return('group')

[Управление проектами с помощью SCons]

В предыдущих секциях мы подробно рассмотрели файлы SConscript, относящиеся к исходному коду RT-Thread. Также Вам следует знать некоторые общие методы написания файлов SConscript, в этой секции показывается, как с помощью SCons управлять своими проектами.

Добавление кода приложения. Как упоминалось выше, папка applications в каталоге BSP используется для сохранения кода приложения пользователя. Сейчас здесь находится только один файл main.c. Если код приложения пользователя невелик, то рекомендуется добавлять модули исходного кода в папку applications. В этом примере в папку applications добавляются 2 файла hello.c и hello.h.

Файл hello.h:

#ifndef _HELLO_H_

#define _HELLO_H_

int hello_world(void);

#endif /* _HELLO_H_ */

Файл hello.c:

#include < stdio.h>

#include < finsh.h>

#include < rtthread.h>

int hello_world(void)
{
   rt_kprintf("Hello, world!\n");
   return 0;
}

MSH_CMD_EXPORT(hello_world, Hello world!);

Файл SConscript в директории applications добавит все исходные файлы в текущей директории в текущую директорию проекта. Вам нужно использовать команду --target=xxx, чтобы добавить 2 новых файла в свой проект. Обратите внимание, что проект регенерируется каждый раз при добавлении нового файла.

Добавление модуля. Как упоминалось выше, в случае, когда исходных файлов не очень много, рекомендуется просто добавлять их в папку applications. Если же у пользователя много исходного кода, и он хочет создать отдельный модуль проекта, или если нужно использовать другие модули, полученные из стороннего источника, то что более подходит для такого случая?

Возьмем для примера те же самые файлы hello.c и hello.h, и разместим их в отдельном подкаталоге, чтобы создать из них группу в проекте MDK, и их можно было бы выбрать через menuconfig. Для этого добавим папку hello в каталог BSP, и перенесем туда файлы hello.c и hello.h.

Обратите внимание на дополнительный файл SConscript в этом каталоге. Если вы хотите добавить какой-то свой исходный код к окружению сборки SCons, то можно просто создать или изменить существующий файл SConscript. Содержание нашего нового файла SConscript, созданного для модуля hello:

from building import *

cwd          = GetCurrentDir()
include_path = [cwd]
src          = []

if GetDepend(['RT_USING_HELLO']):
    src += ['hello.c']

group = DefineGroup('hello', src, depend = [''], CPPPATH = include_path)

Return('group')

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

Kconfig и menuconfig. Давайте рассмотрим, где определяется пользовательский макрос RT_USING_HELLO. Для этого есть файл Kconfig, он используется для конфигурирования ядра и интерфейса конфигурации команды menuconfig. Команда menuconfig используется в системе Env, когда конфигурируются опции, определенные в файле Kconfig. Команда menuconfig генерирует интерфейс конфигурации для пользователя, чтобы конфигурировать ядро путем чтения различных файлов Kconfig проекта. И в завершении все связанные с конфигурацией определения макросов сохраняются в файл rtconfig.h, находящийся в каталоге BSP. Каждый BSP имеет такой файл rtconfig.h, это конфигурационная информация для него.

Ниже показан файл Kconfig для этого BSP, находящегося в подкаталоге BSP папки stm32f10x-HAL, и мы можем добавить опции конфигурации в этот файл. Символом # обозначаются комментарии.

menu "hello module"                          # создает меню "hello module"

   config RT_USING_HELLO                     # опции конфигурации RT_USING_HELLO
      bool "Enable hello module"             # RT_USING_HELLO это переменная bool, и её описание
                                             # отображается как "Enable hello module"
      default y                              # RT_USING_HELLO может получать значения y и n,
                                             # по умолчанию y
      help                                   # Если использовать help, то это отобразит сообщение
      this hello module only used for test   # "this hello module only used for test"

   config RT_HELLO_NAME                      # опции конфигурации RT_HELLO_NAME
      string "hello name"                    # RT_HELLO_NAME строковая переменная, и меню
                                             # отображается как "hello name"
      default "hello"                        # имя по умолчанию "hello"

   config RT_HELLO_VALUE                     # опции конфигурации RT_HELLO_VALUE
      int "hello value"                      # RT_HELLO_VALUE переменная int, и это покажет меню
                                             # как "hello value"
      default 8                              # значение по умолчанию 8

endmenu                                      # конец меню hello

После входа в каталог stm32f10x-HAL/BSP из командной строки Env, можно использовать команду menuconfig, чтобы увидеть меню конфигурации нового модуля hello на главной странице. После входа в меню отобразится следующий экран.

Здесь мы можем поменять значение для hello.

После сохранения конфигурации и выхода из конфигурационного интерфейса команды menuconfig откройте файл rtconfig.h, находящийся в директории stm32f10x-HAL/BSP. Здесь Вы увидите, что появилась конфигурационная информация для модуля hello.

Важное замечание: используйте команду scons --target=XXX для генерации нового проекта всякий раз, когда меняете конфигурацию с помощью menuconfig.

Из-за того, что в rtconfig.h был определен макрос RT_USING_HELLO, к обновленному проекту добавляется файл hello.c, который будет компилироваться при последующей сборке.

Показанный выше пример можно использовать для добавления собственных модулей к опциям конфигурации файла Kconfig или создания собственных файлов Kconfig. Также см. руководство [4], где также описывается, как изменять и добавлять опции конфигурации.

Добавление библиотеки. Если нужно добавить дополнительную библиотеку к своему проекту, то следует уделить внимание к системе именования библиотек в различных тулчейнах. Например, тулчейн GCC распознает имена библиотек, такие как libabc.a, можно указать abc вместо libabc, когда указываете эту библиотеку. Соответственно это нужно учесть в файле SConscript, когда линкуются дополнительные библиотеки. Дополнительно при добавлении библиотек хорошей идеей будет указать пути поиска соответствующей библиотеки. Вот пример:

Import('rtconfig')

from building import *

cwd = GetCurrentDir()
src = Split('''

''')

LIBPATH = [cwd + '/libs']
LIBS = ['abc']

group = DefineGroup('ABC', src, depend = [''], LIBS = LIBS, LIBPATH=LIBPATH)

Здесь LIBPATH задает путь до библиотеки, и LIBS указывает имя библиотеки. Если тулчейн GCC, то имя библиотеки должно быть libabc.a; если тулчейн armcc, то имя библиотеки должно быть abc.lib.LIBPATH = [cwd + '/libs'], показывающее, что путь поиска библиотеки это подкаталог 'libs' в текущей директории.

Опции компилятора. Скрипт rtconfig.py это стандартный файл конфигурации RT-Thread для компилятора, который управляет большинством опций конфигурации. Этот файл скрипта написан на Python, и используется для следующего:

• Указывает компилятор (выбирает один из нескольких поддерживаемых компиляторов).
• Указывает параметры для компилятора, такие как опции компиляции, опции линкера, и т. д.

Когда мы компилируем проект с использованием команды scons, проект компилируется в соответствии с опциями конфигурации компилятора, указанными в rtconfig.py. Следующий код это часть кода rtconfig.py в директории stm32f10x-HAL/BSP.

import os

# опции тулчейна
ARCH='arm'
CPU='cortex-m3'
CROSS_TOOL='gcc'

if os.getenv('RTT_CC'):
   CROSS_TOOL = os.getenv('RTT_CC')

# cross_tool предоставляет кросс-компилятор

# EXEC_PATH это путь запуска компилятора, например CodeSourcery, Keil MDK, IAR

if  CROSS_TOOL == 'gcc':
   PLATFORM    = 'gcc'
   EXEC_PATH   = '/usr/local/gcc-arm-none-eabi-5_4-2016q3/bin/'

elif CROSS_TOOL == 'keil':
   PLATFORM    = 'armcc'
   EXEC_PATH   = 'C:/Keilv5'

elif CROSS_TOOL == 'iar':
   PLATFORM    = 'iar'
   EXEC_PATH   = 'C:/Program Files/IAR Systems/Embedded Workbench 6.0 Evaluation'

if os.getenv('RTT_EXEC_PATH'):
   EXEC_PATH = os.getenv('RTT_EXEC_PATH')

BUILD = 'debug'

if LATFORM == 'gcc':
   # тулчейны
   PREFIX = 'arm-none-eabi-'
   CC = PREFIX + 'gcc'
   AS = PREFIX + 'gcc'
   AR = PREFIX + 'ar'
   LINK = PREFIX + 'gcc'
   TARGET_EXT = 'elf'
   SIZE = PREFIX + 'size'
   OBJDUMP = PREFIX + 'objdump'
   OBJCPY = PREFIX + 'objcopy'

   DEVICE = '-mcpu=cortex-m3 -mthumb -ffunction-sections -fdata-sections'
   CFLAGS = DEVICE
   AFLAGS = '-c' + DEVICE + '-x assembler-with-cpp'
   LFLAGS = DEVICE + '-Wl,--gc-sections,-Map=rtthread-stm32.map,-cref,-u,Reset_Handler -T stm32_rom.ld'

Здесь CFLAGS указывает опции компилятора для C-файлов, AFLAGS опции компиляции для файлов ассемблера, и LFLAGS это опции для линкера. Переменная BUILD управляет уровнем оптимизации кода. По умолчанию BUILD получает значение 'debug', что соответствует компиляции в режиме отладки, с уровнем оптимизации 0 (отсутствие оптимизации). Если Вы как-нибудь измените эту переменную, то при компиляции будет применен уровень оптимизации 2. Ниже показаны соответствующие возможные варианты для этой переменной (все они соответствуют конфигурации без отладки, no 'debug').

BUILD = ''
BUILD = 'release'
BUILD = 'hello， world'

Рекомендуется для использования режим debug (без оптимизации) на стадии разработки, и когда продукт станет стабильным, рассмотреть вариант применения оптимизации.

Специфичный смысл этих опций можно расшифровать, обратившись к руководству компилятора, такому как armcc, который используется средой разработки MDK (в этом случае следует смотреть help для среды разработки MDK).

Как уже упоминалось выше, если нужно компилировать проект другим компилятором, когда выполняется команда scons, то Вы можете использовать соответствующие команды для указания компилятора и пути до него в командной строке Env. Однако такая модификация будет доступна только для текущего процесса Env. Когда Вы перезапустите командную строку Env, то нужно будет заново ввести настройки команды. Чтобы этого избежать, можно напрямую изменить файл rtconfig.py, чтобы достичь необходимого функционала, чтобы определенная конфигурация компилятора применялась постоянно. В общем случае нам надо будет только поменять опции CROSS_TOOL и EXEC_PATH:

CROSS_TOOL: указывает компилятор. Возможные значения для этой опции keil, gcc, iar. Просмотрите файл rtconfig.py, чтобы увидеть, какие компиляторы поддерживаются текущим BSP. Если на вашем PC установлен MDK, то можно изменить CROSS_TOOL на keil, и использовать MDK для компиляции проекта.
EXEC_PATH: путь, где установлен компилятор.

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

(1) Когда устанавливается компилятор (такой как MDK, GNU GCC, IAR, и т. д.), избегайте использования в имени каталога для установки национальных символов и пробелов. Иначе при парсинге пути до компилятора могут быть ошибки. Некоторые программы по умолчанию ставятся в папки наподобие C:\Program Files, и в этом пути присутствует пробел. Рекомендуется использовать другие пути для установки.
(2) При модификации EXEC_PATH следует уделить внимание формату пути. На платформах Windows разделитель пути по умолчанию это обратный слеш \, который используется как escape-символ на языках C и Python. При модификации пути поменяйте \ на /, или добавьте r (специфичный для Python синтаксис для сырых данных).

Предположим, что компилятор установлен в каталог D:\Dir1\Dir2. Ниже показаны корректные варианты записи пути:

# В этом примере в начале строки указан символ r,

# тогда мы можем нормально использовать символ \:
EXEC_PATH = r'D:\Dir1\Dir2'

# Здесь вместо \ используется /, символ r не нужен:
EXEC_PATH = 'D:/Dir1/Dir2'

# Пример экранирования символа \, чтобы символ \ нормально

# передавался как разделитель пути:
EXEC_PATH = 'D:\\Dir1\\Dir2'

Неправильный способ указания пути:

EXEC_PATH = 'D:\Dir1\Dir2'

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

if os.getenv('RTT_CC'):
   CROSS_TOOL = os.getenv('RTT_CC')

...

if os.getenv('RTT_EXEC_PATH'):
   EXEC_PATH = os.getenv('RTT_EXEC_PATH')

Эти два оператора if установят CROSS_TOOL и EXEC_PATH в значение по умолчанию Env.

После того, как компилятор сконфигурирован, мы можем использовать SCons для компиляции BSP RT-Thread. Откройте окно командной строки в директории BSP, и выполните команду scons для запуска процесса компиляции.

Вспомогательный скрипт компиляции RT-Thread. В директории tools исходного кода RT-Thread находятся некоторые вспомогательные скрипты, определенные RT-Thread, такие как файлы проекта для автоматической генерации RT-Thread с некоторыми IDE. Самый важный из них это скрипт building.py.

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

В SCons можно написать скрипты SConscript для компиляции файлов в этих относительно независимых директориях, и также можно использовать в SCons функции Export и Import, чтобы обмениваться данными между файлами SConstruct и SConscript (т. е. данными объектов Python). Для дополнительной информации по использованию SCons см. официальную документацию [5].

[Ссылки]

1. RT-Thread / rtthread-manual-doc site:github.com.
2. SCons User Guide site:scons.org.
3. Download RT-Thread site: rt-thread.io.
4. RT-Thread User Manual of Env site:github.com.
5. SCons Current Documentation site:scons.org.