Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

(7) OPCUA exposition using the opcua north plugin, the output is a OPCUA object.

Code Block
languagejs
{
   "data_object":{
      "do_type":"type_id",
      "do_ca":"ca",
      "do_oa":"oa",
      "do_cot":"cot",
      "do_test":"istest",
      "do_negative":"isnegative",
      "do_ioa":"ioa",
      "do_value":"value",
      "do_quality":"quality_desc",
      "do_ts":"time_marker",
      "do_ts_qual":"isinvalid",
      "do_ts_sum_time":"isSummerTime"
   }
}

Pivot object model

The pivot object model is based on 61850 semantic.

...

AttributeDescriptionExpected valuesMandatory
namethis identifies the protocol stackiec104client, iec104server, tase2client, tase2server, 61850client, 61850server, etc...Yes
versionversion number of the configuration file2 digits x.y => x = major change, y = minor changeYes
connection.patharray of connection paths

connection.path.srv_ipIP address to remote IEC 104 serverIP addressYes
connection.path.clt_ipclient IP in case of multiple network interfaces server access

IP address, machine's default IP for a given interface

No
connection.path.portport number to remote IEC 104 serverdefault = 2404No
tlsactivation of TLS (see tls configuration chapter for details)TRUE, FALSE, default = FALSENo
k_valueMaximum number of outstanding (unacknowledged) APDU's at a given timedefault = 12No
w_valueAcknowledge the reception latest after this number of APDU'sdefault = 8No
t0_timeouttime out of connection establishmentdefault = 10No
t1_timeouttime out for send or test APDU'sdefault = 15No
t2_timeouttime out for acknowledges in case of no data messages (t2 < t1)default = 10No
t3_timeouttime out for sending test framesdefault = 20No
conn_allestablish all paths within one connection at the same time (=TRUE) or only one (=FALSE)TRUE, FALSE, default = FALSENo
start_allstart communication on all established paths at the same time (=TRUE) or on only one (=FALSE)TRUE, FALSE, default = FALSENo
conn_passvestablish connection even in passive mode (=TRUE) or not (=FALSE)TRUE, FALSE, default = FALSENo
orig_addrOriginator Addressdefault = 0No
ca_asdu_sizesize of "Common Address of ASDU"default = 2 (byte)No
ioaddr_sizesize of 'Information Object Address'default = 3 (byte)No
startup_timetime to wait for startup completiondefault = 180 (seconds)No
asdu_size

maximum ASDU size in transmission direction, if set to "0" => maximum possible value is automatically used.

default = 0 (byte)No
gi_timetime to wait for General Interrogation (GI) completiondefault = 0 (seconds)No
gi_cyclesend General Interrogation (GI) cyclicallyTRUE, FALSE, default = FALSENo
gi_all_casend a separate GI request to every CA; otherwise a broadcast GI request is usedTRUE, FALSE, default = FALSENo
gi_repeat_countrepeat GI for this number of times in case it is incompletedefault = 2No
disc_qualinformation object quality in case of interrupted connectionIV = Invalid, NT = Not Topical, default = NTNo
send_iv_timetime delay before infos are sent as invalid (0 = deactivated)default = 0No
tsivspecifies what to do with a time stamp marked as 'invalid'

remove, process, default = remove

remove: the time stamp will be removed from the information object

process: the time stamp will be processed on regular basis and additionally marked as 'not synchronized'

No
utc_timeUTC timezone (=TRUE) or local timezone (=FALSE) for time conversionTRUE, FALSE, default = FALSENo
comm_wttaguse commands with time tag (=TRUE) or without time tag (=FALSE)TRUE, FALSE, default = FALSENo
comm_parallelmaximum number of commands to be executed at in parallel (0 = unlimited)default = 0No
exec_cycl_testexecute cyclical test requests (C_TS_NA_1/C_TS_TA_1) in monitoring direction (=TRUE) or not (=FALSE)TRUE, FALSE, default = FALSENo
startup_statestartup in active mode (=TRUE) or in passive mode (=FALSE)TRUE, FALSE, default = TRUENo
reverseallow transmission of information objects in reverse direction (=TRUE) or only in standard direction (=FALSE)TRUE, FALSE, default = FALSENo
time_syncperform time synchronization (=TRUE)TRUE, FALSE, default = FALSENo

Configuration JSON file structure

, default = FALSENo

Configuration JSON file structure

Code Block
languagejs
{
   "protocol_stack":{
      "name":"iec104client",
      "version":"1.0",
      "transport_layer":{
 
Code Block
languagejs
{
   "protocol_stack":{
        "nameconnection":"iec104client",
{
            "path":[
               {
                  "versionsrv_ip":"1192.168.0.10",
      "transport_layer":{
            "clt_ip":"",
                  "connectionport":{2404
               "path":[},
               {
                  "srv_ip":"192.168.0.1011",
                  "clt_ip":"",
                  "port":2404
               },
            ],
       {     "tls":false
         },
         "srvk_ipvalue":"192.168.0.11"12,
         "w_value":8,
         "t0_timeout":10,
         "cltt1_iptimeout":""15,
         "t2_timeout":10,
         "portt3_timeout":240420,
         "conn_all":true,
       }  "start_all":false,
            ],"conn_passv":false
      },
      "tlsapplication_layer":false{
         }"orig_addr":0,
         "kca_asdu_valuesize":122,
         "wioaddr_valuesize":83,
         "t0startup_timeouttime":10180,
         "t1asdu_timeoutsize":150,
         "t2gi_timeouttime":1060,
         "t3gi_timeoutcycle":20false,
         "conngi_all_ca":truefalse,
         "startgi_repeat_allcount":false2,
         "conndisc_passvqual":false
"NT",
         }"send_iv_time":0,
      "application_layer   "tsiv":{"REMOVE",
         "origutc_addrtime":0false,
         "cacomm_asdu_sizewttag":2false,
         "ioaddrcomm_sizeparallel":30,
         "startupexec_cycl_timetest":180false,
         "asdustartup_sizestate":0true,
         "gi_timereverse":60false,
         "gitime_cyclesync":false,
      }
   }
}

IEC 104 datapoint representation

This is the Datapoint representation of an IEC 104 ASDU.

Code Block
languagejs
{
   "gidata_all_caobject":false,{
         "gi_repeat_count":2do_type":"type_id",
         "discdo_qualca":"NTca",
         "senddo_iv_timeoa":0"oa",
         "tsivdo_cot":"REMOVEcot",
         "utcdo_timetest":false"istest",
         "commdo_wttagnegative":false"isnegative",
         "commdo_parallelioa":0"ioa",
         "execdo_cycl_testvalue":false"value",
         "startupdo_statequality":true"quality_desc",
         "reversedo_ts":false"time_marker",
         "time_sync":false"do_ts_qual":"isinvalid",
      }"do_ts_sum_time":"isSummerTime"
   }
}

...

Path exploration

draw.io Diagram
bordertrue
diagramNamefp_path_exploring
simpleViewerfalse
linksauto
tbstyletop
lboxtrue
diagramWidth343
revision3

...