タグ登録
[タグ] は、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 など (任意) |
| 計算式 | 単位変換などの後処理数式 (任意)。詳細は 計算式の適用 |
| 説明 | メモ。画面でも一緒に表示されます |
データ形式ガイド
| データ形式 | 幅・符号 | いつ使うか | 例 |
|---|---|---|---|
Boolean | 1 ビット | オン/オフ、ON/OFF | ポンプ稼働 / アラーム ON |
Integer | 16-bit 符号あり | 整数 (負数を含む) — 最も一般的 | カウンタ、回転数 |
Long | 64-bit 符号あり | 大きな整数 (32-bit 超) | 累積生産量 |
Float | 32-bit 実数 | 小数点を含む値 | 温度、圧力、速度 |
Double | 64-bit 実数 | 高精度小数 | 精密測定データ |
String | 可変 | 文字列 | バッチ名、レシピ名 |
符号・幅を 名前で明示 する精密タイプ (Kepware と同じ意味):
| データ形式 | 幅・符号 | いつ使うか |
|---|---|---|
Short | 16-bit 符号あり | Integer と同じ (明示的な名前) |
Word | 16-bit 符号なし | 0~65535 カウンタ (負数なし) |
DInt | 32-bit 符号あり | 32-bit 整数 (旧 Integer+DW の組み合わせの代替) |
DWord | 32-bit 符号なし | 21億(2^31)超 の累積カウンタ — Integer で読み取ると失敗していた値 |
QWord | 64-bit 符号なし | 符号なし大型カウンタ |
Byte | 8-bit 符号なし | ステータスバイト |
- 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 符号なし整数 | Integer | UI |
| 32-bit 整数 (メモリ2セル) | Integer | DW |
| 32-bit 実数 (最も一般的な実数型) | Float | REAL |
| 64-bit 実数 (高精度) | Double | LREAL |
| ビット1個 (オン/オフ) | Boolean | (空欄) |
| ワード内の特定ビット | Boolean | BIN[3] (ビット3番) |
| 文字列 N 文字 | String | STR[N] (例: STR[10]) |
32-bit / 64-bit なのに形式補助を空にすると、16-bit として誤って読み取られ、値が異常に小さくまたは大きくなります。その場合は format 欄に DW、REAL、LREAL のような値を入力してください。
高度なタグ設定 (Kepware 参照)
タグには以下の 任意設定 を併せて保存できます (すべて未指定の場合は従来の動作のまま)。
現在はバックアップ/復元 JSON (/connect/restore) または REST で指定し、値はタグ行と一緒に保存されます。
| 設定 | 値 | 意味 |
|---|---|---|
byte_order | AB_CD BA_DC CD_AB DC_BA | 32/64-bit のバイト・ワード順 (未指定=プロトコル既定) |
scaling_type | linear sqrt | 生値 → 工学単位変換 |
raw_low/raw_high | 数値 | スケーリング入力 (生) 範囲 |
scaled_low/scaled_high | 数値 | スケーリング出力 (工学) 範囲 |
clamp | true/false | 出力を scaled 範囲にクランプ |
negate | true/false | 符号反転 |
units | 文字列 | 単位ラベル (例: degC) |
client_access | R / RW | R の場合、書き込み 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 にタグのみ追加
- [接続] メニュー → 左側で PLC をクリック
- 右側の [タグ一覧] の上にある [タグ追加] ボタンをクリック
- 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 の負荷 / ネットワーク遅延も併せて監視することをお勧めします。