HN 日本語サマリー

← 一覧へ戻る
プログラミング

Findphone: 信号強度で近くのBluetoothデバイスを見つける

Findphone: Locate a nearby Bluetooth device by signal strength (github.com)

24 pointsby helsinkiandrew12 コメント

要約

Findphoneは、コマンドラインから近くのBluetoothデバイスを信号強度に基づいて見つけるためのツールです。MDMによって「探す」機能が無効化されている場合でも、デバイスがBluetooth範囲内にあれば、その位置を特定するのに役立ちます。このツールはmacOS 13以降で動作し、信号強度をRSSI値で表示し、オプションで音によるガイダンスも提供しますが、デバイスを鳴らしたり、方向を示したりすることはできません。

全文翻訳

findphone

コマンドラインから信号強度で近くのBluetoothデバイスの位置を特定します。

「探す」機能が利用できない場合、例えばデバイスがMDMによって無効化されているものの、デバイスがまだBluetooth範囲内にあり、部屋のどこにあるかを知りたいだけの場合のために構築されました。

インストール

Releasesからユニバーサルバイナリを入手してください。

tar -xzf findphone-macos-universal.tar.gz
xattr -dr com.apple.quarantine findphone
./findphone --help

署名されていないため、macOSはダウンロード時に隔離します。xattrコマンドはその隔離を解除します。macOS 13以降が必要です。

ビルド

swift build -c release
cp .build/release/findphone ~/bin/findphone

Xcode Command Line ToolsのSwiftツールチェーンが必要です。依存関係はありません。ユニバーサルなarm64 + x86_64バイナリ(CIが配布するもの)をビルドするには:

./scripts/build-universal.sh dist

使用方法

findphone            # サーベイモード: 信号強度順に近くにあるAppleデバイスをすべて表示
findphone iphone     # ハントモード: 名前で1つのデバイスを追跡(大文字小文字を区別しない)
findphone --list     # ペアリング済みのデバイスとそのアドレスを表示

ハントモードで--soundを追加すると、駐車センサーのように近づくにつれて速くなるクリック音が鳴ります。部屋全体では1秒に1回程度ですが、信号強度が約-50 dBm(電話の上にラップトップが置かれている程度の強さ)に達するとブザー音に変わります。これにより、画面を見続けるのではなく、耳で部屋をスキャンできます。信号が途絶えるとクリック音も止まるため、無音はデバイスがないことを意味します。

少し似ている音はしますが、ガイガーカウンターではありません。カウンターは検出された粒子ごとに1回クリックし、そのレートが測定値となりますが、ここではレートは平滑化された信号から計算されます。パケットは固定の0.3秒のポーリングタイマーで到着するため、その到着レートは距離についてほとんど何も語りません。

画面を録画している場合は--redactを追加してください。Bluetoothアドレスをマスクし、サーベイモードでは発見されたデバイス名をデバイスの種類に置き換えます。なぜなら、それらの名前は必ずしもあなたのものではないからです。公開アドレスは安定したハードウェア識別子であり、BLEアドバタイジングアドレスとは異なりローテーションしないため、ビデオに残す価値があります。

意図的に表示されたままになるものが2つあります。ハントモードで入力した名前と、--listのリストです。なぜなら、ターゲットを選択するにはそれらを読む必要があるからです。--redactを使用しても、--listは安全に撮影できるものではありません。

ゆっくり歩き、バーを見てください。表示されるのはdBm単位の信号強度です。この値は負であり、近いほどゼロに近くなります。

dBmおおよその意味
-45 以上腕の届く範囲
-60同じテーブル
-72同じ部屋
-85遠い、または遮蔽物あり
それ以下非常に遠い、またはシールドされている

信号強度は距離の粗い代理です。金属、壁、人体は信号を強く減衰させるため、2メートル離れたファイルキャビネット内のデバイスは、開けた場所で15メートル離れたデバイスと同じ値を示すことがあります。単一の数値ではなく、移動中のトレンドを信頼してください。

仕組み

3つのソースが1つの測定値にフィードされ、品質の高い順に並んでいます。

  1. GATTリンク — BLE経由でデバイスに接続されると、readRSSI()は毎秒約3回、最新の測定値を返します。これが良い方です。
  2. BLEアドバタイズメント — 受動的に観測されます。Appleデバイスは、約15分ごとにアドバタイジングアドレスをローテーションし、時折パケットにのみデバイス名を含めるため、このソースはまばらです。
  3. クラシックリンク RSSI — system_profiler SPBluetoothDataTypeから読み取られ、ペアリング済みデバイスの安定した公開アドレスでキー付けされます。

ソース3には知っておくべき落とし穴があります。macOSはその値を3秒から12秒ごとにしか更新せず、その間はキャッシュされた数値を返します。これより速くポーリングしても、より多くの情報は得られません。0.4秒間隔で112回のポーリングで測定したところ、すべてのポーリングで値は返されましたが、同じ値が8回から31回のポーリングで繰り返されました。そのため、ツールは値が実際に変更された場合にのみ測定値としてカウントします。これが、報告される測定値の数がポーリングレートよりもはるかに低く、かつ正直である理由です。

パーミッション

実行するターミナルでBluetoothアクセスが必要です。これは、システム設定 > プライバシーとセキュリティ > Bluetoothで設定します。不足している場合は通知されます。

制限事項

  • デバイスを鳴らすことはできません。「探す」機能なしではそのパスはありません。
  • 方角を与えることはできません。1つの無線では距離しか得られず、方向は得られません。
  • Bluetoothがオンになっており、範囲内にあるデバイスのみを見つけられます。屋内では約10〜20 m、壁を透過する場合はそれ以下です。