CHANGELOG |

Деполитизированный форк проекта "огненной" лампы FireLamp_EmbUI.

Обсуждение и поддержка данной прошивки идет на форуме

• ESP8266 vs ESP32
• Схема подключения компонентов
• Как скачать/обновлять проект
• Сборка проекта
  • правильный способ
  • легкий способ
  • сборка
  • готовые сборки
  • Обновление и прошивка по воздуху (OTA-update)
• Управление
  • Управление кнопкой
  • Энкодер
  • Управление через HTTP/MQTT
  • служебные http запросы
• Настройки WebUI
• DFPlayer

Основная разработка ведется под контроллеры семейства esp32. ESP8266 морально устарел и поддерживается по остаточному принципу, категорически не рекоммендую использовать платы на 8266 для изготовления новых ламп! Последний стабильно работающий на контроллерах 8266 выпуск проекта - версия v3.1.1, исправления будут аккумулироваться в ветке legacy.

Актуальный срез проекта всегда можно скачать в виде zip-архива по ссылке, либо перейдя по ссылке последнего релиза.

Либо можно поддерживать клон репозитория и подтягивать обновления перед каждой новой сборкой. Открываем консоль Git-bash, клонируем репозиторий в текущую папку командой git clone --depth 1 --no-single-branch https://github.com/vortigont/FireLamp_JeeUI.git

В последующем для того чтобы обновить репозиторий достаточно перейти в папку проекта и выполнить команду git pull. Быстро переключаться между различными ветками проекта можно командами git switch master, git switch feat и т.п.

После того как вы скопировали проект (в виде zip архива или через git clone), необходимо в папке include скопировать файл user_config.h.default под новым именем user_config.h и в нем настроить сборку под свои параметры матрицы, номеров выводов и требуемых функций.

Проект собирается с помощью Platformio

Для сборки проекта понадобится следующее:

Установить IDE Visual Studio Code, и в качестве плагина к ней установить Platformio. О том как это сделать можно найти массу роликов на youtube, например этот.

Желательно еще установить Git, обновлять проект будет значительно проще.

для пользователей Windows OS можно использовать builder-скрипт. Билдер был изначально написан @kostyamat (за что ему спасибо), адаптирован под форк текущей комадой (@andy040670). Запускаете билдер и последовательно проходите шаги установки питона, гит, платформио, клонирование репозитория и сборку требуемого варианта прошивки.

• Открываем папку проекта в VSCode
• Что бы собрать прошивку, можно воспользоваться кнопками в нижней статусной строке:
  • PlatformIO:Build - собрать прошивку
  • PlatformIO:Upload - загрузить прошивку через USB в плату.

Platformio сам скачает необходимые библиотеки для сборки проекта. Убедитесь что верно выбрали необходимый профиль сборки - платформу esp32 или 8266, тип прошивки с отладкой или без.

Также можно открыть терминал с помощью клавиш Ctrl+Shit+` и воспользоваться расширенными командами для сборки проекта.

• pio run -t upload - собрать и записать в контроллер проект по умолчанию под платформу esp32
• pio run -e esp8266 -t upload - собрать и записать версию esp8266, будет собрана облегченная прошивка без вывода отладочных сообщений через serial интерфейс Рекомендуется для повседневного использования, если нет нужды отлаживать работу лампы
• pio run -e esp32debug -t upload - собрать и прошить версию esp32 с отладкой, будет собрана прошивка под esp32 c выводом отладочных сообщений через serial интерфейс
• pio run -e esp8266dev -t upload - собрать и прошить отладочную версию под esp8266
• pio deviсe monitor -e esp32 - запустить serial-монитор для просмотра сообщений, выдаваемых контроллером

Для работы лапмы нужно сформировать и залить в контроллер образ файловой системы. Выполняется это командой аналогично записи прошивки, но с параметром -t uploadfs, к примеру

• pio run -e esp32 -t uploadfs - записать в контроллер образ ФС под платформу esp32
• pio run -e esp8266 -t uploadfs - записать в контроллер образ ФС под платформу esp8266

После первой прошивки дальнейшие обновления можно заливать в контроллер по воздуху. Для этого нужно зайти браузером на контроллер по URL вида http://embui-xxxx/update, где xxxx это ID контроллера, нажать на кномку 'Firmware', выбрать файл с прошивкой и загрузить его в контроллер. Файл с прошивкой Platformio кладет в подпапки проекта:

• .pio/build/esp8266/firmware.bin - версия под esp8266
• .pio/build/esp32/firmware.bin - версия под esp32

Свежие сборки от тов. @andy040670 вместе с инструкцией по заливке с помощью esp flashdownload tool можно найти в этом сообщении.

Последующее обновление ПО можно осуществлять по воздуху, без подключения лампы кабелем. Можно обновить проект, собрать прошивку и залить полученный файл через форму обновления открыв лампу в браузере (напр. http://firelamp/upload), где firelamp это имя хоста или ip-адресс контроллера в сети. Так же можно воспользоваться скриптом для платформио, который автоматически зальет прошивку в лампу. Для этого нужно создать свой профиль сборки проекта и указать в нем адрес доступа к лампе.

• Создайте в каталоге проекта файл user_profile.ini
• скопируйте в файл пример секции ; OTA Upload example из файла platformio.ini
• раскомментируйте параметры, убрав ; в начале строк
• замените в параметре upload_port = http://firelamp/update имя устройства лампы на свое или на ip адрес
• если нужно собирать проект под esp8266 замените параметр extends = esp32 на extends = esp8266
• соберите и загрузите прошивку в лампу командой pio run -e ota -t upload

Набор звуковых файлов MP3-плеера для записи на sdcard с озвучками эффектов от @andy040670 - Soundpack. Архив нужно развернуть на флеш карточку и вставить в плеер. Архив запакован в формат 7z zstd, для распаковки использовать версию 7z с гитхаба. Либо ужатая версия от @dina, умещается на 2GiB карту.

параметры работы мп3-плеера:

• эффект вкл., плеер выкл. - воспроизводится звук эффектов (отдельная фоновая музыка под каждый эффект)
• эффект выкл., плеер выкл. - звука не будет, кроме звука времени и озвучивания эффектов (если задано)
• эффект выкл., плеер вкл. - звук будет для мп3 плеера, управление через кнопку "Еще" на основной странице, при смене эффекта звуковая дорожка не меняется
• эффект вкл., плеер вкл. - звук будет для мп3 плеера, управление через кнопку "Еще" на основной странице, плюс при смене эффекта вручную. Смена эффектов в режиме "Демо" не переключает дорожки