Metadata-Version: 2.4
Name: aquastilla_softener
Version: 0.3.0
Summary: Library to fetch data from Aquastilla softener from Viessmann API
Home-page: https://github.com/alakdae/aquastilla-softener
Author: Tomasz Szymanowicz
Author-email: alakdae@gmail.com
License: GPL
Keywords: aquastilla softener aquastilla_softener
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: summary

# aquastilla-softener
A Home Assistant integration and Python library for interacting with Aquastilla water softeners via their API.

## 📦 Installation

You can install the package using pip:

`pip install aquastilla-softener`

## 🚀 Usage

    from aquastilla_softener import AquastillaSoftener
    softener = AquastillaSoftener(email="user@example.com", password="your_password")
    devices = softener.list_devices()

    print("Devices:")
        for device in devices:
        print(f"UUID: {device['uuid']}, Model: {device['model']['model']}")

    if devices:
        for device in devices:
            device_data = softener.get_device_data(device)
            print(f"\nDevice UUID: {device_data.uuid}")
            print(f"Model: {device_data.model}")
            print(f"State: {device_data.state}")
            print(f"Salt Level: {device_data.salt_level_percent}%")
            print(f"Salt Days Remaining: {device_data.salt_days_remaining}")
            print(f"Water Available: {device_data.water_available_liters} l")
            print(f"Max Water Capacity: {device_data.max_water_capacity_liters} l")
            print(f"Expected Regeneration: {device_data.expected_regeneration_date}")
            print(f"Current Water Usage: {device_data.current_water_usage_liters} l")
            print(f"Today Water Usage: {device_data.today_water_usage_liters} l")
            print(f"Last Regeneration: {device_data.last_regeneration}")

        softener.close_water_valve(device)
        softener.set_vacation_mode(device, 1) # 0 - vacation_mode off, 1 - vacation_mode on
        softener.postpone_regeneration(device)
        softener.force_regeneration(device)

# 🧠   Features

    ✅ Login to the Aquastilla cloud API

    ✅ Fetch current softener status

    ✅ Set vacation mode

    ✅ Close water valve (not possible to remotely open valve, need to open physically on the device)

    ✅ Force regeneration

    ✅ Postpone regeneration by 48h

