本文へ移動

対応ブラウザと接続トラブル

実機への直接接続には、USB接続したPCでChromeまたはEdgeの最新版を使うのがおすすめです。

このページの内容

どのブラウザを使えばいい?

次の表はWeb Serial APIの対応に基づく案内です。NMRLinkの実機で確認した環境は、次の節で分けて示します。

OS直接接続に使えるブラウザ注意点
macOSChrome・Edgeの最新版、Firefox 151以降Safariでは直接接続できません
WindowsChrome・Edgeの最新版、Firefox 151以降組織の管理ポリシーにより制限される場合があります
LinuxChrome・Edgeの最新版、Firefox 151以降ポートの権限とブラウザの配布形式も確認してください

Firefoxでは、初回の機器アクセス時にアドオンの導入を案内される場合があります。 古いFirefoxやESR版を使う場合は、対応バージョンか確認してください。

スマホ・タブレットやSafariでも、ドキュメント・模擬グラフ・保存済みデータの表示や解析は可能です。実機への直接接続は対応ブラウザを使うPCで行ってください。

実機で確認した環境

  • NMRLinkの標準Web UI:macOSのChromeで、標準測定・周波数調整・パルス校正・T1測定・T2測定を確認済みです。
  • その他の組み合わせ:ブラウザがAPIに対応していても、NMRLinkの実機動作をすべて確認したわけではありません。

Debian 13のFirefoxでの成功報告は、ライブラリ化前のブラウザ制御プログラムに対するものです。

接続できないときの確認順

  1. ブラウザとURLを確認する。対応ブラウザで、HTTPSまたは装置を接続したPCのlocalhostから開いてください。 file: URLや、通常のHTTPのLANアドレスでは直接接続できません。
  2. USB接続を確認する。装置の電源と通信用USBケーブルを確認し、OSでシリアルポートとして認識されるか調べます。
  3. ほかのアプリやタブがポートを使っていないか確認する。Pythonの制御プログラム、シリアルモニター、別の測定画面などは、測定の完了を待って切断してください。
  4. 「接続」を押し、装置のポートを選んで許可する。ポートが出ない場合はOSの権限や配布パッケージの制限を、許可できない場合はブラウザのサイト設定や組織の管理ポリシーを確認します。

自作UIでは、ポート選択を接続ボタンのクリックから直接呼んでください。 詳しいAPIの扱いは測定を制御するを参照してください。

Linuxで確認すること

OS側のシリアルポート権限

ブラウザを実行するユーザーに、装置のポートを読み書きする権限が必要です。 Debian系では、ポートの所属グループが dialout の場合があります。 グループを追加した場合は、デスクトップからログアウトして再ログインしてください。

/dev/ttyACM0は例です。実際のポート名に置き換え、所属グループと現在のユーザーのグループを確認します。

sh
ls -l /dev/ttyACM0
id -nG

ポートの所属グループがdialoutで、利用者が未加入の場合は管理者へ追加を依頼します。管理者権限を持つユーザーが自分自身を追加する例です。実行後はデスクトップからログアウトし、再ログインしてください。

sh
sudo usermod -aG dialout "$USER"

Snapなどの配布形式による制限

Snap版Chromiumでは、OSの権限に加えてSnapの raw-usb インターフェースの接続が必要になる場合があります。

Snap版Firefoxには、ポートが表示されない既知の問題があります。 Chromium用のコマンドをそのままFirefoxに置き換える対処は使わず、Mozilla公式の案内で非Snap版の導入方法も確認してください。

sh
snap list chromium
snap connections chromium

raw-usbの行があり、Slot欄が「-」なら未接続です。管理者が次を実行すると、ChromiumにUSB機器へのアクセスを許可できます。

sh
sudo snap connect chromium:raw-usb

Chromiumを完全に終了して起動し直します。この許可はNMR装置だけには限定されず、OS側の権限も別途必要です。raw-usbの行がないパッケージには適用できず、接続成功を保証するものではありません。Snapのraw-usb仕様も参照してください。

解決しない場合

次の情報があると、原因を切り分けやすくなります。

  • OSとブラウザの名前・バージョン。Linuxではブラウザの導入方法も。
  • ポート選択画面が開くか、装置が一覧に出るか、選択したあとに接続できるか。
  • 画面に表示されたエラーメッセージ。

導入するに戻る

参照:MDNのWeb Serial API対応表、MozillaのFirefox対応案内。