search

OpenWonderLabs / homebridge-switchbot

The Homebridge SwitchBot plugin allows you to access your SwitchBot Device(s) from HomeKit. Homebridge.
https://openwonderlabs.github.io/homebridge-switchbot/
ISC License
239 stars 51 forks source link

Feature Request: Add Troubleshooting in docs #973

Closed martenmatrix closed 3 months ago

martenmatrix commented 4 months ago

Problem

No response

Solution

I had an immense pain setting this up on Linux because of bluetoothctl. I would recommend users to run sudo bluetoothctl power on in their terminal to see if any errors are being outputted. If there are some errors, there is the following vague solution, which works 80% of the time; killing and restarting the processes with rfkill block bluetooth and rfkill unblock bluetooth.

Additionally, I would recommend users to check, if their Linux even recognizes their device with sudo bluetoothctl and scan on to see, if their device is listed there.

This would prevent many issues from being opened about not being able to set up the plugin.

Alternatives

No response

Additional context

No response

donavanbecker commented 4 months ago

Feel free to open a PR

github-actions[bot] commented 3 months ago

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

martenmatrix commented 3 months ago

bump, will add asap

github-actions[bot] commented 3 months ago

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

donavanbecker commented 3 months ago

v3.5.1 has been released, this is included in this.