ThinkLink 実践ガイド / モデルとデータ
ThinkLink の物モデル：payload の解析から信頼できる計測値までの五つの確認
項目定義、単位、境界サンプル、更新時の回帰確認によって、アラームやダッシュボード、連携に使える計測値を作ります。
payload の解析前に項目の意味と単位を定義します。正常、境界、異常のサンプルで出力を検証し、表示項目とプロトコルマッピングも確認します。欠測、エラーコード、未測定の値を正常値に変換しないことが重要です。
後段が推測しなくて済む項目表を作る
同じ温度を機器ごとに temp、T、temperature と呼ぶと、表示やアラーム側で繰り返し対応が必要になります。物モデルの役割はバイトを数値へ変えるだけでなく、一貫した意味を持たせることです。
項目名、意味、単位、型、正常範囲、欠測表現、元プロトコル版を記載します。記事の例に合わせて稼働中のモデルを変えず、既存の命名規則を尊重します。積算と瞬時値、状態と測定値を区別します。
| 項目例 | 意味 | 確認点 |
|---|---|---|
| temperature | 現在温度、°C | 符号、倍率、異常コード |
| humidity | 相対湿度、%RH | 範囲、精度、欠測 |
| water_total | 積算水量、m³ | 積算の有無、リセット、桁あふれ |
| sample_time | 測定時刻 | 機器時刻か基盤受信時刻か |
一つのサンプルから推測せず仕様で解析する
AS の実 payload について、ポート、種類、長さ、プロトコル版を確認してからバイト順、符号、倍率を適用します。一件だけ妥当な値が出ても解析の正しさは証明できません。
ThinkLink には解析スクリプトとテスト機能があります。出力するテレメトリーと属性の構造、補助関数、実行制限、参照可能な文脈は対象版の資料に従います。時間のかかる外部要求を解析内へ入れると、収集経路が管理しにくい外部条件へ依存します。
最低三種類のサンプルを用意する
正常系では基準計と比較できる値を使い、項目別の期待値を決めます。境界系には負温度、最大カウンター、仕様上許される状態ビットの組み合わせを含めます。異常系には短いデータ、未知の種類、機器エラー、項目欠落を含めます。
無効値を無視するか診断情報を残すかを仕様に沿って決めます。解析失敗をゼロにすると、消費量ゼロと誤表示したりアラームを誤解除したりします。項目表は設計例であり、すべての機器へ適用できるプロトコルではありません。
解析結果と画面表示を一緒に確認する
スクリプトが項目を返しているのに画面にない場合、未送信と決めつけず、表示項目、選択モデル、デバイスの関連付けを確認します。Modbus や BACnet 出力には個別のマッピング確認が必要で、計測項目があるだけでは出力設定は完成しません。
内部単位と表示単位が異なっても構いませんが、換算箇所は一つに明確化します。リットルから立方メートルへの変換をスクリプトと画面で二重に行うと値がずれます。
変更理由を説明でき、元へ戻せるようにする
変更が影響する機種とメッセージを版の説明に残します。保存済みサンプルで回帰確認後、少数の試験機の新規送信を観察し、既存の表示とアラームが履歴項目を読めるか確かめます。
意味が変わる項目は古い名前を黙って流用せず、明確な新項目を追加して利用側を移行します。旧スクリプトへ戻しても、すでに保存した誤データは自動修正されない点も考慮します。
よくある質問
一つの物モデルを複数台で使えますか？
検証済みの範囲なら再利用できます。型式名だけでなく、プロトコル、ファームウェア、項目の意味を代表サンプルで確認します。
解析成功ならアラームや表示も自動的に正しくなりますか？
いいえ。表示項目、関連付け、しきい値の単位、外部プロトコルへのマッピングは別々に確認します。
参考資料と関連情報
以下の公式資料に基づいて作成しています。図は方法の説明用です。正確なメニュー、項目、機能は対象バージョンの資料をご確認ください。リンク先は中国語です。