測定を制御する
接続・条件の送信・測定は NMRController で扱います。ボタンの有効化やエラー表示を組み合わせて、自分の操作画面を作ります。
以下は最初のWeb UIのHTMLに組み込むコードの抜粋です。各例は独立した完成コードではなく、同じ controller と parameters を使います。
このページの内容
接続と切断
const controller = new NMRController();
const connect = document.getElementById("connect");
const disconnect = document.getElementById("disconnect");
const status = document.getElementById("status");
connect.onclick = async () => {
const result = await controller.connect();
if (result.ok) status.textContent = "接続しました";
};
disconnect.onclick = async () => {
const result = await controller.disconnect();
if (result.ok) status.textContent = "切断しました";
};ポート選択にユーザー操作が必要なので、connect() はボタンクリックから直接呼びます。先に別の非同期処理を待たないようにしてください。
同じポートを別のアプリやタブで使っている場合は、先にそちらを切断します。disconnect() は測定停止ではなく、測定中の切断は拒否されます。
測定条件を指定する
const parameters = {
frequencyHz: 402000,
pulse1Cycles: 21, phase1Degrees: 0,
pulse2Cycles: 42, phase2Degrees: 90,
pulseIntervalMs: 5,
measurementIntervalMs: 200,
scans: 128,
};| 項目 | 意味 | 指定できる値 |
|---|---|---|
frequencyHz | 設定周波数 [Hz] | 1〜2147483647の整数 |
pulse1Cycles / pulse2Cycles | 第1・第2パルスのRF周期数 | 0〜32767の整数 |
phase1Degrees / phase2Degrees | 位相 [度] | 0 / 90 / 180 / 270 |
pulseIntervalMs | パルス間隔 [ms] | 0〜32767の整数 |
measurementIntervalMs | 測定間隔の装置設定 [ms] | 1〜32767の整数 |
scans | 積算回数 | 1〜32767の整数 |
すべて必須です。パルス長はマイクロ秒ではなくRFの周期数で指定します。Singleでも第2パルスの項目を含めます。表の範囲は通信形式の制限であり、装置・試料に適した運転範囲を保証するものではありません。
フォームの値を使う場合は数値に変換します。送信前に入力だけを検証するには、次のように validateParameters を使えます。この呼び出しでは装置へ送信しません。
import { validateParameters } from "./nmrlink/index.js";
try {
validateParameters(parameters);
status.textContent = "入力形式に問題はありません";
} catch (error) {
status.textContent = error.message;
}SingleとDoubleを実行する
const measure = document.getElementById("measure");
measure.onclick = () => controller.measure(parameters, { mode: "single" });
// Doubleを使う場合は、上のハンドラーを次に置き換えます。
// measure.onclick = () => controller.measure(parameters, { mode: "double" });measure() は条件の送信からデータ取得までを行います。積算は scans を装置へ渡して実行します。同時操作の要求は拒否され、キューには積まれません。
測定は自動再送しません。即時停止や正確な進捗通知には対応していないため、実行中は完了を待ってください。
状態でボタンを切り替える
controller.onStateChange(state => {
connect.disabled = !state.canConnect;
measure.disabled = !state.canMeasure;
disconnect.disabled = !state.canDisconnect;
if (state.busy) status.textContent = "処理中…";
});canConnect / canMeasure / canDisconnect:各ボタンを操作できるか。busy:接続・測定などの操作中か。設定フォームの無効化にも使えます。operation:connect / disconnect / measure / sweep、または操作していないときはnull。hasResult:保存や再解析に使える結果があるか。
結果とエラーを受け取る
controller.onResult(record => {
status.textContent = "測定完了:" + record.points + "点";
// record.raw には補正前の [Data 1, Data 2] が入ります。
});
controller.onError(error => {
status.textContent = error.message;
});成功時だけ onResult が呼ばれます。結果は2048点 × 2チャンネルで、sampleIntervalMs は0.02 msです。取得時刻・条件・モードも記録されます。
最後に成功した結果は controller.result に残ります。次の通信や解析が失敗しても消えないので、前回の結果を新しい測定結果と取り違えないように表示してください。
操作メソッドを await する場合は、成功時の { ok: true, value } と失敗時の { ok: false, error } を確認できます。NMRController の操作失敗は onError にも通知されます。
見込み時間を表示する
import { measurementDurationMs } from "./nmrlink/index.js";
const seconds = measurementDurationMs(parameters, { mode: "single" }) / 1000;
status.textContent = "測定の見込み:約" + seconds.toFixed(1) + "秒";通信転送やコマンド処理の時間を含まない目安です。実際の完了時間や進捗を保証するものではありません。
画面を片付ける
コンポーネントなどを破棄するときは、実行中の操作が終わるのを待ち、必要な切断を行ってから監視を解除します。
async function closeUI() {
if (controller.state.busy) return;
if (controller.state.canDisconnect) {
const result = await controller.disconnect();
if (!result.ok) return;
}
controller.dispose();
graphs.dispose();
}dispose() は監視の解除です。装置の測定停止や切断を暗黙には行いません。graphs は最初のWeb UIで作成したグラフ表示です。
接続のトラブルは対応ブラウザと接続トラブルを確認してください。
Node.jsから接続する場合
解析関数はnpmのnmrlinkだけでNode.jsから使えます。実機のシリアル接続には別途NodeSerialTransportが必要です。これはnpm未公開のnmrlink-serverに含まれるため、リポジトリで使います。Node.js 22以上が必要で、Node.js版の実機接続は未検証です。
git clone https://github.com/masabando/nmrlink.git
cd nmrlink
npm install次をリポジトリのルートにmeasure.mjsとして保存し、ポート名と条件を確認したうえでnode measure.mjsを実行します。これは実機を測定するコードで、模擬データの例ではありません。
import { NMRDevice, analyzeMeasurement } from "nmrlink";
import { NodeSerialTransport } from "nmrlink-server";
console.log(await NodeSerialTransport.listPorts());
const device = new NMRDevice({
transport: new NodeSerialTransport({ path: "/dev/cu.YOUR_DEVICE" }),
});
try {
await device.connect();
const record = await device.measure({
frequencyHz: 402000,
pulse1Cycles: 21, phase1Degrees: 0,
pulse2Cycles: 42, phase2Degrees: 90,
pulseIntervalMs: 5, measurementIntervalMs: 200, scans: 128,
}, { mode: "single" });
console.log(analyzeMeasurement(record).peak);
} finally {
await device.disconnect();
}ポート一覧の取得だけでは接続しません。pathを明示し、自動再接続・自動再送は行いません。NMRGraphsやダウンロード用のsaveMeasurementはブラウザ向けです。Firebase経由の構成は遠隔で使う(未検証)を参照してください。