Просмотр кода страницы Установка и настройка Eclipse IDE для MIK32

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

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

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 требуется 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. Чтобы установить драйверы для программатора требуется выполнить ряд действий:  <blockquote>1. Скачайте программу Zadig с сайта https://zadig.akeo.ie. Ссылка на последнюю версию будет в разделе Download.  

2. Подключите программатор и запустите Zadig. Если в открывшемся окне в выпадающем списке нет устройств, в меню Options нажмите на '''List All Devices'''. В выпадающем списке выберите устройство с названием ''USB <-> Serial Converter (Interface 0)'', в белом поле ввода кнопками со стрелками выберите драйвер ''WinUSB'' и нажмите кнопку '''Install Driver''' или '''Replace Driver'''.  </blockquote>Также пакет драйверов можно скачать с сайта https://www.olimex.com/Products/ARM/JTAG/_resources/OLIMEX-FTDI-drivers-2-12-04.zip

== Создание проекта ==
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 чтобы применить настройки

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

== Загрузка программы в MCU32 ==
1. Соберите проект по сочетанию клавиш <code>Ctrl</code>+<code>B</code>, убедитесь что проект успешно собран

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

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

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

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

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

Программа должна быть успешно загружена, светодиод мигать, а в консоли вывод см. на рисунке ниже. В случае проблем на этом шаге проверьте подключение<gallery mode="nolines">
Файл:Olimex-jtag for arduino users.png
Файл:Mcu32 load succesful console log.png
</gallery>