Blog

Project Bindicator: Software

Welcome to the final post in my series on building my bindicator: the software. If you haven’t already read about the hardware I put together then that’s probably worth a read before you go too much futher.

The primary goal of the bindicator is fairly simple: on the evening when the garbage needs to go out, the bindicator should light up in the relevant colours. For the way I plan to use it, I have some additional requirements: I want the people in my household to have a way to dismiss the indication once it’s been dealt with, and I want the notification to time out after a certain amount of time even if nobody has dismissed it. I’d also love for the notification not to fire at all if we’re on vacation.

There’s probably any number of different ways we could go about achieving this with a combination of hardware and software, but in our house we already have Home Assistant installed and hooked in to any number of household devices and functions, running automations to control them and get them working together. As a result, my approach will be to keep all the logic in home assistant and make the bindicator device itself fairly dumb – all I want it to do is show up in home assistant as a light (actually three lights) that home assistant can control.

Enter ESPHome!

ESPHome is a sister project to home assistant intended to be installed on devices with a microcontroller (either commercial or home-made devices) to control the hardware. As you’d imagine, it integrates with home assistant really nicely and I believe there are a few different ways of doing that integration. I use MQTT.

You use a YAML configuration to specify what hardware components your device has and how they’re connected to the microcontroller. It then generates the firmware, and you upload it to the device. Simple!

I published my configuration in my git repository. It defines three lights – one that represents the entire bindicator (both halves), and one each that’s specific to the top and bottom segment of the bindicator. For each of those it adds a custom lighting effect that pulses the light on and off periodically, and then it makes the whole thing available to home assistant over the MQTT and provides some additional options that let me do things like OTA firmware updates.

On the home assistant side, I’m using a couple of key integrations. Recollect Waste and the HomeAssistant mobile app. I then built an automation that runs every day at 6pm and checks if there’s a garbage collection scheduled for the following morning. If there is it additionally checks if there’s one type of garabge being collected or two, and lights up either the whole bindicator in a single colour or each of the two segments independently as appropriate.

It also sends a notification to each of our phones telling us there’s garbage to go out, and watches for one of those notifications to be dismissed with a four hour timeout. When one of us dismisses a notification it then removes the notification for everyone else and turns the bindicator off.

Home assistant uses a nice friendly GUI to create and edit automations and they’re saved in YAML format behind the scenes. I’ve published my automation in YAML format.

What’s Next?

I don’t have many plans to evolve what I’ve built because it’s working pretty well. We already use a “home mode” selector in Home Assistant to change some of our home’s settings if we have houseguests or are on vacation, so the automation I’ve linked above already leverages that and skips taking any action if we’re not home to deal with it.

I have an idea of using our security cameras and computer vision (probaly leveraging frigate) to detect when we put the garbage out and react appropriately so we don’t need to manually acknowledge that it’s done (and also alert us if we accidentally put the wrong colour cart out, or perhaps even alert us once they’ve been emptied and we can take them back in).

Watch this space to see if I actually do any of that!

Blog

Project Bindicator: Final Assembly

Welcome back to my ongoing blog series about my bindicator build!

It’s been a few months since my last proper post about it, I’ve been to Spain and back in that time, done some other things in my life, and my bindicator has been set up and working well for at least the past month!

When last I wrote the parts had arrived and I’d begun modifying the STL files to fit them. That work is now complete and I’ve published it over on printables.com along with the source files in case you wanted to modify them further for your own application.

Starting with the original design by CopperLion, I designed a bracket to hold the microcontroller I’d chosen (an ESP32-C3 Zero), slightly enlarged the hole for the USB port to make it suitable for the USB-C plug that the ESP32 uses, and removed two of the three fins from the light baffle so that it would fit an offcut of addressable LED light strip that I had lying around.

From there I printed everything in white (waiting for my order of white filament was actually the biggest delay in the whole process, because Amazon lost it and I had to get a refund and order it again) and it was on to assembly!

First I soldered three wires from the microcontroller to the light strip – one to the 5v pin, one to ground, and one to GPIO pin for data. Next I peeled the backing off the light strip to reveal its adhesive and stuck it to the baffle, then I glued the microcontroller into its bracket with a little dab of superglue.

With the benefit of hindsight, starting by attaching the baffle was a mistake. The next step was to glue the microcontroller into the bottom of the wheelie bin, and this would have been much easier without the baffle attached. Nevertheless, I managed to get it done.

The baffle more or less sits in the right spot without any adhesion but I did put a little dab of glue on the back of it to hold it still, and then finally I glued on the lid. The lid is my least favourite part of the design because it simply rests on top of the bin. Once you’ve glued it in place it’s fine, but gluing it is not the easiest because there’s nothing to hold in place until the glue has set. If I were doing this over I’d like to add a little lip so that it could be inserted and friction-fitted into the top of the bin. On the other hand, that lip would make the top harder to print, so maybe it’s better how it is now? I’m not sure.

With everything working it was on to software, but that’s for a future post. Watch this space!

Shrapnel

…and another update – I’ve made the u-shaped bracket for the microcontroller that I talked about in my post yesterday.

I originally thought I’d need to adjust the hole in the garbage can model to move it upward, but actually the key was putting the microcontroller into the bin with the port facing down.

It does need to be very slightly wider than it currently is, but on my test piece I did that a file and it’s looking good!

Shrapnel

Prototype is alive!

I was worried that only having two LEDs instead of four would result in it not being bright enough, but I’m running it at half brightness with my example code and it seems great.

Next steps are to find a way to fit the tiny microcontroller I’m going to use into the bottom so the USB port lines up for power, and of course print the bin in white.

Blog

Project Bindicator, Part 2: The Parts Arrive

A few weeks after my initial post about my Bindicator project, the microcontroller has arrived in the mail from China and it’s time to get assembling.

Although I’m sticking fairly closely to the original design, there will be a couple of differences that inevitably are going to require modification.

Firstly, the microcontroller itself. The original uses a Wemos D1 Mini which, as I understand it, the garbage can 3D model is designed around and it fits perfectly into the bottom of the bin. I’m using an ESP32-C3 Zero which is quite a bit smaller.

My plan here is to simply print a U-shaped support for the ESP32 that holds it in place, although I also already know that I’m going to need to to raise the cutout for the USB plug very slightly in order for it to align properly. It’s close already, and happily the hole is already an appropriate size for the USB-C connect my ESP32 uses despite having been designed for micro USB. I’m thinking that shouldn’t be too difficult to achieve, though.

The second change I hope to make is to the light source, although I’m not yet sure if my plan for that is flawed. The original design uses four individual RGB LED pixels. I’d prefer to use an offcut of an LED strip I already have lying around, but the problem is that the LEDs are much too far apart.

That said, the original design also divides the bin into four quadrants for the UK’s many different types of garbage, but where I live in Calgary there are only three garbage categories (general, recycling and organic waste) and at most two of those are collected on the same day. I’m therefore going to modify the light baffle from the original design and remove two of the three fins, splitting the bin into two chambers instead of the original four.

I’ve already done this part and made a quick modification to the original STL in Tinkercad, available here.

It remains to be seen if halving the number of LEDs will give me the level of brightness I want, but now that I have a modified baffle printed that’s the next part of the adventure, as I assemble a prototype. If it’s bright enough for my blue test print then it’ll definitely be bright enough for the finished product that I’ll be printing in white.

Watch this space for more to come!