Spin the feces for the good of the kitties

• Warranties and support
• Problem statement
• Usage
• Items used
• Hardware layouts
• Status
• Cats involved
• Licensing

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

Issue and pull request submissions are welcome.

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:

• Blue light blinks: means the tray is full (but it's not). Cleaning the sensors may or may not help. Turning on and off may or may not help.
• Yellow light blinks: something else is broken
• Yellow light blinks very fast: anti-pinch logic is broken

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.

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.

TODO

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

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!

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

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