Skip to content

Latest commit

 

History

History
39 lines (28 loc) · 3.12 KB

README.md

File metadata and controls

39 lines (28 loc) · 3.12 KB
Raw

esp32-morphing-clock

ESP32 HUB75 Matrix Morphing Clock

I am working on building a clock based on a HUB75 RGB LED matrix, controlled by an ESP32.

Photo

So far, it does the following:

  • Displays the current date, time, and day of the week
  • Updates the time on startup and periodically, via NTP
  • Displays the current outdoor temperature and humidity (received via MQTT - if you want to use this, you will need an MQTT server and a separate temperature sensor publishing to it!)
  • Displays the current light levels, read via a TSL2591 I2C light sensor
  • Can receive OTA updates, triggered via an MQTT message (of course, this also requires an MQTT server :) )

This is very much a work in progress, and it is far from being finished. Things that are planned for the future include:

  • Using the current light levels to control the matrix brightness
  • Displaying the weather forecast (min/max temperature, weather icons) pulled from Accuweather. The icons are already in place, I just need to pull and parse the JSON...
  • Display alerts on-screen (received via MQTT)
  • Add a buzzer module and use it to get the user's attention when an alert comes in

You can find the "components" for the project here:

  • The full source code is here - requires PlatformIO!
  • The schematics for the PCB used is here
  • The drawings for the lasercut plexiglass enclosure are here

Thanks

This project would not have been possible without the work of many others, who have been gracious enough to open source their work. Some of the things that I have used when building this:

  • The PxMatrix library from 2dom. Even though this is NOT used in this project (I switched to the DMA library below, for performance reasons), it is the library that got me started on working with HUB75 matrices.
  • The ESP32 DMA library for controlling the matrix, from mrfaptastic
  • The morphing clock code from HariFun (modified to work with mrfaptastic's library instead of pxmatrix)
  • The shield schematics from hallard, which gave me the confidence to try building my own version of a shield PCB :)

I also have to mention here Brian Lough's work on a shield for the matrix. Even though he decided not to open source the board (he only sells the finished board on tindie), he has been extremely helpful during my initial work on the project. So if you are looking for a simple option for getting the full kit (shield and components, all in one package), take a look at his tindie page .

License

The ESP32 HUB75 Matrix Morphing Clock is (c) Bogdan Sass, licensed with GNU General Public License Version 3.0 (which means, if you use it in a product somewhere, you need to make the source and all your modifications available to the receiver of such product so that they have the freedom to adapt and improve).