Update Readme.md

[mulles]

Making more information about the API used in this programm available

[Trickfilm400]

Hi,

thank you for your contribution, very nice idea!

I used the original manual which I found online here https://community.symcon.de/t/senertec-bhkw-glt-einbindung-ueber-lan-ethernet/26658, but it's a .rar file: https://community.symcon.de/uploads/short-url/6LOE4M5F4zx6XNMeQGgZEAs7AiC.rar

I think uploading the PDF file would not a issue with copyright and so on 🤔

I'm a bit confused about the given manual, as it has the information needed, but is for a different product? :D

[mulles]

Providing links with the document title "Beschreibung der
GLT-Schnittstelle - Dachs Ethernet -" from 2011 seems save.
Uploading .pdf documents in your repository even though more persistent, seems not the low risk method considering copyright.

You seem to have better overview over senertec documentation, do you know on what this python lib is based:
https://github.com/Kleinrotti/py-senertec

The main part of the programm is here and it is connecting to https://dachsconnect.senertec.com/ but somehow using websockets (wss://dachsconnect.senertec.com/ws) and I could not find any documentation for the API.

I am currently working on a project, which is connecting to dachsportal.senertec.com to receive energy production per month and based on that calculate what the grid provider will pay your at the end of the year. I will publish my source code soon, currently I am using selenium python lib to scrap the dachsportal.senertec.com, but I would love to use a defined API.
We can speak german if you like am based in the capital city.

[mulles]

For me the manual your linked fits the product. The communication board can be build in, into many different BHKW's. Maybe I did not get your questions?

[Trickfilm400]

do you know on what this python lib is based: https://github.com/Kleinrotti/py-senertec

It seems this uses the Cloud-API. There was (is?) an online portal to get the information, but I don't know anything about this as my credentials for this are old and not functioning anymore, when the android app was updated a few years back.

I could not find any documentation for the API.

I assume it's reverse-engineered

(This repo uses the local API of the GLT-module, no cloud communication)

I am currently working on a project, which is connecting to dachsportal.senertec.com to receive energy production per month and based on that calculate what the grid provider will pay your at the end of the year. I will publish my source code soon, currently I am using selenium python lib to scrap the dachsportal.senertec.com, but I would love to use a defined API.

Then I would use the Hka_Bd.ulArbeitElektr key and get the delta of the month (so fetching every month and calculate the difference to get the value of one month and use this to calculate everything else

Maybe I did not get your questions?
Oh, there is a typo - well anyways

I think we can create a table at the end of the readme with something like References and just put every link we have in there. So in the case one link breaks, there are a few more; what do you think about this?

[mulles]

I like the reference idea, I can try to implement it quick, but you seems to have a clearer idea and would be less back and forth.

Your credentials are usually b"the serial number" of the BHKW and the ZIP Code where it is installed.
Made up example:
username: b62465
Password: 52475

It is clear to me that you are using the local API :) This is not an option for me as VPN Connection to the house projects is not reliant long term.

[Trickfilm400]

I've added a section to the readme at the bottom with a few links. If you have more links which are useful, we can add them of course

Your credentials are usually b"the serial number" of the BHKW and the ZIP Code where it is installed.

I've found the old portal manual: https://dachsportal.senertec.com/files/DachsPortal_manual_de_DE.pdf
But maybe the credentials were changed at some point, I don't know

It is clear to me that you are using the local API :) This is not an option for me as VPN Connection to the house projects is not reliant long term.

Sorry, I was a bit confused :D

Yeah, to collect data via the local API on a remote server I think you would need a local component of some sort which could push the local data to the remote server (or like a proxy to access the data from somewhere else), I don't have another solution in mind

EDIT: I will add an OpenAPI Schema for the API Documentation soon, so there's an easy documentation for the plain HTTP endpoints