добавлена поддержка платы Start-MIK32
klassents authored and 
KLASSENTS committed No files matched your search
|
Before Width: | Height: | Size: 66 KiB After Width: | Height: | Size: 59 KiB |
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
@@ -0,0 +1,25 @@
|
||||
# Elbear Ace-Uno
|
||||
Особенности работы с платами Elbear Ace-Uno в среде программирования ArduinoIDE.
|
||||
### Функциональное назначение выводов
|
||||
|
||||
### Цифровые выводы
|
||||
На плате Elbear Ace-Uno доступны встроенные светодиод и кнопка. Для их использования необходимо воспользоваться макросами `LED_BUILTIN` и `BTN_BUILTIN`, передавая их в качестве аргументов функции вместо номера цифрового вывода. Макросу `LED_BUILTIN` соответствует номер вывода D22, а макросу `BTN_BUILTIN` - D23.
|
||||
#### ШИМ
|
||||
На плате Elbear Ace-Uno доступны следующие выводы для формирования ШИМ-сигнала: D3, D5, D6, D9, D10, D11. Генерация сигнала осуществляется с помощью 32-битного таймера. Выводы D3, D5, D6, D9 подключены к таймеру 1, выводы D10, D11 подключены к таймеру 2. Выводы, подключенные к одному и тому же таймеру, выдают ШИМ-сигнал одинаковой частоты.
|
||||
Цифровой вывод D10 не может быть использован для генерации ШИМ, если одновременно активен интерфейс SPI. Это ограничение связано с особенностями работы микроконтроллера. Ограничение не распространяется на использование D10 в качестве цифрового вывода при активном SPI.
|
||||
### Прерывания
|
||||
На плате Elbear Ace-Uno доступно 7 прерываний, настраиваемых функцией `void attachInterrupt(uint8_t interruptNum, void (*userFunc)(void), int mode)`:
|
||||
|
||||
|Цифровой вывод|Номер прерывания|
|
||||
|---------|---------|
|
||||
|D2|0|
|
||||
|D3|1|
|
||||
|D4|2|
|
||||
|D5|3|
|
||||
|D8|4|
|
||||
|D9|5|
|
||||
|`BTN_BUILTIN`|6|
|
||||
|
||||
### Serial
|
||||
Интерфейс UART0 доступен на выводах D0, D1, для работы с ним используется экземпляр класса под названием `Serial`.
|
||||
Интерфейс UART1 доступен на выводах D7, D8, используемый экземпляр класса - `Serial1`.
|
||||
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
|
Before Width: | Height: | Size: 24 KiB After Width: | Height: | Size: 31 KiB |
|
Before Width: | Height: | Size: 65 KiB After Width: | Height: | Size: 49 KiB |
@@ -0,0 +1,43 @@
|
||||
## Установка пакета в ArduinoIDE
|
||||
1. Установите [Arduino IDE](https://www.arduino.cc/en/software).
|
||||
2. Откройте меню `Файл -> Параметры`.
|
||||
3. Вставьте данную ссылку в поле "Дополнительные ссылки для Менеджера плат":
|
||||
`https://elron.tech/files/package_elbear_beta_index.json`
|
||||
|
||||
4. Откройте меню `Инструменты -> Плата -> Менеджер плат...`.
|
||||
5. В поиске найдите пакет `MIK32 Boards (Arduino BSP by Elron)`, выберите нужную версию пакета и нажмите кнопку `Установить`.
|
||||
|
||||
6. Процесс установки может занять некоторое время. Результаты установки отобразятся в поле `Вывод`, а так же во всплывающих уведомлениях.
|
||||
|
||||
|
||||
## Запись начального загрузчика через ArduinoIDE
|
||||
Для загрузки скетчей по USB в ArduinoIDE необходимо, чтобы на плате был специальный начальный загрузчик ([elbear_fw_bootloader](https://gitflic.ru/project/elron-tech/elbear_fw_bootloader) для плат Elbear Ace-Uno). Если он уже есть на плате, можно сразу переходить к работе. Если загрузчика еще нет или необходимо обновить его на плате, ниже описан процесс загрузки. Актуальная версия начального загрузчика входит в состав пакета поддержки для всех плат, отдельно скачивать его не нужно.
|
||||
|
||||
Платы Elbear Ace-Uno ревизии 1.1.0 готовы к использованию в ArduinoIDE из коробки, так как поставляются с предварительно записанным начальным загрузчиком.
|
||||
|
||||
Для записи начального загрузчика:
|
||||
1. Подключите плату к ПК по интерфейсу JTAG.
|
||||
Для подключения платы Elbear Ace-Uno потребуется программатор [ELJTAG](https://elron.tech/eljtag-programmator-risc-v-mcu/).
|
||||
Для подключения платы START-MIK32 необходимо перевести переключатель режима программатора в положение JTAG и подключить плату к ПК через USB разъем.
|
||||
2. В ArduinoIDE выберите программатор: `Инструменты -> Программатор -> mik32 uploader`.
|
||||
3. Для записи начального загрузчика выберите `Инструменты -> Записать Загрузчик`.
|
||||
|
||||
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.
|
||||
|
||||
## Начало работы
|
||||
1. Подключите плату к ПК по USB.
|
||||
2. Откройте ArduinoIDE и загрузите необходимый скетч. Для начала работы можно воспользоваться готовыми примерами, например - `Файл -> Примеры -> 01.Basics -> Blink`.
|
||||
|
||||
3. Выберите активную плату - `Инструменты -> Плата`.
|
||||
|
||||
4. Выберите используемый COM порт - `Инструменты -> Порт`.
|
||||
|
||||
Выбранные плата и порт в ArduinoIDE должны отображаться следующим образом:
|
||||
|
||||
5. Проверьте скетч, нажав соответствующую кнопку.
|
||||
|
||||
6. Загрузите полученную прошивку на плату.
|
||||
|
||||
7. При необходимости можно открыть терминал и получать сообщения от платы по интерфейсу Serial. Для этого добавьте в скетч работу с интерфейсом и после загрузки прошивки выберите `Инструменты -> Монитор порта`.
|
||||
|
||||
|
Before Width: | Height: | Size: 79 KiB After Width: | Height: | Size: 61 KiB |
|
Before Width: | Height: | Size: 33 KiB After Width: | Height: | Size: 32 KiB |
|
Before Width: | Height: | Size: 87 KiB After Width: | Height: | Size: 95 KiB |
|
Before Width: | Height: | Size: 61 KiB After Width: | Height: | Size: 64 KiB |
|
After Width: | Height: | Size: 1.5 MiB |
@@ -0,0 +1,59 @@
|
||||
# START-MIK32
|
||||
Особенности работы с платой START-MIK32 в среде программирования ArduinoIDE.
|
||||
### Функциональное назначение выводов
|
||||
|
||||
|
||||
### Загрузка скетчей
|
||||
Для загрузки скетчей в ArduinoIDE необходимо передвинуть переключатель режима программатора на плате в положение `COM`. Так же необходимо установить две перемычки на разъем 5 - первой перемычкой замкнуть выводы `COM_RX` и `MCU_TX`, а второй - выводы `COM_TX` и `MCU_RX`.
|
||||
### Цифровые выводы
|
||||
Выводы на плате START-MIK32 пронумерованы в соответствии с их принадлежностью к определенному GPIO-порту и конкретному пину внутри порта. Чтобы использовать цифровой вывод, необходимо передать в функцию номер порта и номер пина в формате `P0_1`, где "0" — это номер порта, а "1" — номер пина внутри порта. Например, для инициализации вывода 5 порта 2 на выход необходимо вызвать функцию `pinMode(P2_5, OUTPUT)`.
|
||||
Для использования доступны следующие выводы: `P0_0 ... P0_15, P1_0 ... P1_15, P2_0 ... P2_7`.
|
||||
На плате есть встроенные светодиоды и кнопка. Светодиоды подключены к выводам P0_3, P1_3. Кнопка подключена к выводу Р0_8. Для удобства при работе с ними можно воспользоваться макросами `LED_BUILTIN`(P0_3), `LED_BUILTIN1`(P1_3) и `BTN_BUILTIN`, передавая их в качестве аргументов функции вместо номера цифрового вывода.
|
||||
### АЦП
|
||||
На плате доступно 8 выводов, которые можно использовать в качестве каналов АЦП. Для работы с ними в функцию `analogRead()` необходимо передать номер канала или номер соответствующего цифрового вывода. Доступные каналы и их соответствие номерам выводов платы:
|
||||
|
||||
|Цифровой вывод|Номер канала АЦП|
|
||||
|---------|---------|
|
||||
|P1_5|A0|
|
||||
|P1_7|A1|
|
||||
|P0_2|A2|
|
||||
|P0_4|A3|
|
||||
|P0_7|A4|
|
||||
|P0_9|A5|
|
||||
|P0_11|A6|
|
||||
|P0_13|A7|
|
||||
#### ШИМ
|
||||
На плате START-MIK32 в ArduinoIDE доступно 8 выводов для формирования ШИМ-сигнала. Генерация сигнала осуществляется с помощью 32-битного таймера. Выводы, подключенные к одному и тому же таймеру, выдают ШИМ-сигнал одинаковой частоты.
|
||||
Доступные выводы:
|
||||
|
||||
|Цифровой вывод|Используемый таймер|
|
||||
|---------|---------|
|
||||
|P0_0|таймер 1|
|
||||
|P0_1|таймер 1|
|
||||
|P0_2|таймер 1|
|
||||
|P0_3|таймер 1|
|
||||
|P1_0|таймер 2|
|
||||
|P1_1|таймер 2|
|
||||
|P1_2|таймер 2|
|
||||
|P1_3|таймер 2|
|
||||
|
||||
При использовании SPI формирование ШИМ сигнала на выводах P1_0 ... P1_3 недоступно.
|
||||
### Прерывания
|
||||
На плате START-MIK32 доступно 8 прерываний, настраиваемых функцией `void attachInterrupt(uint8_t interruptNum, void (*userFunc)(void), int mode)`:
|
||||
|
||||
|Цифровой вывод|Номер прерывания|
|
||||
|---------|---------|
|
||||
|`BTN_BUILTIN` (P0_8)|0|
|
||||
|P1_9|1|
|
||||
|P0_10|2|
|
||||
|P1_15|3|
|
||||
|P0_12|4|
|
||||
|P0_13|5|
|
||||
|P0_14|6|
|
||||
|P0_15|7|
|
||||
|
||||
### Serial
|
||||
Интерфейс UART0 доступен на выводах P0_5, P0_6, для работы с ним используется экземпляр класса под названием `Serial`.
|
||||
Интерфейс UART1 доступен на выводах P1_8, P1_9, используемый экземпляр класса - `Serial1`.
|
||||
USB-UART преобразователь, установленный на плате, поддерживает стандартные скорости UART до 57600 бод. Нестандартные скорости должны быть кратны
|
||||
12*32=384, например, 240000 бод, 768000 бод.
|
||||