Luma litterbox support

[tjd-dev]

Proposed change:

Adds full-ish support for the Luma Smart Litter Box (PLLB001) with comprehensive entity coverage including sensors, binary sensors, buttons, switches, and firmware update support.

I’m still working through the API and command executor to assess the feasibility of supporting the scheduling of the air filter on the device. I’ve tried to make the entities as helpful and verbose as possible, but many are disabled by default for everyone’s sanity. The goal of future updates will be to intercept or capture photo data and allow users to route poop selfies to an AI task and an AI agent of their choice, at their own cost.

Key Features:

Device Control:

• 7 button entities: Start Clean, Empty Waste, Level Litter, Stop, Open/Close Door, Air Purifier
• 3 switch entities: Sound, Light, Deodorization
• Full door control (open/close)

Monitoring:

• 21 sensor entities covering:
  • Connectivity (WiFi signal, online status)
  • Battery information (level, supply hours)
  • Weight measurements
  • Maintenance tracking (filter days, mat days)
  • Device states (clean state, filter state, mat state, door state)
  • Operational modes (clean mode, deodorization mode, sleep mode)
  • Volume levels
  • Motion sensitivity
• 10 binary sensor entities:
  • Online status
  • Waste bin state
  • Vacuum state
  • Deodorization active
  • Door state
  • Error states (warehouse error, door error)
  • Sleep mode
  • Camera state
  • Hardware button lock

API Implementation:

• Generic exec_device_command() method for executing device commands
• 7 specific command methods for common operations
• Support for 13 discovered API actions: CLEAN, STOP_CLEAN, SUSPEND_CLEAN, RESTART_CLEAN, EMPTY, STOP_EMPTY, RESTART_EMPTY, LEVELING, VACUUM, OPEN_DOOR, CLOSE_DOOR, STOP, CANCEL
• Integration with 4 API endpoints: device_real_info, device_data_real_info, device_attribute_settings, get_device_upgrade

Firmware Updates:

• Full support for firmware update entity via Home Assistant's update platform

Files Changed:

• custom_components/petlibro/__init__.py - Device registration
• custom_components/petlibro/api.py - New API methods for command execution and device info
• custom_components/petlibro/binary_sensor.py - 10 binary sensor entities
• custom_components/petlibro/button.py - 7 button entities
• custom_components/petlibro/devices/litterboxes/__init__.py - Litter box device exports
• custom_components/petlibro/devices/litterboxes/litter_box.py - Base litter box class
• custom_components/petlibro/devices/litterboxes/luma_smart_litter_box.py - Main device implementation (491 lines)
• custom_components/petlibro/number.py - Number entity support
• custom_components/petlibro/select.py - Select entity support
• custom_components/petlibro/sensor.py - 21 sensor entities
• custom_components/petlibro/switch.py - 3 switch entities
• custom_components/petlibro/text.py - Text entity support
• custom_components/petlibro/update.py - Firmware update entity
• README.md - Updated to move device from "Pending" to "Supported Devices"

Total: 14 files changed, 923 insertions(+), 3 deletions(-)

Closes # (issue)

Type of change:

• New device.
• Bug fix (non-breaking change which fixes an issue).
• New feature or enhancement (non-breaking change which adds functionality).
• Documentation only.
• Other (please explain).

Checklist:

• If applicable, I have added corresponding documentation changes.
• If applicable, I have reviewed the feature / enhancement guidlines before submitting my request.
• If applicable, I have tested my code for new features & regressions on the latest version of Home Assistant.

Additional notes:

• All functionality has been tested against a real Luma Smart Litter Box (PLLB001) device
• The API was reverse-engineered from the official PetLibro Flutter app (APK analysis of libapp.so)
• All discovered API endpoints and commands have been verified to work correctly
• The implementation follows the existing code patterns and structure used by other devices in the integration
• Device supports 40+ properties across 4 different API endpoints
• All entity types (sensors, binary sensors, buttons, switches, numbers, selects, text, update) are properly implemented
• The device class includes comprehensive property accessors with proper type hints and error handling

[jjjonesjr33]

Awesome work @tjd-dev , by chance do you have any pictures of the dashboard for the Luna litterbox that you could post so I could take a look?

[tjd-dev]

A good bulk of these will be hidden by default, for some of the values I am still trying to "translate" what they actually mean like weight and water % (likely linked to litter level).

[jjjonesjr33]

Let's give it a try.