Platform-VG015

Платформа разработки программного обеспечения для микроконтроллера К1921ВГ015 (Platform-VG015) с использованием экосистема с открытым исходным кодом для разработки проектов интернета вещей PlatformIO.

Описание

Platform-VG015 позволяет расширить функционал PlatformIO путем добавления возможности разрабатывать, загружать в ОЗУ или ПЗУ, тестировать и отлаживать программное обеспечение для микроконтроллера К1921ВГ015.

В составе Platform-VG015 используются следующие пакеты:

• пакет набора инструментов для программирования микроконтроллеров на основе архитектуры RISC-V (toolchain-riscv);
• пакет OpenOCD для российских микроконтроллеров (openocd-k1921vg015) - (https://gitflic.ru/project/rus_mcu/openocd)
• программная платформа разработки приложений АО «НИИЭТ» для К1921ВГ015, включающая в себя низкоуровневые системные библиотеки микроконтроллера и библиотеку PLIB015 (framework-k1921vg015-sdk) - (https://gitflic.ru/project/niiet/niiet_riscv_sdk);

Для упрощения процесса начала работы с платформой в неё включены исходные коды базовых примеров/шаблонов приложений для отладочных плат на основе микроконтроллера К1921ВГ015.

Соглашение

Загружая, устанавливая и/или используя Platform-VG015, вы соглашаетесь, что

ДАННОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, 
ЯВНО ВЫРАЖЕННЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ ГАРАНТИИ ТОВАРНОЙ ПРИГОДНОСТИ, 
СООТВЕТСТВИЯ ПО ЕГО КОНКРЕТНОМУ НАЗНАЧЕНИЮ И ОТСУТСТВИЯ НАРУШЕНИЙ, НО НЕ ОГРАНИЧИВАЯСЬ ИМИ. 
НИ В КАКОМ СЛУЧАЕ АВТОРЫ ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ПО КАКИМ-ЛИБО ИСКАМ, 
ЗА ПРЯМОЙ ИЛИ КОСВЕННЫЙ УЩЕРБ, ИЛИ ПО ИНЫМ ТРЕБОВАНИЯМ, ВОЗНИКШИМ ИЗ-ЗА ИСПОЛЬЗОВАНИЯ 
ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ ИЛИ ИНЫХ ДЕЙСТВИЙ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ.

Структура каталогов

.
|-- platforms
    |-- k1921vg015 : Платформа разработки программного обеспечения для К1921ВГ015
|-- packages
    |-- framework-k1921vg015-sdk : Программная платформа разработки приложений АО «НИИЭТ» для К1921ВГ015
    |-- tool-openocd-k1921vg015 : Пакет инструментов для отладки на кристалле, внутрисистемного программирования и тестирования методом граничного сканирования

Примечание: Пакет toolchain-riscv скачивается автоматически из репозитория PlatformIO при создании проекта (однократно).

Установка

Установка Platform-VG015 осуществляется путем копирования каталогов platforms и packages в каталог .platformio, расположенный в домашнем каталоге пользователя. Каталог .platformio создаётся автоматически при установке PlatformIO.

Примечание: Если осуществляется повторная установка или обновление платформы, рекомендуется предварительно удалить каталоги, являющиеся частью Platform-VG015 (см. структуру каталогов выше).

Общий порядок установки:

1. Установите текстовый редактор VS Code.
2. Через менеджер расширений:
   • установите поддержку языка программирования Си/Си++ (C/C++ Extension Pack);
   • установите расширение PlatformIO IDE.
   • завершите работу VS Code.
3. Загрузите с GitFlic репозиторий Platform-VG015.
4. Скопируйте каталоги Platform-VG015 в каталог .platformio (см. выше).

Примечания (для ОС Linux):

1. Перед использованием убедитесь, что файл openocd в каталоге ~/.platformio/packages/tool-openocd-k1921vg015/bin имеет разрешение на исполнение.
2. Для запуска openocd в некоторых случаях требуется установка дополнительных пакетов. Для их установки выполните следующие команды:

sudo apt-get install libcapstone-dev
sudo apt-get install libjim-dev

Проверка установки, создание проекта

1. Запустите VS Code, откройте панель PlatformIO (кнопка на боковой панели), выберите пункт Platforms в разделе PIO Home.
2. В списке карточек установленных платформ вы должны увидеть K1921VG015:
   • нажмите на заголовок карточки K1921VG015;
   • во вкладке Boards должны отображаться две отладочные платы (BlueBird-VG015 и Generic-VG015);
   • во вкладке Examples должны быть доступны не менее двух примеров/шаблонов;
   • во вкладке Package перечислены три пакета
3. Перейдите на вкладку Examples, выберите пример:
   • для отладочной платы BlueBird-VG015 - bluebird-vg015-blink;
   • для других плат - generic-vg015-sysinit;
   • нажмите на кнопку Import, дождитесь создания проекта;
   • ознакомьтесь с файлом README.md.

Дополнительная информация

Сбор телеметрии

VS Code и PlatformIO собирают, накапливают и передают телеметрию. Подробнее о составе и объёме собираемых данных, а также способах отключения телеметрии можно узнать на официальных сайтах данных программных продуктов.

Для отключения телеметрии пользователя в PlatformIO выполните команду (из терминала PlatformIO): pio settings set enable_telemetry no.

Использование программатора

Для использования программатора в ОС Windows необходимо установить дополнительные драйверы USB-устройств. Упростить процесс их установки, можно воспользовавшись утилитой Zadig.

В настоящее время в Platform-VG015 в качестве программатора К1921ВГ015 можно использовать:

• Программатор SEGGER jLink или его клоны;
• Программатор BlueProg;
• Платы разработки на основе преобразователя интерфейсов ch347t;
• Программаторы на основе чипа FTDI FT2232H.

Обратная связь

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

1. Создания записей в разделе “Проблемы” репозитория GitFlic для:
   • описания выявленных ошибок в работе платформы;
   • предложений и замечаний по улучшению имеющегося функционала платформы;
   • предложений по добавлению новых функций.
2. Вы можете принять непосредственное участие в разработке платформы путем направления запросов на слияние.