From 723732fb2d9bcc1e9ac9345c1759b2796cd8f260 Mon Sep 17 00:00:00 2001 From: klassents Date: Tue, 24 Dec 2024 11:14:58 +0700 Subject: [PATCH] =?UTF-8?q?=D1=84=D0=B0=D0=B9=D0=BB=D1=8B=20=D0=BE=D0=BF?= =?UTF-8?q?=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D0=B9=20=D0=BF=D0=B5=D1=80=D0=B5?= =?UTF-8?q?=D0=BD=D0=B5=D1=81=D0=B5=D0=BD=D1=8B=20=D0=B2=20=D0=BF=D0=B0?= =?UTF-8?q?=D0=BF=D0=BA=D1=83=20docs?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 6 ++-- Start_mik32_description.md | 1 - .../Elbear_description.md | 2 +- Instructions.md => docs/Instructions.md | 22 +++++++------- docs/Start_mik32_description.md | 29 +++++++++++++++++++ 5 files changed, 44 insertions(+), 16 deletions(-) delete mode 100644 Start_mik32_description.md rename Elbear_description.md => docs/Elbear_description.md (98%) rename Instructions.md => docs/Instructions.md (90%) create mode 100644 docs/Start_mik32_description.md diff --git a/README.md b/README.md index 4e1d867..8724773 100644 --- a/README.md +++ b/README.md @@ -4,12 +4,12 @@ ## Установка пакета в ArduinoIDE Для установки пакета в параметрах ArduinoIDE необходимо добавить ссылку `https://elron.tech/files/package_elbear_beta_index.json` в поле "Дополнительные ссылки для Менеджера плат". -Подробные шаги по установке и начальной настройке описаны в [инструкции](./Instructions.md). +Подробные шаги по установке и начальной настройке описаны в [инструкции](./docs/Instructions.md). ## Платы, входящие в состав пакета Пакет включает в себя поддержку следующих плат: -- [Elbear Ace-Uno](./Elbear_description.md) 8 Mb / 16 Mb / 32 Mb -- [START-MIK32](./Start_mik32_description.md) +- [Elbear Ace-Uno](./docs/Elbear_description.md) 8 Mb / 16 Mb / 32 Mb +- [START-MIK32](./docs/Start_mik32_description.md) ## Особенности использования пакета в ArduinoIDE ### Цифровые выводы diff --git a/Start_mik32_description.md b/Start_mik32_description.md deleted file mode 100644 index 3e5126c..0000000 --- a/Start_mik32_description.md +++ /dev/null @@ -1 +0,0 @@ -new \ No newline at end of file diff --git a/Elbear_description.md b/docs/Elbear_description.md similarity index 98% rename from Elbear_description.md rename to docs/Elbear_description.md index c5dd401..a3fc107 100644 --- a/Elbear_description.md +++ b/docs/Elbear_description.md @@ -1,7 +1,7 @@ # Elbear Ace-Uno Особенности работы с платами Elbear Ace-Uno в среде программирования ArduinoIDE. ### Функциональное назначение выводов -![Pinout](docs/pinout.PNG) +![Pinout](pinout.PNG) ### Цифровые выводы На плате Elbear Ace-Uno доступны встроенные светодиод и кнопка. Для их использования необходимо воспользоваться макросами `LED_BUILTIN` и `BTN_BUILTIN`, передавая их в качестве аргументов функции вместо номера цифрового вывода. Макросу `LED_BUILTIN` соответствует номер вывода D22, а макросу `BTN_BUILTIN` - D23. #### ШИМ diff --git a/Instructions.md b/docs/Instructions.md similarity index 90% rename from Instructions.md rename to docs/Instructions.md index 17f5d0c..58f08e2 100644 --- a/Instructions.md +++ b/docs/Instructions.md @@ -3,12 +3,12 @@ 2. Откройте меню `Файл -> Параметры`. 3. Вставьте данную ссылку в поле "Дополнительные ссылки для Менеджера плат": `https://elron.tech/files/package_elbear_beta_index.json` -![Add_board](docs/Add_board.PNG) +![Add_board](Add_board.PNG) 4. Откройте меню `Инструменты -> Плата -> Менеджер плат...`. 5. В поиске найдите плату `Elbear Ace-Uno`, выберите нужную версию и нажмите кнопку `Установить`. -![Install_board](docs/Install_board.PNG) +![Install_board](Install_board.PNG) 6. Процесс установки может занять некоторое время. Результаты установки отобразятся в поле `Вывод`, а так же во всплывающих уведомлениях. -![Installation_process](docs/Installation_process.PNG) +![Installation_process](Installation_process.PNG) Для загрузки скетчей по USB в ArduinoIDE необходимо, чтобы на плате Elbear Ace-Uno был специальный начальный загрузчик ([elbear_fw_bootloader](https://gitflic.ru/project/elron-tech/elbear_fw_bootloader)). Если он уже есть на плате, можно сразу переходить к работе. Если загрузчика еще нет или необходимо обновить его на плате, ниже описан процесс загрузки. Актуальная версия начального загрузчика входит в состав пакета поддержки, отдельно скачивать его не нужно. @@ -18,23 +18,23 @@ 1. Подключите плату Elbear Ace-Uno к ПК через программатор ELJTAG. 2. В ArduinoIDE выберите программатор: `Инструменты -> Программатор -> mik32 uploader`. 3. Для записи начального загрузчика выберите `Инструменты -> Записать Загрузчик`. -![Bootloader](docs/Bootloader.png) +![Bootloader](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) +![Blink_example](Blink_example.png) 3. Выберите активную плату - `Инструменты -> Плата`. -![Set_board](docs/Set_board.png) +![Set_board](Set_board.png) 4. Выберите используемый COM порт - `Инструменты -> Порт`. -![Set_port](docs/Set_port.png) +![Set_port](Set_port.png) Выбранные плата и порт в ArduinoIDE должны отображаться следующим образом: -![Selected_board_port](docs/Selected_board_port.png) +![Selected_board_port](Selected_board_port.png) 5. Проверьте скетч, нажав соответствующую кнопку. -![Build_project](docs/Build_project.png) +![Build_project](Build_project.png) 6. Загрузите полученную прошивку на плату. -![Flash_project](docs/Flash_project.png) +![Flash_project](Flash_project.png) 7. При необходимости можно открыть терминал и получать сообщения от платы по интерфейсу Serial. Для этого добавьте в скетч работу с интерфейсом и после загрузки прошивки выберите `Инструменты -> Монитор порта`. -![Monitor](docs/Monitor.png) \ No newline at end of file +![Monitor](Monitor.png) \ No newline at end of file diff --git a/docs/Start_mik32_description.md b/docs/Start_mik32_description.md new file mode 100644 index 0000000..ac93f46 --- /dev/null +++ b/docs/Start_mik32_description.md @@ -0,0 +1,29 @@ +# START-MIK32 +Особенности работы с платой START-MIK32 в среде программирования ArduinoIDE. +### Функциональное назначение выводов +![Start_V1_pinout.png](docs/Start_V1_pinout.png) + +### Загрузка скетчей +todo описать установку перемычек на плате +### Цифровые выводы +todo как номер вывода передавать в функции +На плате START-MIK32 доступны встроенные светодиоды и кнопка. Для их использования необходимо воспользоваться макросами `LED_BUILTIN` и `BTN_BUILTIN`, передавая их в качестве аргументов функции вместо номера цифрового вывода. Макросу `LED_BUILTIN` соответствует номер вывода D22, а макросу `BTN_BUILTIN` - D23. +#### ШИМ +На плате START-MIK32 доступны следующие выводы для формирования ШИМ-сигнала: D3, D5, D6, D9, D10, D11. Генерация сигнала осуществляется с помощью 32-битного таймера. Выводы D3, D5, D6, D9 подключены к таймеру 1, выводы D10, D11 подключены к таймеру 2. Выводы, подключенные к одному и тому же таймеру, выдают ШИМ-сигнал одинаковой частоты. +### Прерывания +На плате START-MIK32 доступно 8 прерываний, настраиваемых функцией `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 +Для работы доступно два последовательных интерфейса. Нулевой интерфейс доступен на выводах D0, D1, для работы с ним используется экземпляр класса под названием `Serial`. Нулевой интерфейс используется для вывода информации в Монитор порта в Arduino IDE. +Первый интерфейс доступен на выводах D7, D8, используемый экземпляр класса - `Serial1`. +todo доступные для работы скорости \ No newline at end of file