Установка и настройка Eclipse IDE для MIK32: различия между версиями

Материал из MIK32 микроконтроллер
Нет описания правки
(Добавил ссылку на установку драйвера)
 
(не показаны 32 промежуточные версии 2 участников)
Строка 1: Строка 1:
[[Category:Туториал]]
[[Category:Туториал]]
[[Category:MIK32]]
'''Статья является устаревшей''', если требуется запустить среду Eclipse как можно скорее, перейдите [[Быстрый старт в Eclipse IDE|сюда]]. Данная страница может пригодится, если нужно восстановить или исправить настройки Eclipse IDE.
В рамках данной статьи мы настроим среду разработки, установим драйверы для программатора, соберем и запустим тестовую прошивку.
В рамках данной статьи мы настроим среду разработки, установим драйверы для программатора, соберем и запустим тестовую прошивку.


== Настройка среды разработки ==
== Настройка среды разработки ==
[[Файл:Eclipse CDT Downloads eclipse link.png|мини|Последняя версия пакета eclipse ide|269x269пкс]]
1. Загрузите архив с Eclipse CDT с сайта https://www.eclipse.org/cdt/downloads.php.[[Файл:Eclipse CDT Downloads OS choose.png|мини|130x130px|Выбор ОС]]Найдите последнюю версию и перейдите по ссылке рядом с надписью '''Eclipse package''', на следующей странице выберите вашу операционную систему ('''Windows x86_64'''), далее нажмете кнопку '''Download''' и сохраните архив.


На данный момент последняя версия Eclipse CDT доступна по ссылке: https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/2021-03/R/eclipse-cpp-2021-03-R-win32-x86_64.zip
1. Загрузите архив с Eclipse Embedded CDT с сайта https://eclipse-embed-cdt.github.io/packages/releases/
 
Перейдите по ссылке с последней версией, на следующей странице выберите вашу операционную систему (Windows x86_64 <code>zip</code>), далее нажмете кнопку '''Download''' и сохраните архив.
 
На данный момент последняя версия Eclipse CDT доступна по ссылке: https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/2021-03/R/eclipse-embedcpp-2021-03-R-win32-x86_64.zip
 
<gallery>
Файл:True Eclipse download ( =ω=).png
Файл:True Eclipse choose OS.png
Файл:Eclipse download button.png
</gallery>Распакуйте архив в удобную папку.
 
2. В последние версии Eclipse CDT уже включен JDK, и дополнительные '''действия не требуются (пропустите пункт 2)'''. Но если среда не запускается, возможно следует установить JDK, инструкция находится по ссылке https://eclipse-embed-cdt.github.io/plugins/prerequisites/#install-java
 
Для Windows выполните следующие действия:<blockquote>1. Перейдите на страницу с последней версией [https://openjdk.java.net/ Oracle OpenJDK], перейдите по ссылке '''Download''', которая на данный момент ведет на https://jdk.java.net/16/;
 
2. В разделе '''Builds''' скачайте '''Windows/x64''' <code>.zip</code>  файл;
 
3. Перейдите в папку AppData: введите в проводнике в строку пути %APPDATA% и нажмите Enter
 
4. Создайте папку Oracle
 
5. Распакуйте содержимое архива в папку Oracle. В папке Oracle должна находится папка с названием вида jdk-16.0.1, где '''16.0.1''' - версия jdk, '''она может быть другой!'''
 
6. Откройте командную строку: нажмите сочетание клавиш <code>Ctrl</code>+<code>X</code>, в контекстном меню выберите пункт '''Командная строка'''
 
7. Введите команды :
 
<code>set Path=%APPDATA%\Oracle\jdk-15\bin;%Path%</code>
 
<code>setx Path "%APPDATA%\Oracle\jdk-15\bin;%Path%"</code>
 
8. Проверьте версию java командой
 
<code>java --version</code><gallery>
Файл:Goto Appdata.png
Файл:Eclipse Java install terminal.png
</gallery></blockquote>3. Скачайте набор инструментов для компиляции ([https://disk.yandex.ru/d/1I8HabEqLmYG6A disk.yandex.ru]) и распакуйте папку toolchain из архива в папку Eclipse.
 
4. Скачайте заголовочные файлы для МК ([https://disk.yandex.ru/d/exntuZXCXfh-AQ disk.yandex.ru]) и распакуйте папку mcu32-shared из архива в папку Eclipse.
 
5. Запустите eclipse.exe из папки Eclipse. В диалоговом окне укажите папку для workspace. В данной папке будут храниться ваши проекты. Вы можете создать папку '''workspace''' в папке '''Eclipse''' и указать её в диалоговом окне.
 
Отметьте чекбокс ''Use this as the default and do not ask again'' и нажмите кнопку '''Launch'''
 
6. Откроется окно Eclipse, в строке меню откройте Window->Preferences. В открывшемся диалоговом окне в навигационной панели слева раскройте группу MCU и установите следующие параметры: <blockquote>1. Нажмите на пункт '''Global Build Tools Path''' и в поле ввода Build tools folder введите путь <code>${eclipse_home}\toolchain\build_tools\bin</code> 
 
2. Нажмите на пункт '''Global OpenOCD Path''' и в поле ввода Folder введите путь <code>${eclipse_home}\toolchain\openocd\bin\</code> 
 
3. Нажмите на пункт '''Global RISC-V Toolchain Path''', в выпадающем списке Default toolchain выберите пункт ''Custom'', а в поле Toolchain folder введите путь <code>${eclipse_home}\toolchain\bin</code>  </blockquote>Нажмите кнопку '''Apply and Close''' чтобы закрыть окно и сохранить изменения. 
 
Архив с настроенной средой можно скачать по ссылке: [https://disk.yandex.ru/d/_JSFB_1aHNTPPw ссылка] 
 
7. [[Работа с отладчиками на основе FT2232H|Установите драйвер для программатора]] 
== Создание проекта ==
1. В окне Eclipse нажмите Create a new Embedded C/C++ Project или в строке меню File->New->C/C++ Project.
 
2. В открывшемся диалоговом окне выберите C Managed Build и нажмите клавишу Next.
 
3. Далее введите имя проекта в поле Project name, в левой навигационной панели Project type выберите Empty project, а в правой Toolchain - RISC-V Cross GCC, и нажмите Next.
 
4. В следующем окне нажмите Next.
 
5. В следующем окне в поле Toolchain path проверьте наличие пути <code>${eclipse_home}\toolchain\bin</code> и нажмите Finish.
 
В окне Eclipse откроется вид C/C++ с созданным проектом.
 
6. Далее скачайте библиотеки для разработки на МК по [https://github.com/sh-sergey/mcu32-hal ссылке](Code->Download ZIP) и распакуйте в папку проекта, а в окне Eclipse в Project Explorer нажмите на папку с названием проекта и нажмите на клавиатуре <code>F5</code>
 
7. Откройте папку по пути {папка проекта}/mcu32-hal-main/templates/project и скопируйте содержимое в папку проекта
8. Далее импортируйте конфигурации прошивки:<blockquote>
1. В строке меню выберите File->Import...
 
2. В списке раскройте пункт Run/Debug и выберите Launch Configurations, затем нажмите Next.
 
3. Нажмите кнопку Browse и выбирите папку по пути {папка проекта}/mcu32-hal-main/templates/launch-configs
 
4. Поставте галочку в левой части окна на папке launch-configs и нажмите Finish</blockquote>
9. Настройте проект:<blockquote>
1. Кликните в Project Explorer на папку проекта, затем в строке меню выберите Project->Properties
 
2. В левой колонке выберите группу C/C++ Build, снимите галочку с пунктов ''Use default build command'' и ''Generate Makefiles automatically'', а затем в поле ввода Build command введите путь <code>make SHARED_DIR_PATH=${eclipse_home}mcu32-shared</code>, а в поле ввода Build directory введите путь <code>${ProjDirPath}</code>
 
3. Раскройте группу C/C++ General и выберите группу Path and Symbols, затем во вкладке Includes в поле Languages выберите GNU C, далее нажмите кнопку Add... и в поле ввода введите путь <code>${eclipse_home}/mcu32-shared/periphery</code> и нажмите кнопку OK, а затем таким же образом введите пути <code>${eclipse_home}/mcu32-shared/include</code> и <code>${ProjDirPath}/mcu32-hal-main/src</code> и <code>${eclipse_home}/mcu32-shared</code>. Нажмите кнопку Apply and Close чтобы применить настройки


2. Распакуйте архив в удобную папку.
</blockquote>Проект настроен. Теперь по сочетанию клавиш <code>Ctrl</code>+<code>B</code> проект должен быть успешно собран


3. Скачайте набор инструментов для компиляции ([https://disk.yandex.ru/d/6d5zuTOIWWdkuw disk.yandex.ru]) и распакуйте папку toolchain из архива в папку Eclipse.
== Загрузка программы в MCU32 ==
[[Файл:Eclipse Launch.png|мини|243x243пкс|Диалоговое окно при запуске Eclipse]]
1. Соберите проект по сочетанию клавиш <code>Ctrl</code>+<code>B</code>, убедитесь что проект успешно собран


2. Подключите плату к программатору 20 pin JTAG кабелем. Если используете ПЛИС DE2-115 смотрите схему подключения на рисунке ниже


3. Подключите плату к питанию


4. Запустите eclipse.exe из папки Eclipse. IDE попросит указать папку для workspace. В данной папке будут храниться ваши проекты. Укажите любую удобную папку, например, создайте папку '''workspace''' в папке '''Eclipse''' и укажите её в качестве папки '''workspace'''. Отметьте чекбокс '''Use this as the default and do not ask again''' и нажмите кнопку '''Launch'''
4. Перезагрузите МК кнопкой RESET


5. В открывшемся окне нажмите Create New C/C++ Project или в строке меню File->New->C/C++ Project.
5. Подключите программатор к ПК


6. В открывшемся окне выбирете шаблон Makefile Project и нажмите Next
6. Далее в строке меню выберите Run->External Tools-> External Tools Configurations... в панели слева выберите Load elf Image mlink и нажмите кнопку Run


7. В открывшемся окне в строке Project Name введите название проекта, ниже снимите чекбокс Generate Source and Makefile.<gallery mode="slideshow">
Программа должна быть успешно загружена, светодиод мигать, а в консоли вывод см. на рисунке ниже. В случае проблем на этом шаге проверьте подключение<gallery mode="nolines">
Файл:New C Project Step 1.png
Файл:Olimex-jtag for arduino users.png
Файл:Create C project step 2.png
Файл:Mcu32 load succesful console log.png
</gallery>
</gallery>

Текущая версия от 18:56, 8 февраля 2022

Статья является устаревшей, если требуется запустить среду Eclipse как можно скорее, перейдите сюда. Данная страница может пригодится, если нужно восстановить или исправить настройки Eclipse IDE.

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

Настройка среды разработки

1. Загрузите архив с Eclipse Embedded CDT с сайта https://eclipse-embed-cdt.github.io/packages/releases/

Перейдите по ссылке с последней версией, на следующей странице выберите вашу операционную систему (Windows x86_64 zip), далее нажмете кнопку Download и сохраните архив.

На данный момент последняя версия Eclipse CDT доступна по ссылке: https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/2021-03/R/eclipse-embedcpp-2021-03-R-win32-x86_64.zip

Распакуйте архив в удобную папку.

2. В последние версии Eclipse CDT уже включен JDK, и дополнительные действия не требуются (пропустите пункт 2). Но если среда не запускается, возможно следует установить JDK, инструкция находится по ссылке https://eclipse-embed-cdt.github.io/plugins/prerequisites/#install-java

Для Windows выполните следующие действия:

1. Перейдите на страницу с последней версией Oracle OpenJDK, перейдите по ссылке Download, которая на данный момент ведет на https://jdk.java.net/16/;

2. В разделе Builds скачайте Windows/x64 .zip файл;

3. Перейдите в папку AppData: введите в проводнике в строку пути %APPDATA% и нажмите Enter

4. Создайте папку Oracle

5. Распакуйте содержимое архива в папку Oracle. В папке Oracle должна находится папка с названием вида jdk-16.0.1, где 16.0.1 - версия jdk, она может быть другой!

6. Откройте командную строку: нажмите сочетание клавиш Ctrl+X, в контекстном меню выберите пункт Командная строка

7. Введите команды :

set Path=%APPDATA%\Oracle\jdk-15\bin;%Path%

setx Path "%APPDATA%\Oracle\jdk-15\bin;%Path%"

8. Проверьте версию java командой

java --version

3. Скачайте набор инструментов для компиляции (disk.yandex.ru) и распакуйте папку toolchain из архива в папку Eclipse.

4. Скачайте заголовочные файлы для МК (disk.yandex.ru) и распакуйте папку mcu32-shared из архива в папку Eclipse.

5. Запустите eclipse.exe из папки Eclipse. В диалоговом окне укажите папку для workspace. В данной папке будут храниться ваши проекты. Вы можете создать папку workspace в папке Eclipse и указать её в диалоговом окне.

Отметьте чекбокс Use this as the default and do not ask again и нажмите кнопку Launch

6. Откроется окно Eclipse, в строке меню откройте Window->Preferences. В открывшемся диалоговом окне в навигационной панели слева раскройте группу MCU и установите следующие параметры:

1. Нажмите на пункт Global Build Tools Path и в поле ввода Build tools folder введите путь ${eclipse_home}\toolchain\build_tools\bin

2. Нажмите на пункт Global OpenOCD Path и в поле ввода Folder введите путь ${eclipse_home}\toolchain\openocd\bin\

3. Нажмите на пункт Global RISC-V Toolchain Path, в выпадающем списке Default toolchain выберите пункт Custom, а в поле Toolchain folder введите путь ${eclipse_home}\toolchain\bin

Нажмите кнопку Apply and Close чтобы закрыть окно и сохранить изменения.

Архив с настроенной средой можно скачать по ссылке: ссылка

7. Установите драйвер для программатора

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

1. В окне Eclipse нажмите Create a new Embedded C/C++ Project или в строке меню File->New->C/C++ Project.

2. В открывшемся диалоговом окне выберите C Managed Build и нажмите клавишу Next.

3. Далее введите имя проекта в поле Project name, в левой навигационной панели Project type выберите Empty project, а в правой Toolchain - RISC-V Cross GCC, и нажмите Next.

4. В следующем окне нажмите Next.

5. В следующем окне в поле Toolchain path проверьте наличие пути ${eclipse_home}\toolchain\bin и нажмите Finish.

В окне Eclipse откроется вид C/C++ с созданным проектом.

6. Далее скачайте библиотеки для разработки на МК по ссылке(Code->Download ZIP) и распакуйте в папку проекта, а в окне Eclipse в Project Explorer нажмите на папку с названием проекта и нажмите на клавиатуре F5

7. Откройте папку по пути {папка проекта}/mcu32-hal-main/templates/project и скопируйте содержимое в папку проекта

8. Далее импортируйте конфигурации прошивки:

1. В строке меню выберите File->Import...

2. В списке раскройте пункт Run/Debug и выберите Launch Configurations, затем нажмите Next.

3. Нажмите кнопку Browse и выбирите папку по пути {папка проекта}/mcu32-hal-main/templates/launch-configs

4. Поставте галочку в левой части окна на папке launch-configs и нажмите Finish

9. Настройте проект:

1. Кликните в Project Explorer на папку проекта, затем в строке меню выберите Project->Properties

2. В левой колонке выберите группу C/C++ Build, снимите галочку с пунктов Use default build command и Generate Makefiles automatically, а затем в поле ввода Build command введите путь make SHARED_DIR_PATH=${eclipse_home}mcu32-shared, а в поле ввода Build directory введите путь ${ProjDirPath}

3. Раскройте группу C/C++ General и выберите группу Path and Symbols, затем во вкладке Includes в поле Languages выберите GNU C, далее нажмите кнопку Add... и в поле ввода введите путь ${eclipse_home}/mcu32-shared/periphery и нажмите кнопку OK, а затем таким же образом введите пути ${eclipse_home}/mcu32-shared/include и ${ProjDirPath}/mcu32-hal-main/src и ${eclipse_home}/mcu32-shared. Нажмите кнопку Apply and Close чтобы применить настройки

Проект настроен. Теперь по сочетанию клавиш Ctrl+B проект должен быть успешно собран

Загрузка программы в MCU32

1. Соберите проект по сочетанию клавиш Ctrl+B, убедитесь что проект успешно собран

2. Подключите плату к программатору 20 pin JTAG кабелем. Если используете ПЛИС DE2-115 смотрите схему подключения на рисунке ниже

3. Подключите плату к питанию

4. Перезагрузите МК кнопкой RESET

5. Подключите программатор к ПК

6. Далее в строке меню выберите Run->External Tools-> External Tools Configurations... в панели слева выберите Load elf Image mlink и нажмите кнопку Run

Программа должна быть успешно загружена, светодиод мигать, а в консоли вывод см. на рисунке ниже. В случае проблем на этом шаге проверьте подключение