BearLogica

BearLogica - это среда визуального программирования для плат ELBEAR на базе MIK32 Амур от Микрон. Приложение позволяет собирать программу из графических блоков, преобразовывать её в код, совместимый с Arduino IDE, а также загружать полученный код на плату.
На данный момент приложение доступно для использоваиния только на ОС Windows.

Подготовка к использованию

1. Скачать zip-архив BearLogica...-win.zip из релизов и разархивировать его в папку на своем ПК.
2. Убедиться, что ПК имеет доступ в интернет.
3. В корне папки найти файл install_board.bat и запустить его двойным нажатием. Откроется окно установки пакета поддержки плат ELBEAR и необходимых библиотек. Необходимо дождаться, пока в окне не появится надпись Для продолжения нажмите любую клавишу..., на это потребуется некоторое время. В случае возникновения проблем с установкой необходимо обратиться к производителю.
   

Первый запуск

При первом запуске файлов BearLogica.exe, install_board.bat и update_board.bat операционная система Windows может отобразить предупреждение SmartScreen, так как файлы загружены из интернета. При появлении окна Защита Windows SmartScreen нажмите Дополнительные сведения и выберите Запустить в любом случае. После однократного подтверждения данное предупреждение больше не будет появляться, и вы сможете пользоваться программой в обычном режиме.

Установка драйвера

Для работы с платами ELBEAR по интерфейсу USB необходимо установить драйверы. Драйвер для вашей операционной системы можно найти на официальном сайте - драйвер для платы ELBEAR ACE-UNO, драйвер для платы ELBEAR ACE-NANO.

Использование

1. Для запуска приложения в папке необходимо найти файл BearLogica.exe и запустить его двойным нажатием. Откроется окно рабочей области.
   
2. В выпадающем меню (1) можно создать новый проект или загрузить уже созданный, сохранить текущий проект в файл, а так же сохранить текущий сгенерированный код в файл с расширением .ino, совместимый с ArduinoIDE.
   
3. По умолчанию для работы выбрана плата ELBEAR ACE-UNO 8Мб. Можно посмотреть краткое описание выбранной платы, нажав на кнопку “Список плат” (2) с изображением микросхемы.
   
4. Для создания программы необходимо выбрать блок из нужной категории (8) и перетащить его в рабочую область (9). При этом в редакторе кода (10) появится код, соответствующий этому блоку. Используя блоки из разных категорий, можно сформировать нужную программу.
5. Когда программа готова, ее нужно проверить, нажав кнопку (3). При этом в окне состояния (11) появится информация о ходе проверки. После окончания проверки, если ошибок нет, появится надпись Проверка: ОК.
6. После проверки программы ее можно загружать на плату. Для этого нужно подключить плату к ПК, в приложении нажать кнопку “Список COM портов”(4), выбрать порт, к которому подключена плата, и сохранить выбор.
   
7. После выбора порта нажать кнопку “Загрузить”(5) и подождать. Перед загрузкой программа еще раз проверяется на наличие ошибок и только после этого загружается на плату. В случае успешной загрузки в окне состояния (11) появится надпись Загрузка: ОК.
8. В приложении также доступен встроенный монитор порта, с помощью которого можно просматривать данные, поступающие от платы по последовательному порту, а также отправлять данные с компьютера на плату. Для работы с монитором необходимо нажать кнопку “Монитор порта” (6) – откроется новое окно. Для начала передачи данных в окне необходимо выбрать скорость передачи данных и нажать кнопку “Запустить”.
   
9. В настройках приложения (7) можно выбрать используемый язык, цветовую схему приложения, а так же отображаемые в рабочей области категории блоков.
   

Для быстрого старта можно использовать инструкцию по созданию примера моргания встроенного на плату светодиода или воспользоваться готовыми примерами из папки examples.

Сборка исполняемых файлов BearLogica

Информацию о сборке исполняемых файлов можно найти здесь.

Используемые инструменты

• Ace-Editor
• Arduino-CLI
• Electron
• Node SerialPort

Лицензия

Разработка проекта ведётся на основе объединения двух репозиториев:

• BlocklyDuino-v2, авторы Sébastien Canet и Fred Lin
• BlocklyDuino2Electron, автор Sébastien Canet

Оба проекта распространяются на условиях лицензии GNU General Public License v3.0.
В соответствии с условиями указанной лицензии, данный проект также распространяется под лицензией GPLv3. Вы можете свободно использовать, изменять и распространять данный проект при соблюдении условий лицензии GNU GPLv3. Полный текст лицензии доступен в файле LICENSE и на официальном сайте: https://www.gnu.org/licenses/gpl-3.0.html

В проекте используется следующий сторонний код:

• Blockly. Лицензия Apache License 2.0, репозиторий проекта - https://github.com/google/blockly
• STudio4Education. Лицензия BSD 3-Clause, репозиторий проекта - https://github.com/A-S-T-U-C-E/STudio4Education
• Arduino CLI — используется как бинарный инструмент. Лицензия GNU GPLv3,репозиторий проекта - https://github.com/arduino/arduino-cli

При распространении проекта необходимо сохранять уведомления о лицензиях и авторстве, относящиеся к используемому стороннему коду.

Полезные ссылки

• Материалы по платам ELBEAR
• Телеграмм-канал проекта
• Телеграмм-канал компании