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

Материал из MIK32 микроконтроллер
Нет описания правки
Нет описания правки
 
(не показаны 3 промежуточные версии 2 участников)
Строка 1: Строка 1:
== Скачивание библиотек для Platformio ==
== Подготовка среды разработки PlatformIO ==
Необходимо скачать архив: https://github.com/MikronMIK32/mik32-platformio/releases/download/v0.2.0-alpha/mik32-platformio-v0.2.0-alpha.zip
Под Windows:
[[Файл:Работа с GitHub.png|мини|Рисунок 1 - Работа с GitHub]]
В данный момент установка производится вручную распаковкой архивов в директорию <code>%USERNAME%\.platformio</code>.


В данный момент установка производится распаковкой в директорию %USERNAME%\.platformio.
Порядок действий для скачивания zip архива с GitHub изображен на рисунке 1.


Шаг 1
'''Шаг 1. Фреймворк.'''


* содержимое папки mik32-platformio архива '''mik32-platformio-v0.2.0-alpha.zip''' скопировать в <code>C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\</code> (В Windows эта папка доступна по пути <code>%USERPROFILE%\.platformio</code>, скопируйте этот путь в адресную строку Проводника и нажмите <code>Enter</code>)
* Пройдите по ссылке https://github.com/MikronMIK32/framework-mik32v2-sdk и скачайте zip архив.
Шаг 2
* Распакуйте содержимое папки framework-mik32v2-sdk-main в архиве по пути <code>C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\packages\framework-mik32v2-sdk</code>.  
'''Шаг 2. Библиотеки.'''


Перезапустить '''VS Code.'''  Теперь у вас подготовлена среда для программирования MIK32
* Пройдите по ссылке https://github.com/MikronMIK32/mik32v2-shared и скачайте zip архив.
* Распакуйте содержимое папки mik32v2-shared-main архива по пути <code>C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\packages\framework-mik32v2-sdk\shared</code>.  


Шаг 3
'''Шаг 3. Библиотеки HAL.'''


Дождаться появления значка Platformio в левой части окна и нажать на него: откроется панель, в которой следует нажать на Open.
* Пройдите по ссылке https://github.com/MikronMIK32/mik32-hal и скачайте zip архив.
* Распакуйте содержимое папки mik32-hal-main архива по пути <code>C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\packages\framework-mik32v2-sdk\hal</code>.  


Откроется вкладка PIO Home, нажмите на кнопку New Project.
'''Шаг 4. Загрузчик.'''


В диалоговом окне Project Wizard в поле Name введите имя проекта, в выпадающем списке Board введите mik32 и выберите MIK32V0 Generic Board (Mikron), нажмите Finish.
* Пройдите по ссылке https://github.com/MikronMIK32/mik32-uploader и скачайте zip архив.
* Распакуйте содержимое папки mik32-uploader-master архива по пути <code>C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\packages\tool-mik32-uploader</code>.  


Platformio скачает набор для разработки под RISC-V  
'''Шаг 5. Платформа.'''
 
* Пройдите по ссылке https://github.com/MikronMIK32/platform-mik32 и скачайте zip архив.
* Распакуйте содержимое папки platform-mik32-main архива по пути <code>C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\platforms\mik32</code>.
 
'''Шаг 6. Создание проекта.'''
 
После распаковки всех архивов должна получиться следующая структура .platformio:
 
* packages
** framework-mik32v2-sdk
*** hal
*** shared
** tool-mik32-uploader
* platforms
** mik32
 
[[Файл:Старт в platformio.png|мини|Рисунок 2 - Старт в platformio]]
Перезапустите '''VS Code.'''  Теперь у вас подготовлена среда для программирования MIK32.
 
Дождитесь появления значка Platformio в левой части окна и нажмите на него: откроется панель, в которой следует нажать на Open (см. рисунок 2).
 
Откроется вкладка PIO Home, нажмите на кнопку New Project (рисунок 2).
 
В диалоговом окне Project Wizard в поле Name введите имя проекта, в выпадающем списке Board введите mik32 и выберите MIK32V2 Generic Board (Mikron), нажмите Finish.
 
При первом запуске Platformio скачает набор для разработки под RISC-V. Для этого требуется подключение к интернету, будет скачано около 1 ГБ. В это время platformio скачивает такие пакеты как toolchain-riscv, tool-openocd и tool-scons в папку <code>C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\packages</code> . 


Дождитесь завершения создания проекта и в диалоговом окне нажмите Да, я доверяю авторам.
Дождитесь завершения создания проекта и в диалоговом окне нажмите Да, я доверяю авторам.


В левой части в панели проводника нажмите правой кнопкой мыши на папку src, выберите Создать файл, введите название файла и нажмите Enter.
В левой части в панели проводника нажмите правой кнопкой мыши на папку src, выберите Создать файл, введите название файла, например main.c, и нажмите Enter.
 
'''Шаг 7. Примеры и их параметры.'''
 
Ознакомьтесь с примерами и параметрами конфигурационного файла platformio.ini, который находится в каждом проекте platformio.


[[Работа с отладчиками на основе FT2232H|Установите драйвер программатора]]
Ссылка на примеры: https://github.com/MikronMIK32/mik32-examples.


Шаг 4
Параметры файла platformio.ini: [[Параметры platformio.ini]].
[[Файл:Load.png|мини|Рисунок 3 - Загрузка программы]]
'''Шаг 8. Загрузка программы.'''


Ознакомьтесь с примерами и создавайте свое ПО.
Для того чтобы загрузить программу в микроконтроллер нужно установить драйвер.  


Ссылка на примеры: https://github.com/MikronMIK32/mik32-examples
Описание работы с отладчиками на основе FT2232H: [[Работа с отладчиками на основе FT2232H|Установка драйвера программатора]].


Прим. API Reference, автоматический конфигуратор переферии в данный момент находятся в разработке.
Перед загрузкой программы убедитесь что проект выбран в качестве активного. Для этого в platformio toolbar, расположенном внизу, выберите "switch platformio project environment". В открывшемся выпадающем списке выберите нужный проект. Затем нажмите upload. Порядок действий изображен на рисунке 3.

Текущая версия от 10:10, 2 июля 2024

Подготовка среды разработки PlatformIO

Под Windows:

Рисунок 1 - Работа с GitHub

В данный момент установка производится вручную распаковкой архивов в директорию %USERNAME%\.platformio.

Порядок действий для скачивания zip архива с GitHub изображен на рисунке 1.

Шаг 1. Фреймворк.

  • Пройдите по ссылке https://github.com/MikronMIK32/framework-mik32v2-sdk и скачайте zip архив.
  • Распакуйте содержимое папки framework-mik32v2-sdk-main в архиве по пути C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\packages\framework-mik32v2-sdk.

Шаг 2. Библиотеки.

  • Пройдите по ссылке https://github.com/MikronMIK32/mik32v2-shared и скачайте zip архив.
  • Распакуйте содержимое папки mik32v2-shared-main архива по пути C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\packages\framework-mik32v2-sdk\shared.

Шаг 3. Библиотеки HAL.

  • Пройдите по ссылке https://github.com/MikronMIK32/mik32-hal и скачайте zip архив.
  • Распакуйте содержимое папки mik32-hal-main архива по пути C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\packages\framework-mik32v2-sdk\hal.

Шаг 4. Загрузчик.

  • Пройдите по ссылке https://github.com/MikronMIK32/mik32-uploader и скачайте zip архив.
  • Распакуйте содержимое папки mik32-uploader-master архива по пути C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\packages\tool-mik32-uploader.

Шаг 5. Платформа.

  • Пройдите по ссылке https://github.com/MikronMIK32/platform-mik32 и скачайте zip архив.
  • Распакуйте содержимое папки platform-mik32-main архива по пути C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\platforms\mik32.

Шаг 6. Создание проекта.

После распаковки всех архивов должна получиться следующая структура .platformio:

  • packages
    • framework-mik32v2-sdk
      • hal
      • shared
    • tool-mik32-uploader
  • platforms
    • mik32
Рисунок 2 - Старт в platformio

Перезапустите VS Code. Теперь у вас подготовлена среда для программирования MIK32.

Дождитесь появления значка Platformio в левой части окна и нажмите на него: откроется панель, в которой следует нажать на Open (см. рисунок 2).

Откроется вкладка PIO Home, нажмите на кнопку New Project (рисунок 2).

В диалоговом окне Project Wizard в поле Name введите имя проекта, в выпадающем списке Board введите mik32 и выберите MIK32V2 Generic Board (Mikron), нажмите Finish.

При первом запуске Platformio скачает набор для разработки под RISC-V. Для этого требуется подключение к интернету, будет скачано около 1 ГБ. В это время platformio скачивает такие пакеты как toolchain-riscv, tool-openocd и tool-scons в папку C:\Users\ИМЯ-ПОЛЬЗОВАТЕЛЯ\.platformio\packages .

Дождитесь завершения создания проекта и в диалоговом окне нажмите Да, я доверяю авторам.

В левой части в панели проводника нажмите правой кнопкой мыши на папку src, выберите Создать файл, введите название файла, например main.c, и нажмите Enter.

Шаг 7. Примеры и их параметры.

Ознакомьтесь с примерами и параметрами конфигурационного файла platformio.ini, который находится в каждом проекте platformio.

Ссылка на примеры: https://github.com/MikronMIK32/mik32-examples.

Параметры файла platformio.ini: Параметры platformio.ini.

Рисунок 3 - Загрузка программы

Шаг 8. Загрузка программы.

Для того чтобы загрузить программу в микроконтроллер нужно установить драйвер.

Описание работы с отладчиками на основе FT2232H: Установка драйвера программатора.

Перед загрузкой программы убедитесь что проект выбран в качестве активного. Для этого в platformio toolbar, расположенном внизу, выберите "switch platformio project environment". В открывшемся выпадающем списке выберите нужный проект. Затем нажмите upload. Порядок действий изображен на рисунке 3.