diff --git a/README.md b/README.md index 3b0aa46..e4882f0 100644 --- a/README.md +++ b/README.md @@ -101,7 +101,8 @@ Для всех плат, входящих в состав пакета, доступен режим отладки скетча в ArduinoIDE версии 2. Подготовка к работе в режиме отладки описана в [инструкции.](./docs/debug_description.md) # Полезные ссылки -* [Материалы по платам ELBEAR ACE-UNO](https://elron.tech/support/#elbear) +* [Описание плат ELBEAR](https://elron.tech/russian-arduino-compatible-board/) +* [Материалы по платам ELBEAR](https://elron.tech/support/#elbear) * [Материалы по платам ELSOMIK](https://elron.tech/support/#elsomik) * [Материалы по плате START-MIK32](https://wiki.mik32.ru/%D0%9E%D1%82%D0%BB%D0%B0%D0%B4%D0%BE%D1%87%D0%BD%D0%B0%D1%8F_%D0%BF%D0%BB%D0%B0%D1%82%D0%B0_%D0%A1%D1%82%D0%B0%D1%80%D1%82) * [Телеграмм-канал компании](https://t.me/elrontech) diff --git a/docs/Bootloader.png b/docs/Bootloader.png deleted file mode 100644 index d9a452e..0000000 Binary files a/docs/Bootloader.png and /dev/null differ diff --git a/docs/Bootloader_.png b/docs/Bootloader_.png new file mode 100644 index 0000000..017f2c5 Binary files /dev/null and b/docs/Bootloader_.png differ diff --git a/docs/Build_project.png b/docs/Build_project.png deleted file mode 100644 index 19fdbcb..0000000 Binary files a/docs/Build_project.png and /dev/null differ diff --git a/docs/Build_project_.png b/docs/Build_project_.png new file mode 100644 index 0000000..0b0786d Binary files /dev/null and b/docs/Build_project_.png differ diff --git a/docs/Elsomik_OEM_pinout.png b/docs/Elsomik_OEM_pinout.png new file mode 100644 index 0000000..664f1fc Binary files /dev/null and b/docs/Elsomik_OEM_pinout.png differ diff --git a/docs/Elsomik_SE_pinout.png b/docs/Elsomik_SE_pinout.png new file mode 100644 index 0000000..768f57c Binary files /dev/null and b/docs/Elsomik_SE_pinout.png differ diff --git a/docs/Flash_project.png b/docs/Flash_project.png deleted file mode 100644 index 243bc96..0000000 Binary files a/docs/Flash_project.png and /dev/null differ diff --git a/docs/Flash_project_.png b/docs/Flash_project_.png new file mode 100644 index 0000000..ee69c5a Binary files /dev/null and b/docs/Flash_project_.png differ diff --git a/docs/Install_board.PNG b/docs/Install_board.PNG deleted file mode 100644 index b6a559d..0000000 Binary files a/docs/Install_board.PNG and /dev/null differ diff --git a/docs/Install_board_.PNG b/docs/Install_board_.PNG new file mode 100644 index 0000000..4e5924d Binary files /dev/null and b/docs/Install_board_.PNG differ diff --git a/docs/Installation_process.PNG b/docs/Installation_process.PNG deleted file mode 100644 index 9142182..0000000 Binary files a/docs/Installation_process.PNG and /dev/null differ diff --git a/docs/Installation_process_.PNG b/docs/Installation_process_.PNG new file mode 100644 index 0000000..6f3c7b5 Binary files /dev/null and b/docs/Installation_process_.PNG differ diff --git a/docs/Instructions.md b/docs/Instructions.md index 6e4088a..3e024fa 100644 --- a/docs/Instructions.md +++ b/docs/Instructions.md @@ -6,22 +6,22 @@ ![Add_board](Add_board.PNG) 4. Откройте меню `Инструменты -> Плата -> Менеджер плат...`. 5. В поиске найдите пакет `MIK32 Boards (Arduino BSP by Elron)`, выберите нужную версию пакета и нажмите кнопку `Установить`. -![Install_board](Install_board.PNG) +![Install_board](Install_board_.PNG) 6. Процесс установки может занять некоторое время. Результаты установки отобразятся в поле `Вывод`, а так же во всплывающих уведомлениях. -![Installation_process](Installation_process.PNG) +![Installation_process](Installation_process_.PNG) ## Запись начального загрузчика через ArduinoIDE -Для загрузки скетчей по USB в ArduinoIDE необходимо, чтобы на плате был специальный начальный загрузчик ([elbear_fw_bootloader](https://gitflic.ru/project/elron-tech/elbear_fw_bootloader) для плат Elbear Ace-Uno). Если он уже есть на плате, можно сразу переходить к работе. Если загрузчика еще нет или необходимо обновить его на плате, ниже описан процесс загрузки. Актуальная версия начального загрузчика входит в состав пакета поддержки для всех плат, отдельно скачивать его не нужно. +Для загрузки скетчей по USB в ArduinoIDE необходимо, чтобы на плате был специальный начальный загрузчик ([elbear_fw_bootloader](https://gitflic.ru/project/elron-tech/elbear_fw_bootloader) для плат ELBEAR). Если он уже есть на плате, можно сразу переходить к работе. Если загрузчика еще нет или необходимо обновить его на плате, ниже описан процесс загрузки. Актуальная версия начального загрузчика входит в состав пакета поддержки для всех плат, отдельно скачивать его не нужно. -Платы Elbear Ace-Uno ревизии 1.1.0 готовы к использованию в ArduinoIDE из коробки, так как поставляются с предварительно записанным начальным загрузчиком. +Платы ELBEAR ACE-UNO ревизии 1.1.0, ELBEAR ACE-NANO, ELSOMIK готовы к использованию в ArduinoIDE из коробки, так как поставляются с предварительно записанным начальным загрузчиком. Для записи начального загрузчика: 1. Подключите плату к ПК по интерфейсу JTAG. -Для подключения платы Elbear Ace-Uno потребуется программатор [ELJTAG](https://elron.tech/eljtag-programmator-risc-v-mcu/). +Для подключения плат ELBEAR, ELSOMIK потребуется программатор [ELJTAG](https://elron.tech/eljtag-programmator-risc-v-mcu/). Для подключения платы START-MIK32 необходимо перевести переключатель режима программатора в положение JTAG и подключить плату к ПК через USB разъем. 2. В ArduinoIDE выберите программатор: `Инструменты -> Программатор -> mik32 uploader`. 3. Для записи начального загрузчика выберите `Инструменты -> Записать Загрузчик`. -![Bootloader](Bootloader.png) +![Bootloader](Bootloader_.png) 4. При возникновении проблем с загрузкой ознакомьтесь с разделом `Настройка программатора` в [инструкции](https://elron.tech/wp-content/uploads/2024/05/instrukcija-po-pervomu-zapusku.pdf) по первому запуску платы ELBEAR ACE-UNO или с [документацией](https://wiki.mik32.ru/%D0%9E%D1%82%D0%BB%D0%B0%D0%B4%D0%BE%D1%87%D0%BD%D0%B0%D1%8F_%D0%BF%D0%BB%D0%B0%D1%82%D0%B0_%D0%A1%D1%82%D0%B0%D1%80%D1%82) по запуску платы START-MIK32. Теперь можно загружать скетчи в плату по USB. @@ -30,14 +30,14 @@ 2. Откройте ArduinoIDE и загрузите необходимый скетч. Для начала работы можно воспользоваться готовыми примерами, например - `Файл -> Примеры -> 01.Basics -> Blink`. ![Blink_example](Blink_example.png) 3. Выберите активную плату - `Инструменты -> Плата`. -![Set_board](Set_board.png) +![Set_board](Set_board_.png) 4. Выберите используемый COM порт - `Инструменты -> Порт`. -![Set_port](Set_port.png) +![Set_port](Set_port_.png) Выбранные плата и порт в ArduinoIDE должны отображаться следующим образом: -![Selected_board_port](Selected_board_port.png) +![Selected_board_port](Selected_board_port_.png) 5. Проверьте скетч, нажав соответствующую кнопку. -![Build_project](Build_project.png) +![Build_project](Build_project_.png) 6. Загрузите полученную прошивку на плату. -![Flash_project](Flash_project.png) +![Flash_project](Flash_project_.png) 7. При необходимости можно открыть терминал и получать сообщения от платы по интерфейсу Serial. Для этого добавьте в скетч работу с интерфейсом и после загрузки прошивки выберите `Инструменты -> Монитор порта`. -![Monitor](Monitor.png) \ No newline at end of file +![Monitor](Monitor_.png) \ No newline at end of file diff --git a/docs/Monitor.png b/docs/Monitor.png deleted file mode 100644 index 675d331..0000000 Binary files a/docs/Monitor.png and /dev/null differ diff --git a/docs/Monitor_.png b/docs/Monitor_.png new file mode 100644 index 0000000..ace3b2b Binary files /dev/null and b/docs/Monitor_.png differ diff --git a/docs/Selected_board_port.png b/docs/Selected_board_port.png deleted file mode 100644 index a00ec20..0000000 Binary files a/docs/Selected_board_port.png and /dev/null differ diff --git a/docs/Selected_board_port_.png b/docs/Selected_board_port_.png new file mode 100644 index 0000000..e5779ae Binary files /dev/null and b/docs/Selected_board_port_.png differ diff --git a/docs/Set_board.png b/docs/Set_board.png deleted file mode 100644 index f230da2..0000000 Binary files a/docs/Set_board.png and /dev/null differ diff --git a/docs/Set_board_.png b/docs/Set_board_.png new file mode 100644 index 0000000..40fc236 Binary files /dev/null and b/docs/Set_board_.png differ diff --git a/docs/Set_port.png b/docs/Set_port.png deleted file mode 100644 index 6b75b55..0000000 Binary files a/docs/Set_port.png and /dev/null differ diff --git a/docs/Set_port_.png b/docs/Set_port_.png new file mode 100644 index 0000000..3bd8598 Binary files /dev/null and b/docs/Set_port_.png differ diff --git a/docs/Start_mik32_description.md b/docs/Start_mik32_description.md index 869194a..16be9ea 100644 --- a/docs/Start_mik32_description.md +++ b/docs/Start_mik32_description.md @@ -61,4 +61,8 @@ USB-UART преобразователь, установленный на пла ### SPI Интерфейс SPI1 доступен на выводах P1_0, P1_1, P1_2. Для работы с ним используется экземпляр класса под названием `SPI`. Интерфейс SPI0 доступен на выводах P0_0, P0_1, P0_2. Используемый экземпляр класса - `SPI1`. -Для корректной работы аппаратного SPI микроконтроллер так же использует выводы P1_3 при работе SPI1 и P0_3 при работе SPI0. В связи с этим данные выводы недоступны для использования при работе соответствующего SPI. \ No newline at end of file +Для корректной работы аппаратного SPI микроконтроллер так же использует выводы P1_3 при работе SPI1 и P0_3 при работе SPI0. В связи с этим данные выводы недоступны для использования при работе соответствующего SPI. + +### I2C +Интерфейс I2C1 доступен на выводах P1_12, P1_13, для работы с ним используется экземпляр класса под названием `Wire`. +Интерфейс I2C0 доступен на выводах P0_9, P0_10, используемый экземпляр класса - `Wire1`. \ No newline at end of file diff --git a/docs/elsomikOEM_pinout.png b/docs/elsomikOEM_pinout.png deleted file mode 100644 index d8c18e3..0000000 Binary files a/docs/elsomikOEM_pinout.png and /dev/null differ diff --git a/docs/elsomikSE_pinout.png b/docs/elsomikSE_pinout.png deleted file mode 100644 index 8494850..0000000 Binary files a/docs/elsomikSE_pinout.png and /dev/null differ diff --git a/docs/elsomik_description.md b/docs/elsomik_description.md index f2b3f02..898c1c2 100644 --- a/docs/elsomik_description.md +++ b/docs/elsomik_description.md @@ -1,27 +1,9 @@ # ELSOMIK Особенности работы с платой ELSOMIK в среде программирования ArduinoIDE. -### Функциональное назначение выводов для плат ELSOMIK OEM и ELSOMIK SE -![elsomikOEM_pinout.png](elsomikOEM_pinout.png) -![elsomikSE_pinout.png](elsomikSE_pinout.png) -|Номер вывода|Доступные функции|Номер вывода|Доступные функции| -|---------|---------|---------|---------| -|P0_0|PWM, MISO0|P1_0|PWM, MISO1| -|P0_1|PWM, MOSI0|P1_1|PWM, MOSI1| -|P0_2|PWM, SCLK0, ADC2|P1_2|PWM, SCLK1| -|P0_3|PWM, NSS0|P1_3|PWM, NSS1| -|P0_4|ADC3|P1_4|INT1| -|P0_5|RX0|P1_5|ADC0, INT2| -|P0_6|TX0|P1_6|INT3| -|P0_7|ADC4|P1_7|ADC1| -|P0_8|INT0|P1_8|RX1| -|P0_9|SDA0, ADC5|P1_9|TX1, INT4| -|P0_10|SCL0|P1_10|INT5| -|P0_11|TDI, ADC6|P1_11|REF| -|P0_12|TCK|P1_12|SDA1| -|P0_13|TMS, ADC7|P1_13|SCL1| -|P0_14|TRST|P1_14|-| -|P0_15|TDO|P1_15|INT6| -|P2_6|-|P2_7|INT7| +### Функциональное назначение выводов платы ELSOMIK OEM +![Elsomik_OEM_pinout.png](Elsomik_OEM_pinout.png) +### Функциональное назначение выводов платы ELSOMIK SE +![Elsomik_SE_pinout.png](Elsomik_SE_pinout.png) ### Загрузка скетчей На плате отсутствуют встроенные преобразователи, позволяющие загружать скетчи по USB через COM-порт, однако каждая плата поставляется с предварительно записанным начальным загрузчиком. Для записи скетчей через USB потребуется использование внешнего USB-UART преобразователя, подключаемого к выводам платы P0_5 (RX0) и P0_6 (TX0), которые соответствуют интерфейсу UART0. @@ -87,4 +69,8 @@ ### SPI Интерфейс SPI1 доступен на выводах P1_0, P1_1, P1_2. Для работы с ним используется экземпляр класса под названием `SPI`. Интерфейс SPI0 доступен на выводах P0_0, P0_1, P0_2. Используемый экземпляр класса - `SPI1`. -Для корректной работы аппаратного SPI микроконтроллер так же использует выводы P1_3 при работе SPI1 и P0_3 при работе SPI0. В связи с этим данные выводы недоступны для использования при работе соответствующего SPI. \ No newline at end of file +Для корректной работы аппаратного SPI микроконтроллер так же использует выводы P1_3 при работе SPI1 и P0_3 при работе SPI0. В связи с этим данные выводы недоступны для использования при работе соответствующего SPI. + +### I2C +Интерфейс I2C1 доступен на выводах P1_12, P1_13, для работы с ним используется экземпляр класса под названием `Wire`. +Интерфейс I2C0 доступен на выводах P0_9, P0_10, используемый экземпляр класса - `Wire1`. \ No newline at end of file