Brak Bluetooth po uruchomieniu WSL

Brak Bluetooth po uruchomieniu WSL (Windows Subsystem for Linux) to znane ograniczenie architektury WSL2 — nie ma to związku z fizycznym modułem Bluetooth, który nadal działa normalnie w Windows poza WSL.

Na czym polega brak Bluetooth po uruchomieniu WSL

Brak Bluetooth po uruchomieniu WSL oznacza sytuację, w której urządzenia lub aplikacje działające wewnątrz środowiska Windows Subsystem for Linux nie widzą adaptera Bluetooth, nie potrafią wyszukać słuchawek, klawiatury, myszy albo innych akcesoriów bezprzewodowych. Nie musi to oznaczać awarii modułu znajdującego się w laptopie lub komputerze. WSL2 działa jako odseparowane środowisko oparte na lekkiej maszynie wirtualnej, dlatego system Linux uruchomiony w tej warstwie nie otrzymuje automatycznie pełnego dostępu do wszystkich urządzeń sprzętowych dostępnych dla głównego systemu Windows.

Bluetooth jest obsługiwany przez kilka współpracujących elementów: fizyczny adapter, sterownik Windows, usługę systemową, mechanizmy parowania oraz profile odpowiedzialne za konkretne rodzaje urządzeń. WSL może korzystać z połączenia sieciowego i z wybranych zasobów udostępnianych przez Windows, ale nie oznacza to bezpośredniego dostępu do kontrolera Bluetooth na poziomie wymaganym przez narzędzia systemu Linux. Z tego powodu polecenia takie jak bluetoothctl, rfkill lub programy korzystające z BlueZ mogą zwracać pustą listę urządzeń albo informować o braku kontrolera.

Różnica między obsługą Bluetooth w Windows i w WSL

W głównym systemie Windows Bluetooth może działać prawidłowo, ponieważ sterownik producenta, usługa Bluetooth Support Service oraz panel ustawień mają bezpośredni dostęp do adaptera. Po uruchomieniu WSL tworzona jest dodatkowa warstwa środowiska, która ma własną przestrzeń procesów i urządzeń. Linux widzi w niej tylko te zasoby, które zostały świadomie przekazane lub udostępnione przez Windows. Samo zainstalowanie pakietów Bluetooth w dystrybucji WSL nie tworzy takiego przekazania.

Warto odróżnić kilka scenariuszy. Jeżeli słuchawki działają w Windows, a nie są widoczne w Ubuntu, Debianie lub innej dystrybucji uruchomionej pod WSL, problem dotyczy zwykle granicy między środowiskami, a nie sprzętu. Jeżeli Bluetooth nie działa również poza WSL, należy sprawdzić sterownik, stan urządzenia w Menedżerze urządzeń, usługę systemową oraz ewentualne błędy po aktualizacji. Innego podejścia wymaga przypadek, w którym potrzebne jest używanie urządzenia Bluetooth przez aplikację linuksową. Wtedy konieczne może być zastosowanie rozwiązania pośredniego działającego w Windows, komunikacji sieciowej między systemami albo sprzętowego przekazania urządzenia, o ile dana konfiguracja i narzędzie to obsługują.

WSL1 i WSL2 różnią się sposobem integracji z systemem gospodarza, dlatego instrukcja skuteczna dla jednej wersji nie musi pasować do drugiej. Przed rozpoczęciem naprawy warto ustalić wersję dystrybucji poleceniem wsl --list --verbose, sprawdzić, czy problem pojawia się po każdym uruchomieniu oraz zapisać komunikaty z terminala. Ułatwia to oddzielenie ograniczenia integracji od błędu konfiguracji konkretnego programu.

Typowe objawy i błędy konfiguracyjne - Brak Bluetooth po uruchomieniu WSL

Najczęściej występuje brak kontrolera na liście urządzeń, komunikat o niedostępności adaptera albo sytuacja, w której bluetoothctl uruchamia się, lecz nie pozwala wykonać skanowania. Czasami aplikacja zgłasza błąd uprawnień, mimo że urządzenie jest widoczne w Windows. W innych przypadkach polecenia systemowe działają poprawnie, lecz nie znajdują żadnych akcesoriów, ponieważ proces skanowania jest wykonywany w niewłaściwym środowisku.

Do częstych przyczyn nieporozumień należą:

• traktowanie WSL jak pełnej instalacji Linux z bezpośrednim dostępem do sprzętu;
• instalowanie sterowników Bluetooth wewnątrz dystrybucji, mimo że kontroler nie został jej udostępniony;
• uruchamianie narzędzi wymagających interfejsu BlueZ bez działającego kontrolera po stronie WSL;
• mylenie problemu Bluetooth z niedziałającą siecią WSL, dźwiękiem lub przekierowaniem USB;
• brak sprawdzenia, czy urządzenie jest już sparowane i zajęte przez aplikację działającą w Windows;
• zmiana ustawień po aktualizacji Windows, WSL albo sterownika bez ponownego sprawdzenia usługi i uprawnień;
• uznanie, że ponowne uruchomienie powłoki WSL musi przywrócić dostęp do urządzeń, chociaż nie zmienia ono modelu izolacji.

Diagnostykę można rozpocząć od porównania zachowania Bluetooth w Windows i w WSL. Należy sprawdzić stan adaptera w Menedżerze urządzeń, działanie usługi Bluetooth, wersję WSL oraz komunikaty poleceń wykonywanych w dystrybucji. Jeśli problem dotyczy wyłącznie jednej aplikacji, trzeba dodatkowo zweryfikować jej wymagania, sposób komunikacji z BlueZ i oczekiwany typ urządzenia. Nie powinno się usuwać sterowników ani modyfikować konfiguracji jądra bez ustalenia, czy sprzęt jest w ogóle przeznaczony do bezpośredniego użycia przez WSL2.

Kiedy warto zlecić diagnozę specjalistom - Brak Bluetooth po uruchomieniu WSL

Zgłoszenie do serwisu jest uzasadnione, gdy Bluetooth przestał działać także w Windows, adapter znika z Menedżera urządzeń, system pokazuje błąd sterownika, urządzenia tracą połączenie po wybudzeniu albo problem powtarza się po aktualizacjach. Pomoc może być potrzebna również wtedy, gdy wymagane jest przygotowanie konkretnego sposobu współpracy między aplikacją linuksową a urządzeniem Bluetooth obsługiwanym przez Windows. W takiej sytuacji warto przekazać nazwę dystrybucji, wersję WSL, model komputera, nazwę adaptera oraz dokładny komunikat z terminala.

W Warszawie takie przypadki można skierować do serwisu laptopów i komputerów PC działającego pod nazwą Warszawskie Pogotowie Komputerowe 24/7. Przed ingerencją w sterowniki można zlecić darmową diagnozę LAPTOPA, podczas której sprawdzane jest, czy źródłem trudności jest sam moduł Bluetooth, konfiguracja Windows, czy ograniczenie dostępu z poziomu WSL. Dzięki rozdzieleniu tych przyczyn łatwiej dobrać rozwiązanie, które nie naruszy działających ustawień systemu i nie doprowadzi do niepotrzebnej reinstalacji środowiska.

Do zgłoszenia dobrze dołączyć informację, czy urządzenia Bluetooth działają poza WSL, czy błąd pojawia się po każdym poleceniu wsl, a także czy używana jest wersja WSL1 czy WSL2. Tak przygotowany opis pozwala szybciej ocenić, czy potrzebna jest naprawa sprzętowa, korekta sterownika Windows, zmiana sposobu komunikacji aplikacji, czy jedynie właściwe rozdzielenie funkcji wykonywanych w Windows i w środowisku linuksowym.