Skip to content

Pythonaire/FakeGatoHistory

Repository files navigation

FakeGatoHistory

Based on the fabulous work of https://github.com/simont77/fakegato-history to work with HAP-Python https://github.com/ikalchev/HAP-python.

some modifications ...

The original fakegato-history have a variable mem cache for data records. I set the mem cache fixed to 4032 and the interval of 10 minutes (to prevent memory holes). That gives 4032/6 = 672 hours of values in the memory. Additional, the original javascript implementation has the ability to cache data on harddisk to prevent data lost in case of system crash. These function is implemented just under python3.10 and above. This file can be removed after uploading data to the client.

How To to use (example Weather data)

HAP-Python https://github.com/ikalchev/HAP-python holds the default Apple Homekit services and characteristics in two files 'services.json' and 'characteristics.json' under "/usr/local/lib/python3.x/dist-packages/pyhap/ressources". Apple change these definition in newer IOS versions. Additionally, maybe you like to define your own services. Because of that, i use my own service and characteristic definitions.

If you like to use your own definitions, add the following (see main.py):

from pyhap.loader import Loader as Loader
loader = Loader(path_char='CharacteristicDefinition.json',path_service='ServiceDefinition.json')
driver = AccessoryDriver(port=51826, persist_file= persist_file, loader=loader)

'CharacteristicDefinition.json'and 'ServiceDefinition.json' here, have the history service and characteristic descriptions.

Import the history library to your script:

from history import FakeGatoHistory

Link the history to your device class (here the example 'weather'):

self.History = FakeGatoHistory('weather', self)

If you like to store history data to prevent holes, in case of system crash, you can add "True". That is the same functionality as the original fakegato-history offer.

self.History = FakeGatoHistory('weather', self, True)

Push the data to the history by (here all 10 minutes)


@Accessory.run_at_interval(600)
    def run(self):
    ....
    self.History.addEntry({'time':int(round(time.time())),'temp':XXX,'humidity': XXX, 'pressure':XXX})

See 'Class Example.py' for more information.

Have fun.

About

Python transcoded fakegato-history

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages