メインコンテンツまでスキップ

タグ登録

[タグ] は、PLC の メモリの1セル に名前を付けたものです。PLC ごとにメモリアドレス表記が異なるため、お使いの PLC の種類別ページも併せて参照してください。

  • 三菱: D100、M50 のような形式
  • シーメンス: %DB1.DBW0 のような形式
  • LS: D00309 のような形式
  • OPC-UA: ns=2;s=Channel1.Device1.Tag1 のような形式

詳細な表記は、各 PLC ページの [PLC アドレス] 節にあります → PLC 種類別ガイド


入力項目​

タグ1行につき、以下の情報を入力します。

欄何を記入するか
タグ名画面に表示される名前。韓国語も可 (例: 펌프1 회전수)
PLC アドレスPLC マニュアルに記載されているアドレス表記 (例: D100)
データ形式Float、Integer、Boolean、String、Long、Double のいずれか
形式補助 (format)32-bit の場合は DW、実数の場合は REAL など (任意)
計算式単位変換などの後処理数式 (任意)。詳細は 計算式の適用
説明メモ。画面でも一緒に表示されます

データ形式ガイド​

データ形式幅・符号いつ使うか例
Boolean1 ビットオン/オフ、ON/OFFポンプ稼働 / アラーム ON
Integer16-bit 符号あり整数 (負数を含む) — 最も一般的カウンタ、回転数
Long64-bit 符号あり大きな整数 (32-bit 超)累積生産量
Float32-bit 実数小数点を含む値温度、圧力、速度
Double64-bit 実数高精度小数精密測定データ
String可変文字列バッチ名、レシピ名

符号・幅を 名前で明示 する精密タイプ (Kepware と同じ意味):

データ形式幅・符号いつ使うか
Short16-bit 符号ありInteger と同じ (明示的な名前)
Word16-bit 符号なし0~65535 カウンタ (負数なし)
DInt32-bit 符号あり32-bit 整数 (旧 Integer+DW の組み合わせの代替)
DWord32-bit 符号なし21億(2^31)超 の累積カウンタ — Integer で読み取ると失敗していた値
QWord64-bit 符号なし符号なし大型カウンタ
Byte8-bit 符号なしステータスバイト
既存タグの移行 (2026.07 動作変更)
  • S7 Integer: 符号なし(u16)として誤って読み取られていたのを 符号あり(s16) の正本に修正 — 負数が 65531 のように表示される問題を解決。符号なしが必要な場合は Word を使用。
  • S7 / MELSEC Long: 32-bit で読み取っていたのを、正本の 64-bit に統一。従来 Long で 32-bit を読み取っていたタグは DInt(符号あり)または DWord(符号なし) に変更してください。

配列タグ (Base[N])​

DInt[10] のように 要素タイプ[個数] で登録すると、連続領域を1つのタグとして読み取り、JSON 配列文字列 ("[1,2,3]") で保存します。 対応ドライバ (2026.07 拡大): EIP + MELSEC / S7 / Modbus / LS。要素は数値タイプのみ実際に収集されます (String 配列は登録不可、Boolean/Byte 配列はドライバが未対応 — 値は空になります)。 ドライバ別制限: Modbus 合計 125 ワード · LS 合計 64 ワード · MELSEC シリーズ別 (Q/L・iQ-R 960 / QnA 480 / A 32 ワード) S7 ネゴシエーション PDU − 19 バイト — 超過すると値が空になるため、N を減らすかタグを分割してください。配列タグは 読み取り専用 です (書き込み未対応)。


形式補助 (format) ガイド​

PLC の同じアドレスでも、解釈の仕方によって異なる値になります。16-bit のメモリを2セルまとめて 32-bit として読み取ったり、4セルまとめて 64-bit 実数として読み取るなどの違いです。

お持ちの値데이터 형식형식 보조
16-bit 整数 (最も一般的)Integer(空欄)
16-bit 符号なし整数IntegerUI
32-bit 整数 (メモリ2セル)IntegerDW
32-bit 実数 (最も一般的な実数型)FloatREAL
64-bit 実数 (高精度)DoubleLREAL
ビット1個 (オン/オフ)Boolean(空欄)
ワード内の特定ビットBooleanBIN[3] (ビット3番)
文字列 N 文字StringSTR[N] (例: STR[10])
値がおかしく表示されるとき

32-bit / 64-bit なのに形式補助を空にすると、16-bit として誤って読み取られ、値が異常に小さくまたは大きくなります。その場合は format 欄に DW、REAL、LREAL のような値を入力してください。


高度なタグ設定 (Kepware 参照)​

タグには以下の 任意設定 を併せて保存できます (すべて未指定の場合は従来の動作のまま)。 現在はバックアップ/復元 JSON (/connect/restore) または REST で指定し、値はタグ行と一緒に保存されます。

設定値意味
byte_orderAB_CD BA_DC CD_AB DC_BA32/64-bit のバイト・ワード順 (未指定=プロトコル既定)
scaling_typelinear sqrt生値 → 工学単位変換
raw_low/raw_high数値スケーリング入力 (生) 範囲
scaled_low/scaled_high数値スケーリング出力 (工学) 範囲
clamptrue/false出力を scaled 範囲にクランプ
negatetrue/false符号反転
units文字列単位ラベル (例: degC)
client_accessR / RWR の場合、書き込み API が拒否されます (読み取り専用)
deadband数値前回値との変化量がこの値未満なら発行をスキップ
scan_divisor整数n サイクルごとに1回だけ読み取り (収集周期の倍数)

例 — 4~20mA 生値 0..4095 を 0..100% に線形変換し、微小変動を抑制:

{"tags":[{ "opc_id":"OPC_X", "tag_id":"TAG_PCT", "tag_name":"압력%",
"data_type":"Float", "plc_address":"D100",
"scaling_type":"linear", "raw_low":0, "raw_high":4095,
"scaled_low":0, "scaled_high":100, "clamp":true, "deadband":0.5 }]}

計算式 (fomula) と併用可能です — スケーリング結果の上に計算式が適用されます。

CSV 一括登録 (/ui/connect/csv) でも同じ設定を指定できます — 基本9列の後の任意列: RAW_TYPE, BYTE_ORDER, SCALING_TYPE, RAW_LOW, RAW_HIGH, SCALED_LOW, SCALED_HIGH, CLAMP, NEGATE, UNITS, CLIENT_ACCESS, DEADBAND, SCAN_DIVISOR, TAG_GROUP。 9列の既存 CSV はそのまま動作します。JSON バックアップ/復元 はこの設定を常に含みます (未設定項目はファイルから省略)。


登録方法​

方法 1 — PLC 登録フォームで一緒に追加​

[接続追加] または [修正] 画面内にタグ入力表があります。 [+ タグ追加] ボタンを押して行を増やし、1行ずつ入力して [保存]。

方法 2 — 登録済みの PLC にタグのみ追加​

  1. [接続] メニュー → 左側で PLC をクリック
  2. 右側の [タグ一覧] の上にある [タグ追加] ボタンをクリック
  3. 1つずつ追加。追加直後の次の収集周期から値が入り始めます。

方法 3 — CSV 一括アップロード​

タグが数十個以上なら、[接続] 右上の [CSV 一括アップロード] が便利です。CSV 形式はアップロード画面からダウンロードできます。


正しく登録されたか確認​

PLC をクリックすると、右側の [タグ一覧] に登録したタグが表示されます。

列意味
タグ名 / アドレス / 形式登録した通り
現在値最新の収集値 (5 秒ごとに自動更新)
収集時刻その値が入ってきた時刻
状態정상 / 오류

エラーが表示される場合、PLC アドレス表記の誤字またはデータ形式の不一致が原因である可能性が高いです。トラブルシューティング — 値がおかしいです を参照してください。


タグの修正 / 削除​

  • タグ一覧の行をクリックすると修正フォームが開きます。
  • 行末の [削除] ボタンで1行ずつ削除します。

修正直後の次の収集周期から新しい設定が適用されます。


よくある質問​

Q. PLC アドレスはどうやって調べますか?​

  • PLC プログラマ / 設備メーカーのマニュアルに「データマッピング表」が記載されていることがよくあります。
  • PLC 作成ツール (GX Works、TIA Portal、XG5000 など) の「Watch テーブル / モニタ画面」で使用中のアドレスを確認できます。
  • OPC-UA の場合は UA Expert のような無料クライアントでアドレスをクリック/コピーして取得するのが最も正確です。

Q. タグ ID はどうやって決めますか?​

ゲートウェイが自動的に <connection-id>_TAG_<number> 形式で付与します。直接指定も可能ですが、英字/数字/アンダースコアのみ使用してください。

Q. 同じアドレスを2つのタグとして登録してもいいですか?​

可能です。同じ生値に異なる計算式を適用して単位だけ変え、2種類で送信したい場合によく使用します (例: temperature 生値 + temperature_F 華氏変換)。

Q. 1つの PLC にタグは何個まで登録できますか?​

数百個までは問題ありません。ただし、収集周期内にすべて読み取れる必要があるため、PLC が応答できる時間を考慮してください。1つの PLC のタグが 1000 個を超える場合は、PLC の負荷 / ネットワーク遅延も併せて監視することをお勧めします。