elbear_arduino_bsp/docs/debug_description.md

21 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Режим отладки в ArduinoIDE 2
Начиная с версии пакета 0.5.0 для всех плат, входящих в состав пакета, доступен режим отладки скетчей.
Для отладки плат ELBEAR ACE-UNO, ELBEAR ACE-NANO, ELSOMIK понадобится программатор [ELJTAG](https://elron.tech/eljtag-programmator-risc-v-mcu/). Плата START-MIK32 содержит встроенный программатор, для использования которого необходимо передвинуть переключатель режима программатора на плате в положение `JTAG`.
Режим отладки доступен в ArduinoIDE версии 2 и выше.
# Предварительная подготовка
Для отладки в Arduino IDE используется плагин Cortex-Debug. По умолчанию используется версия плагина 1.5.1, но с указанной версией режим отладки для плат из состава пакета работает некорректно. Для корректной работы отладки необходимо использовать более новую версию плагина. Архив, содержащий актуальную версию Cortex-Debug и всех необходимых ему зависимостей, можно найти в дополнительных материалах к релизу (!ССЫЛКА). Архив необходимо скачать, а его содержимое (несколько файлов с расширением .vsix) разместить в папке C:\Program Files\Arduino IDE\resources\app\plugins, не создавая промежуточных папок.
# Запуск отладки
Установить галочку Оптимизация для отладки
Собрать проект, загрузить скетч
Запустить режим отладки, нажав кнопку, картинка
В отладке доступно:
- пошаговое исследование кода
- выполнение кода до точки останова (доступно только 2 точки)
- отслеживание состояния указанных переменных
- просмотр состояния периферийных регистров микроконтроллера
- просмотр состояния служебных регистров (и регистров из архитектуры)
- просмотр стека вызовов при паузе