Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/serhiile/clock-ws2812b

Clock based on ws2812b 32x8 RGB matrix
https://github.com/serhiile/clock-ws2812b

esp32 esp32-c3 esp32-platformio esp32-s3 esp8266 nodemcu-esp8266 platformio rcwl-0516 ws2812b

Last synced: about 1 month ago
JSON representation

Clock based on ws2812b 32x8 RGB matrix

Awesome Lists containing this project

README 

        
# Часы на основе матрицы на адресных светодиодах



Работает на платформах ESP8266 и ESP32 (ESP32, ESP32-s2, -s3, -c3).



Создано по мотивам проекта [GyverMatrixOS](https://alexgyver.ru/gyvermatrixbt/)

и его портированной на ESP-8266 версии [GyverMatrixWiFi](https://github.com/vvip-68/GyverMatrixWiFi/).

К сожалению эти проекты не для работы в обычном, нудном, режиме часов. В результате появился этот проект.

Есть ещё развития проекта [GyverLamp](https://github.com/AlexGyver/GyverLamp) / [GyverPanelWiFi](https://github.com/vvip-68/GyverPanelWiFi/wiki) / [FireLamp](https://github.com/DmytroKorniienko/FireLamp_JeeUI), но у каждого есть свои нюансы, свои преимущества и недостатки, по этому - больше разных велосипедов!

В описаниях этих проектов есть много полезной информации по подключению, сборке как железной части, так и программной, полезно заглянуть на эти странички.

Отдельное спасибо [vvip-68](https://github.com/vvip-68), хоть я и не использовал его код, но большое число вспомогательных материалов и описаний очень помогли мне.  

(UPD. Как я недавно выяснил эти все проекты вышли из "лампы на адресных светодиодах", по этому они и делают то на что изначально спроектированы - светят.

Даже если матрицу развернули и придали форму панели или бегущей строки и нагрузили тонной дополнительных функций.)



В данный момент переношу некоторые наработки из своего проекта [маленьких настольных часов](https://github.com/SerhiiLe/Clock_Mini).



## Возможности часов



- Показывать время

- Выбор цветового оформления часов.

- Выбор из нескольких циферблатов.

- Выбор режима 12/24 часа.

- Несколько будильников, которые можно настраивать на однократно, постоянный повтор или по дням недели.

- Выбор мелодии для каждого будильника.

- Бегущая строка - информатор. Несколько штук, для каждой можно настроить цветовое оформление и режим повтора.

- Возможно получение температуры, давления, влажности с помощью модулей BMP180/BMP280/BME280/AH10/AH20.

- Возможна установка модуля часов DS1307/DS3231.

- Резервное аккумуляторное питание. Во время пропадания основного питания экран включается только при срабатывании датчика движения.

- Использование датчика движения для информировании о постороннем присутствии (как датчик сигнализации) с отправкой уведомления в телеграмм.

- Использование датчика освещения как датчик сигнализации (резкое изменение освещения).

- Управление через Web. "Охранные" функции можно использовать через телеграмм.

- Подключение внешних датчиков и управление ими через через телеграмм.

- Автоматическое управление яркостью матрицы по освещённости. (экономит электричество и не режет глаза ночью)

- Возможность менять яркость матрицы по времени, в том числе по восходу/заходу солнца.

- Ограничение максимального потребления. Ночью потребление в автоматическом режиме снижается до 2,5Вт. Днём зависит от настроек и может достигать 70Вт. Ограничение по умолчанию - 12,5Вт.

- Минимальное число параметров жестко прописано в коде, большая часть настроек изменяется через Web.



## Управление



Управление часами только через Web, так как бессмысленно управлять кучей опций парой кнопок. Однако есть одна кнопка и датчик движения. Датчик движения

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



- Показать дату в длинном формате, отключить будильник, отключить проверку матрицы.

- Включить проверку матрицы.

- Показать текущий IP, по которому можно подключится к часам.

- Показать текущие значения освещённости.

- Сбросить пароль на Web страничку.



Долгое нажатие - справка. Она контекстная, зависит от текущего режима.



## Особенности



Проект делался под конкретные часы в конкретном месте по этому схема может выглядеть перегруженной, слишком сложной.

При желании схему можно сократить только до одной матрицы, отключив DFPlayer и датчик питания в настройках, выставляя

уровень яркости в настройках, и даже кнопка не сильно нужна, ведь будильник и так не будет работать. Получатся максимально скучные часы. Обязательно в файле include/defines.h надо настроить под себя, меняя или закомментировав ненужные опции, комментарии

для этого имеются. Тогда часы будут работать хорошо, без ругани на отсутствующие оборудование и без сюрпризов.



Если нет модуля часов реального времени и интернета, то время не установится после включения, но подключившись по WiFi можно ввести время вручную.

Если нет ни WiFi, нни модуля часов реального времени, то часы работать не будут! Как вариант, можно временно включить в телефоне точку доступа WiFi, подключить к ней часы и таким образом выставить время.

Автоматический переход зимнее/летнее время работает только вместе с получением погоды из Internet. Если погода не настроена или отключена, то переход на летнее/зимнее время надо будет делать вручную, ставя соответствующую галочку в настройках.



Можно создать кнопку-ярлык на экране смартфона или даже создать "приложение chrome". Но есть нюанс. Иконка всегда подхватывается только в firefox,

а в броузерах родственниках chrome может подхватится, может нет, может в высоком качестве, может в низком...



IP адрес только автоматический. Не вижу смысла делать ручной ввод IP, если проще сделать его статическим в настройках роутера. При желании его

всегда можно посмотреть три раза нажав на кнопку. А ещё можно зайти в настройки часов по адресу http://clock.local



Модуль MP3 (dfPlayer) иногда, очень редко, может перестать работать очень необычным образом - с точки зрения контроллера всё хорошо, команды отрабатываются, обратная связь есть, а звука нет. Как определить такой момент я не знаю. Привести в чувство можно или полной перезагрузкой часов или переключая режимы повтора в "мелодиях", пока модуль сам не перезагрузится. После долгого простоя медленно "запускается", по этому будильник начинает звонить +20/+90 секунд с момента активации. Скорее всего мне

попалась очередная китайская копия платы и с оригинальной таких проблем нет. (UPDATE) Оказалось, что я был прав, чипы бывают в этом модуле такие: GD3200B, YX5200-24, AB23A797393.1-74, AB23A795250.1-74, AA19HFF859-94, TD5580A, AS21CN27OC, MH2024K-16SS, MH2024K-24SS. В моём случае MH2024K-16SS. Именно с ним проблемы у всех. [Вот библиотека](https://github.com/Makuna/DFMiniMp3), которая работает с этим чипом. Я в ней сделал небольшие правки, чтобы она заработала с EspSoftwareSerial, который намного стабильнее обычного SoftwareSerial, [лежит тут](https://github.com/SerhiiLe/DFMiniMp3E). Теперь должно работать с большинством чипов, но надо подобрать два параметра в include/defines.h Кроме того, например модули на чипе MH2024K-24SS имеют подтянутые к +3.3V RX и TX, из-за чего esp8266 не может запуститься, для обхода этой проблемы понадобится добавить эмиттерный повторитель на pnp транзисторе. Смотрите [варианты схем](https://github.com/SerhiiLe/clock-esp8266-ws2812b/blob/main/clock_diagram.pdf). Для плат на ESP32/ESP32c3 это не критично, можно подключать только через резисторы.



В оригинальной схеме матрица подключена так-же через эмиттерный повторитель, но по другой причине, матрица может питаться с двух источников питания - сетевой адаптер или аккумулятор. Повторитель выравнивает напряжение питания и логический сигнал управления. Если резервное питание не планируется реализовывать, то ни реле ни этот транзистор не нужны, только защитный резистор ~470 Om.



Датчик движения RCWL-0516 удобен тем, что имеет хорошую чувствительность и его легко спрятать внутри корпуса. Но проблема в том, что если часы находятся на стене,

то может срабатывать на соседей, за стеной. Если планируется использовать именно как датчик сигнализации, то есть смысл пожертвовать внешним видом и поставить

более распространённый инфракрасный датчик, код менять не надо.  

(UPD) Как оказалось, ложные срабатывания имеет и инфракрасный датчик, например, если яркое солнце будет периодически скрываться за тучками в ветреную погоду, то PIR датчик воспринимает это как движение.



Реальный опыт эксплуатации показал, что модуль часов, например DS1307/DS3231, не лишний в часах, но его некуда было подключать, так как закончились выводы микроконтроллера ESP8266. Длительные операции, например опрос сети, отдача страничек, запуск MP3 - тормозят вывод времени на матрицу. Картинка замирает. По этому очень желательно делать часы на модуле с ESP32. Там и выводов больше и два ядра, на одно выносятся все длительные операции, второе остаётся только для отображения времени. Но, как показала практика, ESP32c3 даже с одним, не самым быстрым ядром показывает чудеса плавности. И ножек там достаточно для всей периферии. На данный момент этот чип я считаю оптимальным для реализации часов. Так-же можно использовать любой микроконтроллер платформы ESP32, но тестировал только ESP8266/ESP32/ESP32c3, могут быть сюрпризы.  

(UPD) Возможна альтернативная схема для ESP8266 с модулем часов реального времени и барометра, подробнее в include/defines.h



Кнопка TTP223B как оказалось любит жить собственной жизнью и очень зависит от перепадов питающего напряжения.



## Схема



[![Схема тут.](https://github.com/SerhiiLe/clock-esp8266-ws2812b/blob/main/clock_diagram.png)](https://github.com/SerhiiLe/clock-esp8266-ws2812b/blob/main/clock_diagram.pdf)



Примечания к схеме:



- Схем несколько! Зависит от того будут датчики на шине i2c (bmp/bme/aht/ds), или нет. Надо уточнять по настройкам в include/defines.h.

- Керамический конденсатор на 47пФ на питании датчика движения. Я не уверен, что он там нужен, впаял, в надежде улучшить стабильность срабатывания. Разницы не почувствовал.

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

- Номинал резистора в паре с фоторезистором я изначально взял из схем других проектов и был не прав. Напряжение на ногу А0 должно поступать 0-3.3V, 1кОм это мало. Для моего фоторезистора оказалось оптимальным 2кОм - 2.2кОм, иначе значения получаются слишком заниженными. А если больше, то чувствительность слишком большая.

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

- Звук имеет нормальную громкость, если отодвинуть корпус часов примерно на 5мм. На фото видны "ножки", которые и для крепёжа и для отодвигания от стенки. Желательно проклеить по периметру динамик к корпусу, это сильно повышает громкость.



Выглядит у меня примерно так:



![front](https://github.com/SerhiiLe/clock-esp8266-ws2812b/blob/main/clock_f.jpg)

![back](https://github.com/SerhiiLe/clock-esp8266-ws2812b/blob/main/clock_b.jpg)



(сборка не мой конёк, нож + термоклей не дадут шедевр эстетики)



[8x32 RGB WS2812B](https://ledplus.com.ua/ua/p1416606496-svetodiodnaya-matritsa-adresnaya.html),

[3PIN M/F](https://ledplus.com.ua/ua/p1511573942-konnektor-3pin-provodami.html),

[WiFi NodeMCU Lua V3](https://ledplus.com.ua/ua/p1013294902-modul-wifi-nodemcu.html) или [Wemos D1 mini](https://ledplus.com.ua/ua/p1162788418-plata-razrabotki-wemos.html),

[MP3-TF-16P](https://ledplus.com.ua/ua/p2348139220-modul-plejera-mp3.html),

[RCWL-0516](https://ledplus.com.ua/ua/p1259627889-datchik-dvizheniya-mikrovolnovyj.html),

[TTP223B](https://ledplus.com.ua/ua/p1121404110-modul-sensornaya-knopka.html),

[Модуль реле](https://ledplus.com.ua/ua/p1284992864-modul-rele-high.html),

[TP4056](https://ledplus.com.ua/ua/p1307577265-modul-zaryadki-tp4056.html),

[остальное](https://www.k206.net/catalog/)



## Сборка



Проект собирается с помощью [PlatformIO](https://platformio.org/)



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



Установить [IDE Visual Studio Code](https://code.visualstudio.com/), и в качестве плагина к ней установить [PlatformIO](https://platformio.org/). О том как это сделать можно найти массу роликов на youtube, например [этот](https://www.youtube.com/watch?v=NSljt17mg74). Чтобы в окне редактора не рябило от квадратиков, надо в настройках найти опцию "editor.unicodeHighlight.ambiguousCharacters" и снять галочку.



Скачать [архив](https://github.com/SerhiiLe/clock-esp8266-ws2812b/archive/refs/heads/main.zip) и распаковать его в папку проектов [PlatformIO](https://platformio.org/).

Где эта папка окажется в Вашей системе я не знаю. У меня к примеру это ~/Documents/PlatformIO/Projects/



Нужные библиотеки добавлены как зависимости и должны установится автоматически при первой сборке.



Возможно понадобится правка файла platformio.ini под Вашу систему.



Если Ваша схема отличается или хочется что-то подкрутить под себя, то это делается в файле include/defines.h Настройки по умолчанию, которые затем меняются в настройках в

WEB интерфейсе находятся в include/define_vars.h Рекомендую на время отладки включить опцию DEBUG.



Компиляция и загрузка в микроконтроллер нажатием на стрелочку "PlatformIO:Upload" в нижней статусной строке.



Создание и загрузка файловой системы: нажать на "голову муравья" слева (PlatformIO), выбрать пункт "Upload Filesystem Image". Так-же можно скопировать содержимое data/* через ftp. Поддерживается только пассивный режим в один поток, я пользуюсь Midnight Commander (mc).



При первом запуске появится WiFi точка доступа "ClockAP". После подключения телефоном должна открыться страничка настроек. Если нет, то зайти броузером на 192.168.4.1.

Затем выбрать свою WiFi сеть и ввести пароль. Часы должны подключится к WiFi. Посмотреть адрес, который получили часы можно сделав три клика по кнопке.

Для удобства можно добавить этот IP как статический в настройках роутера. Если параметры WiFi изменились, то один клик кнопки запускает первичную настройку WiFi по новой.



После сборки, обновлять прошивку можно по wifi через web. PlatformIO при сборке формирует файл прошивки, например у меня это: Documents/PlatformIO/Projects/Clock/.pio/build/esp8266/firmware.bin и файл файловой системы Documents/PlatformIO/Projects/Clock/.pio/build/esp8266/littlefs.bin



Если надо собрать под esp32, то надо переключить окружение на env:esp32, это в самом низу, рядом с кнопками компиляции, загрузки и терминала.



Настройка ножек для esp32 взята из расчёта, чтобы ножки соответствовали ножкам "WeMos D1 mini" (esp8266) и "WeMos D1 mini ESP32" [Распиновка esp32-d1-mini тут](https://templates.blakadder.com/wemos_D1_Mini_ESP32.html), отдельную схему не рисовал. Такой вариант позволяет пробовать оба микроконтроллера меняя их в панельке. В любом случае, всегда надо уточнять номера выводов на конкретной плате. А в случае полноценной ESP32 можно оптимизировать подключение ножек, например библиотека FastLED ругается, что матрица подключена не к аппаратному SPI. Но при использовании аппаратного SPI будет задействована только ножка MOSI, а MISO и SCK должны быть не подключенными, у esp8266 просто нет такой роскоши, а у ESP32 есть. Настройка ножек находится в include/defines.h



Если использовать модуль ESP32c3, то у него второй полноценный UART, и на 3 ножки больше. Это позволит в будущем добавить аппаратный модуль часов и датчики температуры, влажности, давления. А так-же измерять напряжение на аккумуляторе. Я рекомендую для сборки использовать ESP32c3 Supermini.



Сейчас профиль esp32 настроен на esp32 :) Чтобы собрать к примеру для esp32-s2 надо в секцию [env:esp32] добавить строчку:

board_build.mcu = esp32s2

PlatformIO само скачает нужные файлы платформы и обновит библиотеки. По аналогии можно указывать esp32s3 или другие из серии esp32. И не забыть поправить назначение выводов в include/defines.h



Под платформу esp32 используется своя карта flash, она рассчитана на микроконтроллеры с 4 Мбайт. Сборка с ArduinoIDE в принципе возможна, если собрать все файлы в один каталог и переименовать main.cpp в clock-ws2812b.ino Но не советую. PlatformIO само скачает все библиотеки и с формированием файловой системы проблем нет, а вот с ArduinoIDE это всё ручками.



## Внешние датчики



Для удобства управления разными устройствами реализован свой простейший протокол. Всё работает по http. Поиск устройств по MDNS. Настройки в разделе "Охрана".



- http://hostname/registration?pin=SHARED_SECRET&name=DEVICE_NAME - регистрация внешнего датчика. Время жизни регистрации задаётся в настройках.

- http://hostname/send?pin=SHARED_SECRET&msg=MESSAGE_TO_SEND - отправка произвольного сообщения в телеграмм.

- http://hostname/api?pin=SHARED_SECRET&COMMAND=... - адрес на внешнем датчике, который должен принимать команды.



## Отправка текста та экран



Можно отправить сообщение на экран обращением через Web (Дополнительно->Разовый текст) или из скрипта запросом в таком формате:



- http://hostname/show?msg=MESSAGE_TO_SEND - для разового показа сообщения.

- http://hostname/show?msg=MESSAGE_TO_SEND&cnt=XX - для показа сообщений XX раз каждые 30 секунд.

- http://hostname/show?msg=MESSAGE_TO_SEND&cnt=XX&int=YY - для показа сообщений XX раз c интервалом YY секунд.

- http://hostname/show?msg=MESSAGE_TO_SEND&cnt=XX&int=YY&due=FFF - для показа сообщений XX раз c интервалом YY секунд цветом FFF.

- http://hostname/show?help - подсказка по параметрам.



- http://hostname/who - отвечает названием часов.



Можно сокращать msg (text), cnt, int, due до m (t), c, i, d.

Обязательным является только msg (text), остальные параметры получат значения по умолчанию: 2 повтора, через 30 секунд, цвет "радуга".



## Изменения



- Исправлены все найденные за пол года реальной эксплуатации и раздражающие меня проблемы. Кроме нестабильной работы платы dfPlayer и срабатываний на соседей RCWL-0516.

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

- Настройки разбиты на две части, отдельно настройки часов, отдельно telegram, теперь они в разделе "охрана".

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

- Добавлена возможность подключать внешние датчики.

- Улучшена стабильность работы будильника.

- Портировал на ESP32, добавил выбор циферблатов.

- Перенёс наработки из своего проекта мини-часиков, отображение текущей погоды и случайных цитат.

- Упростил настройку будильников, почистил те проблемы, которые заметил.

- Синхронизировал порядок и названия циферблатов с проектом мини-часики. Добавил выбор 12/24 часа.

- Альтернативный вариант цвета текста "радуга" и "разные".

- Адаптация под актуальную версию [fastbot](https://github.com/GyverLibs/FastBot)

- Мелкие изменения, адаптация под esp32c3.

- Перенёс поддержку модулей измерения температуры/давления/влажности и модуля часов.

- Перешел на другую библиотеку для dfPlayer mp3. Добавил много опций в include/defines.h

- Добавлен прогноз на несколько дней из Интернета и возможность полностью гасить матрицу ночью.

- Начата работа над поддержкой локализации.



# Слава Украине!