A collection of esphome firmwares for Petlibro devices.
An esphome firmware for PLWF105 automatic water bowl (also called the Dockstream or the PETLIBRO App Monitoring Cat Water Fountain with Wireless Pump) by Petlibro.
The default firmware, which is included in this respository requires use of the Petlibro application and must be cloud connected. Internally the firmware uses MQTT to communicate.
The esphome firmware included in this repository implements (almost) feature parity as the stock firmware without the need for the third party cloud, or any WAN connection for that matter.
- Turn pump on or off
- Red LED
- Yellow LED
- Scale (used to determine water level)
- Pump error indicator
- water consumption tracking
- water reporting in oz and ml
- configurable pump intervals
- integreated calibration process
If you carefully open the water bowl "base" you will see a PCB holding a ESP32-C3-WROOM-03, a HX7111 and a voltage regulator. There is also one more chip on the board but I am unable to identify it.
The PCB very conveniently contains 3 pins that we can use to flash our firmware. GND, TX, and RX.
The PC has a VCC pin that can be used to power to program, but your USB-Serial converter needs to be able to supply enough current. I suggest using the USB plug to power while programing.
The PCB also has two pads on the lower right corner labled B and G. These pads can be shorted to put the ESP chip in programmer mode.
- Plug the USB to serial converter into your computer and hook up to the pin holes as described below. Do NOT power the board/fountain yet.
GND -> GND
TX -> RX
RX -> TX
You don't even need to solder anything most likely. I was able to hold the pins in place with just tension.
- Take a small wire and hold it on the
BandGpads described above. - While still holding the wire in place, plug in the pumps USB cable.
- At this point the board should be in programming mode.
- Flash the firmware in this repo.
Here is how it looks in HomeAssistant:
- The fountain will now be in calibration mode (slow flashing yellow light).
- With the water a the min fill line and fully assembled, hit the "wifi" button (or enter the number yourself in the home assistant UI)
- The light should flash fast now, with the water a the max fill line and fully assembled, hit the "wifi" button (or enter the number yourself in the home assistant UI)
An esphome firmware for PLAF108 automatic pet feeder (also called the Air feeder) by Petlibro.
The default firmware, which is included in this respository requires use of the Petlibro application and must be cloud connected. Internally the firmware uses MQTT to communicate.
The esphome firmware included in this repository implements (almost) feature parity as the stock firmware without the need for the third party cloud, or any WAN connection for that matter.
- Alarm Red LED
- Sensor for showing if feeder is on battery power
- Sensor for showing if battery is plugged in
- Sensor to enable the "Food Detection" sensor
- Sensor for showing if mains connected
- Switch to turn motor left
- Switch to turn motor right
- Sensor to show when the motor has done a quarter turn
I do not know what GPIO0 and GPIO1 are for. I think it's for the DC current sensor to maybe determine battery charge. But, that's a guess.
The PCB very conveniently contains 4 pins that we can use to flash our firmware. GND, TX, RX, and VCC. The PCB also has two unlabled pin holes. These holes can be connected to each other put the ESP chip in programmer mode.
- Plug the USB to serial converter into your computer and hook up to the pin holes as described below. Do NOT plugin the board yet.
GND -> GND
TX -> RX
RX -> TX
You don't even need to solder anything most likely. I was able to hold the pins in place with just tension.
- Take a small wire and hold place it in the unmarked pin holes described above
- While still holding the wire in place, plug in the board.
- At this point the board should be in programming mode.
- Flash the firmware in this repo.