エッジ専用ノード

パレットの PlantPulse Edge カテゴリで以下のノードを使用できます。

2026.05+ ノードパッケージ

node-red-contrib-plantpulse-edge が image 内 node/conf/plantpulse-edge-nodes/ に配置され entrypoint が 起動の都度 node_modules/node-red-contrib-plantpulse-edge で絶対パス symlink を作成。 提供ノード: pp-tag-value-read / pp-tag-value-write / pp-tag-values-read / pp-tag-list / pp-opc-get / pp-opc-start / pp-opc-stop (計7個)。image upgrade 時 自動更新。

---

1. タグ値読み取り (pp-tag-read)

ゲートウェイの1つのタグ値を取得します。内部的に GET /api/v1/tag/{tagId}/value を呼び出します。

フィールド	説明
名前	(選択) ノード名
Tag ID	読み取るタグ (例: TAG_TEST_00042)。空欄にした場合は msg.tag_id で動的に指定
Fresh	チェック時 PLC を直接 read (キャッシュをバイパス)。?fresh=true と同一。通常はオフにしてください (PLC 負荷のため)
Host / Port	ゲートウェイアドレス (デフォルト 127.0.0.1:80 — 同一マシンであればそのまま)
API Key	REST API 認証(edge.rest.api.auth)が有効な場合 X-API-Key へ送信する値(edge.rest.api.key)。msg.api_key で上書き可能です

入力 (選択):

• msg.tag_id — ノード設定の Tag ID を動的に上書き (1つのノードを複数のタグに再利用)
• msg.fresh — boolean, キャッシュバイパスの動的指定

出力:

msg.payload = {
  tag_id: "TAG_TEST_00042",
  value:  "1234",
  value_time: "2026-05-08 03:01:19.001",
  value_read_status: "OK",
  ...
}
msg.statusCode = 200
msg.tag_id = "TAG_TEST_00042"   // 실제 사용된 ID

動的 Tag ID パターン — 推奨

ノード設定の Tag ID は 空欄にし change ノードで msg.tag_id = "TAG_..." を埋める方式が最も柔軟です。同じ 読み取り ノードを複数のタグに再利用可能です。

---

2. タグ値書き込み (pp-tag-write)

ゲートウェイの1つのタグに値を書き込みます。内部的に POST /api/v1/tag/{tagId}/value。

フィールド	説明
名前	(選択)
Tag ID	書き込むタグ。msg.tag_id で動的に指定可能
Value	固定値 (選択)。msg.value → msg.payload → ノード Value の順で優先適用
Host / Port	ゲートウェイアドレス
API Key	読み取りノードと同様 — edge.rest.api.key の値

出力:

msg.payload = {
  result: "SUCCESS",         // 또는 "ERROR"
  opc_id: "OPC_LS_TEST",
  plc_address: "D1000",
  value: "9999",             // 사용자가 보낸 값
  actual_read: "9999",       // 드라이버가 write 후 즉시 read 한 결과
  msg: ""
}
msg.statusCode = 200

対応プロトコル: HTTP / OPC-UA / Modbus TCP / MELSEC / S7 / LS XGT(XGI/XBC/XBM) / AB EtherNet/IP すべて可能です。EIP は PLC ファームウェア/パッチにより一部のデータタイプの書き込みが拒否される場合があるため、シミュレーターで検証後に実設備へ適用してください。

書き込みは危険です

実際の PLC に値を書き込むことで設備が作動する可能性があります。テストタグ または シミュレーター OPC で十分に検証した後、実設備タグに適用してください。書き込み権限は運用チームと合意したタグにのみ使用します。

---

3. 次のステップ

• MQTT ノード詳細 — 外部 SCADA / クラウド IoT 連携
• IIoT 例集 — 読み書きを組み合わせた実際のパターン