home-assistant / home-assistant.io

:blue_book: Home Assistant User documentation
https://www.home-assistant.io
Other
4.96k stars 7.27k forks source link

Documentation doesn't mention that an Airthings hub is required #31977

Open dbpage opened 7 months ago

dbpage commented 7 months ago

Feedback

Neither Airthings nor the Integration documentation mentions that an Airthings hub is necessary to integrate with Home Assistant. I went round and round until I decided to power my View Plus with USB. Adding the Airthings integration went exactly as documented. The hub was the missing piece. Please add a note about this.

URL

https://www.home-assistant.io/integrations/airthings/

Version

2024.3.1

Additional information

No response

home-assistant[bot] commented 7 months ago

Hey there @danielhiversen, @lastrada, mind taking a look at this feedback as it has been labeled with an integration (airthings) you are listed as a code owner for? Thanks!

Code owner commands Code owners of `airthings` can trigger bot actions by commenting: - `@home-assistant close` Closes the feedback. - `@home-assistant rename Awesome new title` Renames the feedback. - `@home-assistant reopen` Reopen the feedback. - `@home-assistant unassign airthings` Removes the current integration label and assignees on the feedback, add the integration domain after the command. - `@home-assistant add-label needs-more-information` Add a label (needs-more-information) to the feedback. - `@home-assistant remove-label needs-more-information` Remove a label (needs-more-information) on the feedback.
LaStrada commented 7 months ago

Thanks for reporting this! Yes, you're right. The Hub (SmartLink) functionality is not mentioned in the documentation.

You can actually use this integration without any hub, but you won't get any live updates, and you need to rely on the app to sync over Bluetooth and then upload to the cloud.

Adding something about the hub will probably help people to not debug this themself 👍