# Установка пакета и предварительная подготовка к работе
## Установка пакета в 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/2025/07/instrukcija_po_pervomu_zapusku_140725.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)