Инструкция по установке:
Порядок создания пользовательской конфигурации описан здесь: user_config.h , пример такого файла можно посмотреть тут .
Основные возможности прошивки:
Доп. возможности прошивки:
По поводу настройки WiFi - фреймворк позволяет переключать режим AP<->STA по удержанию кнопки "Flash" NodeMsu в течение 5 секунд. Если ее удерживать в течение 10 секунд, то произойдет сброс настроек. Если лампа не может подключиться к роутеру, то будет поднята AP c пустым паролем, а дальше после перехода по адресу http://192.168.4.1 вы сможете сконфирурировать WiFi, либо же можно дополнительно прописать креденшеналы в функции
parameters() файла interface.cpp . Если лампа подключилась к роутеру, то управлять ею можно по тому IP, что она получила от роутера.
История:
По состоянию на сегодня прошивка находится в стабильной стадии. Но я еще планирую реализовать дополнительный функционал. Интерфейс по большей мере вырисовался, выглядеть должно примерно так:
Вариант печатного корпуса для лампы можете посмотреть тут.
----------------------------------------
Можно ли копировать, менять что-то по своему усмотрению? Да, естественно - лицензия GPLv3. Разрешено все, что оговаривается лицензией. Но учтите, что согласно лицензии вы обязуетесь предоставлять исходный код проектов основанных на данном, даже в случае коммерческого использования. Либо сразу (предпочтительно), либо по первому требованию любого из обратившихся. Если вас не устраивают идеи и соглашения свободного кода - выбирайте другой проект и не используйте этот.
Проект: скачать отсюда, фреймворк JeeUI2 переработан и взят отсюда , но он уже включен в проект, так что дополнительно качать не нужно.
1. Устанавливаем Visual Studio Code в зависимости от вашей операционной системы 32 или 64 битную версию.
2. Устанавливаем Git он тоже понадобится, так как Visual Studio Code на пару с PlatformIO будут ругаться что его им очень не хватает.
3. Перезагружаем компьютер.
4. Установить PlatformIO для этого запустить Visual Studio Code и в меню View выбрать пункт Extensions - либо воспользоваться сочетанием клавиш (Ctrl+Shift+X)
5. Выбрать PlatformIO IDE и нажать Install
6. Перезапустить Visual Studio Code у вас сразу откроется вкладка PIO Home, работаем в ней.
7. В вкладке Открыть проект - Open Project - заходим в папку с проектом и нажимаем Open "FireLamp_JeeUI-master"
8. Слева открываем Platformio.ini и делаем необходимые настройки, раскомментировать нужный board, это плата на которой вы собираете лампу, и закомментируйте ненужную.
9. Тут же нужно добавить настройки Com порта на котором у вас ваша плата, это делается командой upload_port = COM8 (где COM8 номер вашего порта COM2, COM3 и т.д.)
10. Останется настроить саму прошивку под себя это делается в include - config.h там все подробно откомментировано.
11. Первоначально вам необходимо будет записать файлы в ФС контроллера, иначе веб-интерфейс не будет доступен! Делается это так меню Terminal - Run Task.. (Ctrl+Alt+T) - PlatformIO - PlatformIO: Upload File System Image, если вы не забыли указать нужный Com порт и подключили плату все должно быть успешно.
12. Можно собирать и заливать прошивку в лампу. Делается это нажатием на PlatformIO Upload.
P.S. Если вы забудете выполнить 11 пункт то не сможете подключится к лампе, при подключении к ней она будет перезагружаться.
Способы обновления прошивки:
OTA - обновляется сама прошивка и есть возможность обновить File System Image как это описано выше, можно работать с лампой так как и по физическому подключению к COM порту без разбора и подключения проводом.
Для обновления прошивки по OTA нужно сделать изменения в файле PlatformIO.ini
1. Закомментировать по аналогии с другими строками и соблюдением пробелов, ваш COM порт.
2. Раскомментировать следующие строки, обратите внимание пробелы очень важны, если не соблюсти их будет выдаваться ошибка при запуске прошивки и она так и не начнется.
В строке с IP адресом, указать ваш адрес лампы.
C++:upload_protocol = espota upload_port = 192.168.1.36 upload_flags = --auth=12345 -p 3232
Перед началом обновления, не забудьте перевести лампу в режим обновления PIO-ОТА, для http обновления (читать ниже) это делать не обязательно. Также убедитесь, что обновление прошивки через PIO разрешено дефайном в user_config.h
* внимание, для питона важны отступы (пробелы), так что внимательно выравнивайте на одном уровне
HTTP - обновление через web интерфейс, не стирает параметры, можно обновить только прошивку, обновление File System Image только из приложения или OTA
IP адрес лампы\update указываем файл firmware.bin
Нужно будет выбрать файл и нажать Update внизу в статусе браузера появятся проценты прогресса.
Для формирования файла firmware.bin нужно в PlatformIO запустить сборку прошивки без заливки.
После непродолжительной сборки прошивки, терминал выдаст ответ:
= [SUCCESS] =
файл будет находится в папке со скачанной прошивкой .pio\build\esp8266dev\
Я прошиваю после стирания:
Быстрый старт.
Что потребуется:
Visual Studio Code - скачиваем и устанавливаем, желательно перелогиниться или перезагрузиться, чтобы точно применились настройки путей.
Под VS Code устанавливается PlatformIO, дальше вся работа там. Если кому приятнее работать в ArduinoIDE - адаптируйте самостоятельно, у меня терпения не хватает ждать пока там все соберется, так что мне проще в PlatformIO все делать.
Проект: скачать отсюда, фреймворк JeeUI2 переработан и взят отсюда , но он уже включен в проект, так что дополнительно качать не нужно.
Внимание! : фреймворк существенно переработан, т.к. в исходном состоянии он к использованию малопригоден, к сожалению. Актуальная версия всегда в проекте, в форке обновляю реже.
В общем у вас после открытия проекта должно выглядеть как-то так:
Контроллер ESP8266/ESP32 выбирается в файле platformio.ini.
ВНИМАНИЕ: Первоначально вам необходимо будет записать файлы в ФС контроллера, иначе веб-интерфейс не будет доступен!
Делается это так: PlatformIO->Run Task...->Upload File System Image
После этого можно собирать проект и записывать его в контроллер. Сами файлы для загрузки в ФС находятся в \FireLamp_JeeUI\data там же у меня находятся и файлы конфигурации config.json и eff_config.json . Вы также можете поместить свои предварительно созданные конфигурации, если это необходимо. Также к файловой системе можно получить доступ, если при компиляции проекта была раскомментирована настройка:
//#define USE_FTP // доступ к SPIFFS по FTP, логин/пароль: esp8266
После чего вы можете подключиться фтп-клиентом и скачать/записать то, что вам нужно.
---------------------
Что потребуется:
Visual Studio Code - скачиваем и устанавливаем, желательно перелогиниться или перезагрузиться, чтобы точно применились настройки путей.
Под VS Code устанавливается PlatformIO, дальше вся работа там. Если кому приятнее работать в ArduinoIDE - адаптируйте самостоятельно, у меня терпения не хватает ждать пока там все соберется, так что мне проще в PlatformIO все делать.
Проект: скачать отсюда, фреймворк JeeUI2 переработан и взят отсюда , но он уже включен в проект, так что дополнительно качать не нужно.
Внимание! : фреймворк существенно переработан, т.к. в исходном состоянии он к использованию малопригоден, к сожалению. Актуальная версия всегда в проекте, в форке обновляю реже.
В общем у вас после открытия проекта должно выглядеть как-то так:
Контроллер ESP8266/ESP32 выбирается в файле platformio.ini.
ВНИМАНИЕ: Первоначально вам необходимо будет записать файлы в ФС контроллера, иначе веб-интерфейс не будет доступен!
Делается это так: PlatformIO->Run Task...->Upload File System Image
После этого можно собирать проект и записывать его в контроллер. Сами файлы для загрузки в ФС находятся в \FireLamp_JeeUI\data там же у меня находятся и файлы конфигурации config.json и eff_config.json . Вы также можете поместить свои предварительно созданные конфигурации, если это необходимо. Также к файловой системе можно получить доступ, если при компиляции проекта была раскомментирована настройка:
//#define USE_FTP // доступ к SPIFFS по FTP, логин/пароль: esp8266
После чего вы можете подключиться фтп-клиентом и скачать/записать то, что вам нужно.
---------------------
Кнопки по сборке проекта, включению вывода сообщений отладчика, очистке проекта от объектных файлов, остановке задач и т.д. находятся внизу, слева:
Порядок создания пользовательской конфигурации описан здесь: user_config.h , пример такого файла можно посмотреть тут .
По кнопке:
* Из выключенного состояния
- 1 касание - включить на последнем эффекте
- 2 касания - включить в режиме ДЕМО
- долгое удержание - включить в режиме "белая лампа" на максимальную яркость
- касание, удержание - включить в режиме "белая лампа" на минимальную яркость (ночник)
* Во включенном состоянии
- 1 касание - выключить лампу
- 2 касания - следующий эффект
- 3 касания - предыдущий эффект
- 4 касания + 4 касания - запуск сервиса ОТА
- 5 касаний - вывод IP на лампу
- 6 касаний - вывод текущего времени бегущей строкой
- удержание - регулировка яркости
- 1 касание, удержание - регулировка "скорости" эффекта
- 2 касания, удержание - регулировка "масштаба" эффекта
* Из выключенного состояния
- 1 касание - включить на последнем эффекте
- 2 касания - включить в режиме ДЕМО
- долгое удержание - включить в режиме "белая лампа" на максимальную яркость
- касание, удержание - включить в режиме "белая лампа" на минимальную яркость (ночник)
* Во включенном состоянии
- 1 касание - выключить лампу
- 2 касания - следующий эффект
- 3 касания - предыдущий эффект
- 4 касания + 4 касания - запуск сервиса ОТА
- 5 касаний - вывод IP на лампу
- 6 касаний - вывод текущего времени бегущей строкой
- удержание - регулировка яркости
- 1 касание, удержание - регулировка "скорости" эффекта
- 2 касания, удержание - регулировка "масштаба" эффекта
По HTTP
команды можно посылать на лампу через браузер или curl по URL вида http://esp-xxxxxx/cmd?arg=param
- /cmd?on /cmd?off - вкл/выкл
- /cmd?demo - режим ДЕМО
- /cmd?msg=Hello - вывод сообщения на лампу
- /cmd?bright=0-255 - яркость
- /cmd?speed=0-255 - скорость
- /cmd?scale=0-255 - шкала
- /cmd?effect=N - эффект номер N
- /cmd?move_next - следующий эффект
- /cmd?move_prev - предыдущий эффект
- /cmd?move_rnd - случайный эффект
- /cmd?reboot - перезагрузить лампу
- /cmd?OTA - запустить сервер обновления OTA через PIO
Дополнительные служебные комманды:
- /heap - показать свободное место на куче
- /echo - показать эхо-ответ (json для формирования интерфейса)
- /config - показать текущий конфиг (json основных настроек)
- /scan - показать доступные WiFi-сети
- /eff_config.json - скачать активный конфиг эффектов
- /config.json - скачать активный конфиг лампы
- /events_config.json - скачать активный конфиг событий
- /update - форма http-обновления прошивки
команды можно посылать на лампу через браузер или curl по URL вида http://esp-xxxxxx/cmd?arg=param
- /cmd?on /cmd?off - вкл/выкл
- /cmd?demo - режим ДЕМО
- /cmd?msg=Hello - вывод сообщения на лампу
- /cmd?bright=0-255 - яркость
- /cmd?speed=0-255 - скорость
- /cmd?scale=0-255 - шкала
- /cmd?effect=N - эффект номер N
- /cmd?move_next - следующий эффект
- /cmd?move_prev - предыдущий эффект
- /cmd?move_rnd - случайный эффект
- /cmd?reboot - перезагрузить лампу
- /cmd?OTA - запустить сервер обновления OTA через PIO
Дополнительные служебные комманды:
- /heap - показать свободное место на куче
- /echo - показать эхо-ответ (json для формирования интерфейса)
- /config - показать текущий конфиг (json основных настроек)
- /scan - показать доступные WiFi-сети
- /eff_config.json - скачать активный конфиг эффектов
- /config.json - скачать активный конфиг лампы
- /events_config.json - скачать активный конфиг событий
- /update - форма http-обновления прошивки
Основные возможности прошивки:
- Повторяет все возможности других прошивок по управлению эффектами
- Включение, выключение, выбор эффекта, смена яркости/скорости/масштаба
- DEMO-режим
- Управление по MQTT , подробную инструкцию по установке и настройке можете почитать тут или посмотреть видео установки брокера
- Отправка текстовых сообщений на лампу, в том числе специальных %IP, %TM
- Настройка и вывод времени, само время синхронизуется по http/ntp или может задаваться вручную
- Периодический вывод времени и/или новогоднего отсчета
- OTA в двух вариантах, при обновлении файловой системы, чтобы не терять настройки можете их сохранить и поместить в папку /data .
- Управление кнопкой, индикаторы управления
- Добавить дополнительный ползунок можно так : [{'R':'127'}], делается это однократно и на текущий момент работает для дыма и мерцания
- Подключение микрофона элементарное: +3.3В с ESP на Vdd микрофона, землю (GND) на землю, сигнальный (Out) микрофона на пин А0. На этом все
- Возможно менять состояние произвольного пина/пинов (HIGH/LOW/TOGGLE) по событию. Строка настройки вида: [{'pin':1,'act':'H'}], допустимые варианты 'H'==HIGH, 'L'==LOW, 'T'==TOGGLE, также можно записать список, к примеруЖ [{'pin':1,'act':'H'},{'pin':2,'act':'L'},{'pin':3,'act':'T'}] - 1 установит в HIGH, 2 в LOW, 3 - переключит.
Доп. возможности прошивки:
- Есть возможность ставить множественные будильники и прочие автоматизации
- Добавлен микрофон и цветомузыка на основе амплитуды/частоты. Добавлен эффект "Частотный анализатор"
- Поддержка http-команд
- Пользовательский интерфейс всегда актуален и синхронизирован с прошивкой, т.к. является частью прошивки
- Если будет написано приложение под андроид/иос/... то оно тоже будет синхронизировано, т.к. интерфейс конструируется динамически
По поводу настройки WiFi - фреймворк позволяет переключать режим AP<->STA по удержанию кнопки "Flash" NodeMsu в течение 5 секунд. Если ее удерживать в течение 10 секунд, то произойдет сброс настроек. Если лампа не может подключиться к роутеру, то будет поднята AP c пустым паролем, а дальше после перехода по адресу http://192.168.4.1 вы сможете сконфирурировать WiFi, либо же можно дополнительно прописать креденшеналы в функции
parameters() файла interface.cpp . Если лампа подключилась к роутеру, то управлять ею можно по тому IP, что она получила от роутера.
История:
- старт с нуля
- перенесены изменения с прошлого проекта
- перенесены эффекты со старых проектов и добавлены новые, общий список - более 30 штук
- перенесен весь функционал
- часы реального времени
- вывод звука
- поддежка мосфетов для автоматизаций
- возможность локализации
- приложение
По состоянию на сегодня прошивка находится в стабильной стадии. Но я еще планирую реализовать дополнительный функционал. Интерфейс по большей мере вырисовался, выглядеть должно примерно так:
Вариант печатного корпуса для лампы можете посмотреть тут.
----------------------------------------
Можно ли копировать, менять что-то по своему усмотрению? Да, естественно - лицензия GPLv3. Разрешено все, что оговаривается лицензией. Но учтите, что согласно лицензии вы обязуетесь предоставлять исходный код проектов основанных на данном, даже в случае коммерческого использования. Либо сразу (предпочтительно), либо по первому требованию любого из обратившихся. Если вас не устраивают идеи и соглашения свободного кода - выбирайте другой проект и не используйте этот.
Последнее редактирование:
