Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 4 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 (2 months ago)
- Default Branch: main
- Last Pushed: 2024-12-18T07:32:51.000Z (5 days ago)
- Last Synced: 2024-12-18T08:27:30.719Z (5 days ago)
- Topics: feeder, home-assistant, iot, philips, smart, tuya, tuya-api
- Language: Python
- Homepage: https://github.com/AboveColin/HA-Philips-Pet-Series
- Size: 58.6 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 4
-
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 (Search for "PAW"), click on "register your device" and log in with your credentials.
> [!TIP]
> If you have not registered your device yet, you can do this through either the PhilipsPetSeries app(s) or find your device on the [Philips Home Support](https://www.home.id/support) page and register it with a new account.
2. **Retrieve Tokens**:
- After logging in, you will be redirected to your account dashboard.
- 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 values from the `cc-access-token` and `cc-refresh-token` field 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 (Android) phone and running frida-trace as shown below:
```bash
frida-trace -U --decorate \
-j '*!*encodeString*' \
-f com.versuni.nbx.petsseries \
-o output.txt
```
Then, search for the localKey in the output.txt
## 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.