k1921vg5t_sdk
================
NIIET K1921VG5T SDK - это набор программных средств разработки для микроконтроллера К1921VG5T RISC-V НИИЭТ Данный репозиторий содержит простые примеры программ демонстрирующие работу периферии микроконтроллера. Более сложные проекты для К1921VG5T, например, с FreeRTOS, расположены в репозитории NIIET_RISCV SDK Так же для разработки проектов можно использовать модульный RISCV_CMAKE SDK.
Структура каталогов
.
|-- hardware : Исходники относящиеся к плате и периферии на ней
| `-- bsp : Board Support Package - описание периферии, подключенной к мк на конкретной плате
| `-- NIIET-MINI-K1921VG5T : описание периферии, подключенной к мк на плате NIIET-MINI-K1921VG5T
|
|-- platform : Общие библиотеки
| |-- Device : Заголовочные файлы микроконтроллера, файлы startup и скрипты линкера
| |-- plib5t : Библиотека периферии К1921ВГ5Т
| |-- retarget : Перенаправление printf/scanf в UART
| `-- unix_time : Библиотека функций календаря для RTC
|
|-- projects : Примеры проектов
| |-- NIIET-MINI-K1921VG5T : Проекты для отладочной платы NIIET-MINI-K1921VG5T
| `-- plib5t : Проекты для отладочной платы NIIET-DEV-K1921VG5T с использованием библиотеки PLIB5T
|
|-- templates : Шаблоны проектов
| |-- k1921vg5t-bare : Шаблон проекта для К1921ВГ5Т
| `-- k1921vg5t-plib5t : Шаблон проекта для К1921ВГ5Т с использованием библиотеки PLIB5T
|
`-- tools : Вспомогательный инструментарий
|-- openocd : Файлы для осуществления отладки мк
|-- scdt_launch_* : Скрипты для формирования файлов запуска сессии отладки *.launch
|-- scdt_fast_launch_* : Скрипты для формирования файлов запуска сессии отладки *.launch с повышением частоты отладки
`-- svd : SVD файлы микроконтроллеров
Отладочные платы
NIIET-MINI-K1921VG5T - КФДЛ.441461.044
Документация по микроконтроллеру К1921ВГ3Т
Файлы документации расположены в подкаталоге doc
Требования и рекомендации
Для сборки проектов под GCC необходимы:
- RISCV GCC
- make для вашей ОС (make, mingw64-make …)
Для отладки проектов необходимы:
OpenOCD с драйверами Flash K1921VG015, K1921VG1T, K1921VG3T, K1921VG5T, K1921VG7T
Проекты для Eclipse (sc-dt) создавались в:
Примечание:
После импорта проектов в sc-dt (Syntacore Development Toolkit) в окне “Problems” отображаются ошибки. Это ошибки в Eclipse CDT: среда разработки не может найти кросс‑компиляторы RISC‑V (riscv64-unknown-elf-gcc и riscv64-unknown-elf-g++) в переменной окружения PATH. Из‑за этого не работает сканирование заголовков и определение макросов — проект выглядит «сломанным», хотя код корректный. Есть три варианта решения данной проблемы:
- ничего не делать. На процесс компиляции и сборку проектов это не влияет, кроме действия как отвлекающего фактора в окне “Problems”;
- в окне “Problems” выделить все ошибки (CTRL + A) и удалить (Delete). Выполнять данную комбинацию каждый раз после импорта проектов;
- Добавьте тулчейн в PATH Найдите папку, где лежат riscv64-unknown-elf-gcc.exe (или без .exe) и riscv64-unknown-elf-g++.exe. В ней должен быть подкаталог bin.
Windows: Откройте «Система» → «Дополнительные параметры системы» → «Переменные среды». В «Системные переменные» найдите Path, нажмите «Изменить». Добавьте путь к папке bin вашего тулчейна, например: C:\tools\sc-dt\riscv-gcc\bin. Сохраните и перезапустите Eclipse.
Linux: Добавьте в ~/.bashrc:
export PATH="$HOME/tools/sc-dt/riscv-gcc/bin:$PATH"
Затем примените: source ~/.bashrc и перезапустите Eclipse.
Для поддержки микроконтроллеров К1921ВГ015, К1921ВГ1Т, К1921ВГ3Т, К1921ВГ5Т, К1921ВГ7Т в Syntacore Development Toolkit (ОС Windows, ОС Linux) необходимо содержимое архива sc-dt_Patch_Niiet_Win32.zip или sc-dt_Patch_Niiet_Linux.tar.gz со страницы релизов “openocd” распаковать в каталог “sc-dt”
Работа с примерами из SDK
Так как в примерах системные каталоги из platform и hardware подключены в виде ссылок, то примеры будут собираться и запускаться только из SDK. Для получения независимой от путей SDK копии примера необходимо воспользоваться шаблоном проекта k1921vg5t-bare или k1921vg5t-plib5t из каталога templates с заменой файла main.c.
Отладка в sc-dt
Изначально в каталогах sc-dt всех проектов отсутсвуют файлы запуска сессии отладки *.launch. Для их генерации в каталоге SDK tools расположены скрипты prepare_launch_*.bat и prepare_fast_launch_*.bat. Каждый скрипт в имени файла содержит название отладчика и предназначен для генерации файлов запуска сессии отладки *.launch с настройками соответствующего отладчика. При использовании отладчика Jlink необходимо выполнить скрипт prepare_launch_JLink.bat. Скрипты prepare_fast_launch_*.bat сначала подключают OpenOCD к микроконтроллеру на частоте 100 КГц, затем записывают в регистр RCU->SYSCLKCFG значение 0x01 (переключая SYSCLK на тактирование от внешнего кварца HSE) и переподключают OpenOCD на частоте 1000 КГц.