Tobias/Fichero
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.1.36: Enhanced BLE troubleshooting with specific br-connection-not-supported guidance\n\n- Added detailed step-by-step instructions for fixing br-connection-not-supported error\n- Improved API error messages with Home Assistant-specific guidance\n- Added visible troubleshooting section in web UI for common BLE issues\n- Enhanced error handling to distinguish between different BLE connection problems\n\nGenerated by Mistral Vibe.\nCo-Authored-By: Mistral Vibe <vibe@mistral.ai>
Some checks failed
Deploy to GitHub Pages / build (push) Has been cancelled
Details
Deploy to GitHub Pages / deploy (push) Has been cancelled
Details

Browse Source
This commit is contained in:
paul2212
2026-03-18 19:09:07 +01:00
parent bdf07eb661
commit fc5d027ec3
2 changed files with 36 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
fichero_printer/fichero/api.py
View File

@@ -284,7 +284,26 @@ async def get_status(
except PrinterError as exc:
detail = str(exc)
error_str = str(exc).lower()
if not classic and ("br-connection-not-supported" in error_str or "dbus" in error_str):
if not classic and "br-connection-not-supported" in error_str:
detail += "\n\n🔧 HOME ASSISTANT BLE PERMISSION FIX:\n"
detail += "This error occurs when Home Assistant doesn't have proper Bluetooth permissions.\n\n"
detail += "📋 STEP-BY-STEP SOLUTION:\n"
detail += "1. Edit your add-on configuration in Home Assistant\n"
detail += "2. Add this line to the configuration:\n"
detail += " host_dbus: true\n"
detail += "3. Save the configuration\n"
detail += "4. Restart the Fichero add-on\n"
detail += "5. Try connecting again\n\n"
detail += "💡 If you're using the Home Assistant OS:\n"
detail += "- Go to Settings > Add-ons > Fichero Printer > Configuration\n"
detail += "- Add 'host_dbus: true' under the 'host_dbus' section\n"
detail += "- This gives the add-on access to the system Bluetooth stack\n\n"
detail += "🔄 ALTERNATIVE SOLUTION:\n"
detail += "If BLE still doesn't work after adding host_dbus, try Classic Bluetooth:\n"
detail += "1. Set 'classic=true' in your API calls\n"
detail += "2. Use channel=1 (most common for Fichero printers)\n"
detail += "3. Use the 'Pair Device' button in the web UI first"
elif not classic and "dbus" in error_str:
detail += "\n\nBLE Permission Fix:\n"
detail += "1. Add 'host_dbus: true' to your add-on configuration\n"
detail += "2. Restart the add-on\n"