Differences

This shows you the differences between two versions of the page.

--- secs_sparkplug_b_integration_guide [2025/05/06 17:54]
amyw [STARTED Event → Polling Initiation]
+++ secs_sparkplug_b_integration_guide [2025/05/06 18:35] (current)
wikiadmin
@@ Line 23: / Line 23: @@
 ===== Project Summary =====
-TransSECS bridges legacy SECS/GEM automation with modern Sparkplug B IIoT ecosystems.
+TransSECS bridges SECS/GEM automation with modern Sparkplug B IIoT ecosystems.
 By treating a GEM host as a Sparkplug node and every GEM interaction (messages, traces, polls, reports) as separate devices, the project delivers:
@@ Line 88: / Line 88: @@
 ===== Good Host Commands =====
- Flow – the host sends PP-SELECT (DCMD/GEMHost/HostCommandPPSELECT, "sendMessage=true") → TransSECS forwards S2F41 W → the tool replies S2F42 ("HCACK 0").
+ Flow – the host sends PP-SELECT (DCMD/GEMHost/HostCommandPPSELECT, ''sendMessage=true'') → TransSECS forwards S2F41 W → the tool replies S2F42 (''HCACK 0'').
  Sparkplug updates:
-     * The driver immediately publishes a "DDATA/…/HostCommandPPSELECT" echo with "sendMessage=false" to show the command as sent.
+     * The driver immediately publishes a ''DDATA/…/HostCommandPPSELECT'' echo with ''sendMessage=false'' to show the command as sent.
   *
-  *    The tool’s S2F42 is translated to "DDATA/…/HostCommandReply" where "HCACK=0" indicates success.
+  *    The tool’s S2F42 is translated to ''DDATA/…/HostCommandReply'' where ''HCACK=0'' indicates success.
- Parameters – "LOTIDParamValue" and "PPIDParamValue" appear exactly as entered by the host; on success they are echoed back unchanged.
+ Parameters – ''LOTIDParamValue'' and ''PPIDParamValue'' appear exactly as entered by the host; on success they are echoed back unchanged.
- Best-practice – SCADA / MES clients should subscribe to "…HostCommandReply" and check "HCACK" before assuming the tool accepted the command.
+ <note tip>SCADA / MES clients should subscribe to ''…HostCommandReply'' and check ''HCACK'' before assuming the tool accepted the command</note>
 {{puml_002.png?500|}}
@@ Line 104: / Line 104: @@
 ===== Bad Host Commands =====
-Scenario – the host issues PP-SELECT with an invalid PPID; the tool rejects it with "HCACK 3" and a populated "ReasonList".
+Scenario – the host issues PP-SELECT with an invalid PPID; the tool rejects it with ''HCACK 3'' and a populated ''ReasonList''.
-ReasonList structure – an array of tuples "<ParameterName, ErrorCode>".
+ReasonList structure – an array of tuples ''<ParameterName, ErrorCode>''.
-  * In this example → "PPID, 1" (= “parameter unknown or out of range” in many GEM implementations).
+  * In this example → ''PPID, 1'' (= “parameter unknown or out of range” in many GEM implementations).
-Error detection – any non-zero "HCACK" must be treated as a transaction failure; the associated "HostCommandPPSELECT" echo still appears but only confirms that the message was transmitted, not that it succeeded.
+Error detection – any non-zero ''HCACK'' must be treated as a transaction failure; the associated ''HostCommandPPSELECT'' echo still appears but only confirms that the message was transmitted, not that it succeeded.
-Client hint – log "ReasonList_*" for root-cause analysis and surface a human-readable alarm where appropriate.
+<note tip>log ''ReasonList_*'' for root-cause analysis and surface a human-readable alarm where appropriate.</note>
 {{puml_003.png?500|}}