Home Assistant Ista Calista Integration

This Home Assistant custom component integrates with the ista Calista portal to monitor your heating and water consumption. It provides sensors for your various meters and records historical data using Home Assistant's Long-Term Statistics feature.

Note: This integration currently supports the Spanish (ista.es) portal.

---

Features

• Multi-Meter Support: Retrieves data for all supported meter types on your account:
  • Heating (kWh)
  • Hot Water (m³)
  • Cold Water (m³)
• Long-Term Statistics (LTS): Imports your full available consumption history from the ista portal into Home Assistant, allowing you to track usage over time in the Energy Dashboard or with history graphs.
• Regular Updates: Periodically fetches the latest readings to keep your sensors current.
• Dynamic Entity Creation: Automatically creates and adds sensors as they appear in your ista account.
• Configurable Options: Adjust the update frequency and log level directly from the UI.
• Re-authentication Flow: Notifies you and prompts for a new password if your credentials expire.

Prerequisites

• An active account on the ista Calista portal.
• Home Assistant (Version 2024.1.0 or newer).
• HACS (Home Assistant Community Store) installed.

Installation

1. Install via HACS (Recommended):

   • Go to HACS > Integrations.
   • Click the three dots in the top right and select "Custom repositories".
   • Add the URL https://github.com/herruzo99/ista-calista with the category "Integration".
   • Find the "Ista Calista" integration in the list and click "Install".
   • Restart Home Assistant when prompted.

2. Manual Installation:

   • Download the latest release from the Releases page.
   • Copy the custom_components/ista_calista directory into your Home Assistant <config>/custom_components folder.
   • Restart Home Assistant.

Configuration

1. Navigate to Settings > Devices & Services.
2. Click Add Integration and search for "Ista Calista".
3. Enter your ista Calista portal email and password.
4. Consumption Start Date: Select the date from which to import historical data. The portal typically provides data for the last 1-2 years. The default is one year ago.
5. Click Submit.

The integration will perform an initial data sync, which may take several minutes depending on the amount of history available.

Options

After setup, you can adjust the integration's options:

1. Navigate to the Ista Calista integration on the Devices & Services page.
2. Click Configure.
3. Adjust the Update Interval (in hours) and Log Level as needed.

Troubleshooting

• Authentication Failed: Double-check your credentials. If the problem persists, log in to the official ista portal to confirm your password is correct. If you are notified of an authentication error in Home Assistant, you can re-authenticate by going to the integration's configuration.
• Sensors Not Appearing: After the initial setup, it can take a few minutes for the first data pull to complete. Check the Home Assistant logs for any errors related to ista_calista. Ensure the "Consumption Start Date" is set to a reasonable past date.

For persistent issues, please open an issue on GitHub and include any relevant logs.

Development

This project uses Nix with flakes to provide a reproducible development environment. All dependencies, including the correct Python version, Home Assistant test libraries, and linters, are defined in flake.nix.

Prerequisites

1. Install Nix: Follow the instructions at nixos.org/download.html.
2. Enable Flakes: Enable flakes by editing your Nix configuration.
   • For NixOS: Add nix.settings.experimental-features = [ "nix-command" "flakes" ]; to your configuration.nix.
   • For other systems: Add experimental-features = nix-command flakes to ~/.config/nix/nix.conf.

Environment Setup

1. Clone the repository:

   git clone https://github.com/herruzo99/ista-calista.git
   cd ista-calista

2. Activate the development shell:

   nix develop

   The first time you run this command, Nix will download and build all the necessary dependencies. This may take some time. Subsequent runs will be much faster as the dependencies will be cached. Once complete, you will be in a shell with all the required tools available.

Running Tests

The test suite is built using pytest and the pytest-homeassistant-custom-component library.

To run all tests:```bash pytest

To run a specific test file:
```bash
pytest tests/test_sensor.py

Contributing

Contributions to this project are welcome! Please follow standard development practices: lint your code, add tests for new functionality, and ensure existing tests pass. Use the Nix development environment to ensure consistency.

Disclaimer

This is an unofficial, third-party integration. It is not affiliated with, authorized, maintained, sponsored, or endorsed by ista International GmbH. Use this at your own risk. The developer is not responsible for any issues or damages that may arise from its use.