Быстрый старт в Eclipse IDE: различия между версиями

Материал из MIK32 микроконтроллер
Нет описания правки
(не показано 16 промежуточных версий этого же участника)
Строка 1: Строка 1:
== Установка и запуск программы ==
== Установка и запуск программы ==
Необходимо скачать архив с программой по ссылке https://disk.yandex.ru/d/C9urM9QtBTNLSg и распаковать.
Необходимо скачать архив с программой по ссылке https://disk.yandex.ru/d/hJidR6OVDKm-AA и распаковать.


Запускается из файла <code>start.cmd</code> в распакованной папке mcu32-ide (Это необходимо чтобы не требовалось указывать пути до toolchain'а в настройках проекта).
Запускать файлом '''eclipse.exe''' из папки программы.


== Создание проекта ==
==Создание проекта==
[[Файл:Eclipse Create Project Settings.png|мини]]
0. Скачать папку-шаблон проекта [https://disk.yandex.ru/d/AieGvNTL7d-FoQ project-template], распаковать, переименовать по названию проекта, скопировать в папку mcu32-ide/workspace.
1) Скопировать из mcu32-ide папку project-template в папку workspace и переименовать в соответствии с названием проекта (не использовать пробелы и кириллицу). Данную папку шаблон также можно скачать отсюда: https://disk.yandex.ru/d/c2fibBeF9hHChA.


2) В строке меню нажать File->New->Makefile Project with Existing Code
1. В строке меню нажать File->Import...
[[Файл:Eclipse Close Welcome.png|мини]]
3) В открывшемся окне нажать <code>Browse...</code> и выбрать папку с проектом. ''Project Name'' установится в соответствии с названием папки. Затем снять галочку в группе ''Languages'' с пункта C++. В группе ''Toolchain for Indexer Settings'' выбрать значение <code>RISC-V Cross GCC</code>. Нажать кнопку Finish.


4) Закрыть вкладку Welcome нажатием на крестик рядом с вкладкой Welcome. На данный момент должна быть видна панель ''Project Explorer'' с папкой проекта.
2. В открывшемся окне раскрыть группу General и выбрать Existing Projects into Workspace, нажать Next


5) В панели ''Project Explorer'' щелкнуть правой кнопкой мыши по папке с названием проекта и выбрать пункт <code>Import</code>. В открывшемся окне раскрыть группу C/C++ и выбрать C/C++ Project Settings, нажать Next. Далее нажать Browse..., перейти в папку mcu32-ide и открыть файл <code>include_paths.xml</code>. Нажать Finish (На этом этапе указали пути до заголовочных файлов для МК). Затем снова вызвать пункт Import, в открывшемся окне раскрыть группу Run/Debug и выбрать Launch Configurations, нажать Browse, перейти в папку mcu32-ide и выбрать папку <code>launch-configurations</code> (https://disk.yandex.ru/d/S6zEBPg4Rw0DXA), далее слева поставить галочку у папки launch-configurations и нажать Finish.
3. Нажать кнопку Browse..., выбрать папку проекта, убедиться что в области Projects проект отмечен галочкой, нажать Finish.<gallery>
[[Файл:Eclipse Build Config.png|мини]]
Файл:Импорт шаблона проекта шаг 1 - Eclipse IDE.png
6) Убедиться что в панели Project Explorer выбрана папка проекта (это необходимо для настройки проекта), в строке меню нажать Project->Properties. В открывшемся окне слева выбрать группу C/C++ Build, снять галочку с пункта ''Use default build command'', в строку ''Build command'' ввести
Файл:Импорт шаблона проекта шаг 2 - Eclipse IDE.png
Файл:Импорт шаблона проекта шаг 3 - Eclipse IDE.png
</gallery>


<code>make SHARED_DIR_PATH=${eclipse_home}shared</code>
==Создание новых файлов==
[[Файл:Main.c location - Eclipse IDE.png|мини|228x228пкс]]
В проекте уже создан файл main.c, он находится в папке src. Для начала работы раскройте в Project Explorer папку с названием вашего проекта, затем раскройте папку src и дважды щелкните по файлу main.c.


Затем слева раскрыть группу C/C++ Build и выбрать Settings. В строке Name в выпадающем списке выбрать <code>RISC-V GCC/Linux (risc64-unknown-linux-gnu-gcc)</code>. Нажать кнопку Apply and Close.
Чтобы создать новый файл с исходным кодом нажмите правой кнопкой мыши на папку src проекта в области Project Explorer и выбирете New->Source File. В открывшемся окне в поле Source file введите main.c и нажмите Finish. Аналогично командой New->Header file создается заголовочный файл.
[[Файл:Eclipse Build Prefix Config.png|мини]]
Теперь по сочетанию клавиш Ctrl+B или по щелчку в строке меню Project->Build All шаблон проекта будет успешно собран. Чтобы открыть исходный код в панели Project Explorer раскройте папку проекта, затем папку src (в ней должны храниться исходники проекта), и дважды щелкните по файлу main.c.


== Запись программы в память ==
==Сборка программы для запуска из ОЗУ и загрузка в ОЗУ контроллера==
Для сборки программы для запуска из ОЗУ необходимо переключить конфигурацию сборки на Debug RAM - для этого необходимо нажать на треугольник рядом с иконкой молотка на панели инструментов, выбрать 2 Debug RAM. Сборка уже должна запуститься, при дальшейшей разработке будет достаточно нажать на кнопку с иконкой молотка или сочетание клавиш <code>Ctrl</code>+<code>B</code>.


== Запуск отладки ==
Затем необходимо нажать на треугольник рядом с кнопкой External Tools и выбрать 2 Load elf Image для загрузки программы в МК.
 
В случае успешной записи в консоли будет видна строка X bytes written at address 0x02000000.
 
В случае появления ошибок вида:<blockquote>Error: Target not examined yet
 
Error: riscv.cpu: Unsupported DTM version: 15</blockquote>проверьте питание МК и соединение с отладчиком, выполните сброс, проверьте наличие колебаний на часовом кварце.
 
В случае появления ошибок вида:<blockquote>Error: no device found
 
Error: unable to open ftdi device with vid 0403, pid 6010, description '*', serial '*' at bus location '*'</blockquote>
 
проверьте подключение программатора к компьютеру, проверьте установку драйверов для программатора.<gallery>
Файл:Debug RAM build mode - Eclipse IDE.png
Файл:External Tools - Eclipse IDE.png
Файл:Load program in RAM - Eclipse IDE.png
Файл:Mcu32 load succesful console log.png
</gallery>
 
==Запись программы в ПЗУ==
Для сборки программы для запуска из ПЗУ необходимо переключить конфигурацию сборки на Debug EEPROM - для этого необходимо нажать на треугольник рядом с иконкой молотка на панели инструментов, выбрать 1 Debug EEPROM. Сборка уже должна запуститься, при дальшейшей разработке будет достаточно нажать на кнопку с иконкой молотка или сочетание клавиш <code>Ctrl</code>+<code>B</code>.
 
Затем необходимо нажать на треугольник рядом с кнопкой External Tools и выбрать 1 Load EEPROM hex для загрузки программы в ПЗУ МК.
 
В случае успешной записи в консоли будет видна строка
 
EEPROM check through APB done!<gallery>
Файл:EEPROM config - Eclipse IDE.png
Файл:Load script EEPROM - Eclipse IDE.png
Файл:EEPROM load console output - Eclipse IDE.png
</gallery>

Версия от 12:13, 23 декабря 2021

Установка и запуск программы

Необходимо скачать архив с программой по ссылке https://disk.yandex.ru/d/hJidR6OVDKm-AA и распаковать.

Запускать файлом eclipse.exe из папки программы.

Создание проекта

0. Скачать папку-шаблон проекта project-template, распаковать, переименовать по названию проекта, скопировать в папку mcu32-ide/workspace.

1. В строке меню нажать File->Import...

2. В открывшемся окне раскрыть группу General и выбрать Existing Projects into Workspace, нажать Next

3. Нажать кнопку Browse..., выбрать папку проекта, убедиться что в области Projects проект отмечен галочкой, нажать Finish.

Создание новых файлов

Main.c location - Eclipse IDE.png

В проекте уже создан файл main.c, он находится в папке src. Для начала работы раскройте в Project Explorer папку с названием вашего проекта, затем раскройте папку src и дважды щелкните по файлу main.c.

Чтобы создать новый файл с исходным кодом нажмите правой кнопкой мыши на папку src проекта в области Project Explorer и выбирете New->Source File. В открывшемся окне в поле Source file введите main.c и нажмите Finish. Аналогично командой New->Header file создается заголовочный файл.

Сборка программы для запуска из ОЗУ и загрузка в ОЗУ контроллера

Для сборки программы для запуска из ОЗУ необходимо переключить конфигурацию сборки на Debug RAM - для этого необходимо нажать на треугольник рядом с иконкой молотка на панели инструментов, выбрать 2 Debug RAM. Сборка уже должна запуститься, при дальшейшей разработке будет достаточно нажать на кнопку с иконкой молотка или сочетание клавиш Ctrl+B.

Затем необходимо нажать на треугольник рядом с кнопкой External Tools и выбрать 2 Load elf Image для загрузки программы в МК.

В случае успешной записи в консоли будет видна строка X bytes written at address 0x02000000.

В случае появления ошибок вида:

Error: Target not examined yet Error: riscv.cpu: Unsupported DTM version: 15

проверьте питание МК и соединение с отладчиком, выполните сброс, проверьте наличие колебаний на часовом кварце. В случае появления ошибок вида:

Error: no device found Error: unable to open ftdi device with vid 0403, pid 6010, description '*', serial '*' at bus location '*'

проверьте подключение программатора к компьютеру, проверьте установку драйверов для программатора.

Запись программы в ПЗУ

Для сборки программы для запуска из ПЗУ необходимо переключить конфигурацию сборки на Debug EEPROM - для этого необходимо нажать на треугольник рядом с иконкой молотка на панели инструментов, выбрать 1 Debug EEPROM. Сборка уже должна запуститься, при дальшейшей разработке будет достаточно нажать на кнопку с иконкой молотка или сочетание клавиш Ctrl+B.

Затем необходимо нажать на треугольник рядом с кнопкой External Tools и выбрать 1 Load EEPROM hex для загрузки программы в ПЗУ МК.

В случае успешной записи в консоли будет видна строка

EEPROM check through APB done!