litter-controller

Spin the feces for the good of the kitties


Project maintained by smaslennikov Hosted on GitHub Pages — Theme by mattgraham

Litter Robot 3 homebrew controller

Spin the feces for the good of the kitties

Warranties and support

Absolutely no expressed or implied warranties are attached to your using this codebase.

Issue and pull request submissions are welcome.

Problem statement

My wife and I dropped over 500$ on a Litter Robot 3 nearly three years ago. For some reason we got the extra one year of warranty - without thinking that there’s no way we’d be willing to pay for its return shipping.

At first it was fine, but the logic has been in decline over the last year or so. Issues we’ve run into include but aren’t limited to:

At some point, we realized it fails to cycle in the dark, when it turns on the blue illumination. I suspected a power issue but didn’t have the time to look into it. Instead, I finalized this project.

In the final assembly, it was apparent that the original Litter Robot power supply (15V 1A) may be at fault: it was unable to drive the motor when connected directly, while a random other one (12V 1A) had no issues in that arena.

Usage

  1. Read Makefile and make sure you know what you’re running in these steps
  2. make deps installs argparse and wiringPi libraries
  3. make rpi-config configures the Raspberry Pi
  4. make builds the binary
  5. make install installs the binary in $PATH
  6. make service installs and starts the systemd service with default values
  7. make logs shows the logs

Or, make deploy covers everything necessary to update after the initial steps have been completed.

Items used

Item Comments Cost
Basic GPIO kit Had all sensors and guidance necessary to start the project off (currently unavailable, but anything similar will work) 21$
Relay module Necessary for controlling the motor 7$
Raspberry Pi 3B+ Most likely any RPi will do, 3B+ is the one I use 40$
MicroSD card For the Pi 9$
Dupont pin crimper Necessary for fabricating cables for sensors 23$
Dupont connector kit Parts for making those sensor cables 14$
PCB Very nice boards, I managed to only need one for this project! 15$
Jumper wires Necessary for connecting sensors on the final board 11$
Soldering iron My favourite iron 80$
Tweezers Sometimes helpful in soldering 7$
Solder sucker The only solder sucker that ever worked for me 24$
Wire cutters   7$
Solder   9$
Flux It might just be a russian thing to solder with a jar of flux 9$
Feather wand The least you can do for taking your cats’ toilet away for weeks is play with them 10$
Total   286$

Hardware layouts

TODO

For now, the closest thing I have is a crude drawing.

Status

This code is relatively stable, the hardware is finished, installed and is in use at home. So, basically, I run this in production, here’s proof!

Cats involved

A fat Felix and a less prone to pose for pictures, tiny Takkun.

Licensing

Code, documentation and everything else in this repository are licensed via Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)