Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Intel - Home Assistant examples and README #294

Merged
merged 7 commits into from
Apr 27, 2022

Conversation

mmccool
Copy link
Contributor

@mmccool mmccool commented Apr 22, 2022

I have been working on a project to extract information from the Home Assistant RESTful API and express access to various Home Assistant "entities" as WoT TDs. This PR includes six example TDs generated this way.

This has not been completely successful because of the way the Home Assistant API mixes data and metadata. The API does not really include ALL the metadata needed to generate a TD, some of it is implicit in the Home Assistant documentation, some is not exposed through the API, some is inconsistently exposed (such as the device categories, sometimes an entity is only defined as a "sensor", and "binary_sensors" might use different values for on-off depending on their device category, etc. etc.). Also, some things like events need JSON RPC and Web Sockets which WoT does not do yet.

In the long run a Home Assistant "add-on" is probably needed to do this properly...

Good news is HA uses bearer tokens so this adds a test for that security mechanism. Bad news is HA requires bearer tokens even if you are using plain HTTP (which is pointless), and it only has a primitive mechanism to limit scopes (so if I open up my HA to a tester, I have to open ALL devices on that instance, not just specific ones; there are "groups" under development in HA but they aren't enforced yet).

See the README.md for more details.

@mmccool mmccool changed the title Intel - Home Assistant examples and README WIP: Intel - Home Assistant examples and README Apr 22, 2022
@mmccool mmccool marked this pull request as draft April 22, 2022 17:46
@mmccool mmccool marked this pull request as ready for review April 27, 2022 10:45
@mmccool mmccool changed the title WIP: Intel - Home Assistant examples and README Intel - Home Assistant examples and README Apr 27, 2022
@mmccool mmccool merged commit 3ddfbc9 into w3c:main Apr 27, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant