DEV Community: Jozef Cipa

How I built a custom Homekit thermostat for 40€

Jozef Cipa — Mon, 10 Mar 2025 08:10:40 +0000

I wanted a smart HomeKit thermostat for a long time. The only problem is that it is quite expensive so I never bought one. Last year, Espressif organized an introductory workshop to familiarize people with ESP32. I’ve heard about this board before but didn’t know what exactly it was and never really played with it. So I signed up for the workshop to get hands-on experience with the chip. If you don’t know what ESP32 is, you can think of it as something between Arduino and Raspberry Pi - a microprocessor that you can program in C with GPIO pins, WiFi and Bluetooth connectivity.

Some time after the workshop, I got an idea to try to make my own thermostat using the ESP32 chip I got from the event. I saw this as a great opportunity to deepen my knowledge about this board and at the same time build something useful.

The idea

The main thing was to define a goal - what exactly do I want my thermostat to be capable of and how should it work. Obviously, it has to be HomeKit compatible, so I can control it with my iPhone. Also, once I mount it on the wall, it would be nice to have instant visual feedback to see the current room temperature and heating state. Also, anyone should be able to control the temperature directly via the thermostat. That means the thermostat needs to have an LCD screen. Moreover, since I want to be able to interact with it to change the temperature, it has to provide some user interface. I decided to use a touch screen as I wanted to avoid adding a bunch of physical buttons. And it also feels more natural nowadays. Besides, why not bring on another challenge for myself 😅. Obviously, I can’t forget a temperature sensor and a relay to control a boiler.

HomeKit

HomeKit is the heart of the whole thermostat, without it the project wouldn’t be possible. That means I had to find a library that would implement the protocol.

There is one library called Homespan, but this is intended for programming ESP32 in the Arduino environment. This is much easier and beginner friendly, but I wanted something more advanced and challenging :). As I said in the beginning, I wanted to get more familiar with the ESP32 environment and the arduino-esp32 project offers a lot of abstractions. That’s why I opted for the ESP-IDF framework instead.

Luckily, there is a great HomeKit library built by Achim Pieters. It comes with a ton of examples, probably for every possible HomeKit appliance, so implementing not only a thermostat but also anything else becomes much easier.

After installing and setting up the library, it will start a HomeKit server on the ESP32 and wait for connections from your iOS Home app. Then you will need to generate a QR code as you might know from other smart devices and scan it to add it to your Home app. The QR code generator is a part of the library, so it is very simple to make one.

Unfortunately, since this is a custom, MFi uncertified product, Apple doesn't support configuring WiFi network in the same step as adding the device to the Home app. Therefore, you will need to scan two QR codes, first, one to set the WiFi network, and then another one for registering the device with the Home app. We’ll talk more about the WiFi QR code later.

Measuring temperature

Measuring temperature is an important part of every thermostat. In this project, I chose the SHT-40 sensor that is cheap but still fairly accurate. Apart from temperature, it can also measure humidity, so this comes in handy too. The sensor communicates with the board via I2C interface. In this project, the temperature is measured in 10 minute intervals.

Controlling a boiler

If the thermostat evaluates the current room temperature as too low compared to the set target temperature, it will turn on a boiler. To do so, we need a relay that will be switching the boiler on and off. In our case, this will be a 5V relay with the max load of 250VAC/10A.

LCD

I picked the 240x320” TFT display with the touch support. It communicates with the board via SPI interface and both display and the touch screen share the same connection. This was quite a challenge to make it work and it took me some time and a lot of head-scratching but eventually I figured it out.

Building the UI

The display is connected but the real fun just begins now. I needed to figure out how to create and show GUI elements on the display, and put it all in a nice layout. Not to mention, I had to find a way to connect those UI elements with the touch screen.

Luckily, there is this awesome graphics library for the embedded devices called LVGL. It is very intuitive and easy to use. Moreover, it is inspired by CSS, so it was surprisingly easy to use. But the initial setup and connecting the UI with the LCD screen was quite a challenge.

Here you can see the diagram of the thermostat GUI. Eventually I ended up creating three different screens for handling various states of the thermostat.

Showing current time

Since we already have the display that shows the room temperature and will be mounted on a wall, I thought it would be cool to also display the current time and date.

For that, I used the NTP protocol that fetches the current time from the internet servers and sets the local clock based on the configured timezone. Then I just created a task that updates the screen with the new time every minute.

WiFi provisioning

I’m a perfectionist and even though hardcoding the WiFi credentials was the easiest way, I was thinking of the future and the last thing I want to do is having to reprogram the device once the WiFi network or password changes 😅. That is why I made extra effort to set up automatic WiFi provisioning.

The way it works is that the ESP32 first creates a Bluetooth connection with the iOS Provisioning app. Then, you scan the WiFi QR code displayed on the screen that contains the connection details. Next, the app will connect to the device and configure WiFi credentials that are then stored in the device flash memory.

Now, whenever the configured WiFi network is not available or the thermostat just can’t establish a connection for any reason, it will show the setup screen so you can restart the provisioning process and configure a new WiFi network.

Electrical circuit

The electronic is pretty straightforward, and you can find the circuit below. The LCD, the temperature sensor, and the relay are all connected directly to the ESP32 board and that’s pretty much it 😀.

Conclusion

In total, the whole project cost less than 20€ (ESP32 is usually extra 20€, but I got mine for free from the workshop) and many mental breakdowns while trying to make things work :).

But, I learned a lot of new cool stuff. In fact, almost the entire project was something completely new to me. I learned more about ESP32 and ESP-IDF, how WiFi provisioning works, how to connect an LCD and make the touch screen work, what is a LVGL library and how to build UI interfaces in embedded systems.

On top of that, I learned a lot of things about programming in C, how horrible and cool it is at the same time. And that all those memory crashes are a pain in the ass to debug. But it truly forces you to really understand what’s going on in the program.

So it was definitely a fun project to work on. If you are interested in the code, you can find everything on Github.

Monitoring your website with Upptime

Jozef Cipa — Mon, 03 Feb 2025 10:28:59 +0000

Recently I’ve encountered an unpleasant situation on one of the websites I manage. I randomly opened it only to find out it wasn’t working. Unfortunately, it was not a very important website, so no harm was done but the problem was that I didn’t know for how long it had been down. This is unacceptable, especially for the important websites that cannot go down.

Therefore, I did research on some tools that would help me with monitoring the website status and notify me when something goes south again in the future.

I came across an open-source tool called Upptime, a monitoring solution that you can easily configure to constantly monitor the specified HTTP endpoints. It is Github-based, which means you can easily clone the repository by clicking on the “Use this template”. It uses Github Actions for constantly checking the configured endpoints and then commits the results back to your Git repository 💯.

By default, it checks the website every 5 minutes and commits a daily report once a day, but this is configurable. Whenever your website goes down or is unresponsive, Upptime creates a new GitHub issue and sends you a notification. There are several channels that you can configure for receiving those alerts, such as Slack, Telegram, email, or even SMS.

It comes with a static status page that reads the data from your repository and you can freely customize it as you like. And it can be easily deployed to Github Pages, for instance.

Check out their getting started guide and follow all the steps to set it up. The whole process is super straightforward and doesn’t take more than half an hour to complete.

And after that, you can start sleeping without worries again 😁.

Are you getting tired of localhost:3000 URLs?

Jozef Cipa — Fri, 17 Jan 2025 12:39:48 +0000

I'll show you how you can quickly and easily turn http://localhost:3000 into https://your-custom-domain.test to improve your webdev experience in 3 minutes.

Just open your terminal and install novus

$ brew tap jozefcipa/novus
$ brew install novus
$ novus init

After that, define your URL with a single command 🤩

$ novus serve your-custom-domain.test http://localhost:3000

And that's it.
Now, you can start using HTTPS locally with your custom domains and forget annoying localhost URLs 🎉

If you're curious to learn more, check out Novus on Github

I just released an update for my HTTPS tool

Jozef Cipa — Thu, 16 Jan 2025 18:22:29 +0000

Dive into the latest updates on Novus, the lightweight tool that makes local development with HTTPS a breeze.

Check it out here: Novus Just Got Better (Again)

Your feedback is always welcome, so let me know what you think! 🙌

🚀 Novus Just Got Better (Again)! 🌟

Jozef Cipa — Thu, 16 Jan 2025 09:44:54 +0000

Dive into the latest updates on Novus, the lightweight tool that makes local development with HTTPS a breeze. Whether you're already using it or curious about how it can simplify your workflow, this update brings exciting improvements you won't want to miss.

Check it out here: Novus Just Got Better (Again)

Your feedback is always welcome, so let me know what you think! 🙌

Does Laravel Valet contain a security hole?

Jozef Cipa — Wed, 15 Jan 2025 09:35:01 +0000

If you use Laravel Valet, beware, it contains a security vulnerability.
Read more in my newest article https://jozefcipa.com/blog/how-to-use-sudo-without-a-password-in-your-programs/ to learn about sudoers file and what to keep in mind when using it.

Just released a new version of Novus 🚀

Jozef Cipa — Thu, 14 Nov 2024 17:27:51 +0000

I've just released a new version of my pet project called novus.
If you are a web developer and are tired of localhost:3000 URLs, check out novus - a tiny Go utility that provides nice HTTPS URLs for local development.
Read what's new in v0.0.4 and let me know what you think! Any feedback or ideas are welcome!