Bluetooth (Русский)

Bluetooth является стандартом для беспроводных соединений малой дальности сотовых телефонов, компьютеров и других электронных устройств. В Linux канонической реализацией стека протоколов Bluetooth является BlueZ.

Состояние перевода: На этой странице представлен перевод статьи Bluetooth. Дата последней синхронизации: 24 сентября 2021. Вы можете помочь синхронизировать перевод, если в английской версии произошли изменения.

Установка

Установите пакет bluez, который предоставляет стек Bluetooth протокола.
Установите bluez-utils, предоставляющий утилиту bluetoothctl. В качестве альтернативы можно установить , который содержит устаревшие инструменты BlueZ.
Универсальный драйвер Bluetooth находится в модуле ядра . Проверьте, что он загружен. Если нет, то загрузите его вручную.
Запустите и включите службу .

Консольные

bluetoothctl — Сопряжение устройств через командную строку является одним из самых простых и надежных вариантов.

http://www.bluez.org/ || bluez-utils

Совет: Для автоматизации команд bluetoothctl используйте echo -e "команда1\nкоманда2\n" | bluetoothctl или bluetoothctl -- команда.

Графические

Следующие пакеты позволяют настраивать Bluetooth с помощью графического интерфейса.

Сопряжение

Этот раздел описывает прямую настройку bluez5 через утилиту командной строки bluetoothctl. Это необязательно, если вы используете какой-нибудь другой инструмент (например, GNOME Bluetooth).

Точная процедура зависит от особенностей конкретного устройства; эта инструкция описывает сопряжение с устройством при помощи лишь в общих чертах.

Запустите интерактивную команду bluetoothctl. После этого можно ввести для получения списка доступных команд.

(необязательно) Выберите контроллер по умолчанию командой select MAC-адрес.
Включите питание контроллера, введя power on. По умолчанию оно отключено и отключается при каждой перезагрузке; смотрите #Автоматическое включение после загрузки.
Введите , чтобы увидеть MAC-адрес устройства для сопряжения.
Войдите в режим обнаружения устройств при помощи команды , если нужного вам устройства нет в списке.
Включите агент при помощи или выберите конкретный агент: если вы введёте и дважды нажмёте Tab, будет отображён список доступных вариантов. Агент Bluetooth управляет кодом сопряжения. должен подойти в большинстве случаев.
Введите , чтобы осуществить сопряжение (работает автодополнение по tab).
При использовании устройства без PIN, возможно, потребуется подтверждение, прежде чем оно сможет успешно переподключиться. Для этого введите .
Наконец, используйте для установки соединения.

Ваша сессия будет выглядеть примерно так:

# bluetoothctl 
[NEW] Controller 00:10:20:30:40:50 pi [default]
[bluetooth]# agent KeyboardOnly 
Agent registered
[bluetooth]# default-agent 
Default agent request successful
[bluetooth]# scan on
Discovery started
[CHG] Controller 00:10:20:30:40:50 Discovering: yes
[NEW] Device 00:12:34:56:78:90 myLino
[CHG] Device 00:12:34:56:78:90 LegacyPairing: yes
[bluetooth]# pair 00:12:34:56:78:90
Attempting to pair with 00:12:34:56:78:90
[CHG] Device 00:12:34:56:78:90 Connected: yes
[CHG] Device 00:12:34:56:78:90 Connected: no
[CHG] Device 00:12:34:56:78:90 Connected: yes
Request PIN code
[agent] Enter PIN code: 1234
[CHG] Device 00:12:34:56:78:90 Paired: yes
Pairing successful
[CHG] Device 00:12:34:56:78:90 Connected: no

Сопряжение при Dual boot

Чтобы сопряжение работало во всех установленных операционных системах, необходимо изменить ключи сопряжения так, чтобы они были одинаковыми во всех системах.

Установка

Чтобы следать это, сперва сделайте сопряжение в вашем Arch Linux. Потом перезагрузитесь в другую ОС и сделайте сопряжение там. Теперь нужно извлечь ключи сопряжения, но сперва отключите Bluetooth-устройства, чтобы не было ненужных попыток подключения до завершения настройки.

Извлечение ключей в Windows

Запись реестра, содержащая ключи, доступна только пользователю SYSTEM, в которого нельзя выполнить вход. Поэтому понадобится утилита PsExec с официального сайта Windows Sysinternals для запуска от имени SYSTEM.

Скачайте архив PsTools и извлеките из него файл .

Запустите командную строку от имени администратора, перейдите в папку с извлечённым exe-файлом и запустите редактор реестра:

.\PsExec64.exe -s -i regedit.exe

Откройте эту ветку реестра:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BTHPORT\Parameters\Keys

В ней содержатся подветки для каждого Bluetooth-адаптера по их MAC-адресам. Если их несколько и вы не знаете, какой из них вам нужен, смотрите эту инструкцию для выяснения MAC-адреса нужного вам Bluetooth-адаптера.

В ветках каждого адаптера лежат записи для каждого сопряжённого устройства аналогично по MAC-адресам с ключами в бинарном виде.

Для каждого устройства, которое вы хотите сделать доступным во всех ОС, нажмите правой кнопкой мыши на соответствующий ключ в реестре и экспортируйте его в .reg. Как вариант, можно скопировать hex-значение.

Если есть записи , и , значит это Bluetooth 5.1 устройство и эти записи тоже нужно экспортировать.

Извлечение ключей в Linux

Перезагрузитесь в Arch. Установите . Примонтируйте ваш Windows-раздел.

$ cd /путь/к/windows/диску/Windows/System32/config
$ chntpw -e SYSTEM

В окружении выполните

> cd CurrentControlSet\Services\BTHPORT\Parameters\Keys

Затем узнайте MAC-адрес вашего Bluetooth-адаптера и перейдите в соответствующую папку

> ls
> cd mac-адрес

Сделайте то же самое с сопряжёнными устройствами:

Теперь можно получить ключ устройства через hex:

> hex 123456789876

:00000 XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX (всякие другие символы)

«XX»ы и являются ключом сопряжения. Запомните, какие ключи каким MAC-адресам соответствуют.

В случае BT5.1 вы можете увидеть такой вывод:

Здесь нужно сохранить , и .

Подготовка ключей Bluetooth 5.1

Если в реестре для нужного устройства были ключи , и , они должны быть сконвертированы для использования в Linux. соответствует , — , — . Значение должно быть развёрнуто и преобразовано в десятичное число. ННапример:

Из со значением получается со значением .
Из со значением получается со значением .
Из со значением 37520 получается со значением 37520.

Для macOS

Загрузитесь в macOS, откройте терминал.

Если у вас Sierra или старее, выполните

Если у вас High Sierra или новее, выполните

$ sudo defaults read /private/var/root/Library/Preferences/com.apple.bluetoothd.plist LinkKeys > ~/bt_keys.txt

Для старых версий macOS (High Sierra и более ранние) нужно развернуть ключи. Например, преобразуется в .

Скопируйте файл на диск, который можно будет прочитать в Arch Linux, и перезагрузитесь в Arch Linux.

Завершение

Теперь, когда у вас есть нужные ключи, войдите как root и перейдите в каталог:

Здесь вы найдёте подкаталоги для каждого сопряжённого устройства. Для каждого нужного устройства перейдите в его подкаталог:

Измените файл и подставьте ключ под [LinkKey], например:

Затем перезапустите и (командой ).

Теперь устройство должно успешно подключаться.

Примечание: В зависимости от вашего менеджера Bluetooth может понадобиться выполнить полную перезагрузку для переподключения устройств.

Настройка

Автоматическое включение после загрузки

По умолчанию адаптер Bluetooth не включается после перезагрузки. Если вам это нужно, добавьте строку в файле конфигурации в разделе :

/etc/bluetooth/main.conf

[Policy]
AutoEnable=true

Видимость при запуске системы

Если вы хотите, чтобы ваше устройство всегда было видимо и доступно для подключения:

Аудио

Обычно нужны дополнительные шаги для интеграции аудиосервера с Bluetooth. Подробнее это описано ниже.

Смотрите также Bluetooth headset для информации о подключении Bluetooth-гарнитуры.

PulseAudio

Установите пакет . Не забудьте перезапустить PulseAudio после переустановки: . При стандартной установке PulseAudio после этого у вас сразу должна появиться возможность использования Bluetooth-устройств.

Если ваш PulseAudio работает как общесистемная служба, убедитесь, что пользователь, от имени которого запущен демон (обычно ), состоит в группе , и не забудьте загрузить нужные модули:

PipeWire

PipeWire с версии 0.3.19 включает свою поддержку Bluetooth по умолчанию, смотрите Config Bluetooth.

ALSA

Сперва убедитесь, что ваше аудиоустройство Bluetooth подключено и сопряжено с системой.

Затем установите , запустите (и включите) службу bluealsa и добавьте своего пользователя в группу .

Выполните следующую команду для проверки, что всё работает (замените XX:XX:XX:XX:XX:XX и на нужные значения):

$ aplay -D bluealsa:SRV=org.bluealsa,DEV=XX:XX:XX:XX:XX:XX,PROFILE=a2dp ФАЙЛ.wav

В завершение добавьте эти строки в :

Теперь можно использовать устройство bluealsa для доступа к аудиоустройству Bluetooth. Управление объемом обычно осуществляется через с опцией .

Bluetooth serial

Чтобы получить последовательную связь на Bluetooth-to-Serial модулях (HC-05, HC-06), выполните следующие шаги:

Выполните сопряжение с вашим устройством Bluetooth с помощью bluetoothctl как описано выше.

Установите и , так как они предоставляют функции, отсутствующие в более новых инструментах.

Привяжите MAC-адрес сопряжённого устройства к терминула tty:

# rfcomm bind rfcomm0 MAC-адрес-устройства

Теперь можно открыть /dev/rfcomm0 для последовательной связи:

picocom /dev/rfcomm0 -b 115200

Решение проблем

Отладка

Для отладки сперва остановите .

Затем запустите его напрямую с параметром :

# /usr/lib/bluetooth/bluetoothd -n -d

Другой вариант — использовать инструмент btmon.

Устаревшие инструменты BlueZ

Восемь инструментов BlueZ объявлены устаревшими и удалены из bluez-utils, хотя не для всех из них есть замена среди новых инструментов. Пакет предоставляет альтернативный вариант bluez-utils, включающий в себя устаревшие инструменты.

Устаревший инструмент	Ближайшая замена
gatttool	btgatt-client, D-Bus Gatt API
hciattach	btattach
hciconfig	btmgmt (и bluetoothctl?)
hcidump	btmon (и btsnoop)
hcitool	отсутствует, есть D-Bus Device API
rfcomm	отсутствует, сделать с D-Bus Profile1 API?
ciptool	отсутствует, сделать с D-Bus Profile1 API?
sdptool	отсутствует, функциональность кажется разбросанной по разным объектам DBus: Profile, Advertising, и массивы UUID в device и adapter.

gnome-bluetooth

Если вы видите это при попытке включить получение файлов в настройках bluetooth:

Bluetooth OBEX start failed: Invalid path
Bluetooth FTP start failed: Invalid path

То убедитесь, что пользовательские каталоги XDG существуют.

Bluetooth USB донгл

Если вы пользуетесь USB донглом, вы должны проверить, что ваш Bluetooth донгл распознан системой. Это можно сделать с помощью команды , после того как вы воткнёте USB донгл (или заглянув в ). Должно появиться что-то вроде следующего (ищите hci):

Если вы получили только первые две строки, значит донгл распознан, но вам необходимо его активировать (поднять). Пример:

# btmgmt

[hci0]# info

hci0:	Primary controller
	addr 00:1A:7D:DA:71:10 version 6 manufacturer 10 class 0x1c0104
	supported settings: powered connectable fast-connectable discoverable bondable link-security ssp br/edr hs le advertising secure-conn debug-keys privacy static-addr 
	'''current settings: powered''' connectable discoverable bondable ssp br/edr le secure-conn

Или

# bluetoothctl

Чтобы убедиться, что устройство было определено, вы можете использовать , являющуюся частью . Вы можете получить список доступных устройств, их идентификаторов и MAC-адресов, используя:

$ btmgmt info

Index list with 1 item
hci0:	Primary controller
	addr 00:1A:7D:DA:71:10 '''version 6''' manufacturer 10 class 0x1c0104
	supported settings: powered connectable fast-connectable discoverable bondable link-security ssp br/edr hs le advertising secure-conn debug-keys privacy static-addr 
	current settings: powered connectable discoverable bondable ssp br/edr le secure-conn

Для проверки версии Bluetooth можно сопоставить её с версией HCI по таблице из официальной спецификации. Например, в предыдущем выводе HCI version 6 означает Bluetooth 4.0.

Более детальная информация об устройстве может быть получена с помощью устаревшего инструмента . ()

Устройства аудио начинают пропускать звук на небольшом расстоянии от донгла

Если другие устройства работают через тот же USB-хост, они могут прерывать связь с устройствами аудио. Убедитесь, что только Bluetooth-устройство подключено к соответствующей USB-шине. Например:

CSR Dongle 0a12:0001

С устройством есть баг, и оно сейчас работает только в версиях ядра ≤ 3.9.11. Есть патч для новых версий. Подробнее смотрите Kernel Bug 60824.

Logitech Bluetooth USB донгл

Существуют Logitech донглы (например, Logitech MX5000), которые могут работать в двух режимах: встроенный (Embedded) и HCI. Во встроенном режиме донгл эмулирует устройство USB так, что ваш компьютер думает, что вы используете обычную USB мышь/клавиатуру.

Если вы нажмёте маленькую красную кнопку на USB BT мини-приёмнике, включится другой режим. Удерживайте красную кнопку на BT донгле и вставьте его в компьютер, и через 3-5 секунд удерживания кнопки в системном трее появится иконка Bluetooth (Обсуждение).

В качестве альтернативы, вы можете установить пакет bluez-hid2hci. Когда вы подключите ваш Logitech донгл, он автоматически переключится.

hcitool scan: Устройство не найдено

На некоторых ноутбуках Dell (например, Studio 15) вы должны переключить режим Bluetooth с HID на HCI. Установите пакет bluez-hid2hci, после чего udev будет делать это автоматически. В качестве альтернативы вы можете выполнить эту команду для переключения на HCI вручную:

# /usr/lib/udev/hid2hci

Если устройство не появится, а на вашей машине есть операционная система Windows, попробуйте загрузить её и включить адаптер bluetooth в windows.

Иногда также помогает эта простая команда:

# bluetoothctl power on

bluetoothctl: No default controller available

Эта ошибка может случаться, если устройство заблокировано через rfkill.

Также это случается с некоторыми картами intel (такими как 8260), которые не распознаются корректно службой Bluetooth. Иногда использование устаревшего взамен bluez-utils, как сообщалось, решает проблему.

Это также может быть вызвано мерами по энергосбережению, тогда добавление параметра ядра может помочь. Смотрите также Red Hat Bugzilla – Bug 1573562.

systemd: Condition check resulted in Bluetooth service being skipped

требует только существование каталога , который создаётся модулем ядра , который автоматически загружается через , если он находит работающее устройство Bluetooth.

Если у вас не существует, проверьте, что модуль Bluetooth загружен, с помощью . Если нет, и вы уверены, что у вас есть устройство Bluetooth, попробуйте загрузить его вручную и перезапустить службу .

Также нужно загрузить соответствующий драйвер Bluetooth, чаще всего , но иногда могут понадобиться и т.д.

Проверьте статус , чтобы убедиться, что он запущен.

Смотрите также Debian Bug report logs - #853207.

Если успешно запущен, есть шанс, что использовать Bluetooth нормально всё равно не получится (например, bluetoothctl говорит что-то вроде при выполнении ). Если такое случается, попробуйте перезагрузить компьютер и дважды проверьте: каталог существует; содержит нужные модули Bluetooth; сообщения в журнале; и т.д. должен подхватить ваше устройство Bluetooth автоматически.

rfkill unblock: не происходит разблокировка

Если ваше устройство по-прежнему программно блокируется и у вас запущен connman, попробуйте это:

$ connmanctl enable bluetooth

Мой компьютер невидим

Включите режим обнаружения:

# bluetoothctl discoverable on

Убедитесь, что он включен:

# bluetoothctl show

	Powered: yes
	Discoverable: yes
	Pairable: yes

Если компьютер всё равно невидим, попробуйте изменить класс устройства в /etc/bluetooth/main.conf, как здесь:

# Default device class. Only the major and minor device class bits are
# considered.
#Class = 0x000100 # Computer Type (from default config)
Class = 0x100100 # (Object-Transfer Service & Computer Type)

Примечание: Иногда Class в файле main.conf оказывается переопределён после инициализации устройства, так что попробуйте установить класс напрямую с помощью hciconfig hci0 class 100100.

Пользователь сообщал, что это было единственное решение, сделавшее его компьютер видимым для телефона. Телевизоры LG (и некоторые другие) видимы с других устройств аудио, так что использование класса (soundbar) заставит такие устройства появиться.

Смотрите https://bluetooth-pentest.narod.ru/software/bluetooth_class_of_device-service_generator.html для генерации классов устройств/служб Bluetooth.

Foxconn / Hon Hai / Lite-On Broadcom

Некоторые из этих устройств необходимо прошивать при загрузке. Файлы прошивок не предоставляются, но их можно сконвертировать из Windows-файлов .hex в .hcd с помощью hex2hcd (который устанавливается с bluez-utils).

Чтобы получить нужный .hex файл, попробуйте поискать vendor:product (производитель:продукт) из lsusb, например:

...
Bus 002 Device 004: ID 04ca:2006 Lite-On Technology Corp. Broadcom BCM43142A0 Bluetooth Device
...

или

Bus 004 Device 004: Id 0489:e031 Foxconn / Hon Hai

В качестве альтернативы, вы можете загрузиться в Windows (можете использовать виртуальную машину) и узнать название прошивки из утилиты Диспетчер Устройств. Если вы хотите знать модель устройста, но не видите его в lsusb, его можно увидеть в lsusb -v как .

Файл .hex можно извлечь из скачанного драйвера Windows без необходимости загружать Windows. Скачайте правильный драйвер, например Bluetooth Widcomm (перечислен среди драйверов для Lifebook P771), который содержит драйверы для многих устройств Broadcomm. В случае Widcomm драйвер является самораспаковывающимя RAR-архивом, так что его можно распаковать с помощью x. Чтобы найти, какой из .hex файлов нужен вам, смотрите и ищите , где следует заменить на product code вашего устройства (второе hex-число из lsusb) в верхнем регистре.

Когда вы сконвертируете его в .hcd, скопируйте его в /lib/firmware/brcm/BCM.hcd — это имя файла предлагает dmesg и может быть другим, так что проверьте вывод dmesg у себя. Затем перезагрузите модуль

# rmmod btusb
# modprobe btusb

Теперь устройство должно быть доступно. Смотрите BBS#162688 для информации о том, как сделать эти изменения постоянными.

Комбинированные WiFi-Bluetooth карты Intel

See Wireless network configuration (Русский)#Bluetooth Coexistence.

Устройство подключается и затем отключается спустя мгновение

Если вы видите в журнале подобные сообщения и устройство не может подключиться или отключается вскоре после подключения:

bluetoothd: Unable to get connect data for Headset Voice gateway: getpeername: Transport endpoint is not connected (107)
bluetoothd: connect error: Connection refused (111)

Это может быть из-за того, что вы уже настроили сопряжение с этим устройством в другой операционной системе с тем же Bluetooth-адаптером (например, в случае dual-booting). Некоторые устройства не могут обрабатывать несколько сопряжений с одним и тем же MAC-адресом. Смотрите #Сопряжение при Dual boot для решения этой проблемы.

Устройство не подключается и пишет ошибку в журнал

Если при попытке подключения вы видите в журнале сообщение вроде такого:

a2dp-source profile connect failed for 9C:64:40:22:E1:3F: Protocol not available

попробуйте установить и перезапустить PulseAudio. Эта ошибка может проявиться даже при использовании только передачи файлов.

Устройство не видно в scan

Некоторые устройства с Bluetooth low energy не отображаются при сканировании в bluetoothctl, например Logitech MX Master. Самым простым найдённым путём для соединения может быть установка , запуск и выполнение:

[bluetooth]# power on

[CHG] Controller (MAC) Class: 0x0c010c
Changing power on succeeded
[CHG] Controller (MAC) Powered: yes

В другом терминале:

# hcitool lescan

Дождитесь появления устройства и затем прервите hcitool с помощью . Теперь bluetoothctl должен увидеть ваше устройство и позволить нормально настроить сопряжение.

Не удаётся получить файлы из-за символьной ссылки

Если передача файла обрывается при успешно работающем соединении Bluetooth, проблема может быть из-за символьных ссылок в пути. В журнале могут появиться примерно такие записи:

Jun 18 11:18:13 ember obexd[3338969]: open(/home/me/.cache/obexd/MOC740): Operation not permitted (1)

Если показанный здесь путь содержит символьную ссылку, то obexd по умолчанию не примет его. Поведение можно переопределить с помощью drop-in файла для пользовательской службы :

Затем выполните от имени нужного пользователя и перезапустите пользовательский юнит .

Интерференция между наушниками и мышью

Если аудио заикается при одновременном использовании Bluetooth мыши и клавиатуры, попробуйте это, как указано в #23 https://bugs.launchpad.net/ubuntu/+source/bluez/+bug/424215

# hciconfig hci0 lm ACCEPT,MASTER
# hciconfig hci0 lp HOLD,SNIFF,PARK

Bluetooth мышь двигается с задержкой

Попробуйте изменить файл (где - MAC-адрес вашего Bluetooth-адаптера, YY:YY:YY:YY:YY:YY - MAC-адрес вашей мыши), добавив туда следующие строки:

[ConnectionParameters]
MinInterval=6
MaxInterval=9
Latency=44
Timeout=216

Вы можете посмотреть MAC-адрес адаптера командой , а MAC-адреса подключенных устройств командой

Адаптер пропадает после ждущего режима

Сперва найдите product ID адаптера. Например:

В данном случае vendor ID — 8087, product ID — 0025.

Затем используйте для сброса адаптера:

# usb_modeswitch -R -v vendor_ID -p product_ID

Проблемы со всеми устройствами BLE на ядре 5.9+

С версии 5.9 стек Bluetooth в ядре пытается использовать link-layer privacy на BLE соединениях. Если устройство работает после сопряжения, но не переносит перезагрузку или ждущий режим — вероятно, из-за этого.

Чтобы обойти эту проблему, откройте , удалите следующие строки и перезапустите :

Смотрите связанное обсуждение на форуме Arch.

Смотрите также

gollark: Where are you anyway?

gollark: It's heavserver.

gollark: Interesting.

gollark: You realise epicbot prefixes it with "Heavpoot:"?

gollark: Heavserver.

This article is issued from Archlinux. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.