https://github.com/abovecolin/ha-philips-pet-series

This is a Home Assistant integration for the Philips Pet Series devices. It allows you to control and monitor various aspects of your Philips Pet Series devices through Home Assistant.
https://github.com/abovecolin/ha-philips-pet-series

feeder home-assistant iot philips smart tuya tuya-api

Last synced: 8 days ago
JSON representation

This is a Home Assistant integration for the Philips Pet Series devices. It allows you to control and monitor various aspects of your Philips Pet Series devices through Home Assistant.

• Host: GitHub
• URL: https://github.com/abovecolin/ha-philips-pet-series
• Owner: AboveColin
• Created: 2024-10-09T20:32:17.000Z (29 days ago)
• Default Branch: main
• Last Pushed: 2024-10-16T19:38:12.000Z (22 days ago)
• Last Synced: 2024-10-31T10:05:40.452Z (8 days ago)
• Topics: feeder, home-assistant, iot, philips, smart, tuya, tuya-api
• Language: Python
• Homepage: https://github.com/AboveColin/HA-Philips-Pet-Series
• Size: 50.8 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Philips Pet Series Integration

This is a Home Assistant integration for the Philips Pet Series devices. It allows you to control and monitor various aspects of your Philips Pet Series devices through Home Assistant.

## Features

- **Switches**: Control various switches on your Philips Pet Series devices.

- **Sensors**: Monitor different sensors, including event sensors and Tuya status sensors.

- **Numbers**: Adjust numerical settings like portion sizes.

- **Calendars**: View meal schedules.

**Note**: Camera support is not yet implemented.







## Installation

This integration can be installed via [HACS](https://hacs.xyz/).

1. Ensure that [HACS](https://hacs.xyz/) is installed and configured in your Home Assistant setup.

2. Add this repository to HACS:

   - Go to HACS in the Home Assistant sidebar.

   - Click on the three dots in the top right corner and select "Custom repositories".

   - Add the repository URL: `https://github.com/abovecolin/HA-Philips-Pet-Series` and select the category as "Integration".

3. Search for "Philips Pet Series" in HACS and install it.

4. Restart Home Assistant.

## Configuration

1. Go to the Home Assistant Configuration page.

2. Click on "Integrations".

3. Click on the "+" button to add a new integration.

4. Search for "Philips Pet Series" and follow the setup instructions.

## Authentication

This integration uses OAuth2 tokens (access_token and refresh_token) to authenticate with the PetsSeries API. Follow the steps below to obtain and set up your tokens.

### Obtaining Tokens

1. **Login via Web Interface**:

    - Navigate to [PetsSeries Appliance Login](https://www.home.id/find-appliance).

    - Select a PetsSeries product (Starts with PAW) and log in with your credentials.

2. **Retrieve Tokens**:

    - After logging in, you will be redirected to a "Thanks for your purchase" screen.

    - Open your browser's developer tools (usually by pressing F12 or Ctrl+Shift+I).

    - Go to the Application tab and inspect the cookies.

    - Locate and copy the `cc-access-token` and `cc-refresh-token` from the cookies.

3. **Provide Tokens to the Integration**:

    - You can provide the `access_token` and `refresh_token` when setting up the integration.

After the first run, the tokens will be saved automatically, and you won't need to provide them again unless they are invalidated.

## Tuya Integration (Optional)

The integration also supports Tuya devices, which is required for controlling features such as food dispensers. To enable this, you will need to provide the following:

- **client_id**: This can be found in the PetsSeries app's device screen.

- **ip**: The IP address of the device.

- **local_key**: You can extract this from the device using a rooted phone and running frida-trace as shown below:

    

```bash 

frida-trace -H 127.0.0.1:27042 --decorate -j '*!*encodeString*' -f com.versuni.petsseries -o 

```

Then, search for the localKey in the logs.


## Contributing

Contributions are welcome! Please open an issue or submit a pull request on the [GitHub repository](https://github.com/abovecolin/HA-Philips-Pet-Series).

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.