oekofen-api 0.0.25

A python library to retrieve statistics from your Oekofen Pelletronic

Oekofen API

Usage

• change 192.168.178.222 to your Oekofen IP
• change eMlG to your JSON Password (see Touchpad of your Oekofen)

import oekofen_api
import time

client = oekofen_api.Oekofen("192.168.178.222", "eMlG")
#client.update_csv_data()
x = client.update_data()
client.get_version()
client.get_uid()
client.get_model()
client.get_name()

client.update_data()
client.get_status()
client.get_weather_temp()
client.get_heating_circuit_temp()


old_value = client.get_attribute('pu', 'L_tpo_act').get_value()
print(old_value)
while True:
    try:
        client.update_data()
    except Exception:
        time.sleep(5)
        continue
    new_value = client.get_attribute('pu', 'L_tpo_act').get_value()
    time.sleep(10)
    if new_value != old_value:
        print(old_value, new_value)
        old_value = new_value

#client.set_heating_circuit_temp(celsius=23)

Todo

• dont use domains and attributes- make it less complicate and pass dict to homeassistant, then use data scheme like netgear integration
• add historical data via csv api and HASS async_external_statistics
  • https://github.com/home-assistant/core/blob/74e2d5c5c312cf3ba154b5206ceb19ba884c6fb4/homeassistant/components/tibber/sensor.py#L642
  • https://github.com/home-assistant/core/blob/74e2d5c5c312cf3ba154b5206ceb19ba884c6fb4/homeassistant/components/demo/__init__.py#L236
  • https://github.com/home-assistant/core/blob/74e2d5c5c312cf3ba154b5206ceb19ba884c6fb4/homeassistant/components/recorder/statistics.py#L1335-L1362
  • see forum

Online Resources

• pyOekofen implementation by JbPasquier
• Local Pellematic JSON page
• This repository on pypi
• HomeAssistant BinarySensor Documentation
• HomeAssistant BinarySensor Source
• Local Homeassistant Instance
• Material Icons
• Abkürzungen Sanitär

Berechnung Pelletsverbrauch

Berechnungsgrundlage: Abschnitt Calculations in Oekofen-Spy

1. Ableitung pe1_L_modulation via derivative minütlich
   1. siehe Integration derivative / Code Berechnung der Ableitung
   2. <Differenz Sensortwert alt - Sensorwert neu> / <Sekunden zwischen beiden Sensorwerten> / 1 * <Sekunden = 60>
   3. Einrichten als Helper derivative_modulation
2. Helper einrichten Schwellenwertsensor für derivative_modulation
   1. Hysterese: 0
   2. Untere Grenze: 0
   3. Obere Grenze: 1000
   4. Ergebnis: True/False für den Zeitraum, wenn der Wert positiv ist
   5. Muss der Schwellenwertsensor evtl. vor den Ableitungssensor? (non_negative_derivative)
3. Formel Pelletsverbrauch:
   1. Schwellwert / 60 * <kW Leitung Pelletsheizung, z.B. 7.8kW> *