elbear_arduino_bsp/docs/Instructions.md
klassents 35d96be524 Исправление известных ошибок
- исправлены ошибки при работе с пользователями, в названии которых есть пробелы
- исправлены ошибки при работе с программатором на win11
- исправлены ссылки на документацию от компании Микрон
- в описания плат добавлены ссылки на инструкцию по записи начального загрузчика, в инструкцию добавлен блок про загрузку скетчей с помощью программатора
- исправлены известные ошибки
2025-07-15 09:30:14 +03:00

57 lines
7.0 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
1. Установите [Arduino IDE](https://www.arduino.cc/en/software).
2. Откройте меню `Файл -> Параметры`.
3. Вставьте данную ссылку в поле "Дополнительные ссылки для Менеджера плат":
`https://elron.tech/files/package_elbear_beta_index.json`
![Add_board](Add_board.PNG)
4. Откройте меню `Инструменты -> Плата -> Менеджер плат...`.
5. В поиске найдите пакет `MIK32 Boards (Arduino BSP by Elron)`, выберите нужную версию пакета и нажмите кнопку `Установить`.
![Install_board](Install_board_.PNG)
6. Процесс установки может занять некоторое время. Результаты установки отобразятся в поле `Вывод`, а так же во всплывающих уведомлениях.
![Installation_process](Installation_process_.PNG)
## Запись начального загрузчика через ArduinoIDE
Для загрузки скетчей по USB в ArduinoIDE необходимо, чтобы на плате был специальный начальный загрузчик ([elbear_fw_bootloader](https://gitflic.ru/project/elron-tech/elbear_fw_bootloader) для плат ELBEAR). Если он уже есть на плате, можно сразу переходить к работе. Если загрузчика еще нет или необходимо обновить его на плате, ниже описан процесс загрузки. Актуальная версия начального загрузчика входит в состав пакета поддержки для всех плат, отдельно скачивать его не нужно.
Платы ELBEAR ACE-UNO ревизии 1.1.0, ELBEAR ACE-NANO, ELSOMIK готовы к использованию в ArduinoIDE из коробки, так как поставляются с предварительно записанным начальным загрузчиком.
Для записи начального загрузчика:
1. Подключите плату к ПК по интерфейсу JTAG.
Для подключения плат ELBEAR, ELSOMIK потребуется программатор [ELJTAG](https://elron.tech/eljtag-programmator-risc-v-mcu/).
Для подключения платы START-MIK32 необходимо на плате перевести переключатель режима программатора (COM/JTAG) в положение JTAG и подключить плату к ПК через USB разъем.
2. В ArduinoIDE выберите программатор: `Инструменты -> Программатор -> mik32 uploader`.
![programmer](programmer.png)
3. Для записи начального загрузчика выберите `Инструменты -> Записать Загрузчик`.
![Bootloader](Bootloader_.png)
4. При возникновении проблем с загрузкой ознакомьтесь с разделом `Настройка программатора` в [инструкции](https://elron.tech/wp-content/uploads/2024/05/instrukcija-po-pervomu-zapusku.pdf) по первому запуску платы ELBEAR ACE-UNO или с [документацией](https://docs.mikron.ru/wiki/boards/start.html) по запуску платы START-MIK32 (ссылки на документацию по плате START-MIK32 актуальны на июль 2025 года, если они не действительны, возможно найти актуальную информацию на сайте производителя - https://mikron.ru/).
Теперь можно загружать скетчи в плату по USB.
## Начало работы
1. Подключите плату к ПК по USB.
2. Откройте ArduinoIDE и загрузите необходимый скетч. Для начала работы можно воспользоваться готовыми примерами, например - `Файл -> Примеры -> 01.Basics -> Blink`.
![Blink_example](Blink_example.png)
3. Выберите активную плату - `Инструменты -> Плата`.
![Set_board](Set_board_.png)
4. Выберите используемый COM порт - `Инструменты -> Порт`.
![Set_port](Set_port_.png)
Выбранные плата и порт в ArduinoIDE должны отображаться следующим образом:
![Selected_board_port](Selected_board_port_.png)
5. Проверьте скетч, нажав соответствующую кнопку.
![Build_project](Build_project_.png)
6. Загрузите полученную прошивку на плату.
![Flash_project](Flash_project_.png)
7. При необходимости можно открыть терминал и получать сообщения от платы по интерфейсу Serial. Для этого добавьте в скетч работу с интерфейсом и после загрузки прошивки выберите `Инструменты -> Монитор порта`.
![Monitor](Monitor_.png)
## Загрузка скетчей через программатор
ArduinoIDE позволяет так же загружать скетчи через программатор. Для этого:
1. Подключите плату к ПК по интерфейсу JTAG.
Для подключения плат ELBEAR, ELSOMIK потребуется программатор [ELJTAG](https://elron.tech/eljtag-programmator-risc-v-mcu/).
Для подключения платы START-MIK32 необходимо на плате перевести переключатель режима программатора (COM/JTAG) в положение JTAG и подключить плату к ПК через USB разъем.
2. Откройте ArduinoIDE и загрузите необходимый скетч. Для начала работы можно воспользоваться готовыми примерами, например - `Файл -> Примеры -> 01.Basics -> Blink`.
3. Выберите активную плату - `Инструменты -> Плата`.
4. Выберите программатор - `Инструменты -> Программатор -> mik32 uploader`.
5. Проверьте скетч, нажав соответствующую кнопку.
6. Для загрузки скетча через программатор выберите - `Скетч -> Загрузить на плату при помощи программатора`.
![Flash_project_jtag](Flash_project_jtag.png)