HNZ connexion initialization
When the HNZ south plugin establishes a new connection with a HNZ device, it will automatically send the following messages to the device:
- A set date and a set time: Those two messages will synchronize the date and time of the device with the one from the south plugin machine.
- A CG request: This message will request all TS to be sent by the device in CG format (equivalent of GI request of iec104).
HNZ Protocol stack configuration
The HNZ protocol stack configuration specifies communication parameters and is a collection of entries containing information about OSI Transport and OSI Application layers objects.
...
Each entry shall be mapped with the corresponding configuration function in the chosen implementation protocol library.
The present specification corresponds to the HNZ B1/TR mode working on a TCP/IP connection.
Attributes definition
Attribute | Description | Expected values | Mandatory |
---|
name | this identifies the protocol stack | iec104client, iec104server, tase2client, tase2server, 61850client, 61850server, etc... | Yes |
version | version number of the configuration file | 2 digits x.y => x = major change, y = minor change | Yes |
connections | array of connections |
| Yes |
connections.srv_ip | IP address to remote |
IEC 104 HNZ server | IP address | Yes |
connections.port | port number to remote |
IEC 104 serverHNZ server | default = 6001 | No |
remote_station_addr | remote server station address | 6 bits | Yes |
local_station_addr | local server station address | 6 bits | Yes |
remote_addr_in_local_station | remote address in local station | 0, 1 or 2 | Yes |
Inacc_timeout | timeout before declaring the remote server unreachable (DF.GLOB.TS) | default = 180 (seconds) | No |
MaxRepeatmax_sarm | max number of SARM messages before handing over to the passive path (A/B) | default = 30 | No |
To_socket | repeat_path_A | max number of authorized repeats for path A | default = 3 | No |
Repeatrepeat_path_B | max number of authorized repeats for path B | default = 3 | No |
Repeatrepeat_timeout | time allowed for the receiver to acknowledge a frame, after this time, the sender repeats the frame. | default = 3000 | No |
Anticipationmax messages send without ACKTestframes allowed to be received without acknowledgement | default = 3 |
Default_msg_period | Test test message code in sending direction | default = 1304 |
YesTestTest test message code in receiving direction |
Yesdefault = 1304 | No |
gi_schedule | scheduled time for General Interrogation sending | default = 99:99 (disabled) | No |
gi_repeat_count | repeat GI for this number of times in case it is incomplete | default = 3 | No |
gi_time | time to wait for General Interrogation (GI) completion | default = 255 (seconds) | No |
c_ack_time | time to wait before receving a acknowledgement for a control command | default = 10 (seconds) | No |
cmd_recv_timeout | time to wait for bytes when receiving data from the HNZ device | default = 100000 (microseconds) | No |
bulle_time | time to wait before sending a BULLE message after the previous message sent | default = 10 (seconds) | No |
south_monitoring.asset | asset name used to send the connection and gi status information to the north | default = "CONNECTION-1" | No |
Configuration JSON structure
Code Block |
---|
|
{
"protocol_stack":{
"name":"hnzclient",
"version":"1.0",
"transport_layer":{
"connections":[
{
"srv_ip":"192.168.0.10",
"port":6001
},
{
"srv_ip":"192.168.0.11",
"port":6002
}
]
},
"application_layer":{
"remote_station_addr":12,
"local_station_addr":12inacc_timeout":180,
"max_sarm":30,
"remoterepeat_addr_in_local_station":0path_A":3,
"repeat_path_B":3,
"inaccrepeat_timeout":1803000,
"maxanticipation_sarmratio":303,
"totest_msg_socketsend":1"1304",
"repeattest_pathmsg_Areceive":3"1304",
"repeat_path_B":3gi_schedule":"99:99",
"gi_repeat_timeoutcount":30003,
"anticipationgi_time":3255,
"defaultc_msgack_periodtime":010,
"Testcmd_msgrecv_sendtimeout":"1304"100000,
"bulle_time": 10
},
"south_monitoring":{
"Test_msg_receive "asset":"1304CONNECTION-1"
}
}
} |
HNZ datapoint representation
This is the Datapoint representation of an HNZ message.
Attribute | Description | Expected values | Mandatory |
---|
do_type | message type |
TSCE TSCG TMA, TMN, ACK_TC, MOD10TC, TVC | YES |
do_station | station address |
| YES |
do_address | message address |
| YES |
do_value | value | TM (do_an = TMA): [-127..127] TM (do_an = TM8): [0..255] TM (do_an = TM16): [-32768..32767] TS: [0..1] TC: [1..2] (01b = on, 10b = off) TVC: [-255..255] | YES except in quality update readings |
do_valid | validity | valid = 0 or invalid = 1 | YES |
do_ |
tstime code | 10 ms fraction in the 10 min modulo | YESan | TM type (analogic / numeric) | "TMA", "TM8", "TM16" | TM only |
do_cg | TS source | CG = 1 or CE = 0 | TS only |
do_outdated | Outdated message (after connection loss) | up to date =0, outdated = 1 | TM and TS only |
do_ts | timestamp | epoch timestamp in milliseconds | TS CE only |
do_ts_iv | timestamp invalid | valid = 0 or invalid = 1 |
YES(from bit HNV) | TS CE only |
do_ts_c | loss of chronology | lost = |
0 1YES0 (from bit CV) | TS CE only |
do_ts_s | ts not synchronized | synchronized = 0 else = 1 |
YES | ...
Example for a TS from CE:
Code Block |
---|
|
{
"data_object":{
"do_type":"TS",
"do_station":12,
"do_addr":325,
"do_value":1,
"do_valid":0,
"do_cg":0,
"do_outdated":0,
"do_ts":1685019425432,
"do_ts_iv":0,
"do_ts_c":0,
"do_ts_s":0
}
} |
Example for a TS from CG:
Code Block |
---|
|
{
"data_object":{
"do_type":"TSCE""TS",
"do_station":12,
"do_addressaddr":325,
"do_value":1,
"do_valid":0,
"do_cg":1,
"do_outdated":0
}
} |
Example for a TS quality update:
Code Block |
---|
|
{
"data_object":{
"do_type":"TS",
"do_station":12,
"do_addr":325,
"do_valid":0,
"do_cg":0,
"do_outdated":1,
"do_ts":801685019425432,
"do_ts_iv":0,
"do_ts_c":0,
"do_ts_s":0
}
} |
Example for a TMA:
Code Block |
---|
|
{
"data_object":{
"do_type":"TM",
"do_station":12,
"do_addr":71,
"do_value":-15,
"do_valid":0,
"do_an":"TMA",
"do_outdated":0
}
} |
Example for a TMN 8 bits (TM8):
Code Block |
---|
|
{
"data_object":{
"do_type":"TM",
"do_station":12,
"do_addr":71,
"do_value":42,
"do_valid":0,
"do_an":"TM8",
"do_outdated":0
}
} |
Example for a TMN 16 bits (TM16):
Code Block |
---|
|
{
"data_object":{
"do_type":"TM",
"do_station":12,
"do_addr":71,
"do_value":420,
"do_valid":0,
"do_an":"TM16",
"do_outdated":0
}
} |
Example for a TM quality update:
Code Block |
---|
|
{
"data_object":{
"do_type":"TM",
"do_station":12,
"do_addr":71,
"do_valid":0,
"do_an":"TMA",
"do_outdated":1
}
} |
Example for a TC (after receiving ACK):
Code Block |
---|
|
{
"data_object":{
"do_type":"TC",
"do_station":12,
"do_addr":71,
"do_valid":0
}
} |
Example for a TVC (after receiving ACK):
Code Block |
---|
|
{
"data_object":{
"do_type":"TVC",
"do_station":12,
"do_addr":31,
"do_valid":0
}
} |
NB: if an attribute is not required, then it is not put in the output data object, which means that the output object structure always fits the protocol model object type.
HNZ command representation
This is the command representation of an HNZ message.
Warning |
---|
The current implementation does not use a json structure, so the order of parameters is mandatory. |
Order | Attribute | Description | Expected values | Mandatory |
---|
0 | co_type | message type | TC, TVC | YES |
1 | co_addr | message address | [0..255][0..7] (ADO + ADB) for a TC, [0..31] for a TVC | YES |
2 | co_value | value | [1..2] (01b = on, 10b = off) | YES |
The processing of FLEDGE commands should evolve. Below is an example of JSON format :
Example for a TC:
Code Block |
---|
|
{
"co_type":"TC",
"co_addr":325,
"co_value":1
} |
Example for a TVC:
Code Block |
---|
|
{
"co_type":"TVC",
"co_addr":31,
"co_value":42
} |
NB: if an attribute is not required, then it is not put in the output data object, which means that the output object structure always fits the protocol model object type.
HNZ south event representation
South events are special messages used to communicate information about the state of the connection and GI requests between south and north plugins.
Their behivior and structure is defined here.
Path exploration
In redundant network configuration or generally in cases where several communication paths exist between one client and one server, the path checking exploration mechanism allows the client to try all the paths one by one without making any difference between them. The client uses the first available path. On disconnection this procedure starts again from the beginning.