elbear_arduino_bsp/README.md

# elbear_arduino_bsp
Пакет поддержки платы Elbear Ace-Uno на базе микроконтроллера MIK32 Амур в среде программирования Arduino IDE.


## Установка пакета в ArduinoIDE
1. Установите [Arduino IDE](https://www.arduino.cc/en/software).
2. Откройте меню `Файл -> Параметры`.
3. Вставьте данную ссылку в поле "Дополнительные ссылки для Менеджера плат":  
`https://gitflic.ru/project/elron-tech/elbear_arduino_board_manager_files/blob/raw?file=package_elbear_beta_index.json`  
![Add_board](docs/Add_board.PNG)
4. Откройте меню `Инструменты -> Плата -> Менеджер плат...`.
5. В поиске найдите плату `Elbear Ace-Uno`, выберите нужную версию и нажмите кнопку `Установить`.  
![Install_board](docs/Install_board.PNG)
6. Процесс установки может занять некоторое время. Результаты установки отобразятся в поле `Вывод`, а так же во всплывающих уведомлениях.  
![Installation_process](docs/Installation_process.PNG)

Для загрузки скетчей по USB в ArduinoIDE необходимо, чтобы на плату Elbear Ace-Uno была загружена специальная программа-загрузчик ([elbear_fw_bootloader](https://gitflic.ru/project/elron-tech/elbear_fw_bootloader)). Если она уже есть на плате, можно сразу переходить к работе. Если загрузчика еще нет или необходимо обновить его на плате, ниже описан процесс загрузки. Актуальная версия программы-загрузчика входит в состав пакета поддержки, отдельно скачивать её не нужно.

Платы ревизии 1.1.0 готовы к использованию в ArduinoIDE из коробки, так как поставляются с предварительно загруженной программой-загрузчиком.

## Загрузка программы-загрузчика через ArduinoIDE
1. Подключите плату Elbear Ace-Uno к ПК через программатор ELJTAG.
2. В ArduinoIDE выберите программатор: `Инструменты -> Программатор -> mik32 uploader`.
3. Для загрузки программы-загрузчика выберите `Инструменты -> Записать Загрузчик`.  
![Bootloader](docs/Bootloader.png)
4. При возникновении проблем с загрузкой ознакомьтесь с разделом `Настройка программатора` в [инструкции](https://elron.tech/wp-content/uploads/2024/05/instrukcija-po-pervomu-zapusku.pdf) по первому запуску платы ELBEAR ACE-UNO.  
Теперь можно загружать скетчи в плату по USB.

## Начало работы
1. Подключите плату к ПК по USB.
2. Откройте ArduinoIDE и загрузите необходимый скетч. Для начала работы можно воспользоваться готовыми примерами, например - `Файл -> Примеры -> 01.Basics -> Blink`.  
![Blink_example](docs/Blink_example.png)
3. Выберите активную плату - `Инструменты -> Плата`.  
![Set_board](docs/Set_board.png)
4. Выберите используемый COM порт - `Инструменты -> Порт`.  
![Set_port](docs/Set_port.png)  
Выбранные плата и порт в ArduinoIDE должны отображаться следующим образом:  
![Selected_board_port](docs/Selected_board_port.png)
5. Проверьте скетч, нажав соответствующую кнопку.  
![Build_project](docs/Build_project.png)
6. Загрузите полученную прошивку на плату.  
![Flash_project](docs/Flash_project.png)
7. При необходимости можно открыть терминал и получать сообщения от платы по интерфейсу Serial. Для этого выберите `Инструменты -> Монитор порта`.  
![Monitor](docs/Monitor.png)


При возникновении вопросов или выявлении проблем можно оставить заявку [здесь](https://gitflic.ru/project/elron-tech/elbear_arduino_bsp/issue).

# Полезные ссылки 
*  [Описание платы и ее распиновка](https://elron.tech/russian-arduino-compatible-board/)
*  [Материалы для плат разных ревизий](https://elron.tech/materialy-dlja-elbear-ace-uno/)