Dit project biedt ESPHome-pakketten voor de Whisker Litter Robot 4, waarmee gebruikers de cloudinfrastructuur van de fabrikant kunnen omzeilen. Door de ESP32-firmware te vervangen, wordt het apparaat compatibel met lokale systemen zoals Home Assistant, wat resulteert in volledige privacy en onafhankelijkheid van internetverbindingen.
Kernpunten uit het artikel:
- Veiligheid: De modificatie is relatief veilig omdat de kritieke hardwarebesturing wordt beheerd door een aparte PIC-microcontroller; de ESP32 fungeert enkel als communicatiebrug.
- Functionaliteit: Bijna alle originele functies blijven behouden. Er zijn zelfs verbeteringen, zoals nauwkeurigere sensor-tracking en flexibelere slaapschema's per dag.
- Installatie: Het flashen vereist hardwarematige aanpassingen, specifiek het solderen van een ESP-Prog-2 development board op het moederbord.
- Compatibiliteit: Hoewel momenteel alleen de Litter Robot 4 wordt ondersteund, is er een oproep aan eigenaren van de Litter Robot 3 om te helpen bij het porten van de firmware.
Litter Robot ESPHome-pakketten
Waarom?
Het flashen van de Litter Robot met ESPHome-gebaseerde firmware elimineert de afhankelijkheid van de cloudinfrastructuur van Whisker en maakt in plaats daarvan eenvoudige integratie met open, zelfgehoste diensten zoals Home Assistant mogelijk. Dit betekent:
- Totale privacy – alle gegevens blijven lokaal. Er worden geen telemetrie, gebruiksstatistieken of andere gegevens verzonden naar Whisker of AWS.
- Geen internet vereist – het apparaat kan volledig offline verbinding maken met je smart home, waardoor je je geen zorgen hoeft te maken over cloudstoringen of toekomstige stopzettingen van de dienst.
- Aanpasbaar – voeg functionaliteit toe of wijzig deze naar wens.
Welke apparaten worden ondersteund?
Op dit moment wordt alleen de Litter Robot 4 ondersteund. Hoewel ik vermoed dat de Litter Robot 3 zeer vergelijkbaar is, heb ik er geen om op te testen. Bijdragen worden gewaardeerd!
Is het veilig?
De ESP32 in de Litter Robot 3 en 4 dient als een WiFi-naar-UART-brug die commando's doorgeeft tussen de cloud en de PIC-microcontroller op het moederbord. Alle hardwarebesturing en veiligheidskritische logica komen van deze aparte microcontroller, dus het vervangen van de ESP32-firmware zou de veiligheidsmechanismen van het apparaat op geen enkele manier in gevaar brengen.
Welke functies worden ondersteund?
Elke bekende functie van de originele firmware wordt ondersteund, met de volgende uitzonderingen (gesorteerd van meest naar minst waarschijnlijk om te veranderen):
- Niet alle fouten hebben nog een beschrijvende naam, hoewel de algemene foutstatus nog steeds wordt gedetecteerd.
- De besturing en status van de LitterHopper zijn niet geïmplementeerd, maar de hopper zelf zou nog steeds moeten werken.
- Het bijwerken van de firmware van het moederbord/laserbord is niet mogelijk.
Er zijn echter enkele verbeteringen ten opzichte van de officiële firmware/app:
- Slaapschema's kunnen op dagbasis worden ingesteld in plaats van slechts één keer voor doordeweeks/weekend.
- Directere toegang tot de laser- en gewichtsdetectiesensoren voor nauwkeurige tracking van het betreden en verlaten van het apparaat.
Is het omkeerbaar?
De originele firmware kan opnieuw op de ESP32 worden geflasht om het apparaat volledig te herstellen naar de originele staat. Je dient een volledige back-up van de stock-firmware te maken voordat je de ESPHome-firmware flasht.
Hoe installeer ik het?
Voor het initiële flashen van de firmware is het nodig om een ESP-Prog-2 development board te verbinden met een onbevolkte ESP-Prog header op het moederbord. Omdat de pads onbevolkt zijn, moet je ofwel direct op ze solderen, of ze voorzien van de beoogde 1.27mm 6-pin surface mount header (door mijzelf direct gesoldeerd, kan ook worden gevonden bij DigiKey) om de ribbonkabel te gebruiken die bij de ESP-Prog-2 is inbegrepen. Volledige instructies zijn te vinden in de Firmware Flashing Guide.
De broncode voor de component is te vinden in mijn ESPHome-fork totdat deze mogelijk wordt samengevoegd in ESPHome.
Waar kan ik meer informatie vinden?
Raadpleeg de Litter Robot 4 UART Reference voor een volledig overzicht van het seriële protocol van het moederbord.
Kan ik helpen?
Dit project kan bijna zeker met weinig moeite worden geport naar de Litter Robot 3, maar ik heb er zelf geen om het te proberen. Als je een Litter Robot 3 "Connect" met WiFi hebt, zou het nuttig zijn om seriële pakketten tussen de PIC en ESP32 vast te leggen om het LR3 UART-protocol te begrijpen.
Een specifieke blogpost gaat dieper in op sommige van de hardware op het LR3-moederbord en de eerste sectie legt uit hoe je logs uit de ESP32 haalt. Als de logs geen seriële gegevens bevatten, dan zouden de fysieke TX/RX-lijnen de middelste 2 pads van de 4 pads zijn die zijn aangeduid als J8 op het moederbord.
Als je de seriële gegevens niet kunt ontcijferen of zelf geen code kunt schrijven, stuur me dan gewoon de captures die je krijgt en ik doe de rest!
Donaties
Als je dit project nuttig vindt, worden donaties van elk bedrag zeer gewaardeerd. Weet echter dat ik deze waarschijnlijk toch weer doorgeef aan andere open-source projecten :)
Je kunt ook $50 korting krijgen op een Litter-Robot via mijn referral-link.
Disclaimer
Dit project is niet gelieerd aan, onderschreven door of geassocieerd met Whisker, Litter Robot of Automated Pet Care Products. Het aanpassen van je apparaat vereist hardwarematige demontage en modificatie, wat je garantie kan laten vervallen en het risico op permanente schade met zich meebrengt. Je doet dit op eigen risico. Noch de auteur(s) noch de bijdragers zijn verantwoordelijk voor enige schade aan je apparaat, eigendommen of huisdieren als gevolg van het gebruik van deze firmware of instructies.
Litter Robot ESPHome-pakketten
Waarom?
Het flashen van de Litter Robot met ESPHome-gebaseerde firmware elimineert de afhankelijkheid van de cloudinfrastructuur van Whisker en maakt in plaats daarvan eenvoudige integratie met open, zelfgehoste diensten zoals Home Assistant mogelijk. Dit betekent:
- Totale privacy – alle gegevens blijven lokaal. Er worden geen telemetrie, gebruiksstatistieken of andere gegevens verzonden naar Whisker of AWS.
- Geen internet vereist – het apparaat kan volledig offline verbinding maken met je smart home, waardoor je je geen zorgen hoeft te maken over cloudstoringen of toekomstige stopzettingen van de dienst.
- Aanpasbaar – voeg functionaliteit toe of wijzig deze naar wens.
Welke apparaten worden ondersteund?
Op dit moment wordt alleen de Litter Robot 4 ondersteund. Hoewel ik vermoed dat de Litter Robot 3 zeer vergelijkbaar is, heb ik er geen om op te testen. Bijdragen worden gewaardeerd!
Is het veilig?
De ESP32 in de Litter Robot 3 en 4 dient als een WiFi-naar-UART-brug die commando's doorgeeft tussen de cloud en de PIC-microcontroller op het moederbord. Alle hardwarebesturing en veiligheidskritische logica komen van deze aparte microcontroller, dus het vervangen van de ESP32-firmware zou de veiligheidsmechanismen van het apparaat op geen enkele manier in gevaar brengen.
Welke functies worden ondersteund?
Elke bekende functie van de originele firmware wordt ondersteund, met de volgende uitzonderingen (gesorteerd van meest naar minst waarschijnlijk om te veranderen):
- Niet alle fouten hebben nog een beschrijvende naam, hoewel de algemene foutstatus nog steeds wordt gedetecteerd.
- De besturing en status van de LitterHopper zijn niet geïmplementeerd, maar de hopper zelf zou nog steeds moeten werken.
- Het bijwerken van de firmware van het moederbord/laserbord is niet mogelijk.
Er zijn echter enkele verbeteringen ten opzichte van de officiële firmware/app:
- Slaapschema's kunnen op dagbasis worden ingesteld in plaats van slechts één keer voor doordeweeks/weekend.
- Directere toegang tot de laser- en gewichtsdetectiesensoren voor nauwkeurige tracking van het betreden en verlaten van het apparaat.
Is het omkeerbaar?
De originele firmware kan opnieuw op de ESP32 worden geflasht om het apparaat volledig te herstellen naar de originele staat. Je dient een volledige back-up van de stock-firmware te maken voordat je de ESPHome-firmware flasht.
Hoe installeer ik het?
Voor het initiële flashen van de firmware is het nodig om een ESP-Prog-2 development board te verbinden met een onbevolkte ESP-Prog header op het moederbord. Omdat de pads onbevolkt zijn, moet je ofwel direct op ze solderen, of ze voorzien van de beoogde 1.27mm 6-pin surface mount header (door mijzelf direct gesoldeerd, kan ook worden gevonden bij DigiKey) om de ribbonkabel te gebruiken die bij de ESP-Prog-2 is inbegrepen. Volledige instructies zijn te vinden in de Firmware Flashing Guide.
De broncode voor de component is te vinden in mijn ESPHome-fork totdat deze mogelijk wordt samengevoegd in ESPHome.
Waar kan ik meer informatie vinden?
Raadpleeg de Litter Robot 4 UART Reference voor een volledig overzicht van het seriële protocol van het moederbord.
Kan ik helpen?
Dit project kan bijna zeker met weinig moeite worden geport naar de Litter Robot 3, maar ik heb er zelf geen om het te proberen. Als je een Litter Robot 3 "Connect" met WiFi hebt, zou het nuttig zijn om seriële pakketten tussen de PIC en ESP32 vast te leggen om het LR3 UART-protocol te begrijpen.
Een specifieke blogpost gaat dieper in op sommige van de hardware op het LR3-moederbord en de eerste sectie legt uit hoe je logs uit de ESP32 haalt. Als de logs geen seriële gegevens bevatten, dan zouden de fysieke TX/RX-lijnen de middelste 2 pads van de 4 pads zijn die zijn aangeduid als J8 op het moederbord.
Als je de seriële gegevens niet kunt ontcijferen of zelf geen code kunt schrijven, stuur me dan gewoon de captures die je krijgt en ik doe de rest!
Donaties
Als je dit project nuttig vindt, worden donaties van elk bedrag zeer gewaardeerd. Weet echter dat ik deze waarschijnlijk toch weer doorgeef aan andere open-source projecten :)
Je kunt ook $50 korting krijgen op een Litter-Robot via mijn referral-link.
Disclaimer
Dit project is niet gelieerd aan, onderschreven door of geassocieerd met Whisker, Litter Robot of Automated Pet Care Products. Het aanpassen van je apparaat vereist hardwarematige demontage en modificatie, wat je garantie kan laten vervallen en het risico op permanente schade met zich meebrengt. Je doet dit op eigen risico. Noch de auteur(s) noch de bijdragers zijn verantwoordelijk voor enige schade aan je apparaat, eigendommen of huisdieren als gevolg van het gebruik van deze firmware of instructies.
Groetjes,