[i] Создание проекта для МК MDR12065 в Visual Studio Code

ID статьи: 66216

Дата последнего изменения: 09.07.2026 15:21:12

Статья содержит информацию по настройке среды Visual Studio Code для микросхемы MDR12065.

1. Установка необходимых компонентов

Помимо самой среды Visual Studio Code, также понадобятся следующие программные средства:

1.GNU RISC-V Embedded GCC – набор программ (компилятор, ассемблер, компоновщик, библиотеки, отладчик GDB), которые необходимы для разработки ПО на устройствах с ядром RISC-V. Так как пакет xPack собирается разработчиками для нескольких платформ, скачивать нужно архив для целевой ОС.

2. Windows Build Tools (при использовании ОС Windows) – набор программ (make, rm), которые необходимы для сборки и очистки проекта.

3. OpenOCD – ПО для программирования и отладки устройств. OpenOCD для ОС Windows, собранный с поддержкой МК MDR12065 доступен для скачивания на официальном сайте компании «Миланд р», а также в конце статьи в разделе «Программное обеспечение». При использовании ОС Linux версию OpenOCD с поддержкой микросхем компании Миландр можно собрать самостоятельно (см. "[i] Компиляция OpenOCD из исходных данных").

После скачивания данного ПО для удобства дальнейшей работы следует добавить их в PATH (Windows/Linux) - во всех случаях добавлять в PATH нужно папки bin с исполняемыми файлами программ.

В самой среде Visual Studio Code потребуются следующие расширения:

Стандартные С/С++ и C/C++ Extension Pack от Microsoft.
Расширение Cortex-Debug, а также связанные с ним плагины, для отладки.

Рисунок 1 – Расширения для VSCode

2. Сборка проекта

В конце статьи приложен архив с шаблоном проекта:

Рисунок 2 – Шаблон проекта

2.1. Структура шаблона проекта

В этом шаблоне расположены все необходимые файлы:

src/main.c - файл с пустой функцией main() основной программы.
папка Library - папка с библиотекой SPL для микросхем.
папка svd - папка с файлами System View Description, с помощью которых далее можно будет просматривать регистры периферийных блоков под отладкой.
makefile - файл с правилами сборки проекта. Есть несколько скриптов линковки программы под разные регионы памяти (FLASH, ОЗУ) - выбор осуществляется ключом CONFIG (возможные варианты - FLASH, RAM_TCM_debug, RAM_TCM_release). Конфигурации сборки в общем аналогичны таковым в шаблоне проекта для среды Eclipse. Файлы при сборке собираются в папку build.
.vscode/settings.json - файл с общими настройками - в шаблоне проекта в этом файле добавлено ключевое слово для названия проекта, при необходимости переименования проекта нужно заменить значение "PROJECT_NAME" на свое.
.vscode/tasks.json - файл с задачами сборки проекта. Позволяет запускать сборку с помощью файла makefile с заранее установленными ключами, а также очищать папку build/ с собранными файлами.
.vscode/launch.json - файл с конфигурациями запуска отладки с помощью openocd и riscv-none-elf-gdb, используя плагин Cortex-Debug. Конфигурации запуска во многом аналогичны таковым в шаблоне проекта для среды Eclipse.

2.2 Сборка проекта

Перед запуском отладки необходимо предварительно собрать проект. Для этого надо открыть вкладку Terminal в меню, выбрать пункт Run Build Task, а затем в появившемся списке указать требуемую конфигурацию сборки.

Рисунок 3 – Сборка проекта

В файле tasks.json описано, какие команды вызываются при вызове каждой из задач – с каким ключом CONFIG вызывается команда make.

Сборка проекта осуществляется в папке build, в ней располагаются все собранные файлы, а также добавляется файл current_config.mk c текущей конфигурацией. По результатам сборки создаются файлы программы .elf и .hex, а также вспомогательные .map и .lst. Их название соответствует названию проекта, заданному в settings.json с помощью PROJECT_NAME.

Также по результатам успешной сборки в терминале выводится информация о размере собранного elf-файла.

В качестве примера соберем проект в конфигурации "Build: MDR12065 FLASH" с запуском из FLASH-памяти.

Рисунок 4 – Результаты сборки

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

3. Запуск отладки

Отладка осуществляется с помощью riscv-none-elf-gdb (который находится в составе xPack) и OpenOCD (скачанного/собранного ранее). Для работы с ними в среде Visual Studio Code используется плагин Cortex-Debug.

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

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

В ОС Windows для работы OpenOCD с отладчиками требуется переустановить драйвер отладчика, как это описано в статье [i] Создание проекта для МК MDR12065 в IDE Eclipse.
В ОС Linux для работы OpenOCD с отладчиками нужно разрешить отладчику-программатору работать, как доверенному источнику, как это описано в статье [i] Компиляция OpenOCD из исходных данных.

Если требуется выбрать другой аппаратный отладчик, например, JLink, нужно также обновить драйвера, а также в задаче в launch.json в поле configFiles вместо interface/ftdi/mdr-ft2232hl.cfg указать interface/jlink.cfg (см. [i] Создание проекта для МК MDR12065 в IDE Eclipse под рисунком 25).

Для запуска отладки нужно выбрать пункт View->OpenView->Run and Debug в меню или нажать на соответствующую кнопку на боковой панели.

Рисунок 5 – Переход в режим отладки

В выпадающем списке надо выбрать нужную отладочную конфигурацию. Ранее проект был собран в конфигурации "Build: MDR12065 FLASH", соответственно на этапе запуска отладки нужно выбрать конфигурацию "Debug MDR12065 (FT2232HL debugger)" и нажать зеленую стрелку.

Рисунок 6 – Запуск отладки

После запуска программа остановится в начале функции main(). Процессом исполнения программы можно управлять с помощью панели сверху. Регистры периферийных блоков доступны во вкладке XPERIPHERALS. Регистры ядра отображаются в VARIABLES->Registers.

Рисунок 7 – Процесс отладки