viessmann-gridbox-connector 1.2.0

No project description provided

Viessmann Gridbox Connector

This is not an official Viessmann library

a GridboxConnector Lib to fetch your Data from the Cloud. It is using the same Rest-API like the Dashboard and the App.

Installation

pip install viessmann-gridbox-connector

Set your email and password in the config.json. Use your Login Data from the App or from https://mygridbox.viessmann.com/login

Setup the python environment and install all dependencies

python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt

Example Output

{
    "consumption": 496,
    "directConsumption": 413,
    "directConsumptionEV": 0,
    "directConsumptionHeatPump": 0,
    "directConsumptionHeater": 0,
    "directConsumptionHousehold": 413,
    "directConsumptionRate": 1,
    "grid": 83,
    "gridMeterReadingNegative": 4318200000,
    "gridMeterReadingPositive": 14499360000,
    "measuredAt": "2023-08-04T11:29:43Z",
    "photovoltaic": 413,
    "production": 413,
    "selfConsumption": 413,
    "selfConsumptionRate": 1,
    "selfSufficiencyRate": 0.8326612903225806,
    "selfSupply": 413,
    "totalConsumption": 496
}

Usage

from gridbox_connector import GridboxConnector

# Initialize the connector with your configuration
config = {
  "urls": {
    "login":"https://gridx.eu.auth0.com/oauth/token",
    "gateways":"https://api.gridx.de/gateways",
    "live":"https://api.gridx.de/systems/{}/live"
  },
  "login":{
    "grant_type":"http://auth0.com/oauth/grant-type/password-realm",
    "username":"email",
    "password":"password",
    "audience":"my.gridx",
    "client_id":"oZpr934Ikn8OZOHTJEcrgXkjio0I0Q7b",
    "scope":"email openid",
    "realm":"viessmann-authentication-db"
  }
}

connector = GridboxConnector(config)

# Retrieve live data
live_data = connector.retrieve_live_data()
print(live_data)

Configuration

You need to provide a configuration dictionary with the following keys:

urls: Dictionary containing endpoint URLs. login: Dictionary containing login credentials.

Dependencies

requests

Contributing

If you'd like to contribute to viessmann-gridbox-connector, please follow these steps:

Fork the repository. Create a new branch for your feature or bug fix. Make your changes and write tests if possible. Run tests and ensure they pass. Submit a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.