「Bluetooth」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(テンプレート:Expansion を削除)
(同期)
 
(2人の利用者による、間の3版が非表示)
3行目: 3行目:
 
[[en:Bluetooth]]
 
[[en:Bluetooth]]
 
[[es:Bluetooth]]
 
[[es:Bluetooth]]
[[fr:Bluetooth]]
 
 
[[ru:Bluetooth]]
 
[[ru:Bluetooth]]
 
[[zh-hans:Bluetooth]]
 
[[zh-hans:Bluetooth]]
24行目: 23行目:
 
{{Note|
 
{{Note|
 
* デフォルトでは bluetooth デーモンは {{ic|lp}} [[ユーザーとグループ#システムグループ|グループ]]のメンバーのユーザーだけに bnep0 デバイスを提供します。bluetooth テザリングに接続するときはユーザーをグループに追加しておいてください。必要なグループは {{ic|/etc/dbus-1/system.d/bluetooth.conf}} ファイルで変更することができます。
 
* デフォルトでは bluetooth デーモンは {{ic|lp}} [[ユーザーとグループ#システムグループ|グループ]]のメンバーのユーザーだけに bnep0 デバイスを提供します。bluetooth テザリングに接続するときはユーザーをグループに追加しておいてください。必要なグループは {{ic|/etc/dbus-1/system.d/bluetooth.conf}} ファイルで変更することができます。
* Bluetooth アダプターには Wi-Fi カードがバンドルされているものもあります (例: [https://www.intel.com/content/www/us/en/wireless-products/centrino-advanced-n-6235.html Intel Centrino])。これらの Bluetooth アダプターをカーネルから見えるようにするには、まず Wi-Fi カードを有効にする必要があります (大体はラップトップ上のキーボードショートカットを使う)。
+
* Bluetooth アダプターには Wi-Fi カードがバンドルされているものもあります (例: [https://www.intel.com/content/www/us/en/wireless-products/centrino-advanced-n-6235.html Intel Centrino]{{Dead link|2023|09|16|status=404}})。これらの Bluetooth アダプターをカーネルから見えるようにするには、まず Wi-Fi カードを有効にする必要があります (大体はラップトップ上のキーボードショートカットを使う)。
 
* Bluetooth カードによってはネットワークアダプタと衝突することがあります (例: Broadcom)。したがって、ネットワークサービスを起動する前に Bluetooth デバイスを接続するようにしてください。
 
* Bluetooth カードによってはネットワークアダプタと衝突することがあります (例: Broadcom)。したがって、ネットワークサービスを起動する前に Bluetooth デバイスを接続するようにしてください。
 
* hcitool や hciconfig などのツールは上流では非推奨となっており、{{Pkg|bluez-utils}} にはもはや含まれていません。アップデートされないことが決まっているため、スクリプトの中で使用している場合は使わないように書き換えることを推奨します。それでも使いたい場合は {{AUR|bluez-utils-compat}} をインストールしてください。詳しい情報は {{Bug|53110}} や [https://lore.kernel.org/linux-bluetooth/20170104133401.3636-1-luiz.dentz@gmail.com/ Bluez メーリングリスト] を参照。}}
 
* hcitool や hciconfig などのツールは上流では非推奨となっており、{{Pkg|bluez-utils}} にはもはや含まれていません。アップデートされないことが決まっているため、スクリプトの中で使用している場合は使わないように書き換えることを推奨します。それでも使いたい場合は {{AUR|bluez-utils-compat}} をインストールしてください。詳しい情報は {{Bug|53110}} や [https://lore.kernel.org/linux-bluetooth/20170104133401.3636-1-luiz.dentz@gmail.com/ Bluez メーリングリスト] を参照。}}
66行目: 65行目:
   
 
# (任意) {{ic|select ''MAC Address''}} と入力してデフォルトのコントローラを選択してください。
 
# (任意) {{ic|select ''MAC Address''}} と入力してデフォルトのコントローラを選択してください。
# {{ic|power on}} と入力してコントローラの電源を入れさい。デフォルトでになっており、起動するたびにオフになります[[#起動後/再開後に自動で有効にする]] を見てください
+
# (任意) デバイスがオフになっている場合、{{ic|power on}} と入力してコントローラの電源供給オンにしください。デバイスはデフォルトでオになってます ([[#アダプタのデフォルト電源状態]])
 
# {{ic|devices}} と入力して、ペアリングしたいデバイスの MAC アドレスを取得してください。
 
# {{ic|devices}} と入力して、ペアリングしたいデバイスの MAC アドレスを取得してください。
 
# デバイスが表示されないときは {{ic|scan on}} コマンドでデバイス検出モードにしてください。
 
# デバイスが表示されないときは {{ic|scan on}} コマンドでデバイス検出モードにしてください。
113行目: 112行目:
 
=== デュアルブートペアリング ===
 
=== デュアルブートペアリング ===
   
デュアルブート環境でデバイスをペアリングするには、Linux インストール時にペアリングキーを手動で変更し、両方のシステム一致すようにする必要があります。
+
デュアルブート環境でデバイスをペアリングするには、Linux の方でペアリングキーを変更して Windows または macOS 使用されていペアリングキーと同じにする必要があります。
  +
  +
このページでは、これを手動で行う方法のみを説明しています。この手順を自動化するには、[https://github.com/x2es/bt-dualboot bt-dualboot プロジェクト]や関連するリポジトリを参照してください。
   
 
==== 設定方法 ====
 
==== 設定方法 ====
119行目: 120行目:
 
これを行うには、まず Arch Linux 上でデバイスのペアリングを行います。その後、もう一方の OS を再起動し、デバイスをペアリングします。ここでペアリング・キーを取り出す必要がありますが、まず Bluetooth デバイスの電源を切り、接続を試みないようにします。
 
これを行うには、まず Arch Linux 上でデバイスのペアリングを行います。その後、もう一方の OS を再起動し、デバイスをペアリングします。ここでペアリング・キーを取り出す必要がありますが、まず Bluetooth デバイスの電源を切り、接続を試みないようにします。
   
{{Note|([[Logitech MX Master|MX Master 3]] などの)一部の Logitech デバイスは、デバイスが新しいシステムとペアリングするたびに MAC アドレスの値を1つ増加させます。プロセスの最後にこれに対処するために、このケースに該当するかどうかを確認する必要があります。}}
+
{{Note|([[Logitech MX Master]] や Logitech 604 Lightspeed などの) 一部の Logitech デバイスは、デバイスが新しいシステムとペアリングするたびに MAC アドレスの値を1つ増加させます。プロセスの最後にこれに対処するために、このケースに該当するかどうかを確認する必要があります。}}
   
 
==== Windows の場合 ====
 
==== Windows の場合 ====
125行目: 126行目:
 
===== Windows での展開 =====
 
===== Windows での展開 =====
   
  +
まず、Windows を起動してください。
リンクキーを含むレジストリキーは、[https://docs.microsoft.com/en-us/windows/security/identity-protection/access-control/local-accounts#system SYSTEM アカウント] でしかアクセスできないため、ログインすることができません。そのため、{{ic|regedit.exe}} を {{ic|SYSTEM}} として実行するには、Windows Sysinternals 公式サイトにある Microsoft の [https://docs.microsoft.com/en-us/sysinternals/downloads/psexec PsExec] ツールが必要になります。
 
   
  +
リンクキーを含むレジストリキーは、[https://docs.microsoft.com/en-us/windows/security/identity-protection/access-control/local-accounts#system SYSTEM アカウント]でしかアクセスできないため、ログインすることができません。そのため、{{ic|regedit.exe}} を {{ic|SYSTEM}} として実行するには、Windows Sysinternals 公式サイトにある Microsoft の [https://docs.microsoft.com/en-us/sysinternals/downloads/psexec PsExec] ツールが必要になります。
[https://download.sysinternals.com/files/PSTools.zip PsTools] をダウンロードし、{{ic|PsExe64.exe}} を解凍します。
 
  +
  +
[https://download.sysinternals.com/files/PSTools.zip PsTools] をダウンロードし、{{ic|PsExec64.exe}} を解凍します。
   
 
[https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/windows-commands#command-shell-overview コマンドシェル] の管理者インスタンスで、解凍した EXE の場所からレジストリエディタを起動してください:
 
[https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/windows-commands#command-shell-overview コマンドシェル] の管理者インスタンスで、解凍した EXE の場所からレジストリエディタを起動してください:
  +
 
.\PsExec64.exe -s -i regedit.exe
 
.\PsExec64.exe -s -i regedit.exe
   
レジストリエディタで、以下のレジストリキーに移動します
+
レジストリエディタで、以下のレジストリキーに移動します:
  +
 
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BTHPORT\Parameters\Keys
 
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\BTHPORT\Parameters\Keys
   
 
このキーの中に各 Bluetooth アダプターの MAC アドレス別のキーがあります。複数のキーがあり、どれを使えばいいかわからない場合は、[https://www.addictivetips.com/windows-tips/find-bluetooth-mac-address-windows-10/ このガイド]に従って、目的の Bluetooth アダプタの MAC アドレスを検索してください。
 
このキーの中に各 Bluetooth アダプターの MAC アドレス別のキーがあります。複数のキーがあり、どれを使えばいいかわからない場合は、[https://www.addictivetips.com/windows-tips/find-bluetooth-mac-address-windows-10/ このガイド]に従って、目的の Bluetooth アダプタの MAC アドレスを検索してください。
   
目的のデバイスアダプタキーの中に、同じように MAC アドレス別に、ペアリングされたデバイスのバイナリ値あります。
+
目的のデバイスアダプタキーの中に、ペアリングされたデバイスのそれぞれに対してキー、MAC アドレスと関連付けられて存在しています。
   
 
インストール間で共有したい各ペアデバイスについて、キー全体を右クリックし、''.reg'' ファイルとしてエクスポートしてください。これはテキストファイルで、このファイルからキーをコピーできます。
 
インストール間で共有したい各ペアデバイスについて、キー全体を右クリックし、''.reg'' ファイルとしてエクスポートしてください。これはテキストファイルで、このファイルからキーをコピーできます。
143行目: 148行目:
 
このファイルにバイナリキーが1つだけ存在する場合、Bluetooth 5.1 デバイスではなく、そのペアリングキーが必要なもの全てであるということになります。
 
このファイルにバイナリキーが1つだけ存在する場合、Bluetooth 5.1 デバイスではなく、そのペアリングキーが必要なもの全てであるということになります。
   
ペアリングしたデバイスに複数のキー ({{ic|LTK}} や {{ic|IRK}} など) が存在する場合、これは Bluetooth 5.1 デバイスで''ある''ということになります。これらのキーを使う方法は [[#Bluetooth 5.1キーの準備]] を見てください。
+
ペアリングしたデバイスに複数のキー ({{ic|LTK}} や {{ic|IRK}} など) が存在する場合、これは Bluetooth 5.1 デバイスで''ある''ということになります。これらのキーを使う方法は [[#Bluetooth 5.1 キーの準備]] を見てください。
   
最後に、キーを Linux 環境にインポートするために [[#終わりに]] へ進んでください。
+
最後に、キーを Linux 環境にインポートするために、Linux を起動して [[#終わりに]] へ進んでください。
   
 
===== Linux での展開 =====
 
===== Linux での展開 =====
198行目: 203行目:
 
}}
 
}}
   
これらのキーを使う方法は [[#Bluetooth 5.1キーの準備]] を見てください。必要な値を得るには {{ic|hex ''value_name''}} を使います。
+
これらのキーを使う方法は [[#Bluetooth 5.1 キーの準備]] を見てください。必要な値を得るには {{ic|hex ''value_name''}} を使います。
   
 
最後に、キーを Linux 環境にインポートするために [[#終わりに]] へ進んでください。
 
最後に、キーを Linux 環境にインポートするために [[#終わりに]] へ進んでください。
   
===== Bluetooth 5.1キー準備 =====
+
==== macOS場合 ====
   
  +
macOS を起動し:
展開した Bluetooth 5.1 のキーとパラメータは、Linux のものにマッピングする必要があります。要求されたファイル作成し、適切な内容を書き込んでください。[[#終わりに]] でそれらをインストールします。この処理はデバイスに依存し、いくつかの値は操作する必要があります。操作を行うコードユーティリティは以下に記載します。
 
   
  +
* macOS Monterey 及びそれ以降の場合:
* Logitech MX Master 3、Pebble M350 マウス、K580 キーボード、そして Logitech BT5.1 デバイスの場合:
 
  +
*# Keychain Access を開き、Bluetooth と検索してください。
** {{ic|LTK}} は {{ic|SlaveLongTermKey.Key}} と {{ic|PeripheralLongTermKey.Key}} の '''両方''' にマップします。16進数の桁の間にあるスペースは取り除いてください。
 
  +
*# 日付順でソートしてください。
** {{ic|IRK}} は {{ic|IdentityResolvingKey.Key}} にマップします。16進数の桁の間にあるスペースは取り除いてください。
 
  +
*# 対象のデバイスを最近取り除いて再接続した場合、キーを変更日時順でソートして、最新のものを選べばよいです。キーはおそらく MobileBluetooth (古い Bluetooth デバイスの場合) という名前か、UUID (Bluetooth 5.1 以降) だけです。
** {{ic|ERand}} は {{ic|0}} である必要があります。操作は必要ありません。
 
  +
*# 対象のエントリをダブルクリックしてください。Account フィールドの MAC アドレスが対象デバイスの MAC アドレスと一致することを確認してください。
** {{ic|EDiv}} は {{ic|0}} である必要があります。操作は必要ありません。
 
  +
*# "Show password" チェックボックスをクリックしてください。ここで、パスワードを2回入力する必要があります。
* 他のデバイスの場合:
 
  +
*# パスワードフィールド内のテキストをコピーしてください ({{ic|⌘+a}} {{ic|⌘+c}})。これは実際には XML ファイルです。
** {{ic|LTK}} は {{ic|LongTermKey.Key}} に対応します。16進数の桁の間にあるスペースは取り除いてください。
 
  +
#* テキストをホームディレクトリ内の {{ic|bt_keys.txt}} ファイルにペーストしてください。
** {{ic|ERand}} は {{ic|Rand}} にマップします。オクテットの順番を逆にして、全体の数字を10進数に変換してください。
 
  +
* High Sierra 及びそれ以降の場合、次のコマンドをターミナルで実行してください: {{bc|# defaults read /private/var/root/Library/Preferences/com.apple.bluetoothd.plist LinkKeys > ~/bt_keys.txt}}
** {{ic|EDIV}} は {{ic|EDiv}} にマップします。16進数の桁の間にあるスペースは取り除いてください。
 
  +
* Sierra 及びそれ以前の場合、次のコマンドをターミナルで実行してください: {{bc|# defaults read /private/var/root/Library/Preferences/blued.plist LinkKeys > ~/bt_keys.txt}}
   
  +
すると、{{ic|~/.bt_keys.txt}} ファイルには、確立された Bluetooth キーが含まれています。古いバージョンの macOS (High Sierra 及びそれ以前) では、先に進む前にキーの並びを逆にする必要があります。例えば、{{ic|98 54 2f aa bb cc dd ee ff gg hh ii jj kk ll mm}} は {{ic|MM LL KK JJ GG FF EE DD CC BB AA 2F 54 98}} になります。
{{Note|
 
  +
* 値からスペースを除くために[https://www.browserling.com/tools/remove-all-whitespace このオンラインツール]や以下の [[Python]] コードを使用できます:
 
  +
{{Note|キーの並びを逆にするには、以下の [[Python]] コードを使用できます:
>>> <nowiki>'</nowiki>''key_value''<nowiki>'</nowiki>.replace(' ', '')
 
* 以下の Python コードは {{ic|ERand}} の変換を行います:
 
 
{{bc|1=
 
{{bc|1=
>>> ERand=' 63 02 84 B8 5D 40 44 DF '
+
>>> key = "98 54 2f aa bb cc dd ee ff gg hh ii jj kk ll mm"
>>> ERand=list(reversed(ERand.strip().split()))
+
>>> " ".join(reversed(key.strip().split()))
>>> int("".join(ERand), 16)
 
16088054540146049635
 
 
}}
 
}}
 
}}
 
}}
   
  +
Bluetooth 5.1 デバイスの場合、1つのデバイスに対して複数のキーが関連付けられています。それらのキーを使用する方法については [[#Bluetooth 5.1 キーの準備]] を見てください。
一般的なケースの例として:
 
* {{ic|48 4D AF CD 0F 92 22 88 0A 52 9A F4 76 DA 8B 94}} の {{ic|LTK}} は、{{ic|484DAFCD0F9222880A529AF476DA8B94}} の {{ic|LongTermKey.Key}} となります。
 
* {{ic|63 02 84 B8 5D 40 44 DF}} の {{ic|ERand}} は、{{ic|16088054540146049635}} の {{ic|Rand}} となります。
 
* {{ic|37520}} の {{ic|EDIV}} は、{{ic|37520}} の {{ic|EDiv}} となります。
 
   
  +
最後に、キーを Linux 環境にインポートするために、Linux を起動し、[[#終わりに]] へ進んでください。
==== macOS の場合 ====
 
   
  +
==== Bluetooth 5.1 キーの準備 ====
{{Accuracy|These instructions will not work for Bluetooth 5.1 devices such as the Logitech MX Master 3. A step should be added for locating those, and then [[#Bluetooth 5.1キーの準備]] should be generalized (if needed) to cover macOS.}}
 
   
  +
[[#Windows の場合]] や [[#macOS の場合]] の章に従っていて Bluetooth 5.1 キーが存在していた場合、それらのキーを Linux にインポートする前に特定の変換をかける必要があります。[[#終わりに]] の章で使うために、要求されたファイルを適切に作成してください。この手順は対象デバイスによって異なり、キーの一部を操作する必要があります。これを行うためのユーティリティは以下で挙げられています。
macOS を起動し、ターミナルを開きます。
 
   
  +
{| class="wikitable"
* Sierra 以前の OS の場合、以下を実行します。
 
  +
! デバイス !! 元のキー及び変換 (Windows) !! 元のキー及び変換 (macOS) || キーの保存先ファイル
  +
|-
  +
|rowspan="3"|
  +
* Logitech MX Master 3
  +
* Xbox One S Wireless Controller
  +
|
  +
* {{ic|IRK}} をコピー。
  +
* 16進数の桁間のスペースを除去。
  +
| {{Grey|?}}
  +
| {{ic|IdentityResolvingKey.Key}}
  +
|-
  +
|
  +
* {{ic|LTK}} をコピー。
  +
* 16進数の桁間のスペースを除去。
  +
| {{Grey|?}}
  +
| {{ic|SlaveLongTermKey.Key}} と {{ic|PeripheralLongTermKey.Key}}
  +
|-
  +
|{{ic|ERand}} と {{ic|EDIV}} は {{ic|0}} にする必要あり。
  +
|''Random Number'' と ''Encrypted Diversifier'' は {{ic|0}} にする必要あり。
  +
| {{-}}
  +
|-
  +
|rowspan="4"|
  +
* ThinkPad TrackPoint Keyboard II
  +
* Pebble M350 マウス
  +
* Logitech G604 Lightspeed マウス
  +
|
  +
* {{ic|IRK}} をコピー
  +
* バイトの順番を逆に。
  +
|
  +
* ''Remote IRK'' をコピー。
  +
* Base64 から16進数に変換。
  +
| {{ic|IdentityResolvingKey.Key}}
  +
|-
  +
|
  +
* {{ic|LTK}} をコピー。
  +
* 16進数の桁間のスペースを除去。
  +
|
  +
* ''Remote Encryption'' を ''Long-term Key'' にコピー。
  +
* Base64 から16進数に変換。
  +
| {{ic|LongTermKey.Key}}
  +
|-
  +
|
  +
* {{ic|ERand}} をコピー。
  +
* バイトの順番を逆に。
  +
* 数値全体を10進数に変換。
  +
|
  +
* ''Remote Encryption'' を ''Random Number'' にコピー
  +
* Base64 をリトルエンディアンの10進数に変換 (以下の Python コードを参照)。
  +
| {{ic|LongTermKey.Rand}}
  +
|-
  +
|
  +
* {{ic|EDIV}} をコピー。
  +
* バイトの順番を逆に。
  +
* 数値全体を10進数に変換。
  +
|
  +
* ''Remote Encryption'' を ''Encrypted Diversifier'' にコピー。
  +
* Base64 からリトルエンディアンの10進数に変換 (以下の Python コードを参照)。
  +
| {{ic|LongTermKey.EDiv}}
  +
|-
  +
|rowspan="3"|他のデバイス
  +
|
  +
* {{ic|LTK}} をコピー。
  +
* 16進数の桁間のスペースを除去。
  +
|
  +
* ''Remote IRK'' をコピー。
  +
* Base64 から16進数に変換。
  +
| {{ic|LongTermKey.Key}}
  +
|-
  +
|
  +
* {{ic|ERand}} をコピー。
  +
* バイトの順番を逆に。
  +
* 数値全体を10進数に変換。
  +
|
  +
* ''Remote Encryption'' を ''Long-term Key'' にコピー。
  +
* Base64 から16進数に変換。
  +
| {{ic|LongTermKey.Rand}}
  +
|-
  +
|
  +
* {{ic|EDIV}} をコピー。
  +
* 16進数の桁間のスペースを除去。
  +
|
  +
* ''Remote Encryption'' を ''Encrypted Diversifier'' にコピー。
  +
* Base64 から16進数に変換。
  +
* バイトの順番を逆に。
  +
| {{ic|LongTermKey.EDiv}}
  +
|-
  +
|rowspan="1"|Xbox ワイヤレスコントローラ
  +
|
  +
* {{ic|LTK}} をコピー。
  +
* 16進数の桁間のスペースを除去。
  +
| {{Grey|?}}
  +
| {{ic|SlaveLongTermKey.Key}}
  +
|}
   
  +
{{Note|
{{bc|# defaults read /private/var/root/Library/Preferences/blued.plist LinkKeys > ~/bt_keys.txt}}
 
  +
* 値からスペースを取り除くには、[https://www.browserling.com/tools/remove-all-whitespace このオンラインツール]や以下の [[Python]] コードを使用できます:
 
  +
>>> "''key_value''".replace(" ", "")
* High Sierra 以降をお使いの場合は、以下を実行してください。
 
  +
* 以下の Python コードはバイトの順番を逆にするだけです:
 
  +
{{bc|1=
{{bc|# defaults read /private/var/root/Library/Preferences/com.apple.bluetoothd.plist LinkKeys > ~/bt_keys.txt}}
 
  +
>>> ERand=" 63 02 84 B8 5D 40 44 DF "
  +
>>> ERand=list(reversed(ERand.strip().split()))
  +
}}
  +
* 以下の Python コードは、一部で必要となる追加の10進数変換を行います:
  +
{{bc|1=
  +
>>> int("".join(ERand), 16)
  +
16088054540146049635
  +
}}
  +
* 以下の Python コードは base64 から16進数への変換を行います:
  +
binascii.hexlify(base64.decodebytes(b'...')).upper()
  +
* 以下の Python コードは完全な macOS Encrypted Diversifier の変換を行います:
  +
struct.unpack('<H', base64.decodebytes(b'...'))
  +
* 以下の Python コードは完全な macOS Random Number の変換を行います:
  +
struct.unpack('&lt;Q', base64.decodebytes(b'...'))
  +
}}
   
  +
一般的なケースの例としては:
古いバージョンの macOS(High Sierra およびそれより古いバージョン)の場合、キーを反転する必要があります。例えば {{ic|98 54 2f aa bb cc dd ee ff gg hh ii jj kk ll mm}} は {{ic|MM LL KK JJ GG FF EE DD CC BB 2F 54 98}} となります。
 
  +
* {{ic|LTK}} の値 {{ic|48 4D AF CD 0F 92 22 88 0A 52 9A F4 76 DA 8B 94}} は、{{ic|LongTermKey.Key}} の値 {{ic|484DAFCD0F9222880A529AF476DA8B94}} となります。
 
  +
* {{ic|ERand}} の値 {{ic|63 02 84 B8 5D 40 44 DF}} は、{{ic|Rand}} の値 {{ic|16088054540146049635}} となります。
{{ic|bt_keys.txt}} ファイルを Arch Linux から読み込み可能なドライブにコピーします。Arch Linux を起動してください。
 
  +
* {{ic|EDIV}} の値 {{ic|37520}} は、{{ic|EDiv}} の値 {{ic|37520}} となります。
   
 
==== 終わりに ====
 
==== 終わりに ====
263行目: 372行目:
 
{{Note|この時点で、ペアリング時に MAC アドレスの値を増加させるデバイスを使用している場合、MAC アドレスのディレクトリを、値を増加させたパスへ移動させる必要があります。Windows から MAC アドレスをコピーするか、あるいは、各オクテットが2桁の[[Wikipedia:Hexadecimal|16進数]]であることに注意しながら自分で値を増加させてください。}}
 
{{Note|この時点で、ペアリング時に MAC アドレスの値を増加させるデバイスを使用している場合、MAC アドレスのディレクトリを、値を増加させたパスへ移動させる必要があります。Windows から MAC アドレスをコピーするか、あるいは、各オクテットが2桁の[[Wikipedia:Hexadecimal|16進数]]であることに注意しながら自分で値を増加させてください。}}
   
ペアリングキーを持っている場合(つまり、これは Bluetooth 5.1 デバイスでない)、{{ic|info}} ファイルを編集し、{{ic|[LinkKey]}} 以下のキーを変更します。例えば:
+
ペアリングキーを持っている場合 (つまり、これは Bluetooth 5.1 デバイスでない)、{{ic|info}} ファイルを編集し、{{ic|[LinkKey]}} 以下のキーを変更します。例えば:
   
 
{{hc|1=info|2=
 
{{hc|1=info|2=
272行目: 381行目:
 
{{Note|すべての文字が大文字であることを確認する必要があります。スペースはすべて削除してください。}}
 
{{Note|すべての文字が大文字であることを確認する必要があります。スペースはすべて削除してください。}}
   
  +
複数のキーが存在する場合 (Bluetooth 5.1 の場合)、以下の {{ic|info}} ファイルを編集して、全てのキーをそれぞれの値で置き換えてください。例えば、Xbox One S Wireless Controller の場合:
Bluetooth 5.1 キーを持っている場合、代わりにキーファイルを MAC アドレスのディレクトリにコピーする必要があります。
 
  +
  +
{{hc|1=info|2=
  +
[IdentityResolvingKey]
  +
Key=<IdentityResolvingKey.Key>
  +
  +
[PeripheralLongTermKey]
  +
Key=<PeripheralLongTermKey.Key>
  +
  +
[SlaveLongTermKey]
  +
Key=<SlaveLongTermKey.Key>
  +
}}
   
次に、{{ic|bluetooth.service}} と {{ic|pulseaudio}} を [[再起動]] してください。({{ic|pulseaudio -k && pulseaudio --start}} を使ってください。)
+
次に、{{ic|bluetooth.service}} と {{ic|pulseaudio}} を[[再起動]]してください。({{ic|pulseaudio -k && pulseaudio --start}} を使ってください。)
   
 
これで、デバイスに接続できるはずです。
 
これで、デバイスに接続できるはずです。
282行目: 402行目:
 
== 設定 ==
 
== 設定 ==
   
  +
=== アダプタのデフォルト電源状態 ===
=== 起動後/再開後に自動で有効にする ===
 
   
 
{{Pkg|bluez}} 5.65 以降、BlueZ はデフォルトで、サービスの起動時やサスペンドからの復帰時にすべての Bluetooth アダプタをオンにします。[https://github.com/bluez/bluez/commit/180cf09933b2d8eb03972c8638063429fe5fece5]
 
{{Pkg|bluez}} 5.65 以降、BlueZ はデフォルトで、サービスの起動時やサスペンドからの復帰時にすべての Bluetooth アダプタをオンにします。[https://github.com/bluez/bluez/commit/180cf09933b2d8eb03972c8638063429fe5fece5]
334行目: 454行目:
 
SUBSYSTEM=="usb", ATTRS{idVendor}=="8087", ATTRS{idProduct}=="0039" RUN+="/''your''/''path''/''to''/configure_keyboard.sh"
 
SUBSYSTEM=="usb", ATTRS{idVendor}=="8087", ATTRS{idProduct}=="0039" RUN+="/''your''/''path''/''to''/configure_keyboard.sh"
 
}}
 
}}
  +
  +
=== 実験的な機能を有効化する ===
  +
  +
Bluez スタックは、バグがあるかもしれない新しい機能を D-Bus 実験的オプションおよびカーネル実験的オプションに留めます。実験的な機能は最終的に、安定していると判断され、もはやオプションを必要としなくなるので、どのような実験的な機能が存在するかはバージョンによって異なります (例えば、現在 D-Bus の実験的なインターフェイスを有効化すると、古いヘッドセットのバッテリーレベルを報告できるようになります)。実験的な機能を有効化するには、設定の対応する行をアンコメントしてください:
  +
  +
{{hc|/etc/bluetooth/main.conf|2=
  +
...
  +
  +
# Enables D-Bus experimental interfaces
  +
# Possible values: true or false
  +
'''#Experimental = true'''
  +
  +
# Enables kernel experimental features, alternatively a list of UUIDs
  +
# can be given.
  +
# Possible values: true,false,<UUID List>
  +
# Possible UUIDS:
  +
...
  +
# Defaults to false.
  +
'''#KernelExperimental = true'''
  +
}}
  +
  +
あるいは、{{ic|bluetooth.service}} を[[編集]]して、{{ic|--experimental}} フラグあるいは {{ic|--kernel}} フラグを追加してください。例えば、以下の[[ドロップインファイル]]のように:
  +
  +
{{hc|/etc/systemd/system/bluetooth.service.d/override.conf|2=
  +
[Service]
  +
ExecStart=
  +
ExecStart=/usr/lib/bluetooth/bluetoothd --experimental
  +
}}
  +
  +
いずれの場合でも、{{ic|bluetooth.service}} を[[再起動]]する必要があります。
   
 
== オーディオ ==
 
== オーディオ ==
343行目: 493行目:
 
=== PulseAudio ===
 
=== PulseAudio ===
   
Bluetooth ヘッドフォンやスピーカーのようなオーディオ機器を使うには {{Pkg|pulseaudio-bluetooth}} パッケージのインストールが必要です。インストールを反映させるために、pulseaudio を再起動してください: {{ic|pulseaudio -k}}。デフォルトの Pulseaudio インストールでは、即座に Bluetooth デバイスからスピーカーにオーディオをストリーミングできるはずです。
+
Bluetooth ヘッドフォンやスピーカーのようなオーディオ機器を使うには {{Pkg|pulseaudio-bluetooth}} パッケージのインストールが必要です。インストールを反映させるために、pulseaudio を再起動してください: {{ic|pulseaudio -k}}。デフォルトの Pulseaudio インストールでは (具体的には、パッケージングされているデフォルトの {{ic|default.pa}} でユーザインスタンスを使用している場合)、即座に Bluetooth デバイスからスピーカーにオーディオをストリーミングできるはずです。[https://gitlab.freedesktop.org/pulseaudio/pulseaudio/-/blob/stable-16.x/src/daemon/default.pa.in#L84-93]
   
 
システム全体の PulseAudio 設定がある場合は、デーモンを実行しているユーザー(通常は {{ic|pulse}}) が {{ic|lp}} グループに属しており、PulseAudio 設定に Bluetooth モジュールをロードしていることを確認します:
 
システム全体の PulseAudio 設定がある場合は、デーモンを実行しているユーザー(通常は {{ic|pulse}}) が {{ic|lp}} グループに属しており、PulseAudio 設定に Bluetooth モジュールをロードしていることを確認します:
398行目: 548行目:
 
これで、シリアル通信用に {{ic|/dev/rfcomm0}} を開くことができます:
 
これで、シリアル通信用に {{ic|/dev/rfcomm0}} を開くことができます:
   
picocom /dev/rfcomm0 -b 115200
+
$ picocom /dev/rfcomm0 -b 115200
   
 
== トラブルシューティング ==
 
== トラブルシューティング ==
404行目: 554行目:
 
{{Out of date|Replace hciconfig with newer commands.}}
 
{{Out of date|Replace hciconfig with newer commands.}}
   
=== デバッグ ===
+
=== 一般的なトラブルシューティング ===
  +
  +
==== デバッグ ====
   
 
デバッグするには、最初に {{ic|bluetooth.service}} を[[停止]]します。
 
デバッグするには、最初に {{ic|bluetooth.service}} を[[停止]]します。
414行目: 566行目:
 
別のオプションとして、 {{ic|btmon}} ツールが有ります。
 
別のオプションとして、 {{ic|btmon}} ツールが有ります。
   
=== 非推奨の BlueZ tools ===
+
==== 非推奨の BlueZ ツール ====
   
 
8つの BlueZ ツールは[https://git.kernel.org/pub/scm/bluetooth/bluez.git/commit/?id=b1eb2c4cd057624312e0412f6c4be000f7fc3617 非推奨となり]、{{Pkg|bluez-utils}} から削除されましたが、それらのすべてが新しいツールに取って代わられたわけではありません。{{AUR|bluez-utils-compat}} パッケージは非推奨のツールを含む代替バージョンの {{Pkg|bluez-utils}} を提供します。
 
8つの BlueZ ツールは[https://git.kernel.org/pub/scm/bluetooth/bluez.git/commit/?id=b1eb2c4cd057624312e0412f6c4be000f7fc3617 非推奨となり]、{{Pkg|bluez-utils}} から削除されましたが、それらのすべてが新しいツールに取って代わられたわけではありません。{{AUR|bluez-utils-compat}} パッケージは非推奨のツールを含む代替バージョンの {{Pkg|bluez-utils}} を提供します。
423行目: 575行目:
 
! あり得る代替
 
! あり得る代替
 
|-
 
|-
| [https://manpages.debian.org/stretch/bluez/gatttool.1.en.html gatttool] || btgatt-client, [https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/gatt-api.txt D-Bus Gatt API]
+
| [https://manpages.debian.org/latest/bluez/gatttool.1.en.html gatttool] || btgatt-client, [https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/gatt-api.txt D-Bus Gatt API]{{Dead link|2023|10|29|status=404}}
 
|-
 
|-
| [https://manpages.debian.org/stretch/bluez/hciattach.1.en.html hciattach] || btattach
+
| [https://manpages.debian.org/latest/bluez/hciattach.1.en.html hciattach] || btattach
 
|-
 
|-
| [https://manpages.debian.org/stretch/bluez/hciconfig.1.en.html hciconfig] || btmgmt (そして bluetoothctl?)
+
| [https://manpages.debian.org/latest/bluez/hciconfig.1.en.html hciconfig] || btmgmt (そして bluetoothctl?)
 
|-
 
|-
| [https://manpages.debian.org/stretch/bluez-hcidump/hcidump.1.en.html hcidump] || btmon (そして btsnoop)
+
| [https://manpages.debian.org/latest/bluez-hcidump/hcidump.1.en.html hcidump] || btmon (そして btsnoop)
 
|-
 
|-
| [https://manpages.debian.org/stretch/bluez/hcitool.1.en.html hcitool] || なし、[https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/device-api.txt D-Bus Device API] 利用可能
+
| [https://manpages.debian.org/latest/bluez/hcitool.1.en.html hcitool] || なし、[https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/device-api.txt D-Bus Device API]{{Dead link|2023|10|29|status=404}} が利用可能
 
|-
 
|-
| [https://manpages.debian.org/stretch/bluez/rfcomm.1.en.html rfcomm]
+
| [https://manpages.debian.org/latest/bluez/rfcomm.1.en.html rfcomm]
| rowspan="2" | なし、[https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/profile-api.txt D-Bus Profile1 API] の実装?
+
| rowspan="2" | なし、[https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/profile-api.txt D-Bus Profile1 API]{{Dead link|2023|10|29|status=404}} の実装?
 
|-
 
|-
| [https://manpages.debian.org/stretch/bluez/ciptool.1.en.html ciptool]
+
| [https://manpages.debian.org/latest/bluez/ciptool.1.en.html ciptool]
 
|-
 
|-
|[https://manpages.debian.org/stretch/bluez/sdptool.1.en.html sdptool]
+
|[https://manpages.debian.org/latest/bluez/sdptool.1.en.html sdptool]
| なし、機能が、異なる D-Bus オブジェクトに散らばっている模様: [https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/profile-api.txt Profile]、[https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/advertising-api.txt Advertising]、そして [https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/device-api.txt device] と [https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/adapter-api.txt adapter] の UUID の配列。
+
| なし、機能が、異なる D-Bus オブジェクトに散らばっている模様: [https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/profile-api.txt Profile]{{Dead link|2023|10|29|status=404}}、[https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/advertising-api.txt Advertising]{{Dead link|2023|10|29|status=404}}、そして [https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/device-api.txt device]{{Dead link|2023|10|29|status=404}} と [https://git.kernel.org/cgit/bluetooth/bluez.git/tree/doc/adapter-api.txt adapter]{{Dead link|2023|10|29|status=404}} の UUID の配列。
 
|}
 
|}
   
=== gnome-bluetooth ===
+
=== サービスの問題 ===
   
  +
==== systemd: Condition check resulted in Bluetooth service being skipped ====
bluetooth-properties でファイルの受信を有効にしようとしたときに以下のメッセージが表示される場合:
 
   
  +
{{ic|bluetooth.service}} は {{ic|/sys/class/bluetooth}} ディレクトリが存在することのみを要求します。このディレクトリは {{ic|bluetooth}} カーネルモジュールによって作成されるはずです。このカーネルモジュールは、{{ic|systemd-udev}} が動作している Bluetooth ハードウェアデバイスを発見した場合にのみ、{{ic|systemd-udev}} により自動的にロードされます。
Bluetooth OBEX start failed: Invalid path
 
Bluetooth FTP start failed: Invalid path
 
   
  +
{{ic|/sys/class/bluetooth}} が存在しない場合、{{ic|lsmod}} コマンドを使って、Bluetooth カーネルモジュールがロードされているかどうかを確認してください。Bluetooth デバイスがあるにも関わらずロードされていない場合、[[カーネルモジュール#手動でモジュールを扱う|Bluetooth モジュールをロード]]し、{{ic|bluetooth.service}} を[[再起動]]することで、手動で起動できます。
[[XDG ユーザーディレクトリ]] が存在することを確認してください。
 
  +
  +
また、{{ic|bluetooth}} モジュールをロードする際に、対応するカーネル Bluetooth ドライバもロードする必要があります。{{ic|btusb}} が最も可能性がありますが、{{ic|btrtl,btintel,btbcm,bnep,btusb}} などの可能性もあります。
  +
  +
{{ic|bluetooth.service}} の[[ユニットステータス]]を確認して、このサービスが起動しているかどうかを確認してください。
  +
  +
[https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=853207 Debian Bug report logs - #853207] も参照してください。
  +
  +
{{ic|bluetooth.service}} の起動に成功したが、まだ Bluetooth を使えないことがあります (例: {{ic|scan on}} の時に {{ic|bluetoothctl}} が {{ic|org.Bluez.Error.NotReady}} のようなメッセージを発する)。この場合、コンピュータを再起動し、次のことをダブルチェックしてください: {{ic|/sys/class/bluetooth}} ディレクトリが存在するか; {{ic|lsmod}} の出力に正しい Bluetooth モジュールが含まれているか; [[journal]] のログを確認するなど。{{ic|systemd-udev}} は、また手動の変更をせずとも Bluetooth ハードウェアを自動的に認識するはずです。
  +
  +
==== Bluetooth が suspend-to-idle 中のデバイスを即座に立ち上げてしまう ====
  +
  +
[[サスペンドとハイバネート|suspend-to-idle/S2idle/S0ix/Modern Standby]] する能力のあるシステムにおいては、Bluetooth コントローラがスリープ中も有効化されたままになります。通常、これにより、Bluetooth デバイスが接続されていると、システムが[https://bugzilla.kernel.org/show_bug.cgi?id=200039 スリープに移行した直後にスリープが解除されてしまいます]。
  +
  +
これを防ぐには、スリープに移行する前に Bluetooth を完全に無効化できます。{{Pkg|bluez-utils}} をインストールし、以下のファイルを作成してください:
  +
  +
{{hc|/etc/systemd/system/bluetooth-disable-before-sleep.service|2=
  +
[Unit]
  +
Description=Disable Bluetooth before going to sleep
  +
Before=sleep.target
  +
Before=suspend.target
  +
Before=hybrid-sleep.target
  +
Before=suspend-then-hibernate.target
  +
StopWhenUnneeded=yes
  +
  +
[Service]
  +
Type=oneshot
  +
RemainAfterExit=yes
  +
  +
ExecStart=/usr/bin/bluetoothctl power off
  +
ExecStop=/usr/bin/bluetoothctl power on
  +
  +
[Install]
  +
WantedBy=sleep.target
  +
WantedBy=suspend.target
  +
WantedBy=hybrid-sleep.target
  +
WantedBy=suspend-then-hibernate.target
  +
}}
  +
  +
このサービスを[[有効化]]し、スリープに移行した時に Bluetooth デバイスが切断されることや、スリープからの復帰時に Bluetooth が再び接続されることを確認してください。
  +
  +
この回避策を使用すると、[[#サスペンドからの復帰|Bluetooth マウス/キーボードを使ってシステムをスリープから復帰させること]]ができなくなります。
  +
  +
==== ヘッドレス/サーバのシステムでログアウト後に Bluetooth がオフになる ====
  +
  +
様々な原因が考えられます:
  +
  +
* [[PulseAudio]] と [[PipeWire]] は両方ともデフォルトでユーザサービスとして動作します。よって、最後のセッションが終了するとこれらのサービスは終了されます。この問題を解決するには、対象のユーザに対して [[systemd/ユーザー#systemd のユーザーインスタンスを自動起動|Lingering (残留)]] を有効化してください。
  +
* さらに、[[WirePlumber]] を [[PipeWire]] と共に実行している場合 (これはよくある環境です)、WirePlumber は "logind-monitor" を実行します。これは、Bluetooth をログイン時に有効化し、ログアウト時に無効化します。問題の解決方法は [[WirePlumber#ログアウト後も Bluetooth を実行し続ける/ヘッドレス Bluetooth]] を見てください。
  +
  +
=== アダプタの問題 ===
  +
  +
==== hcitool scan: Device not found ====
  +
  +
* 一部のラップトップ (例: Dell Studio 15、Lenovo Thinkpad X1) では、Bluetooth モードを HID から HCI に切り替える必要があります。{{Pkg|bluez-hid2hci}} パッケージをインストールすれば、[[udev]] が自動的に切り替えを行うはずです。また、次のコマンドを実行して手動で HCI に切り替えることもできます:
  +
  +
# /usr/lib/udev/hid2hci
  +
  +
* デバイスが表示されず、かつマシンに Windows オペレーティングシステムがある場合、Windows から bluetooth アダプターを有効にして見てください。
  +
  +
* 場合によっては次のコマンドで問題が解決するかもしれません:
  +
  +
# bluetoothctl power on
  +
  +
==== bluetoothctl: No default controller available ====
  +
  +
一部のマザーボード Bluetooth コントローラにはバグがあります。バグがこの問題の原因であるか調べるには、{{ic|journalctl {{!}} grep hci}} を実行してください。このコマンドの出力に "command tx timeout" や "Reading Intel version command failed" のようなエントリが存在する場合、PC の電源を切り、電源ケーブルを物理的に外して数秒間放置してください。これにより、コントローラにファームウェアを再ロードさせます (通常の再起動では再ロードしません)。[https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1859592 こちら]のバグレポートを参照してください。
  +
  +
デバイスが [[rfkill]] によってブロックされていないことを確認してください。
  +
  +
また、一部の Intel カード (8260 など) は Bluetooth サービスによって正しく認識されないかもしれません。{{Pkg|bluez-utils}} の代わりに非推奨の {{AUR|bluez-utils-compat}} を使うことでこの問題が解決したというケースが報告されています。
  +
  +
また、これは省電力機能が原因かもしれません。その場合、{{ic|1=btusb.enable_autosuspend=n}} [[カーネルパラメータ#設定|カーネルパラメータ]]により解決できる可能性があります。[https://bugzilla.redhat.com/show_bug.cgi?id=1573562 Red Hat Bugzilla – Bug 1573562] も参照してください。
  +
  +
時々、{{ic|btusb}} をオプション無しでアンロード・ロードすればコントローラを元に戻せることがあります:
  +
  +
# modprobe -r btusb
  +
# modprobe btusb
  +
  +
また、ドングルが [[#CSR ドングル 0a12:0001|CSR クローン]]である場合にもこの問題が発生することがあります。
  +
  +
==== rfkill unblock: Do not unblock ====
  +
  +
デバイスがソフトブロックされていて [[ConnMan]] を動作させている場合、次を試してみて下さい:
  +
  +
$ connmanctl enable bluetooth
   
=== Bluetooth USB ドングル ===
+
==== Bluetooth USB ドングル ====
   
 
USB ドングルを使う場合は、Bluetooth ドングルが認識されているか確認してください。USB ドングルを挿入する時に {{ic|journalctl -f}} を root として実行する(もしくは {{ic|/var/log/messages.log}} を調査する)ことで、そのことを確認できます。以下のような見た目であるはずです(hci を見てください)。
 
USB ドングルを使う場合は、Bluetooth ドングルが認識されているか確認してください。USB ドングルを挿入する時に {{ic|journalctl -f}} を root として実行する(もしくは {{ic|/var/log/messages.log}} を調査する)ことで、そのことを確認できます。以下のような見た目であるはずです(hci を見てください)。
466行目: 702行目:
 
例:
 
例:
   
# btmgmt
+
{{hc|# btmgmt|
  +
[mgmt]# info
 
{{hc|[mgmt]# info|
 
 
Index list with 1 item
 
Index list with 1 item
 
hci0: Primary controller
 
hci0: Primary controller
 
addr 00:1A:7D:DA:71:10 version 6 manufacturer 10 class 0x000000
 
addr 00:1A:7D:DA:71:10 version 6 manufacturer 10 class 0x000000
supported settings: powered connectable fast-connectable discoverable bondable link-security ssp br/edr hs le advertising secure-conn debug-keys privacy static-addr
+
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:''' connectable discoverable bondable ssp br/edr le secure-conn
+
'''current settings:''' connectable discoverable bondable ssp br/edr le secure-conn
 
name Mozart
 
name Mozart
short name
+
short name
}}
 
   
{{hc|[mgmt]# select hci0|
+
[mgmt]# select hci0
 
Selected index 0
 
Selected index 0
}}
 
   
{{hc|[hci0]# power up|
+
[hci0]# power up
 
hci0 Set Powered complete, settings: '''powered''' connectable discoverable bondable ssp br/edr le secure-conn
 
hci0 Set Powered complete, settings: '''powered''' connectable discoverable bondable ssp br/edr le secure-conn
}}
 
   
{{hc|[hci0]# info|
+
[hci0]# info
 
hci0: Primary controller
 
hci0: Primary controller
 
addr 00:1A:7D:DA:71:10 version 6 manufacturer 10 class 0x1c0104
 
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
+
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
 
'''current settings: powered''' connectable discoverable bondable ssp br/edr le secure-conn
 
}}
 
}}
495行目: 727行目:
 
または
 
または
   
# bluetoothctl
+
{{hc|# bluetoothctl|
  +
[bluetooth]# show
 
{{hc|[bluetooth]# show|
 
 
Controller 00:1A:7D:DA:71:10 (public)
 
Controller 00:1A:7D:DA:71:10 (public)
 
Name: Mozart
 
Name: Mozart
505行目: 736行目:
 
Discoverable: yes
 
Discoverable: yes
 
Pairable: yes
 
Pairable: yes
}}
 
   
{{hc|[bluetooth]# power on'''|
+
[bluetooth]# power on
 
[CHG] Controller 00:1A:7D:DA:71:10 Class: 0x001c0104
 
[CHG] Controller 00:1A:7D:DA:71:10 Class: 0x001c0104
 
Changing power on succeeded
 
Changing power on succeeded
 
[CHG] Controller 00:1A:7D:DA:71:10 '''Powered: yes'''
 
[CHG] Controller 00:1A:7D:DA:71:10 '''Powered: yes'''
}}
 
   
{{hc|[bluetooth]# show|
+
[bluetooth]# show
 
Controller 00:1A:7D:DA:71:10 (public)
 
Controller 00:1A:7D:DA:71:10 (public)
 
Name: Mozart
 
Name: Mozart
555行目: 784行目:
 
}}
 
}}
   
==== ドングルから短距離にいるときにオーディオデバイスがおかしくなる ====
+
===== ドングルから短距離にいるときにオーディオデバイスがおかしくなる =====
   
 
他のデバイスと同一の USB ホストを共有している場合、[https://bbs.archlinux.org/viewtopic.php?pid=1440161#p1440161 オーディオデバイスとの通信に干渉] する可能性があります。オーディオデバイスがバスに接続されている唯一のデバイスであることを確認してください。例:
 
他のデバイスと同一の USB ホストを共有している場合、[https://bbs.archlinux.org/viewtopic.php?pid=1440161#p1440161 オーディオデバイスとの通信に干渉] する可能性があります。オーディオデバイスがバスに接続されている唯一のデバイスであることを確認してください。例:
568行目: 797行目:
 
}}
 
}}
   
==== CSR ドングル 0a12:0001 ====
+
===== CSR ドングル 0a12:0001 =====
   
デバイス {{ic|ID 0a12:0001 Cambridge Silicon Radio, Ltd Bluetooth Dongle (HCI mode)}} にはリグレッションのバグがあり、現在のところカーネルバージョン 3.9.11 以下でしか動作しません。新しいバージョン用のパッチがあります。詳細は、 [https://bugzilla.kernel.org/show_bug.cgi?id=60824 Kernel Bug 60824] を参照してください。
+
デバイス {{ic|ID 0a12:0001 Cambridge Silicon Radio, Ltd Bluetooth Dongle (HCI mode)}} にはリグレッションのバグがあり、現在カーネルバージョン 5.17 及び < 6.0 でしか動作しません。詳細は、[https://bugzilla.kernel.org/show_bug.cgi?id=60824 Kernel Bug 60824] を参照してください。
   
=== Logitech Bluetooth USB ドングル ===
+
==== Logitech Bluetooth USB ドングル ====
   
 
Logitech のドングルには Embedded と HCI という二つのモードで動作するものがあります (例: Logitech MX5000)。embedded モードではドングルは USB デバイスをエミュレートするので PC は普通の USB マウス・キーボードを使っていると認識します。
 
Logitech のドングルには Embedded と HCI という二つのモードで動作するものがあります (例: Logitech MX5000)。embedded モードではドングルは USB デバイスをエミュレートするので PC は普通の USB マウス・キーボードを使っていると認識します。
   
USB BT ミニレシーバの小さな赤いボタンを押すと他のモードが有効になります。BT ドングルの赤いボタンを押しながらコンピュータに接続してください。ボタンを押して3-5秒で、Bluetooth アイコンがシステムトレイに表示されます [https://ubuntuforums.org/showthread.php?t=1332197 Discussion]。
+
USB BT ミニレシーバの小さな赤いボタンを押すと他のモードが有効になります。BT ドングルの赤いボタンを押しながらコンピュータに接続してください。ボタンを押して3-5秒で、Bluetooth アイコンがシステムトレイに表示されます ([https://ubuntuforums.org/showthread.php?t=1332197 議論])
   
 
また、{{Pkg|bluez-hid2hci}} パッケージをインストールすることもできます。Logitech のドングルを接続すると自動的に切り替えます。
 
また、{{Pkg|bluez-hid2hci}} パッケージをインストールすることもできます。Logitech のドングルを接続すると自動的に切り替えます。
   
  +
==== Foxconn / Hon Hai / Lite-On の Broadcom デバイス ====
=== hcitool scan: Device not found ===
 
   
  +
一部のデバイスでは、起動時にファームウェアを書き込む必要があります。
* 一部の Dell ラップトップ (例: Studio 15) では Bluetooth モードを HID から HCI に切り替える必要があります。{{Pkg|bluez-hid2hci}} パッケージをインストールすれば、[[udev]] が自動的に切り替えを行うはずです。また、次のコマンドを実行して手動で HCI に切り替えることもできます:
 
   
  +
一部のファームウェアは、[[AUR]] で [https://aur.archlinux.org/packages?K=broadcom broadcom] と検索すると入手できます。特出すべきパッケージは {{AUR|broadcom-bt-firmware}} です。これは、[https://github.com/winterheart/broadcom-bt-firmware/blob/master/DEVICES.md 様々なカード]用のファイルを提供します。
# /usr/lib/udev/hid2hci
 
   
  +
または、[https://github.com/jessesung/hex2hcd hex2hcd] ({{Pkg|bluez-utils}} でインストールされます) を使ってファームウェアを Microsoft Windows の ''.hex'' ファイルから ''.hcd'' ファイルに変換することもできます。
* デバイスが表示されない場合で、かつマシンに Windows オペレーティングシステムがあるときは Windows から bluetooth アダプターを有効にして見て下さい。
 
   
  +
正しい ''.hex'' ファイルを取得するために、''lsusb'' でデバイスの vendor:product コードを検索してください。例:
* 場合によっては次のコマンドで有効にできます:
 
   
  +
Bus 002 Device 004: ID '''04ca:2006''' Lite-On Technology Corp. Broadcom BCM43142A0 Bluetooth Device
# bluetoothctl power on
 
   
  +
または:
=== bluetoothctl: No default controller available ===
 
   
  +
Bus 004 Device 004: Id '''0489:e031''' Foxconn / Hon Hai
一部のマザーボード Bluetooth コントローラにはバグがあります。バグがこの問題の原因であるか調べるには、{{ic|journalctl {{!}} grep hci}} を実行してください。このコマンドの出力に "command tx timeout" や "Reading Intel version command failed" のようなエントリが存在する場合、PC の電源を切り、電源ケーブルを物理的に外して数秒間放置してください。これにより、コントローラにファームウェアを再ロードさせます(通常の再起動では再ロードしません)。[https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1859592 こちら]のバグレポートを見てください。
 
   
  +
もしくは、Windows (仮想マシンでもかまいません) を起動して Device Manager ユーティリティからファームウェアの名前を取得してください。デバイスのモデルを知りたいのに ''lsusb'' で表示されない場合、''lsusb -v'' の {{ic|iProduct}} でわかることがあります。
デバイスが [[rfkill]] によってブロックされていないことを確認してください。
 
   
  +
''.hex'' ファイルはダウンロードした Windows ドライバーから抽出することができます。Windows を実行する必要はありません。適切なドライバーをダウンロードしてください (例えば、[http://www.fujitsupc.com/downloads/mobile/BLUETOOTH_WIDCOMM_V6.5.0.3100_WIN7-32_FPC46-1771-01.EXE Bluetooth Widcomm]{{Dead link|2023|09|16|status=domain name not resolved}})。フォーマットにも依りますが、ファイルの展開には{{Pkg|unrar}} か {{Pkg|cabextract}} が必要である場合があります。多数の ''.hex'' ファイルの中から必要なファイルを見つけるには、{{ic|Win32/bcbtums-win7x86-brcm.inf}} ファイルの中身を確認して {{ic|[RAMUSB'''E031'''.CopyList]}} を検索してください。{{ic|E031}} はあなたの使っているデバイスの product コード (大文字) に置き換えて下さい (''lsusb'' で確認できる2番目の16進数)。その下に、必要な ''.hex'' ファイルの名前が書かれているはずです。
また、一部の Intel カード(8260 など)は Bluetooth サービスによって正しく認識されないかもしれません。{{Pkg|bluez-utils}} の代わりに非推奨の {{AUR|bluez-utils-compat}} を使うことでこの問題が解決したというケースが報告されています。
 
   
  +
''.hcd'' ファイルを手に入れたら、{{ic|/lib/firmware/brcm/BCM.hcd}} にコピーしてください - このファイル名は [[dmesg]] からわかります。あなたのマシンでは異なっている可能性があるため ''dmesg'' の出力で確認してください。そして ''btusb'' モジュールをリロードしてください:
これは省電力機能が原因かもしれません。その場合、{{ic|1=btusb.enable_autosuspend=n}} [[カーネルパラメータ#設定|カーネルパラメータ]]により解決できる可能性があります。[https://bugzilla.redhat.com/show_bug.cgi?id=1573562 Red Hat Bugzilla – Bug 1573562] も参照してください。
 
   
  +
# rmmod btusb
時々、{{ic|btusb}} をオプション無しでアンロード・ロードすればコントローラを元に戻せることがあります:
 
 
# modprobe -r btusb
 
 
# modprobe btusb
 
# modprobe btusb
   
  +
これでデバイスが使えるようになるはずです。以上の設定を永続化させる方法は [https://bbs.archlinux.org/viewtopic.php?id=162688 BBS#162688] を参照。
=== systemd: Condition check resulted in Bluetooth service being skipped ===
 
   
  +
==== Intel の複合 WiFi と Bluetooth カード ====
{{ic|bluetooth.service}} は {{ic|/sys/class/bluetooth}} ディレクトリが存在することのみを要求します。このディレクトリは {{ic|bluetooth}} カーネルモジュールにより作成される必要があります。このカーネルモジュールは、{{ic|systemd-udev}} が動作している Bluetooth ハードウェアデバイスを発見した場合にのみ、{{ic|systemd-udev}} により自動的にロードされます。
 
   
  +
[[ネットワーク設定/ワイヤレス#Bluetooth の共存]] を見てください。
{{ic|/sys/class/bluetooth}} が存在しない場合、{{ic|lsmod}} コマンドを使って、Bluetooth カーネルモジュールがロードされているかどうかを確認してください。Bluetooth デバイスがあるにも関わらずロードされていない場合、[[カーネルモジュール#手動でモジュールを扱う|Bluetooth モジュールをロード]]し、{{ic|bluetooth.service}} を[[再起動]]することで、手動で起動できます。
 
   
  +
==== Windows とのデュアルブート環境における Mediatek MT7921 や MT7961 ====
また、{{ic|bluetooth}} モジュールをロードする際に、対応するカーネル Bluetooth ドライバもロードする必要があります。{{ic|btusb}} が最も可能性がありますが、{{ic|btrtl,btintel,btbcm,bnep,btusb}} などの可能性もあります。
 
   
  +
デュアルブートシステムでは、Bluetooth のファームウェアバージョンが Windows と Linux とで異なる場合、Windows を起動した後に Bluetooth アダプタが動作しなくなります。
{{ic|bluetooth.service}} の[[ユニットステータス]]を確認して、このサービスが起動しているかどうかを確認してください。
 
   
  +
これを防ぐ最も良い方法は、各 OS 用の Bluetooth ドライバ (特にファームウェア) を最新にすることです。
[https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=853207 Debian Bug report logs - #853207] も参照してください。
 
   
  +
Windows 用の最新バージョンのドライバ (またはファームウェア) を見つけられない場合、最新のファームウェアファイル {{ic|/usr/lib/firmware/mediatek/BT_RAM_CODE_MT7961_1_2_hdr.bin.xz}} を Arch Linux からコピーし、Windows へ展開することができます (例えば、{{ic|C:\WINDOWS\system32\DRIVERS\}}。Windows でのファームウェアファイルへのパスはデバイスマネージャから確認できます)。
{{ic|bluetooth.service}} の起動に成功したが、まだ Bluetooth を使えないことがある場合(例: {{ic|scan on}} 時に {{ic|bluetoothctl}} が {{ic|org.Bluez.Error.NotReady}} のようなメッセージを発する)、コンピュータを再起動し、次のことをダブルチェックしてください: {{ic|/sys/class/bluetooth}} ディレクトリが存在するか; {{ic|lsmod}} の出力に正しい Bluetooth モジュールが含まれているか; ジャーナルのログを確認するなど。{{ic|systemd-udev}} は、また手動の変更をせずとも Bluetooth ハードウェアを自動的に認識するはずです。
 
   
  +
==== サスペンド/復帰後にアダプタが消える ====
=== rfkill unblock: Do not unblock ===
 
   
  +
まず、アダプタのベンダーと製品 ID を見つけてください。例:
デバイスがソフトブロックされていて [[ConnMan]] を動作させている場合、次を試してみて下さい:
 
  +
$ connmanctl enable bluetooth
 
  +
First, find vendor and product ID of the adapter. For example:
  +
  +
{{hc|$ lsusb -tv|<nowiki>
  +
/: Bus 01.Port 1: Dev 1, Class=root_hub, Driver=xhci_hcd/12p, 480M
  +
ID 1d6b:0002 Linux Foundation 2.0 root hub
  +
...
  +
|__ Port 3: Dev 3, If 0, Class=Wireless, Driver=btusb, 12M
  +
ID 8087:0025 Intel Corp.
  +
|__ Port 3: Dev 3, If 1, Class=Wireless, Driver=btusb, 12M
  +
ID 8087:0025 Intel Corp.
  +
...
  +
</nowiki>}}
  +
  +
この場合、ベンダー ID は 8087 で、製品 ID は 0025 です。
  +
  +
次に、 {{pkg|usb_modeswitch}} を使用してアダプタをリセットします:
  +
  +
# usb_modeswitch -R -v ''vendor_ID'' -p ''product_ID''
  +
  +
=== ペアリングと接続の問題 ===
   
=== コンピュータが表示されない ===
+
==== コンピュータが表示されない ====
   
 
携帯からコンピュータが表示されないときは、discoverable モードを有効にしてください:
 
携帯からコンピュータが表示されないときは、discoverable モードを有効にしてください:
655行目: 902行目:
 
Bluetooth デバイス/サービスのクラスを生成するには https://bluetooth-pentest.narod.ru/software/bluetooth_class_of_device-service_generator.html を見てください。
 
Bluetooth デバイス/サービスのクラスを生成するには https://bluetooth-pentest.narod.ru/software/bluetooth_class_of_device-service_generator.html を見てください。
   
  +
==== デバイスを接続した数秒後に切断してしまう ====
=== Foxconn / Hon Hai / Lite-On の Broadcom デバイス ===
 
 
一部のデバイスでは、起動時にファームウェアを書き込む必要があります。ファームウェアは提供されていませんが、[https://github.com/jessesung/hex2hcd hex2hcd] ({{Pkg|bluez-utils}} でインストールされます) を使って Microsoft Windows の ''.hex'' ファイルから ''.hcd'' に変換することができます。
 
 
正しい ''.hex'' ファイルを取得するために、''lsusb'' でデバイスの vendor:product コードを検索してください。例:
 
 
...
 
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 (仮想マシンでもかまいません) を起動して Device Manager ユーティリティからファームウェアの名前を取得してください。デバイスのモデルを知りたいのに ''lsusb'' で表示されない場合、''lsusb -v'' の {{ic|iProduct}} でわかることがあります。
 
 
''.hex'' ファイルはダウンロードした Windows ドライバーから抽出することができます。Windows を実行する必要はありません。適切なドライバーをダウンロードしてください。例えば [http://www.fujitsupc.com/downloads/mobile/BLUETOOTH_WIDCOMM_V6.5.0.3100_WIN7-32_FPC46-1771-01.EXE Bluetooth Widcomm] ([http://support.fujitsupc.com/CS/Portal/supportsearch.do?srch=DOWNLOADS&Series=P%20Series&Model=P771&ProductType=Notebook%20PC Lifebook P771] のドライバーとして記載) には多数の Broadcom デバイスのドライバーが含まれています。Bluetooth Widcomm の場合、ドライバーは RAR アーカイブになっているので、''{{Pkg|unrar}} x'' で解凍できます。多数の ''.hex'' ファイルの中から必要なファイルを見つけるために、{{ic|Win32/bcbtums-win7x86-brcm.inf}} ファイルの中身を確認して {{ic|[RAMUSB'''E031'''.CopyList]}} を検索してください。{{ic|E031}} はあなたの使っているデバイスの product コード (大文字) に置き換えて下さい (''lsusb'' で確認できる2番目の16進数)。その下に、必要な ''.hex'' ファイルの名前が書かれているはずです。
 
 
''.hcd'' ファイルを手に入れたら、{{ic|/lib/firmware/brcm/BCM.hcd}} にコピーしてください - このファイル名は {{ic|dmesg}} によって提案されています。あなたのマシンでは異なっている可能性があるため ''dmesg'' の出力で確認してください。そして ''btusb'' モジュールをリロードします:
 
 
# rmmod btusb
 
# modprobe btusb
 
 
これでデバイスが使えるようになるはずです。以上の設定を永続化させる方法は [https://bbs.archlinux.org/viewtopic.php?id=162688 BBS#162688] を参照。
 
 
=== Intel の複合 WiFi と Bluetooth カード===
 
 
[[ワイヤレス設定#Bluetooth の共存]] を見てください。
 
 
=== デバイスを接続した数秒後に切断してしまう ===
 
   
 
デバイスを接続したすぐ後に切断が発生し、ジャーナルの出力に以下のようなメッセージが確認できる場合:
 
デバイスを接続したすぐ後に切断が発生し、ジャーナルの出力に以下のようなメッセージが確認できる場合:
693行目: 911行目:
 
おそらく別のオペレーティングシステムで同一の Bluetooth アダプタを使ってデバイスがペアリングされていることが原因です (例: デュアルブート)。一部のデバイスは同一の MAC アドレス (例: Bluetooth アダプタ) に対して複数のペアリングを関連付けた場合に対処できません。この問題を解決するには [[#デュアルブートペアリング]] の指示に従ってください。
 
おそらく別のオペレーティングシステムで同一の Bluetooth アダプタを使ってデバイスがペアリングされていることが原因です (例: デュアルブート)。一部のデバイスは同一の MAC アドレス (例: Bluetooth アダプタ) に対して複数のペアリングを関連付けた場合に対処できません。この問題を解決するには [[#デュアルブートペアリング]] の指示に従ってください。
   
=== スキャンしてもデバイスが表示されない ===
+
==== スキャンしてもデバイスが表示されない ====
   
Bluetooth Low Energy を使用しているデバイスは bluetoothctl でスキャンしても表示されないことがあります (例: Logitech MX Master)。{{aur|bluez-utils-compat}} をストールしてから以下を実行してみてください:
+
Bluetooth Low Energy を使用しているデバイスは bluetoothctl でスキャンしても表示されないことがあります (例: [[Logitech MX Master]])。{{ic|transport le}} を使ってスキャすることができます。
   
 
{{hc|# bluetoothctl|
 
{{hc|# bluetoothctl|
  +
[bluetooth]# menu scan
[NEW] Controller (MAC) myhostname [default]
 
  +
[bluetooth]# transport le
  +
[bluetooth]# back
  +
[bluetooth]# scan on
  +
[bluetooth]# devices
  +
...
  +
Device XX:XX:XX:XX:XX:XX DA V2 X <---- 低消費電力なデバイス
 
}}
 
}}
   
  +
もう一つの方法は、{{aur|bluez-utils-compat}} をインストールし、{{ic|bluetooth.service}} を[[開始]]し、以下を実行することです:
{{hc|[bluetooth]# power on|
 
  +
  +
{{hc|# bluetoothctl|
  +
[NEW] Controller (MAC) myhostname [default]
  +
  +
[bluetooth]# power on
 
[CHG] Controller (MAC) Class: 0x0c010c
 
[CHG] Controller (MAC) Class: 0x0c010c
 
Changing power on succeeded
 
Changing power on succeeded
 
[CHG] Controller (MAC) Powered: yes
 
[CHG] Controller (MAC) Powered: yes
}}
 
   
{{hc|[bluetooth]# scan on|
+
[bluetooth]# scan on
 
Discovery started
 
Discovery started
 
[CHG] Controller (MAC) Discovering: yes
 
[CHG] Controller (MAC) Discovering: yes
 
}}
 
}}
   
他のターミナルで以下を実行:
+
他のターミナルで:
   
 
# hcitool lescan
 
# hcitool lescan
718行目: 946行目:
 
デバイスが表示されるまで待機してから hcitool を {{ic|Ctrl+c}} で閉じてください。bluetoothctl からデバイスが認識されたら通常通りにペアリングできます。
 
デバイスが表示されるまで待機してから hcitool を {{ic|Ctrl+c}} で閉じてください。bluetoothctl からデバイスが認識されたら通常通りにペアリングできます。
   
  +
==== Intel Corp. AX200 Bluetooth で BLE デバイスが見つからない ====
=== シンボリックリンクのせいで、転送されたファイルを受信できない ===
 
   
  +
どうやら、このデバイスでは BLE のパッシブスキャンが壊れているようです。詳細は[https://community.intel.com/t5/Wireless/AX200-Passive-BLE-scan-linux/m-p/1227456 上流のバグレポート]を見てください。
有効な Bluetooth 接続でファイルの受信に失敗する場合、問題はファイルの転送パス内のシンボリックリンクである場合があります。ジャーナルに以下のようなログが現れます:
 
   
  +
==== スリープ後に再接続できない ====
Jun 18 11:18:13 ember obexd[3338969]: open(/home/me/.cache/obexd/MOC740): Operation not permitted (1)
 
   
  +
スリープ後や、コンピュータがスリープから復帰した後に、デバイスが自動的に再接続されないことがあります。
エラーメッセージに表示されれたパス内にシンボリックリンクが含まれている場合、obexd はデフォルトで[https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/obexd/plugins/filesystem.c#n90 それを拒否します]。この挙動は、[[systemd#ドロップインファイル|ドロップインファイル]]を {{ic|obex.service}} [[systemd/ユーザー|ユーザサービス]]に対して使うことにより初期化時に上書きできます。
 
   
  +
この時、ログに以下のエラーが記録されます:
{{hc|~/.config/systemd/user/obex.service.d/10-symlink.conf|2=
 
  +
[Service]
 
  +
{{bc|
ExecStart=
 
  +
bluetoothd[487]: Authentication attempt without agent
ExecStart=/usr/lib/bluetooth/obexd --symlinks
 
  +
bluetoothd[487]: Access denied: org.bluez.Error.Rejected
 
}}
 
}}
   
その後ユーザの ''systemd'' マジャの設定を[[リロード]]し、{{ic|obex.service}} ユーザユニット[[再起動]]してください。
+
これはデバイスが ''trusted'' としてマークされていないことが原因です。[[#ペアング]] を参照してください。
   
=== ヘッドホンとマウスの干渉 ===
+
=== デバイ固有問題 ===
   
  +
==== Bluetooth マウスのラグ / 接続断 / 応答なし ====
Bluetooth マウスとキーボードを同時に使用しているときに音声が途切れる場合は #23 https://bugs.launchpad.net/ubuntu/+source/bluez/+bug/424215 で参照されているように、次を試してくみてださい。
 
   
  +
[[Bluetooth マウス#トラブルシューティング]] を参照してください。
# hciconfig hci0 lm ACCEPT,MASTER
 
# hciconfig hci0 lp HOLD,SNIFF,PARK
 
   
  +
==== オーディオデバイスが br-connection-profile-unavailable で接続に失敗する ====
=== Bluetoothマウスの動きの遅さ ===
 
   
  +
PipeWire (pulseaudio-bluetooth ではない) が使用されているが、PipeWire のインスタンスが実行されていない場合、bluetooth オーディオデバイスは接続に失敗します。PipeWire デーモンを開始するには、{{ic|pipewire.service}} [[ユーザーユニット]]を[[開始]]するか、何らかの音声を再生してください。その後、オーディオデバイスをもう一度接続してみてください。
{{ic|/var/lib/bluetooth/XX:XX:XX:XX:XX:XX/YY:YY:YY:YY:YY:YY/info}} ({{ic|XX:XX:XX:XX:XX:XX}} Bluetooth アダプタの MAC アドレス {{ic|YY:YY:YY:YY:YY:YY}} - マウスの MAC アドレス) このファイルを編集し、次の行を追加します:
 
   
  +
==== ヘッドホンとマウスの干渉 ====
[ConnectionParameters]
 
MinInterval=6
 
MaxInterval=9
 
Latency=44
 
Timeout=216
 
   
  +
Bluetooth マウスとキーボードを同時に使用しているときに音声が途切れる場合は #23 https://bugs.launchpad.net/ubuntu/+source/bluez/+bug/424215 で参照されているように、次を試してくみてださい:
{{ic|hcitool dev}} コマンドを実行すると、ローカルアダプタの MAC アドレスを確認できます。また、 {{ic|hcitool con}} コマンドを実行すると、現在接続されているリモートデバイスの MAC アドレスを確認できます。
 
   
  +
# hciconfig hci0 lm ACCEPT,MASTER
=== サスペンド/リジューム後にアダプタが消える ===
 
  +
# hciconfig hci0 lp HOLD,SNIFF,PARK
   
  +
==== TP-LINK UB400 と Xbox のコントローラが接続/切断を繰り返す ====
まず、アダプタのベンダーと製品 ID を見つけます。例:
 
   
  +
以下の設定を使用してください:
{{hc|lsusb -tv|<nowiki>
 
/: Bus 01.Port 1: Dev 1, Class=root_hub, Driver=xhci_hcd/12p, 480M
 
ID 1d6b:0002 Linux Foundation 2.0 root hub
 
...
 
|__ Port 3: Dev 3, If 0, Class=Wireless, Driver=btusb, 12M
 
ID 8087:0025 Intel Corp.
 
|__ Port 3: Dev 3, If 1, Class=Wireless, Driver=btusb, 12M
 
ID 8087:0025 Intel Corp.
 
...
 
</nowiki>}}
 
   
  +
{{hc|/etc/bluetooth/main.conf|2=
この場合、ベンダー ID は 8087 で、製品 ID は 0025 です。
 
  +
...
次に、 {{pkg|usb_modeswitch}} を使用してアダプタをリセットします。
 
  +
[General]
 
  +
JustWorksRepairing = always
# usb_modeswitch -R -v ''vendor_ID'' -p ''product_ID''
 
  +
FastConnectable = true
 
  +
Class = 0x000100
=== カーネル 5.9 以降のすべての BLE デバイスの問題 ===
 
  +
...
 
  +
[GATT]
v5.9 以降のカーネルでは、カーネルの Bluetooth スタックは BLE 接続でリンク層プライバシーを使用しようとします。ペアリング後にデバイスが動作しても、リブートまたはサスペンド後にペアリングが解除される場合、おそらくこれが原因です。
 
  +
ReconnectIntervals=1,1,2,3,5,8,13,21,34,55
 
  +
AutoEnable=true
この問題を回避[https://lkml.kernel.org/lkml/D577711C-4AF5-4E82-8A17-E766B64E15A9@holtmann.org/] するには、 {{ic|/var/lib/bluetooth/''アダプターMACアドレス''/''デバイスMACアドレス''/info}} を開いて次の行を削除し、{{ic|bluetooth.service}} を再起動します:
 
  +
...
 
{{bc|1=
 
[IdentityResolvingKey]
 
Key=...
 
 
}}
 
}}
   
  +
そして、{{ic|bluetooth.service}} を[[再起動]]してください。
Arch フォーラムの関連する [https://bbs.archlinux.org/viewtopic.php?id=259954 discussion] を参照してください。
 
   
  +
関連する [https://github.com/atar-axis/xpadneo/issues/166 xpadneo に関する議論]を見ることができますが、xpadneo のドライバは必要ありません。
=== Bluetooth が suspend-to-idle 中のデバイスを即座に立ち上げてしまう ===
 
   
  +
=== ファイル転送の問題 ===
[[サスペンドとハイバネート|suspend-to-idle/S2idle/S0ix/Modern Standby]] する能力のあるシステムにおいては、Bluetooth コントローラがスリープ中も有効化されたままになります。通常、これにより、Bluetooth デバイスが接続されていると、システムが[https://bugzilla.kernel.org/show_bug.cgi?id=200039 スリープに移行した直後にスリープが解除されてしまいます]。
 
   
  +
==== gnome-bluetooth ====
これを防ぐために、スリープに移行する前に Bluetooth を完全に無効化できます。{{Pkg|bluez-utils}} をインストールし、以下のファイルを作成してください:
 
   
  +
bluetooth-properties でファイルの受信を有効にしようとしたときに以下のメッセージが表示される場合:
{{hc|/etc/systemd/system/bluetooth-disable-before-sleep.service|2=
 
[Unit]
 
Description=Disable Bluetooth before going to sleep
 
Before=sleep.target
 
Before=suspend.target
 
Before=hybrid-sleep.target
 
Before=suspend-then-hibernate.target
 
StopWhenUnneeded=yes
 
   
  +
Bluetooth OBEX start failed: Invalid path
[Service]
 
  +
Bluetooth FTP start failed: Invalid path
Type=oneshot
 
RemainAfterExit=yes
 
   
  +
[[XDG ユーザーディレクトリ]]が存在することを確認してください。
ExecStart=/usr/bin/bluetoothctl power off
 
ExecStop=/usr/bin/bluetoothctl power on
 
   
  +
==== シンボリックリンクのせいで、転送されたファイルを受信できない ====
[Install]
 
WantedBy=sleep.target
 
WantedBy=suspend.target
 
WantedBy=hybrid-sleep.target
 
WantedBy=suspend-then-hibernate.target
 
}}
 
   
  +
有効な Bluetooth 接続でファイルの受信に失敗する場合、問題はファイルの転送パス内のシンボリックリンクである場合があります。ジャーナルに以下のようなログが現れます:
このサービスを[[有効化]]し、スリープに移行した時に Bluetooth デバイスが切断されることや、スリープからの復帰時に Bluetooth が再び接続されることを確認してください。
 
   
  +
Jun 18 11:18:13 ember obexd[3338969]: open(/home/me/.cache/obexd/MOC740): Operation not permitted (1)
この回避策を使用すると、[[#サスペンドからの復帰|Bluetooth マウス/キーボードを使ってシステムをスリープから復帰させること]]ができなくなります。
 
   
  +
エラーメッセージに表示されれたパス内にシンボリックリンクが含まれている場合、obexd はデフォルトで[https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/obexd/plugins/filesystem.c#n90 それを拒否します]。この挙動は、[[ドロップインファイル]]を {{ic|obex.service}} [[systemd/ユーザー|ユーザサービス]]に対して使うことにより初期化時に上書きできます:
=== tp-link UB400 と Xboxのコントローラが接続/切断を繰り返す ===
 
   
  +
{{hc|~/.config/systemd/user/obex.service.d/10-symlink.conf|2=
{{ic|/etc/bluetooth/main.conf}} を編集して、以下の設定をします(アンコメント/値を変更します)
 
 
[General
 
JustWorksRepairing = always
 
FastConnectable = true
 
Class = 0x000100
 
 
[GATT]
 
ReconnectIntervals=1,1,2,3,5,8,13,21,34,55
 
AutoEnable=true
 
 
その後、{{ic|bluetooth.service}} を [[再起動]] します。
 
 
関連する [https://github.com/atar-axis/xpadneo/issues/166 xpadneo に関する議論] を見ることができますが、xpadneo のドライバは必要ありません。
 
 
=== 実験的な機能を有効化する ===
 
 
Bluez スタックでは、バグがあるかもしれない新しい機能が ''Experimental'' オプションに含まれています。このオプションに含まれている機能は、実験的な機能の安定化が決まったり、不要と判断されたりすることにより、時間と共に変化します。これを有効化するには、設定ファイルの該当する行をアンコメントしてください:
 
 
{{hc|/etc/bluetooth/main.conf|2=
 
# Enables experimental features and interfaces.
 
# Defaults to false.
 
Experimental = true
 
}}
 
 
あるいは、{{ic|bluetooth.service}} を[[編集]]して、{{ic|--experimental}} フラグを追加することもできます。以下の[[ドロップインファイル]]のように:
 
 
{{hc|/etc/systemd/system/bluetooth.service.d/override.conf|2=
 
 
[Service]
 
[Service]
 
ExecStart=
 
ExecStart=
ExecStart=/usr/lib/bluetooth/bluetoothd --experimental
+
ExecStart=/usr/lib/bluetooth/obexd --symlinks
 
}}
 
}}
  +
  +
その後、ユーザの ''systemd'' マネージャの設定を[[リロード]]し、{{ic|obex.service}} ユーザユニットを[[再起動]]してください。
   
 
== 参照 ==
 
== 参照 ==
859行目: 1,033行目:
 
* [https://nullroute.eu.org/~grawity/bluetooth-key-sharing.html Bluetooth link keys on dual-boot systems]
 
* [https://nullroute.eu.org/~grawity/bluetooth-key-sharing.html Bluetooth link keys on dual-boot systems]
   
{{TranslationStatus|Bluetooth|2022-08-08|740713}}
+
{{TranslationStatus|Bluetooth|2023-11-03|791392}}

2023年11月3日 (金) 12:41時点における最新版

関連記事

Bluetooth は携帯電話やコンピュータなどの電子デバイス用の近距離無線通信規格です。Linux においては、Bluetooth プロトコルスタックの実装として BlueZ が標準的に使われています。

目次

インストール

  1. Bluetooth プロトコロスタックを提供する、bluez パッケージをインストールします。
  2. bluetoothctl ユーティリティを提供する、bluez-utilsインストールします。または bluez-utils-compatAURインストールして、非推奨の BlueZ tools を追加します。
  3. 一般的な Bluetooth ドライバは、btusb カーネルモジュールです。このモジュールがロードされているかどうかを確認してください。もしロードされていなければ、モジュールをロードしてください。
  4. bluetooth.service起動/有効化します。
ノート:
  • デフォルトでは bluetooth デーモンは lp グループのメンバーのユーザーだけに bnep0 デバイスを提供します。bluetooth テザリングに接続するときはユーザーをグループに追加しておいてください。必要なグループは /etc/dbus-1/system.d/bluetooth.conf ファイルで変更することができます。
  • Bluetooth アダプターには Wi-Fi カードがバンドルされているものもあります (例: Intel Centrino[リンク切れ 2023-09-16])。これらの Bluetooth アダプターをカーネルから見えるようにするには、まず Wi-Fi カードを有効にする必要があります (大体はラップトップ上のキーボードショートカットを使う)。
  • Bluetooth カードによってはネットワークアダプタと衝突することがあります (例: Broadcom)。したがって、ネットワークサービスを起動する前に Bluetooth デバイスを接続するようにしてください。
  • hcitool や hciconfig などのツールは上流では非推奨となっており、bluez-utils にはもはや含まれていません。アップデートされないことが決まっているため、スクリプトの中で使用している場合は使わないように書き換えることを推奨します。それでも使いたい場合は bluez-utils-compatAUR をインストールしてください。詳しい情報は FS#53110Bluez メーリングリスト を参照。

フロントエンド

コンソール

  • bluetoothctl — シェルからデバイスをペアリングすることは、最も単純で信頼性の高いオプションの一つです。
http://www.bluez.org/ || bluez-utils
  • bluetuith — ターミナルユーザインターフェイスによる Bluetooth マネージャを提供します。OBEX ファイル転送とマウスのサポート付きで、デバイス/アダプタを簡単に管理できます。
https://www.github.com/darkhz/bluetuith || bluetuithAUR
ヒント: bluetoothctl コマンドを自動化するには、echo -e "command1\ncommand2\n" | bluetoothctl または bluetoothctl -- command を使用します。

グラフィカル

以下のパッケージでは、Bluetooth をカスタマイズするためのグラフィカルインターフェイスが利用可能です。

  • GNOME BluetoothGNOME の Bluetooth ツール。
    • gnome-bluetooth-3.0 バックエンドを提供 (gnome-bluetooth はレガシーです)
    • gnome-shell ステータスモニターアプレットを提供
    • gnome-control-center は設定用のフロントエンド GUI を提供しており、アクティビティ概要で Bluetooth と入力するか、 gnome-control-center bluetooth コマンドでアクセスすることができます。
    • また、bluetooth-sendto コマンドを直接起動して、リモートデバイスにファイルを送信することも可能です。
    • nautilus-bluetoothAUR は Nautilus の右クリックメニューに "Bluetoothで送信" エントリを追加します。
    • ファイルを受信するには、Bluetooth 設定パネルを開きます。Bluetooth パネルが開いている間のみ受信できます。
    • Thunar のファイルプロパティメニューの 送信先 メニューに Bluetooth エントリを追加するには、説明 ここ を参照してください。(設定が必要なコマンドは bluetooth-sendto %F です)
https://wiki.gnome.org/Projects/GnomeBluetooth ||
  • BluedevilKDE の Bluetooth ツール。 Dolphin やシステムトレイに Bluetooth のアイコンが表示されていない場合は、システムトレイオプションで有効にするか、ウィジェットを追加してください。アイコンをクリックすることで、Bluedevil の設定や Bluetooth デバイスの検出が可能です。KDE システム設定からもインターフェースが利用できます。
https://invent.kde.org/plasma/bluedevil || bluedevil
  • Blueberry — GNOME Bluetooth から Linux Mint でスピンオフした Blueberry は全てのデスクトップ環境で動作します。Obex Object Push によるファイル受信をサポートしていません。
https://github.com/linuxmint/blueberry || blueberry
  • Blueman — フル機能の Bluetooth マネージャー
https://github.com/blueman-project/blueman || blueman
  • ObexFTP — OBEX 対応のデバイスとの間でファイルを転送するツール。
http://dev.zuckschwerdt.org/openobex/wiki/ObexFtp || obexftpAUR

ペアリング

ノート: Bluetooth デバイスを使用する前に、rfkill でブロックされていないことを確認してください。

このセクションでは、bluetoothctl CLI を使って bluez5 を直接設定する方法を説明しています。これは、代替のフロントエンドツール(例えば GNOME Bluetooth)を使用している場合は必要ないかもしれません。

正確な手順は、利用するデバイスとその入力機能によります。以下は bluetoothctl を使ってデバイスをペアリングする一般的な説明です。

bluetoothctl 対話コマンドを実行してください。help と入力することで利用できるコマンドのリストを表示できます。

  1. (任意) select MAC Address と入力してデフォルトのコントローラを選択してください。
  2. (任意) デバイスがオフになっている場合、power on と入力してコントローラへの電源供給をオンにしてください。デバイスはデフォルトでオンになっています (#アダプタのデフォルト電源状態)。
  3. devices と入力して、ペアリングしたいデバイスの MAC アドレスを取得してください。
  4. デバイスが表示されないときは scan on コマンドでデバイス検出モードにしてください。
  5. agent on でエージェントをオンにするか、特定のエージェントを選択してください: agent の後にタブキーを2回押すと、利用可能なエージェントのリストが表示されるはずです。Bluetooth エージェントとは、Bluetooth の 'ペアリングコード' を管理するもののことです。エージェントは、'ペアリングコード'の受信に応答したり、'ペアリングコード'を送信したりできます。ほとんどの場合、default-agent を使うのが適切なはずです。[1]
  6. pair MAC Address と入力することでペアリングを実行します (タブ補完が使えます)。
  7. PIN がないデバイスを使う場合は、手動でデバイスを信頼する必要があるかもしれません。trust MAC Address と入力してこれを行なって下さい。デバイスを信頼するには trust MAC_address と入力してください。
  8. connect MAC_address を使って接続を確立してください。

セッションの例は以下のようになります:

$ bluetoothctl
[NEW] Controller 00:10:20:30:40:50 hostname [default]
[bluetooth]# agent KeyboardOnly
Agent registered

[bluetooth]# default-agent
Default agent request successful

[bluetooth]# power on
Changing power on succeeded
[CHG] Controller 00:10:20:30:40:50 Powered: yes

[bluetooth]# scan on
Discovery started
[CHG] Controller 00:10:20:30:40:50 Discovering: yes
[NEW] Device 00:12:34:56:78:90 device name
[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

[bluetooth]# connect 00:12:34:56:78:90
Attempting to connect to 00:12:34:56:78:90
[CHG] Device 00:12:34:56:78:90 Connected: yes
Connection successful

デュアルブートペアリング

デュアルブート環境でデバイスをペアリングするには、Linux の方でペアリングキーを変更して Windows または macOS で使用されているペアリングキーと同じにする必要があります。

このページでは、これを手動で行う方法のみを説明しています。この手順を自動化するには、bt-dualboot プロジェクトや関連するリポジトリを参照してください。

設定方法

これを行うには、まず Arch Linux 上でデバイスのペアリングを行います。その後、もう一方の OS を再起動し、デバイスをペアリングします。ここでペアリング・キーを取り出す必要がありますが、まず Bluetooth デバイスの電源を切り、接続を試みないようにします。

ノート: (Logitech MX Master や Logitech 604 Lightspeed などの) 一部の Logitech デバイスは、デバイスが新しいシステムとペアリングするたびに MAC アドレスの値を1つ増加させます。プロセスの最後にこれに対処するために、このケースに該当するかどうかを確認する必要があります。

Windows の場合

Windows での展開

まず、Windows を起動してください。

リンクキーを含むレジストリキーは、SYSTEM アカウントでしかアクセスできないため、ログインすることができません。そのため、regedit.exeSYSTEM として実行するには、Windows Sysinternals 公式サイトにある Microsoft の PsExec ツールが必要になります。

PsTools をダウンロードし、PsExec64.exe を解凍します。

コマンドシェル の管理者インスタンスで、解凍した EXE の場所からレジストリエディタを起動してください:

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

レジストリエディタで、以下のレジストリキーに移動します:

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

このキーの中に各 Bluetooth アダプターの MAC アドレス別のキーがあります。複数のキーがあり、どれを使えばいいかわからない場合は、このガイドに従って、目的の Bluetooth アダプタの MAC アドレスを検索してください。

目的のデバイスアダプタキーの中に、ペアリングされたデバイスのそれぞれに対してキーが、MAC アドレスと関連付けられて存在しています。

インストール間で共有したい各ペアデバイスについて、キー全体を右クリックし、.reg ファイルとしてエクスポートしてください。これはテキストファイルで、このファイルからキーをコピーできます。

このファイルにバイナリキーが1つだけ存在する場合、Bluetooth 5.1 デバイスではなく、そのペアリングキーが必要なもの全てであるということになります。

ペアリングしたデバイスに複数のキー (LTKIRK など) が存在する場合、これは Bluetooth 5.1 デバイスであるということになります。これらのキーを使う方法は #Bluetooth 5.1 キーの準備 を見てください。

最後に、キーを Linux 環境にインポートするために、Linux を起動して #終わりに へ進んでください。

Linux での展開
ノート: Windows パーティションが Bitlocker で暗号化されている場合、Linux から chntpw を使ってアクセスすることはできません。

Arch をリブートしてください。chntpw をインストールして、Windows システムドライブをマウントします。

$ cd /path/to/windows/system/Windows/System32/config
$ chntpw -e SYSTEM
ノート: CurrentControlSet の代わりに ControlSet00X(X は任意の数字)と表示されることがあります。ls コマンドで確認してください。

chntpw 環境の中で以下を実行します。

> cd CurrentControlSet\Services\BTHPORT\Parameters\Keys

もしくは

> cd ControlSet00X\Services\BTHPORT\Parameters\Keys

次に、Bluetooth アダプタの MAC アドレスを取得し、そのフォルダを入力します。

> ls
> cd your-device's-mac-address

ペアリングしているデバイスにも同じことをします。Bluetooth 5.1 デバイスでない場合、ペアリングキーしか表示されません:

> ls
Node has 0 subkeys and 1 values
size  type        value name    [value if type DWORD]
16    REG_BINARY <123456789876>

Bluetooth 5.1 デバイスである場合、hex を通して、デバイスのキーを取得します。

> hex 123456789876
:00000 XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX (いくつかの他の文字)

”XX" はペアリング・キーです。どのキーがどの MAC アドレスにマッピングされているか、メモしておいてください。

Bluetooth 5.1 デバイスである場合、1つのデバイスに対応するキーが複数表示されます。

Node has 0 subkeys and 8 values
  size     type              value name             [value if type DWORD]
    16  3 REG_BINARY         <LTK>
     4  4 REG_DWORD          <KeyLength>               16 [0x10]
     8  b REG_QWORD          <ERand>
     4  4 REG_DWORD          <EDIV>                 37520 [0x9290]
    16  3 REG_BINARY         <IRK>
     8  b REG_QWORD          <Address>
     4  4 REG_DWORD          <AddressType>              1 [0x1]
     4  4 REG_DWORD          <AuthReq>                 45 [0x2d]

これらのキーを使う方法は #Bluetooth 5.1 キーの準備 を見てください。必要な値を得るには hex value_name を使います。

最後に、キーを Linux 環境にインポートするために #終わりに へ進んでください。

macOS の場合

macOS を起動し:

  • macOS Monterey 及びそれ以降の場合:
    1. Keychain Access を開き、Bluetooth と検索してください。
    2. 日付順でソートしてください。
    3. 対象のデバイスを最近取り除いて再接続した場合、キーを変更日時順でソートして、最新のものを選べばよいです。キーはおそらく MobileBluetooth (古い Bluetooth デバイスの場合) という名前か、UUID (Bluetooth 5.1 以降) だけです。
    4. 対象のエントリをダブルクリックしてください。Account フィールドの MAC アドレスが対象デバイスの MAC アドレスと一致することを確認してください。
    5. "Show password" チェックボックスをクリックしてください。ここで、パスワードを2回入力する必要があります。
    6. パスワードフィールド内のテキストをコピーしてください (⌘+a ⌘+c)。これは実際には XML ファイルです。
    • テキストをホームディレクトリ内の bt_keys.txt ファイルにペーストしてください。
  • High Sierra 及びそれ以降の場合、次のコマンドをターミナルで実行してください:
    # defaults read /private/var/root/Library/Preferences/com.apple.bluetoothd.plist LinkKeys > ~/bt_keys.txt
  • Sierra 及びそれ以前の場合、次のコマンドをターミナルで実行してください:
    # defaults read /private/var/root/Library/Preferences/blued.plist LinkKeys > ~/bt_keys.txt

すると、~/.bt_keys.txt ファイルには、確立された Bluetooth キーが含まれています。古いバージョンの macOS (High Sierra 及びそれ以前) では、先に進む前にキーの並びを逆にする必要があります。例えば、98 54 2f aa bb cc dd ee ff gg hh ii jj kk ll mmMM LL KK JJ GG FF EE DD CC BB AA 2F 54 98 になります。

ノート: キーの並びを逆にするには、以下の Python コードを使用できます:
>>> key = "98 54 2f aa bb cc dd ee ff gg hh ii jj kk ll mm"
>>> " ".join(reversed(key.strip().split()))

Bluetooth 5.1 デバイスの場合、1つのデバイスに対して複数のキーが関連付けられています。それらのキーを使用する方法については #Bluetooth 5.1 キーの準備 を見てください。

最後に、キーを Linux 環境にインポートするために、Linux を起動し、#終わりに へ進んでください。

Bluetooth 5.1 キーの準備

#Windows の場合#macOS の場合 の章に従っていて Bluetooth 5.1 キーが存在していた場合、それらのキーを Linux にインポートする前に特定の変換をかける必要があります。#終わりに の章で使うために、要求されたファイルを適切に作成してください。この手順は対象デバイスによって異なり、キーの一部を操作する必要があります。これを行うためのユーティリティは以下で挙げられています。

デバイス 元のキー及び変換 (Windows) 元のキー及び変換 (macOS) キーの保存先ファイル
  • Logitech MX Master 3
  • Xbox One S Wireless Controller
  • IRK をコピー。
  • 16進数の桁間のスペースを除去。
? IdentityResolvingKey.Key
  • LTK をコピー。
  • 16進数の桁間のスペースを除去。
? SlaveLongTermKey.KeyPeripheralLongTermKey.Key
ERandEDIV0 にする必要あり。 Random NumberEncrypted Diversifier0 にする必要あり。
  • ThinkPad TrackPoint Keyboard II
  • Pebble M350 マウス
  • Logitech G604 Lightspeed マウス
  • IRK をコピー
  • バイトの順番を逆に。
  • Remote IRK をコピー。
  • Base64 から16進数に変換。
IdentityResolvingKey.Key
  • LTK をコピー。
  • 16進数の桁間のスペースを除去。
  • Remote EncryptionLong-term Key にコピー。
  • Base64 から16進数に変換。
LongTermKey.Key
  • ERand をコピー。
  • バイトの順番を逆に。
  • 数値全体を10進数に変換。
  • Remote EncryptionRandom Number にコピー
  • Base64 をリトルエンディアンの10進数に変換 (以下の Python コードを参照)。
LongTermKey.Rand
  • EDIV をコピー。
  • バイトの順番を逆に。
  • 数値全体を10進数に変換。
  • Remote EncryptionEncrypted Diversifier にコピー。
  • Base64 からリトルエンディアンの10進数に変換 (以下の Python コードを参照)。
LongTermKey.EDiv
他のデバイス
  • LTK をコピー。
  • 16進数の桁間のスペースを除去。
  • Remote IRK をコピー。
  • Base64 から16進数に変換。
LongTermKey.Key
  • ERand をコピー。
  • バイトの順番を逆に。
  • 数値全体を10進数に変換。
  • Remote EncryptionLong-term Key にコピー。
  • Base64 から16進数に変換。
LongTermKey.Rand
  • EDIV をコピー。
  • 16進数の桁間のスペースを除去。
  • Remote EncryptionEncrypted Diversifier にコピー。
  • Base64 から16進数に変換。
  • バイトの順番を逆に。
LongTermKey.EDiv
Xbox ワイヤレスコントローラ
  • LTK をコピー。
  • 16進数の桁間のスペースを除去。
? SlaveLongTermKey.Key
ノート:
>>> "key_value".replace(" ", "")
  • 以下の Python コードはバイトの順番を逆にするだけです:
>>> ERand=" 63 02 84 B8 5D 40 44 DF   "
>>> ERand=list(reversed(ERand.strip().split()))
  • 以下の Python コードは、一部で必要となる追加の10進数変換を行います:
>>> int("".join(ERand), 16)
16088054540146049635
  • 以下の Python コードは base64 から16進数への変換を行います:
binascii.hexlify(base64.decodebytes(b'...')).upper()
  • 以下の Python コードは完全な macOS Encrypted Diversifier の変換を行います:
struct.unpack('<H', base64.decodebytes(b'...'))
  • 以下の Python コードは完全な macOS Random Number の変換を行います:
struct.unpack('<Q', base64.decodebytes(b'...'))

一般的なケースの例としては:

  • LTK の値 48 4D AF CD 0F 92 22 88 0A 52 9A F4 76 DA 8B 94 は、LongTermKey.Key の値 484DAFCD0F9222880A529AF476DA8B94 となります。
  • ERand の値 63 02 84 B8 5D 40 44 DF は、Rand の値 16088054540146049635 となります。
  • EDIV の値 37520 は、EDiv の値 37520 となります。

終わりに

キーを手に入れたら、ユーザーを root に変更し、以下を実行してください:

# cd /var/lib/bluetooth/BT-Adapter-MAC-address

ここには、ペアリングした Bluetooth 機器ごとのフォルダがあります。Arch とデュアルブートでペアリングしたい各デバイスについて、以下を実行します:

# cd device-MAC-address
ノート: この時点で、ペアリング時に MAC アドレスの値を増加させるデバイスを使用している場合、MAC アドレスのディレクトリを、値を増加させたパスへ移動させる必要があります。Windows から MAC アドレスをコピーするか、あるいは、各オクテットが2桁の16進数であることに注意しながら自分で値を増加させてください。

ペアリングキーを持っている場合 (つまり、これは Bluetooth 5.1 デバイスでない)、info ファイルを編集し、[LinkKey] 以下のキーを変更します。例えば:

info
[LinkKey]
Key=XXXXXXXXXXXXXXX
ノート: すべての文字が大文字であることを確認する必要があります。スペースはすべて削除してください。

複数のキーが存在する場合 (Bluetooth 5.1 の場合)、以下の info ファイルを編集して、全てのキーをそれぞれの値で置き換えてください。例えば、Xbox One S Wireless Controller の場合:

info
[IdentityResolvingKey]
Key=<IdentityResolvingKey.Key>

[PeripheralLongTermKey]
Key=<PeripheralLongTermKey.Key>

[SlaveLongTermKey]
Key=<SlaveLongTermKey.Key>

次に、bluetooth.servicepulseaudio再起動してください。(pulseaudio -k && pulseaudio --start を使ってください。)

これで、デバイスに接続できるはずです。

ノート: Bluetooth マネージャによっては、デバイスに再接続するために完全な再起動が必要な場合があります。

設定

アダプタのデフォルト電源状態

bluez 5.65 以降、BlueZ はデフォルトで、サービスの起動時やサスペンドからの復帰時にすべての Bluetooth アダプタをオンにします。[2]

アダプタを自動で有効化させたくない場合(例えば、ポータブルデバイスなどでバッテリを節約したい場合)、/etc/bluetooth/main.conf[Policy] セクションで AutoEnable=false を設定してください:

/etc/bluetooth/main.conf
[Policy]
AutoEnable=false

この設定を行っても、#ペアリング で説明されているように power on を実行すれば、アダプタを手動でオンにできます。

起動時に発見可能にする

デバイスが常に見えていて、かつ直接接続できる必要がある場合:

/etc/bluetooth/main.conf
[General]
DiscoverableTimeout = 0

サスペンドからの復帰

Bluetooth キーボードやマウスなどをサスペンドから起動できるようにする。まず、bios の設定を確認し、サスペンドからの復帰 が無効になっていないことを確認します。多くの場合、マザーボードからの Bluetooth は USB デバイスです。

bluetooth アダプターのベンダーコードとデバイス ID を確認してください:

$ lsusb | grep bluetooth -i
Bus 001 Device 002: ID 8087:0039 Intel Corp. AX200 Bluetooth

サスペンドからの復帰を有効にするために、ベンダコードとデバイス ID の新しい udev ルールを追加してください:

/etc/udev/rules.d/91-keyboard-mouse-wakeup.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="8087", ATTRS{idProduct}=="0039" RUN+="/bin/sh -c 'echo enabled > /sys$env{DEVPATH}/../power/wakeup;'"

復帰後に Bluetooth キーボードを自動的に再設定して、例えば異なるキーマップやキーのリピート速度をもたせたりする(詳細は Xorg でのキーボード設定#typematic delay と rate の調整xmodmap)には、実行可能なスクリプトを作成してください。

configure_keyboard.sh
#!/bin/sh
export DISPLAY=:0
xset r rate 220 30
xmodmap /your/path/to/.Xmodmap

そして、上記のような追加の udev ルールを作成してください。

/etc/udev/rules.d/92-keyboard-reconfiguration-wakeup.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="8087", ATTRS{idProduct}=="0039" RUN+="/your/path/to/configure_keyboard.sh"

実験的な機能を有効化する

Bluez スタックは、バグがあるかもしれない新しい機能を D-Bus 実験的オプションおよびカーネル実験的オプションに留めます。実験的な機能は最終的に、安定していると判断され、もはやオプションを必要としなくなるので、どのような実験的な機能が存在するかはバージョンによって異なります (例えば、現在 D-Bus の実験的なインターフェイスを有効化すると、古いヘッドセットのバッテリーレベルを報告できるようになります)。実験的な機能を有効化するには、設定の対応する行をアンコメントしてください:

/etc/bluetooth/main.conf
...

# Enables D-Bus experimental interfaces
# Possible values: true or false
#Experimental = true

# Enables kernel experimental features, alternatively a list of UUIDs
# can be given.
# Possible values: true,false,<UUID List>
# Possible UUIDS:
...
# Defaults to false.
#KernelExperimental = true

あるいは、bluetooth.service編集して、--experimental フラグあるいは --kernel フラグを追加してください。例えば、以下のドロップインファイルのように:

/etc/systemd/system/bluetooth.service.d/override.conf
[Service]
ExecStart=
ExecStart=/usr/lib/bluetooth/bluetoothd --experimental

いずれの場合でも、bluetooth.service再起動する必要があります。

オーディオ

通常は、オーディオサーバーと Bluetooth を統合するために追加の手順を実行する必要があります。これについては、以下のセクションで説明します。

Bluetooth オーディオや Bluetooth ヘッドセットなどの情報については Bluetooth ヘッドセット のページを見てください。

PulseAudio

Bluetooth ヘッドフォンやスピーカーのようなオーディオ機器を使うには pulseaudio-bluetooth パッケージのインストールが必要です。インストールを反映させるために、pulseaudio を再起動してください: pulseaudio -k。デフォルトの Pulseaudio インストールでは (具体的には、パッケージングされているデフォルトの default.pa でユーザインスタンスを使用している場合)、即座に Bluetooth デバイスからスピーカーにオーディオをストリーミングできるはずです。[3]

システム全体の PulseAudio 設定がある場合は、デーモンを実行しているユーザー(通常は pulse) が lp グループに属しており、PulseAudio 設定に Bluetooth モジュールをロードしていることを確認します:

/etc/pulse/system.pa
...
load-module module-bluetooth-policy
load-module module-bluetooth-discover
...

これは任意ですが、Bluetooth デバイスの接続時にすべてのオーディオをそのデバイスに自動で切り替えたい場合、load-module module-switch-on-connect を追加してください。

PipeWire

v0.3.19 以降の PipeWire はデフォルトで Bluetooth をサポートしています。

ALSA

ノート: Bluez5 は ALSA の直接統合を中止し、 PulseAudio のみをサポートします。 PulseAudio を使用できない場合、または使用しない場合は、次の手順に従ってください。

まず、 Bluetooth オーディオデバイスが正しくペアリングされ、システムに接続されていることを確認します。

次に、 bluez-alsa-gitAUR をインストールし、 bluealsa サービスを開始(そして、有効に) し、ユーザーを audio グループに追加します。

次のコマンドを実行して、すべてが意図したとおりに動作しているかどうかを確認します(XX:XX:XX:XX:XX:XXFILE.wav の部分は置き換えてください):

$ aplay -D bluealsa:SRV=org.bluealsa,DEV=XX:XX:XX:XX:XX:XX,PROFILE=a2dp FILE.wav

最後に、 ~/.asoundrc に次の行を追加します。

~/.asoundrc
defaults.bluealsa {
    service "org.bluealsa"
    device "XX:XX:XX:XX:XX:XX"
    profile "a2dp"
}

これで、 bluealsa デバイスを使って Bluetooth オーディオデバイスに接続できるようになります。ボリューム管理は alsamixer とオプション -D bluealsa を使って通常行われます。

Bluetooth シリアル

Bluetooth-to-Serial modules (HC-05、HC-06) で Bluetooth シリアル通信が機能するようにするには、次の手順に従います:

上記で説明したように、 bluetoothctl を使って Bluetooth デバイスをペアリングします。

bluez-utils-compatAUR をインストールします。新しいツールにはない機能があります。

ペアになっているデバイスの MAC アドレスを tty 端末にバインドします:

# rfcomm bind rfcomm0 MAC_address_of_Bluetooth_device

これで、シリアル通信用に /dev/rfcomm0 を開くことができます:

$ picocom /dev/rfcomm0 -b 115200

トラブルシューティング

この記事またはセクションは情報が古くなっています。
理由: Replace hciconfig with newer commands. (Discuss)

一般的なトラブルシューティング

デバッグ

デバッグするには、最初に bluetooth.service停止します。

そして -d パラメーターを付けて開始します。

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

別のオプションとして、 btmon ツールが有ります。

非推奨の BlueZ ツール

8つの BlueZ ツールは非推奨となりbluez-utils から削除されましたが、それらのすべてが新しいツールに取って代わられたわけではありません。bluez-utils-compatAUR パッケージは非推奨のツールを含む代替バージョンの bluez-utils を提供します。

非推奨のツール あり得る代替
gatttool btgatt-client, D-Bus Gatt API[リンク切れ 2023-10-29]
hciattach btattach
hciconfig btmgmt (そして bluetoothctl?)
hcidump btmon (そして btsnoop)
hcitool なし、D-Bus Device API[リンク切れ 2023-10-29] が利用可能
rfcomm なし、D-Bus Profile1 API[リンク切れ 2023-10-29] の実装?
ciptool
sdptool なし、機能が、異なる D-Bus オブジェクトに散らばっている模様: Profile[リンク切れ 2023-10-29]Advertising[リンク切れ 2023-10-29]、そして device[リンク切れ 2023-10-29]adapter[リンク切れ 2023-10-29] の UUID の配列。

サービスの問題

systemd: Condition check resulted in Bluetooth service being skipped

bluetooth.service/sys/class/bluetooth ディレクトリが存在することのみを要求します。このディレクトリは bluetooth カーネルモジュールによって作成されるはずです。このカーネルモジュールは、systemd-udev が動作している Bluetooth ハードウェアデバイスを発見した場合にのみ、systemd-udev により自動的にロードされます。

/sys/class/bluetooth が存在しない場合、lsmod コマンドを使って、Bluetooth カーネルモジュールがロードされているかどうかを確認してください。Bluetooth デバイスがあるにも関わらずロードされていない場合、Bluetooth モジュールをロードし、bluetooth.service再起動することで、手動で起動できます。

また、bluetooth モジュールをロードする際に、対応するカーネル Bluetooth ドライバもロードする必要があります。btusb が最も可能性がありますが、btrtl,btintel,btbcm,bnep,btusb などの可能性もあります。

bluetooth.serviceユニットステータスを確認して、このサービスが起動しているかどうかを確認してください。

Debian Bug report logs - #853207 も参照してください。

bluetooth.service の起動に成功したが、まだ Bluetooth を使えないことがあります (例: scan on の時に bluetoothctlorg.Bluez.Error.NotReady のようなメッセージを発する)。この場合、コンピュータを再起動し、次のことをダブルチェックしてください: /sys/class/bluetooth ディレクトリが存在するか; lsmod の出力に正しい Bluetooth モジュールが含まれているか; journal のログを確認するなど。systemd-udev は、また手動の変更をせずとも Bluetooth ハードウェアを自動的に認識するはずです。

Bluetooth が suspend-to-idle 中のデバイスを即座に立ち上げてしまう

suspend-to-idle/S2idle/S0ix/Modern Standby する能力のあるシステムにおいては、Bluetooth コントローラがスリープ中も有効化されたままになります。通常、これにより、Bluetooth デバイスが接続されていると、システムがスリープに移行した直後にスリープが解除されてしまいます

これを防ぐには、スリープに移行する前に Bluetooth を完全に無効化できます。bluez-utils をインストールし、以下のファイルを作成してください:

/etc/systemd/system/bluetooth-disable-before-sleep.service
[Unit]
Description=Disable Bluetooth before going to sleep
Before=sleep.target
Before=suspend.target
Before=hybrid-sleep.target
Before=suspend-then-hibernate.target
StopWhenUnneeded=yes

[Service]
Type=oneshot
RemainAfterExit=yes

ExecStart=/usr/bin/bluetoothctl power off
ExecStop=/usr/bin/bluetoothctl power on

[Install]
WantedBy=sleep.target
WantedBy=suspend.target
WantedBy=hybrid-sleep.target
WantedBy=suspend-then-hibernate.target

このサービスを有効化し、スリープに移行した時に Bluetooth デバイスが切断されることや、スリープからの復帰時に Bluetooth が再び接続されることを確認してください。

この回避策を使用すると、Bluetooth マウス/キーボードを使ってシステムをスリープから復帰させることができなくなります。

ヘッドレス/サーバのシステムでログアウト後に Bluetooth がオフになる

様々な原因が考えられます:

  • PulseAudioPipeWire は両方ともデフォルトでユーザサービスとして動作します。よって、最後のセッションが終了するとこれらのサービスは終了されます。この問題を解決するには、対象のユーザに対して Lingering (残留) を有効化してください。
  • さらに、WirePlumberPipeWire と共に実行している場合 (これはよくある環境です)、WirePlumber は "logind-monitor" を実行します。これは、Bluetooth をログイン時に有効化し、ログアウト時に無効化します。問題の解決方法は WirePlumber#ログアウト後も Bluetooth を実行し続ける/ヘッドレス Bluetooth を見てください。

アダプタの問題

hcitool scan: Device not found

  • 一部のラップトップ (例: Dell Studio 15、Lenovo Thinkpad X1) では、Bluetooth モードを HID から HCI に切り替える必要があります。bluez-hid2hci パッケージをインストールすれば、udev が自動的に切り替えを行うはずです。また、次のコマンドを実行して手動で HCI に切り替えることもできます:
# /usr/lib/udev/hid2hci
  • デバイスが表示されず、かつマシンに Windows オペレーティングシステムがある場合、Windows から bluetooth アダプターを有効にして見てください。
  • 場合によっては次のコマンドで問題が解決するかもしれません:
# bluetoothctl power on

bluetoothctl: No default controller available

一部のマザーボード Bluetooth コントローラにはバグがあります。バグがこの問題の原因であるか調べるには、journalctl | grep hci を実行してください。このコマンドの出力に "command tx timeout" や "Reading Intel version command failed" のようなエントリが存在する場合、PC の電源を切り、電源ケーブルを物理的に外して数秒間放置してください。これにより、コントローラにファームウェアを再ロードさせます (通常の再起動では再ロードしません)。こちらのバグレポートを参照してください。

デバイスが rfkill によってブロックされていないことを確認してください。

また、一部の Intel カード (8260 など) は Bluetooth サービスによって正しく認識されないかもしれません。bluez-utils の代わりに非推奨の bluez-utils-compatAUR を使うことでこの問題が解決したというケースが報告されています。

また、これは省電力機能が原因かもしれません。その場合、btusb.enable_autosuspend=n カーネルパラメータにより解決できる可能性があります。Red Hat Bugzilla – Bug 1573562 も参照してください。

時々、btusb をオプション無しでアンロード・ロードすればコントローラを元に戻せることがあります:

# modprobe -r btusb
# modprobe btusb

また、ドングルが CSR クローンである場合にもこの問題が発生することがあります。

rfkill unblock: Do not unblock

デバイスがソフトブロックされていて ConnMan を動作させている場合、次を試してみて下さい:

$ connmanctl enable bluetooth

Bluetooth USB ドングル

USB ドングルを使う場合は、Bluetooth ドングルが認識されているか確認してください。USB ドングルを挿入する時に journalctl -f を root として実行する(もしくは /var/log/messages.log を調査する)ことで、そのことを確認できます。以下のような見た目であるはずです(hci を見てください)。

Feb 20 15:00:24 hostname kernel: [ 2661.349823] usb 4-1: new full-speed USB device number 3 using uhci_hcd
Feb 20 15:00:24 hostname bluetoothd[4568]: HCI dev 0 registered
Feb 20 15:00:24 hostname bluetoothd[4568]: Listening for HCI events on hci0
Feb 20 15:00:25 hostname bluetoothd[4568]: HCI dev 0 up
Feb 20 15:00:25 hostname bluetoothd[4568]: Adapter /org/bluez/4568/hci0 has been enabled

最初の2行しか表示されていなかった場合、デバイスは見つかっていますが、そのデバイスを立ち上げる必要があります。 例:

# btmgmt
[mgmt]# info
Index list with 1 item
hci0:	Primary controller
	addr 00:1A:7D:DA:71:10 version 6 manufacturer 10 class 0x000000
	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: connectable discoverable bondable ssp br/edr le secure-conn 
	name Mozart
	short name 

[mgmt]# select hci0
Selected index 0

[hci0]# power up
hci0 Set Powered complete, settings: powered connectable discoverable bondable ssp br/edr le secure-conn

[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
[bluetooth]# show
Controller 00:1A:7D:DA:71:10 (public)
	Name: Mozart
	Alias: Mozart
	Class: 0x0000095c
	Powered: no
	Discoverable: yes
	Pairable: yes

[bluetooth]# power on
[CHG] Controller 00:1A:7D:DA:71:10 Class: 0x001c0104
Changing power on succeeded
[CHG] Controller 00:1A:7D:DA:71:10 Powered: yes

[bluetooth]# show
Controller 00:1A:7D:DA:71:10 (public)
	Name: Mozart
	Alias: Mozart
	Class: 0x001c0104
	Powered: yes
	Discoverable: yes
	Pairable: yes

公式の仕様表に従って、Bluetooth のバージョンが HCI のバージョンにマップされていることを確認できます。例えば、先の出力では、HCI version 6 が Bluetooth version 4.0 です。

デバイスが検出されているか確認するために bluez-utils に含まれている hcitool を使うことができます。次のコマンドで利用可能なデバイスとその識別子・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

デバイスに関するもっと詳細な情報は、非推奨の hciconfig を使うことで取得できます。(bluez-utils-compatAUR)

$ hciconfig -a hci0
hci0:   Type: USB
        BD Address: 00:1B:DC:0F:DB:40 ACL MTU: 310:10 SCO MTU: 64:8
        UP RUNNING PSCAN ISCAN
        RX bytes:1226 acl:0 sco:0 events:27 errors:0
        TX bytes:351 acl:0 sco:0 commands:26 errors:0
        Features: 0xff 0xff 0x8f 0xfe 0x9b 0xf9 0x00 0x80
        Packet type: DM1 DM3 DM5 DH1 DH3 DH5 HV1 HV2 HV3
        Link policy: RSWITCH HOLD SNIFF PARK
        Link mode: SLAVE ACCEPT
        Name: 'BlueZ (0)'
        Class: 0x000100
        Service Classes: Unspecified
        Device Class: Computer, Uncategorized
        HCI Ver: 2.0 (0x3) HCI Rev: 0xc5c LMP Ver: 2.0 (0x3) LMP Subver: 0xc5c
        Manufacturer: Cambridge Silicon Radio (10)
ドングルから短距離にいるときにオーディオデバイスがおかしくなる

他のデバイスと同一の USB ホストを共有している場合、オーディオデバイスとの通信に干渉 する可能性があります。オーディオデバイスがバスに接続されている唯一のデバイスであることを確認してください。例:

$ lsusb
Bus 002 Device 002: ID 0a12:0001 Cambridge Silicon Radio, Ltd Bluetooth Dongle (HCI mode)
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 001 Device 004: ID 048d:1345 Integrated Technology Express, Inc. Multi Cardreader
Bus 001 Device 003: ID 0424:a700 Standard Microsystems Corp. 2 Port Hub
Bus 001 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
CSR ドングル 0a12:0001

デバイス ID 0a12:0001 Cambridge Silicon Radio, Ltd Bluetooth Dongle (HCI mode) にはリグレッションのバグがあり、現在、カーネルバージョン 5.17 及び < 6.0 でしか動作しません。詳細は、Kernel Bug 60824 を参照してください。

Logitech Bluetooth USB ドングル

Logitech のドングルには Embedded と HCI という二つのモードで動作するものがあります (例: Logitech MX5000)。embedded モードではドングルは USB デバイスをエミュレートするので PC は普通の USB マウス・キーボードを使っていると認識します。

USB BT ミニレシーバの小さな赤いボタンを押すと他のモードが有効になります。BT ドングルの赤いボタンを押しながらコンピュータに接続してください。ボタンを押して3-5秒で、Bluetooth アイコンがシステムトレイに表示されます (議論)。

また、bluez-hid2hci パッケージをインストールすることもできます。Logitech のドングルを接続すると自動的に切り替えます。

Foxconn / Hon Hai / Lite-On の Broadcom デバイス

一部のデバイスでは、起動時にファームウェアを書き込む必要があります。

一部のファームウェアは、AURbroadcom と検索すると入手できます。特出すべきパッケージは broadcom-bt-firmwareAUR です。これは、様々なカード用のファイルを提供します。

または、hex2hcd (bluez-utils でインストールされます) を使ってファームウェアを Microsoft Windows の .hex ファイルから .hcd ファイルに変換することもできます。

正しい .hex ファイルを取得するために、lsusb でデバイスの vendor:product コードを検索してください。例:

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 (仮想マシンでもかまいません) を起動して Device Manager ユーティリティからファームウェアの名前を取得してください。デバイスのモデルを知りたいのに lsusb で表示されない場合、lsusb -viProduct でわかることがあります。

.hex ファイルはダウンロードした Windows ドライバーから抽出することができます。Windows を実行する必要はありません。適切なドライバーをダウンロードしてください (例えば、Bluetooth Widcomm[リンク切れ 2023-09-16])。フォーマットにも依りますが、ファイルの展開にはunrarcabextract が必要である場合があります。多数の .hex ファイルの中から必要なファイルを見つけるには、Win32/bcbtums-win7x86-brcm.inf ファイルの中身を確認して [RAMUSBE031.CopyList] を検索してください。E031 はあなたの使っているデバイスの product コード (大文字) に置き換えて下さい (lsusb で確認できる2番目の16進数)。その下に、必要な .hex ファイルの名前が書かれているはずです。

.hcd ファイルを手に入れたら、/lib/firmware/brcm/BCM.hcd にコピーしてください - このファイル名は dmesg からわかります。あなたのマシンでは異なっている可能性があるため dmesg の出力で確認してください。そして btusb モジュールをリロードしてください:

# rmmod btusb
# modprobe btusb

これでデバイスが使えるようになるはずです。以上の設定を永続化させる方法は BBS#162688 を参照。

Intel の複合 WiFi と Bluetooth カード

ネットワーク設定/ワイヤレス#Bluetooth の共存 を見てください。

Windows とのデュアルブート環境における Mediatek MT7921 や MT7961

デュアルブートシステムでは、Bluetooth のファームウェアバージョンが Windows と Linux とで異なる場合、Windows を起動した後に Bluetooth アダプタが動作しなくなります。

これを防ぐ最も良い方法は、各 OS 用の Bluetooth ドライバ (特にファームウェア) を最新にすることです。

Windows 用の最新バージョンのドライバ (またはファームウェア) を見つけられない場合、最新のファームウェアファイル /usr/lib/firmware/mediatek/BT_RAM_CODE_MT7961_1_2_hdr.bin.xz を Arch Linux からコピーし、Windows へ展開することができます (例えば、C:\WINDOWS\system32\DRIVERS\。Windows でのファームウェアファイルへのパスはデバイスマネージャから確認できます)。

サスペンド/復帰後にアダプタが消える

まず、アダプタのベンダーと製品 ID を見つけてください。例:

First, find vendor and product ID of the adapter. For example:

$ lsusb -tv
/:  Bus 01.Port 1: Dev 1, Class=root_hub, Driver=xhci_hcd/12p, 480M
    ID 1d6b:0002 Linux Foundation 2.0 root hub
    ...
    |__ Port 3: Dev 3, If 0, Class=Wireless, Driver=btusb, 12M
        ID 8087:0025 Intel Corp. 
    |__ Port 3: Dev 3, If 1, Class=Wireless, Driver=btusb, 12M
        ID 8087:0025 Intel Corp. 
    ...

この場合、ベンダー ID は 8087 で、製品 ID は 0025 です。

次に、 usb_modeswitch を使用してアダプタをリセットします:

# usb_modeswitch -R -v vendor_ID -p product_ID

ペアリングと接続の問題

コンピュータが表示されない

携帯からコンピュータが表示されないときは、discoverable モードを有効にしてください:

# bluetoothctl discoverable on

discoverable モードがオンになっていることを確認してください:

# bluetoothctl show
	Powered: yes
	Discoverable: yes
	Pairable: yes
ノート: /etc/bluetooth/main.confPairableTimeoutDiscoverableTimeout を確認してください。

まだコンピュータが表示されない場合、以下のように /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)
ノート: 場合によっては、main.conf 内の Class はデバイスの初期化後に上書きされます。なので、hciconfig hci0 class 100100 のようにクラスを直接設定してください。

あるユーザは、携帯からコンピュータを見られるようにするためにはこうするしか無いと報告しています。LG TV(そして、一部の他の機器)はオーディオデバイスから発見可能です。なので、000414 (soundbar クラス)を使用することでそのようなデバイスを発見できるようにできます。

Bluetooth デバイス/サービスのクラスを生成するには https://bluetooth-pentest.narod.ru/software/bluetooth_class_of_device-service_generator.html を見てください。

デバイスを接続した数秒後に切断してしまう

デバイスを接続したすぐ後に切断が発生し、ジャーナルの出力に以下のようなメッセージが確認できる場合:

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

おそらく別のオペレーティングシステムで同一の Bluetooth アダプタを使ってデバイスがペアリングされていることが原因です (例: デュアルブート)。一部のデバイスは同一の MAC アドレス (例: Bluetooth アダプタ) に対して複数のペアリングを関連付けた場合に対処できません。この問題を解決するには #デュアルブートペアリング の指示に従ってください。

スキャンしてもデバイスが表示されない

Bluetooth Low Energy を使用しているデバイスは bluetoothctl でスキャンしても表示されないことがあります (例: Logitech MX Master)。transport le を使ってスキャンすることができます。

# bluetoothctl
[bluetooth]# menu scan
[bluetooth]# transport le
[bluetooth]# back
[bluetooth]# scan on
[bluetooth]# devices
...
Device XX:XX:XX:XX:XX:XX DA V2 X <---- 低消費電力なデバイス

もう一つの方法は、bluez-utils-compatAUR をインストールし、bluetooth.service開始し、以下を実行することです:

# bluetoothctl
[NEW] Controller (MAC) myhostname [default]

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

[bluetooth]# scan on
Discovery started
[CHG] Controller (MAC) Discovering: yes

他のターミナルで:

# hcitool lescan

デバイスが表示されるまで待機してから hcitool を Ctrl+c で閉じてください。bluetoothctl からデバイスが認識されたら通常通りにペアリングできます。

Intel Corp. AX200 Bluetooth で BLE デバイスが見つからない

どうやら、このデバイスでは BLE のパッシブスキャンが壊れているようです。詳細は上流のバグレポートを見てください。

スリープ後に再接続できない

スリープ後や、コンピュータがスリープから復帰した後に、デバイスが自動的に再接続されないことがあります。

この時、ログに以下のエラーが記録されます:

bluetoothd[487]: Authentication attempt without agent
bluetoothd[487]: Access denied: org.bluez.Error.Rejected

これは、デバイスが trusted としてマークされていないことが原因です。#ペアリング を参照してください。

デバイス固有の問題

Bluetooth マウスのラグ / 接続断 / 応答なし

Bluetooth マウス#トラブルシューティング を参照してください。

オーディオデバイスが br-connection-profile-unavailable で接続に失敗する

PipeWire (pulseaudio-bluetooth ではない) が使用されているが、PipeWire のインスタンスが実行されていない場合、bluetooth オーディオデバイスは接続に失敗します。PipeWire デーモンを開始するには、pipewire.service ユーザーユニット開始するか、何らかの音声を再生してください。その後、オーディオデバイスをもう一度接続してみてください。

ヘッドホンとマウスの干渉

Bluetooth マウスとキーボードを同時に使用しているときに音声が途切れる場合は #23 https://bugs.launchpad.net/ubuntu/+source/bluez/+bug/424215 で参照されているように、次を試してくみてださい:

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

TP-LINK UB400 と Xbox のコントローラが接続/切断を繰り返す

以下の設定を使用してください:

/etc/bluetooth/main.conf
...
[General]
JustWorksRepairing = always
FastConnectable = true
Class = 0x000100
...
[GATT]
ReconnectIntervals=1,1,2,3,5,8,13,21,34,55
AutoEnable=true
...

そして、bluetooth.service再起動してください。

関連する xpadneo に関する議論を見ることができますが、xpadneo のドライバは必要ありません。

ファイル転送の問題

gnome-bluetooth

bluetooth-properties でファイルの受信を有効にしようとしたときに以下のメッセージが表示される場合:

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

XDG ユーザーディレクトリが存在することを確認してください。

シンボリックリンクのせいで、転送されたファイルを受信できない

有効な Bluetooth 接続でファイルの受信に失敗する場合、問題はファイルの転送パス内のシンボリックリンクである場合があります。ジャーナルに以下のようなログが現れます:

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

エラーメッセージに表示されれたパス内にシンボリックリンクが含まれている場合、obexd はデフォルトでそれを拒否します。この挙動は、ドロップインファイルobex.service ユーザサービスに対して使うことにより初期化時に上書きできます:

~/.config/systemd/user/obex.service.d/10-symlink.conf
[Service]
ExecStart=
ExecStart=/usr/lib/bluetooth/obexd --symlinks

その後、ユーザの systemd マネージャの設定をリロードし、obex.service ユーザユニットを再起動してください。

参照

翻訳ステータス: このページは en:Bluetooth の翻訳バージョンです。最後の翻訳日は 2023-11-03 です。もし英語版に 変更 があれば、翻訳の同期を手伝うことができます。